接入自己的 Zigbee 协调器

知识库
接入自己的 Zigbee 协调器

已经在自己的接收棒上跑 Zigbee2MQTT 了?那就四步接到 FairGrow。硬件还是你的,防火墙上什么都不用开。

用你自己的接收棒没有开放端口每台设备由你放行
4
从代码到第一次测量的步数
15 分钟
需要的时间
0
防火墙上要开的端口
你
决定哪台设备能进来
怎么进行

四步,一次性

之后你的协调器就像其他设备一样,以卡片的形式立在 FairGrow 里。

1

下载桥

一个给 Windows、macOS 或 Raspberry Pi 用的安装程序。它就在下面,其余的它自己搞定。
2

取一个配对码

从显示设备面板取一个八位码,一次性,有效一刻钟。下面就能看到怎么做。
3

把码输入一次

桥会把它换成一把留在你自己机器上的钥匙。码随后立刻作废。

4

配对第一台设备

在协调器上打开网络。那里有用于新设备的打开配对窗口,以及用于已有设备的接管设备。

桥

安装只要一分钟

选好你的系统再启动安装程序。它把一切准备好,问你要配对码,并让桥以后自己跟着开机。

FairGrow-brug

可以配合你自己的 Zigbee2MQTT,也可以直接对接 Home Assistant 里的 ZHA。它只和你的协调器以及 FairGrow 通信,不和别的东西通信。

版本 1.21
Windows10 和 11
下载 然后双击
macOSVentura 及以上
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.sh
LinuxRaspberry Pi、NAS、服务器
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.sh

请注意:网桥不装在 Home Assistant 本机上。它既不是集成也不是加载项,而且在 Home Assistant OS 上你无法加装 Python。请把它装在同一网络中一台保持开机的其他机器上:你的电脑、一台 Raspberry Pi、一台 NAS 或一台虚拟机。使用 ZHA 时,它从那里通过网络连到 Home Assistant。

安装程序具体做什么
  1. 看你机器上有没有 Python 3,没有就告诉你去哪儿拿。
  2. 建一个自己的文件夹和自己的 Python 环境,跟你的系统分开。
  3. 把桥取下来,再把指纹和平台给出的比对。对不上就什么都不启动。
  4. 询问你的配对码,以及 Zigbee2MQTT 或 Home Assistant 运行在哪里。
  5. 配对一次,并让桥跟着机器一起启动。

所有东西都放在自己的文件夹里,你的系统 Python 一点都不动。要删掉就用 fairgrow-brug.bat /verwijderen 或 sh fairgrow-brug.sh --verwijderen;配对本身在你自己的协调器卡片上撤销。更想手动来?单独的桥还在:fgzb_brug.py。

要升级到更新的版本,请运行 fairgrow-brug.bat /bijwerken 或 sh fairgrow-brug.sh --bijwerken。你的配对和设置都会保留,因此不需要新的配对码。

第 2 步

配对码这样取

在 FairGrow 里点三下。码只用一次,有效一刻钟。

1. 显示设备面板

显示设备
设备
+添加数据记录仪
+添加协调器
办公室在线
客厅在线

2. 选择你的协调器

添加协调器
你用的是哪种协调器?
选择你的协调器Zigbee2MQTT ▾
Zigbee2MQTT完全控制
Home Assistant ZHA尚未确定
deCONZ / Phoscon尚未确定
封闭网关(旁观)尚未确定
生成配对码

3. 你的码

把这个码输入你的桥
7K4M‑2QP9
14:52 后失效
等待你的桥报到……
打开显示设备,点添加协调器,选好你的类型,就会拿到一个八位码。那个码在安装程序里输入一次。
路线

你的测量数据走哪条路

每条连接都从你这边向外发起。没有任何东西进来。

你的设备 传感器、阀门 你的协调器 你自己的接收棒 桥 在你的机器上 FairGrow 平台

每个箭头都朝外。你的协调器和设备都留在你自己的网络里。

你需要什么

三样东西

一个受支持的协调器

凡是 Zigbee2MQTT 带得动的接收棒:SONOFF ZBDongle-E 或 P、SLZB-06、ConBee III。

一个正在跑的 Zigbee2MQTT

2.x 版本,配你自己网络里的 MQTT 服务器。你现有的搭法照旧运行。

一台一直开着的机器

桥是个小小的 Python 程序。协调器旁边放一台 Raspberry Pi 就够。

配对之后

