『瀚思彼岸』» 智能家居技术论坛

 找回密码
 立即注册
查看: 49467|回复: 55

[基础教程] 把不在支持列表的新设备接入zigbee2mqtt的方法

  [复制链接]

1

主题

13

帖子

2472

积分

金牌会员

Rank: 6Rank: 6

积分
2472
金钱
2459
HASS币
0
发表于 2021-5-30 19:10:07 | 显示全部楼层 |阅读模式
本帖最后由 long3772 于 2022-8-3 23:21 编辑

我是在树莓派上安装的hassio,在加载项商店安装的zigbee2mqtt add-on,这种插件安装方式不能通过修改devices.js文件来支持新设备,要通过外部转换器的方式来支持新设备,当时zigbee2mqtt官方文档也没写得很清楚,我也是踩了不少坑才搞定的,现把配置方法分享总结如下:

1、把新设备配对接入z2m网关后,只要 Model 这一栏能识别出设备的型号,就能继续进行下面的修改配置文件,完成设备的识别和接入。有部分设备如果这一栏是空白的,就不能通过修改配置文件接入了;还有部分设备进入配对状态后,完全不能被z2m网关检测到,没有任何反应。后2种情况的设备只能通过刷入大神专门定制的固件才能救活并接入z2m网关了。

快照6.jpg

2、根据待接入设备的类型,把我上传附件提供的几种常用zigbee设备的配置文件模板简单修改下就行了。除说明的地方外,其他地方不要改动。
Zigbee设备配置文件模板.rar (67.21 KB, 下载次数: 1050)

    zigbeeModel: ['ZHA-DoorLockSensor'],------------Model栏识别出的设备型号
    model: 'ZHA-DLS',                   ------------设备型号,自己随意
    vendor: 'LDS',                      ------------厂家或品牌,自己随意
    description: '门锁传感器',          ------------功能描述,自己随意
    fromZigbee: [fz.ias_contact_alarm_1],
    toZigbee: [],
    exposes: [e.contact(), e.battery_low(), e.tamper()],

如果你的设备支持显示电量百分比,就要在exposes: []里加入e.battery(),

至于其他不常用的设备,要写配置文件,就要先到z2m官方支持的设备页面查询和你的设备同类型的设备型号,然后打开devices.js文件并找到这个型号,把配置信息代码复制出来再自己修改即可。

3、把修改好的配置文件复制到以下位置,\\192.168.x.x\config\zigbee2mqtt
   注意:文件名要英文的,名称自己随意,不重复就行。

快照4.jpg

4、修改Zigbee2mqtt的配置文件,Supervisor -- Zigbee2mqtt -- 配置

快照5.jpg

如上图修改好后,点击保存--重启加载项,重启Zigbee2mqtt后就大功告成了。

从下图可以看到,Manufacturer 这一栏由 Unsupported 变成你修改的制造商品牌,就表示配置成功了。

快照7.jpg

特别提醒:

如果配置文件里的配置信息代码不正确,会导致z2m系统启动失败,比如有个别设备的配置信息,在devices.js里能正常识别,但在external_converters里因为缺少几行配置信息代码,就导致z2m系统启动失败了,502: Bad Gateway。

快照8.jpg

如果上述原因导致z2m系统启动失败,又无法修改正确的配置信息,那就只能把xxxx.js文件里新增的配置信息删除,或删除external_converters下新增的  - xxxx.js 字段了,然后重启Zigbee2mqtt即可恢复正常。

可以根据不同类型的设备,创建几个不同的xxxx.js配置文件,以方便设备的管理。需要注意的是,只有一个设备的配置文件和多个设备合一的配置文件的代码格式是有区别的,具体看我上传的附件配置模板,搞错了也会导致z2m系统启动失败。
=========================================================

更新接入方法:

Zigbee2mqtt 升级1.25版本以后,外部转换器的配置方法又变了,之前的配置路径已失效(配置 -- 加载项 -- Zigbee2mqtt -- 配置),有2种新的配置方法如下:

第一种:(推荐此方法,操作最简单)

\\192.168.X.X\config\zigbee2mqtt\configuration.yaml
在上面的路径找到configuration.yaml,用记事本打开,把下面的内容复制进去,(注意把xxxx.js改成你自己的文件名称),保存,重启Zigbee2mqtt即生效。

