米家HASS组件代码剖析

hevake_lcj · 发表于 2017-7-31 07:49:33

本帖最后由 hevake_lcj 于 2017-7-31 12:54 编辑

上一个帖子里，博主分享了首次按教程接入小米网关经历，成功了。
秉着知其然，一定要知其所以然的探索精神，博主决定好好剖析一下组件的代码。
如有不对的地方，还请各位指正。

插件文件的组织结构：

最上面有一个 xiaomi.py，是总的组件。下以的四个子目录各有一个 xiaomi.py，是顶对各种设备的组件。

./xiaomi.py
在这个文件里，定义了 setup(hass, config) 函数，这个函数的功能是安装组件的，每个组件都有。
它的执行过程如下：

其中定义了三个类：

XiaomiDevice类的定义：
Image [8].png

该类定义了所有小米设备的属性与方法。

./switch/xiaomi.py 小米开关代码
在这个文件里，定义了switch的设备加载与设备行为处理方法

该文件分如下几个部分：

import 模块

导入的有：SwitchDevice（标准开关类的基类），PY_XIAOMI_GATEWAY（网关管理对象，见 ./xiaomi.py中定义），XiaomiDevice（小米设备定义）。
setup_platform(hass, config, add_device, discovery_info)，设备组件安装函数

创建对象，并 append 到 devices 列表中，然后调用 add_devices(devices)，注册这些设备到 hass 中。
实现 XiaomiGenericSwitch 类
XiaomiGenericSwitch类继承于两个父类：XiaomiDevice（小米设备消息处理），SwitchDevice（开关设备模板定义）。
其详细定义如下：

主要定义了：icon，is_on 属性与 turn_on(), turn_off() 方法，与消息回调函数 parse_data()。