一台新的 Zigbee 设备在等你

你的面板上不会凭空冒出东西。

它待在隔离区

设备在等着。没有测量,没有面板,暂时什么都没有。

我们问它是谁

品牌、型号、会些什么。卡片上你能看到哪些是实测的、哪些是查来的。

由你决定

接受或拒绝。拒绝会把设备移走并挡在外面。

如实说明边界

你的 Zigbee 协调器在这里能做什么

别的牌子的协调器并不差。它只是造法不同。

能做到

  • 从 FairGrow 里打开配对窗口
  • 读出一台设备的品牌、型号和能力
  • 说明一台设备能不能转发别人的流量
  • 移走一台设备并挡在外面
  • 跑一次网络扫描:哪些设备经由哪些设备,信号有多强
  • 认出你的适配器和固件,并对我们已知会出问题的组合发出提醒

做不到

  • Zigbee2MQTT 问不出设备不肯给的东西。这时我们依靠自己的设备库。
  • 不是每台设备都通过 Zigbee2MQTT 提供闪灯找我。

我们自己量不到的,卡片会说明。借来的数值从不冒充实测值。

跑起来之后

看看你的 Zigbee 网络状况

Zigbee 是网状网络:设备之间互相中转。你从协调器发起一次网络扫描,就能看到谁经由谁。

平面图

每台设备、每条链路以及它有多强。薄弱环节在传感器掉线之前就看得见。

哪里不对劲

只有一个邻居的设备、太弱的链路、挂得离协调器太远的东西。旁边写着我们这么说的依据。

变化

每次扫描我们都留着。这样你能看到链路一点点变弱,或者设备反复换邻居,而不是等它没声了才发觉。

扫描会向每个路由器索取邻居表,要占用射频时间,所以从不自动开始。而对不作答的路由器,我们不会悄悄称它孤立:那里写的是我们不知道。

出问题的时候

如果不成功,我们能看到原因

安装程序会把你的系统测一遍,并记录发生了什么。

先测量,再配对

端口、权限、驱动、开机任务。几乎所有出问题的地方,都在网桥之外。

我们手上有另一半

每次尝试都会有一个参考编号。编号下面记着从你这边传来的内容,即使配对从未成功。

发送只需一个按钮

在“你的协调器”下面有“发送日志”。密码在到达的那一刻就被遮蔽。

哪些 Zigbee 硬件能用。 市售适配器和品牌会出什么岔子,我们又挡下了什么。 看看哪些能用

你的 Zigbee 协调器已连接。接下来这样做。 添加设备、批准它,并知道它去了哪里。以及之后我们替你盯着什么。 添加你的第一台设备

常见问题

大家常问我们的

我能接哪些协调器?

Zigbee2MQTT 和 Home Assistant ZHA,今天都可以,而且都能自己来:下载桥接程序,在安装时选择你用的是哪一个,取一个配对码,就完成了。如果你用的是 ZHA,就完全不需要安装 Zigbee2MQTT,你现有的配置也不用改动。这两者在真实硬件上的最后一轮验收我们仍在收尾,遇到问题请告诉我们。接下来轮到 deCONZ / Phoscon,那个还不能选。列表里没有你的?告诉我们你用的是哪一个。

我的网络里有什么出去?

你协调器的数据,以及在你这次会话中配对的设备的数据:地址、品牌、型号和它们的测量值。已经在你 Zigbee2MQTT 里且没有配对的设备不在其中。

需要开端口吗?

不需要。桥只建立向外的连接。我们这边没有任何东西进入你的网络。

我要停用怎么办?

在 FairGrow 里断开协调器。钥匙立刻作废。你的设备仍留在列表里,只是不再收到新的测量值。

如果我的桥关了一阵子呢?

什么都不会坏。测量停下,桥一回来就继续。卡片上你会看到距上一条消息的时间在增加。

如果有设备掉线会怎样?

网桥每五分钟报告一次协调器看到的情况。某台设备不再上报时,会显示在你的协调器处,旁边写明原因:是设备本身,还是它所挂靠的路由器。如果是网桥停止上报,我们会先说这一点,否则看上去像全都掉了,其实只是网桥停了。

接入你自己的协调器

告诉我们你用的是哪根接收棒、想测什么。配对这一步我们陪你走一遍。

✓

谢谢您!

我们已收到您的请求,将尽快与您联系。

➤ 1 个工作日内专人联系

➤ 根据您的实际情况提供方案