external_converters:
  - roome.js
  - sensor.js
  - switch.js
  - yudun.js

第二种:

Zigbee2MQTT -- 设置 -- 外部转换器

127_5.jpg

点击右下角的 +
在出现的长框内输入xxxx.js文件的全名
点击 Submit提交 重启即生效。

踩坑提醒:之前我在1.24版本里配置好的设备,升级到1.25版本后,按新方法修改配置,重启后,z2m系统启动失败,502: Bad Gateway,百思不得其解,因为已用此方法测试成功接入部分设备了,操作方法是没问题的,最后经过排查终于发现,是我其中一个设备在1.25版本被z2m官方支持了,我在外部转换器加了一个同样型号的设备引起冲突了,把此设备的配置文件删除,问题解决!






评分

参与人数 8金钱 +33 收起 理由
lvictor + 1 高手,这是高手!
偷心者联盟 + 5 厉害了word楼主!
owench + 1
wwisdom + 1 厉害了word楼主!
firewater + 10 感谢楼主分享!
Simonyud + 5 感谢楼主分享!
cym9007 + 5 感谢楼主分享!
独心 + 5 感谢感谢~刚好需要~!!!!

查看全部评分

回复

使用道具 举报

11

主题

313

帖子

1324

积分

金牌会员

Rank: 6Rank: 6

积分
1324
金钱
1011
HASS币
10
发表于 2021-5-30 22:01:29 | 显示全部楼层
学习了                    。
回复

使用道具 举报

33

主题

2196

帖子

5838

积分

论坛元老

Rank: 8Rank: 8

积分
5838
金钱
3642
HASS币
60
QQ
发表于 2021-5-30 23:16:18 | 显示全部楼层
赞一个,虽然经常这样搞,但没写过帖子。
z2m能识别到的都好说,就怕识别不到。
我不生产技术,我只是技术的搬运工。
回复

使用道具 举报

8

主题

171

帖子

2461

积分

金牌会员

Rank: 6Rank: 6

积分
2461
金钱
2290
HASS币
0
发表于 2021-6-1 21:16:49 来自手机 | 显示全部楼层
我的model可以识别,按你的方法一改z2m就起不来,设备zha下可以直接用,z2m只能识别用不了
回复

使用道具 举报

0

主题

22

帖子

244

积分

中级会员

Rank: 3Rank: 3

积分
244
金钱
222
HASS币
0
发表于 2021-6-5 22:47:17 | 显示全部楼层
太棒了,跟着这个步骤接上了
回复

使用道具 举报

3

主题

92

帖子

1465

积分

金牌会员

Rank: 6Rank: 6

积分
1465
金钱
1373
HASS币
10
发表于 2021-6-6 07:50:48 来自手机 | 显示全部楼层
谢谢分享。。。。。。
回复

使用道具 举报

31

主题

531

帖子

2463

积分

金牌会员

Rank: 6Rank: 6

积分
2463
金钱
1927
HASS币
20
发表于 2021-6-16 11:09:18 | 显示全部楼层
按照您的帖子方式,可以接入新设备,但是新设备只要进行publish设定,比如把插座的默认状态修改为开启状态 ,就会报错,而且 power energy temperature这几类的现实内容都是null
回复

使用道具 举报

6

主题

114

帖子

1409

积分

金牌会员

Rank: 6Rank: 6

积分
1409
金钱
1295
HASS币
0
发表于 2021-6-17 16:00:47 来自手机 | 显示全部楼层
我出现了这问题谁能给解决一下
59b900e30dff0b73.png
回复

使用道具 举报

31

主题

531

帖子

2463

积分

金牌会员

Rank: 6Rank: 6

积分
2463
金钱
1927
HASS币
20
发表于 2021-6-17 22:03:20 | 显示全部楼层
祁连山路 发表于 2021-6-17 16:00
我出现了这问题谁能给解决一下

毛都看不清
回复

使用道具 举报

1

主题

198

帖子

2185

积分

金牌会员

Rank: 6Rank: 6

积分
2185
金钱
1987
HASS币
0
发表于 2021-6-17 22:51:47 | 显示全部楼层

学习了
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|Hassbian

GMT+8, 2024-11-24 10:36 , Processed in 0.572908 second(s), 36 queries .

Powered by Discuz! X3.4

Copyright © 2001-2021, Tencent Cloud.

快速回复 返回顶部 返回列表