【Zigbee2mqtt】接入HA，Z2m Add-on 及 Assistant Add-on介绍

whxciotw

1. 起因

---

1.1 最近一些小伙伴入手了Zigbee2mqtt的网关，我也一道入手，用来部分替代小米的Zigbee网关。
1.2 Aqara S2，通过小米网关是不支持接入HA的，但是使用了DIY的z2m网关则可以接入；同时无线开关用DIY的z2m网关接入，可以实现更多的动作。
1.3 现在各厂家的zigbee设备层出不穷，归类也比较混乱，比如小米绿米，有的产品已有网关支持，有的产品却不支持、可能需另购网关。同时未来可能会使用更多的第三方（非小米绿米）的zigbee设备，如易微联的zigbee设备等。
1.4 实现真正的智能家居局域网化，摆脱厂商的“云”限制。


2. 效果展示

---

2-1

2-2

2-3

2-4

3. 硬件准备

---

3.1 我是使用了妖神DIY的无线zigbee网关，详见链接：https://github.com/smarthomefans/z2m_partner。感谢妖神开发分享、及众多小伙伴的测试完善。
3.2 也有其他方案选择，可以使用zigbee CC2531 Sniffer USB dongle，某宝购买，自行烧录，具体可参考：https://bbs.hassbian.com/forum.php?mod=viewthread&tid=4448&highlight=zigbee。感谢大佬珠玉在前。


4. 软件准备，Add-on安装

---

我的环境是Hass.io，可以安装第三方的Add-on；如果是Homeassistant，可以使用虚拟机、群晖等的docker自行部署z2m。
在此我将演示使用Hass.io安装2个Add-on，一个作为bridge/server，一个作为assistant/webui。
在add-on-store中添加以下2个源，并安装
    https://github.com/yllibed/hassio
    https://github.com/danielwelch/hassio-zigbee2mqtt


5. Zigbee2mqtt Add-on配置及使用

---

打开Zigbee2mqtt插件配置页面，在config中进行配置，如下几项进行修改及说明，其他配置项如果不懂，请勿更改。如需更改更多的设置，请自行阅读文档：https://www.zigbee2mqtt.io/information/configuration.html

{
  "data_path": "/share/zigbee2mqtt",
  "devices": "devices.yaml",
  "groups": "groups.yaml",
  "homeassistant": true,     #开启，使得设备通过mqtt被HA自动发现
  "permit_join": false,
  "mqtt": {
    "base_topic": "zigbee2mqtt",
    "server": "mqtt://192.168.19.4:1883",        #填写自己的mqtt服务器地址及端口
    "user": "mqtt",               #mqtt服务器的用户名
    "password": "mqtt"       #mqtt服务器的密码
  },
  "serial": {
    "port": "tcp://192.168.19.16:8880"     #【端口二选一】，如使用【3.1】中我的硬件方案，请填写z2m网关的ip地址及端口

    "port": "/dev/ttyACM0"      #【端口二选一】，如使用【3.2】中类似dodojie大佬的硬件方案，请填写cc2531的ttyACM0串口

  },
  "advanced": {
    "pan_id": 6754,
    "channel": 11,
    "network_key": [
      1,
      3,
      5,
      7,
      9,
      11,
      13,
      15,
      0,
      2,
      4,
      6,
      8,
      10,
      12,
      13
    ],
    "availability_blacklist": []
  },
  "ban": [],
  "whitelist": [],
  "queue": {},
  "socat": {
    "enabled": false,
    "master": "pty,raw,echo=0,link=/dev/ttyZ2M,mode=777",
    "slave": "tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5",
    "restartdelay": 1,
    "initialdelay": 1,
    "options": "-d -d",
    "log": false
  }
}

配置完成后，启动。如有错误，请查看add-on日志


6. Zigbee2mqtt Assistant Add-on配置

---

打开Zigbee2mqtt Assistant插件配置页面，在config中进行配置，如下几项进行修改及说明，其他配置项如果不懂，请勿更改。如需更改更多的设置，请自行阅读文档：https://github.com/yllibed/Zigbee2MqttAssistant#settings

{
  "settings": {
    "mqttserver": "192.168.19.4",      #mqtt服务器地址
    "mqttusername": "mqtt",            #mqtt服务器用户名
    "mqttpassword": "mqtt",             #mqtt服务器密码    "allowJoinTimeout": "2"              #zigbee设备配对过期时间，建议设为2分钟，足够了
  }
}

配置完成后，启动，等待片刻，即可扫描到设备并读取信息。如有错误，请查看add-on日志


7. Zigbee2mqtt Assistant Add-on的使用

---

打开webui，有devices、map、status 3个标签页，如下图

5.1 devices标签页：查看、修改设备信息，并可对多个zigbee设备绑定
5.2 map标签页：查看zigbee的地图，并可重新扫描设备
5.3 status标签页：添加新的zigbee设备，设置日志等级。
添加完成设备后，根据自己的习惯修改设备信息，即可在HA的mqtt集成中自动发现。


8. 隐藏的内容（雾）

---

并没什么隐藏内容，只说下小的感想。
在网上找了几个zigbee network/map的插件或前端，实测下来，使用这个assistant add-on效果是最好的，直观、简洁、信息完整。
建议采用此add-on。


9. 已支持的Zigbee设备

---

https://www.zigbee2mqtt.io/information/supported_devices.html


10. 参考及致谢

---

感谢诸位大神的开源分享，使得各zigbee终端设备可以通过此方法来万能接入，不受厂商的束缚，真正实现智能的局域网化。
以下致谢不分先后，如有遗漏，请海涵。
https://github.com/Koenkk/zigbee2mqtt
https://www.zigbee2mqtt.io/
https://github.com/smarthomefans/z2m_partner
https://github.com/yllibed/Zigbee2MqttAssistant
https://bbs.hassbian.com/forum.php?mod=viewthread&tid=4448&highlight=zigbee
https://bbs.hassbian.com/forum.php?mod=viewthread&tid=7217&highlight=zigbee
妖神、dodojie、hongong3、鼎盛驾校



祝各位在庚子鼠年，身体健康、阖家幸福，智能家居的研究更上一层楼！

Hassbian论坛红红火火！

新年快乐！

lylh

感谢楼主的分享，学习学习~

noahzh89

这个硬件有车没有

Meng

謝謝分享

whxciotw

noahzh89 发表于 2020-1-22 14:28
这个硬件有车没有

貌似没车了

sundat

妖神那个设备的车没上到。。。。。群主最好不要发隐藏贴，隐藏贴回复的全是垃圾。。。。

whxciotw

sundat 发表于 2020-1-22 17:14
妖神那个设备的车没上到。。。。。群主最好不要发隐藏贴，隐藏贴回复的全是垃圾。。。。
...

感谢提醒~！

sirakawa

卧槽？cc2531还有车?
这玩意不是淘宝随便买个就能用了么= =！

一直看着CC26X2R1眼馋，不过太贵了- -！

whxciotw

sirakawa 发表于 2020-1-22 20:02
卧槽？cc2531还有车?
这玩意不是淘宝随便买个就能用了么= =！

这个车除了zigbee模块，还带了个esp32。就不用树莓派或其他主机了。

sirakawa

whxciotw 发表于 2020-1-22 23:03
这个车除了zigbee模块，还带了个esp32。就不用树莓派或其他主机了。

esp32不也是随便买么。。还是说这玩意是定制的esp32和cc2531一体的车？

我ha跑在树莓派，直接一根线拉出去就用了～