其实就是接了几个 Zigbee 的吸顶灯到 HA 里。

今年有同学也出来工作，就盘算着一起整租套房子，比来比去居然是自如最有性价比，也好，省心了。

租的时候同学问了一嘴是不是全屋智能，答曰不是，在详情页似乎也没看到描述。不过签约之后看到 app 里能控制灯具，并且在房间里找到了下面这个玩意儿：

研究了下这玩意儿应该是个网关，房子里的吸顶灯走 Zigbee 连。门锁走的 Zigbee 还是 NB-IoT 不太确定，不过这玩意儿不是重点。

btw 有个相当扯淡的事情是，吸顶灯在自如的 app 里能控制开关、亮度和色温，但墙壁开关还是机械的。只能说智能了个寂寞。

正向接入 Home Assistant

OK 回到正题，傻子才会想用自如的 app 来搞智能家具。如果能接入到 HA 里面，能搞的事情就非常多了。

HA 有两种接入 Zigbee 设备的方式，一种是自带的 ZHA (Zigbee Home Automation)，一种是第三方集成 Z2M (Zigbee2Mqttt)。ZHA 有残废的开箱即用：只能控制开关，不能控制亮度和色温。而给第三方设备编写配置（在 ZHA 里叫 Quirk）的难度也非常大，只能基于模板来搞，也没办法自行控制设备支持的功能和具体的命令。虽然说有新版本的 Quirks 2.0，但依旧是难用。所以最后决定还是用 Z2M 来搞了。

不过 ZHA 有个比较好的地方是，调试 Zigbee 设备比 Z2M 方便，会直接列出所有命令，直接鼠标点点就能发送命令。调完之后这个设备大概支持了这么些功能：

色温：
Color (endpoint id = 1, id = 0x0300, type = in)
读取：
color_temperatue (id: 0x0007)
设置：
move_to_color_temp (id: 0x000a)
  color_temp_mireds = 166~370 (2700K ~ 6500K)
  transition_time
​
亮度：
LevelControl (endpoint id = 1, id = 0x0008, type = in)
读取：
current_level (id: 0x0000)
off_transition_time (id: 0x0013) r/w
on_transition_time (id: 0x0012) r/w
start_up_current_level (id: 0x4000) r/w
设置：
move_to_level (id: 0x0000)
  level = 0~255
  transition_time
​
开关：
OnOff (endpoint id = 1, id = 0x0006, type = in)
读取：
on_off (id: 0x0000)
关：
off (id = 0x0000)
开：
on (id = 0x0001)
切换开关：
toggle (id = 0x0002)

色温、亮度和开关，足够使用了。接下来开始编写 Z2M 的设备文件。

需要注意的是只有在 Z2M 里能显示出来制造厂商和型号的 Zigbee 设备才能接入 Z2M，比如这样：

一个基础的 Z2M 设备配置长这样：

const definition = {
    zigbeeModel: ['ZH-D00002021'],
    model: 'ZH-D00002021',
    vendor: 'Vensi',
    description: '吸顶灯',
    extend: [],
    fromZigbee: [
        fz.on_off, fz.brightness, fz.color_colortemp, fz.level_config
    ],
    toZigbee: [
        tz.on_off, tzLocal.light_onoff_brightness, tz.light_colortemp, tz.level_config
    ],
    exposes: [
        new VensiZHLight().withBrightness().withColorTemp()
    ],
};
​
module.exports = definition;

前几行是型号、厂商和描述，fromZigbee 决定了如何读取设备的属性状态，toZigebee 决定了如何发送 Zigbee 控制命令，而 exposes 决定了有哪些属性会被暴露出去。

默认情况下，Z2M 提供的带亮度和色温功能的灯具模板里，调整亮度会根据一些设备属性来决定使用 moveToLevel 还是 moveToLevelWithOnOff 命令。而自如的灯在这种情况下会被认为该使用后者。但实际上它用的应该是前者，所以这里我们仿照预置模板来继承出我们自己的灯具设备：

class VensiZHLight extends exposes.Base {
    constructor() {
        super();
        this.type = 'light';
        this.features = [];
        this.features.push(new Binary('state', access.ALL, 'ON', 'OFF').withValueToggle('TOGGLE').withDescription('On/off state of this light'));
    }
​
    withBrightness() {
        assert(!this.endpoint, 'Cannot add feature after adding endpoint');
        this.features.push(new Numeric('brightness', access.ALL).withValueMin(0).withValueMax(255).withDescription('Brightness of this light'));
        return this;
    }
​
    withLevelConfig() {
        assert(!this.endpoint, 'Cannot add feature after adding endpoint');
        const levelConfig = new Composite('level_config', 'level_config', access.ALL)
            .withFeature(new Numeric('on_transition_time', access.ALL)
                .withLabel('ON transition time')
                .withPreset('disabled', 65535, 'Use on_off_transition_time value')
                .withDescription('Represents the time taken to move the current level from the minimum level to the maximum level when an On command is received'),
            )
            .withFeature(new Numeric('off_transition_time', access.ALL)
                .withLabel('OFF transition time')
                .withPreset('disabled', 65535, 'Use on_off_transition_time value')
                .withDescription('Represents the time taken to move the current level from the maximum level to the minimum level when an Off command is received'),
            )
            .withDescription('Configure genLevelCtrl');
        this.features.push(levelConfig);
​
        return this;
    }
​
    withColorTemp(range) {
        assert(!this.endpoint, 'Cannot add feature after adding endpoint');
        const rangeProvided = range !== undefined;
        if (range === undefined) {
            range = [167, 370];
        }
​
        const feature = new Numeric('color_temp', access.ALL).withUnit('mired').withValueMin(range[0]).withValueMax(range[1])
            .withDescription('Color temperature of this light');
​
        [
            {name: 'coolest', value: range[0], description: 'Coolest temperature supported'},
            {name: 'neutral', value: parseInt((range[0] + range[1]) / 2), description: 'Neutral temperature'},
            {name: 'warmest', value: range[1], description: 'Warmest temperature'},
        ].filter((p) => p.value >= range[0] && p.value <= range[1]).forEach((p) => feature.withPreset(p.name, p.value, p.description));
​
        this.features.push(feature);
        return this;
    }
}

亮度我们使用 Numeric 来作为控制，这里已经是归一化之后的亮度等级，范围 0~255。色温同理，不过我们可以再通过 withPreset 来增加几个预设的等级。需要注意的是这个预设等级只供 Z2M 使用，HA 在接入设备之后有自己的色温预设等级。

withLevelConfig 用来控制状态转换过程中的渐变时间。对自如这个灯来说这个属性不太能有自定义的值，不过我们还是给它暴露出去。

toZigbee 的部分大部分是改自模板，这里就不列出来了。完整的设备文件放在了 gist 上，可以直接下载使用。

完成之后，将设备文件放在 /config/zigbee2mqtt 目录下，在 Z2M 的设置里添加外部设备文件，然后重启 Z2M 集成。如果一切正常，应该就能在设备里看到灯具了，接下来就能正常在 HA 里使用了。

反向接入回米家（小爱同学）

解决了正向接入 HA 的问题，接下来再反向接入回米家，这样就能躺床上控制了。

不过虽然说的是叫接入米家，实际上应该叫接入小爱同学。米家不能支持的第三方设备接入之后，只能使用小爱同学语音控制。但这样也足够了，“小爱同学，开灯”“小爱同学，灯的亮度调到 50%”“小爱同学，灯的色温调到暖光”，三类语音描述刚好覆盖完整功能。

这里我们使用巴法云作为中间平台。具体使用可以直接参考其 Github 仓库。