已经在用 Home Assistant？直接连接，无需安装其他东西
不需要第二台机器，也不需要桥接器。你的设备留在 Home Assistant 中，可使用 ZHA、Zigbee2MQTT 或任何其他集成。你勾选 FairGrow 可以看到哪些传感器，只有这些数据会离开你的场所。
将 FairGrow 添加到 Home Assistant
下载集成，将 fairgrow 文件夹解压到 Home Assistant 的 config/custom_components 中（使用 File editor 或 Samba 加载项）。然后重启 Home Assistant。FairGrow 一旦进入 HACS 列表，这一步只需点击一次。
下载集成选择你要共享的内容
勾选 FairGrow 可以看到的传感器：温度、湿度、土壤湿度、光照、功率等。之后可通过“配置”修改。读数每分钟传送一次；如果网络中断，Home Assistant 会保存数据并在之后补发。
你可以随时停止共享：在 Home Assistant 中删除该集成，或在 你的协调器 下断开连接。你在 FairGrow 上的历史数据会保留。
高级用户：独立桥接器
你在使用 Zigbee2MQTT 或 ZHA，并希望 FairGrow 自己管理 Zigbee 网络（配对窗口、隔离、网络扫描）？那么下面的桥接器适合你。它运行在你自己的一台机器上，放在协调器旁边。
四步，一次性
之后你的协调器就像其他设备一样，以卡片的形式立在 FairGrow 里。
安装只要一分钟
选好你的系统再启动安装程序。它把一切准备好，问你要配对码，并让桥以后自己跟着开机。
FairGrow-brug
可以配合你自己的 Zigbee2MQTT，也可以直接对接 Home Assistant 里的 ZHA。它只和你的协调器以及 FairGrow 通信，不和别的东西通信。
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -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。
安装程序具体做什么
- 看你机器上有没有 Python 3，没有就告诉你去哪儿拿。
- 建一个自己的文件夹和自己的 Python 环境，跟你的系统分开。
- 把桥取下来，再把指纹和平台给出的比对。对不上就什么都不启动。
- 询问你的配对码，以及 Zigbee2MQTT 或 Home Assistant 运行在哪里。
- 配对一次，并让桥跟着机器一起启动。
所有东西都放在自己的文件夹里，你的系统 Python 一点都不动。要删掉就用 fairgrow-brug.bat /verwijderen 或 sh fairgrow-brug.sh --verwijderen；配对本身在你自己的协调器卡片上撤销。更想手动来？单独的桥还在：fgzb_brug.py。
要升级到更新的版本，请运行 fairgrow-brug.bat /bijwerken 或 sh fairgrow-brug.sh --bijwerken。你的配对和设置都会保留，因此不需要新的配对码。
配对码这样取
在 FairGrow 里点三下。码只用一次，有效一刻钟。
1. 显示设备面板
2. 选择你的协调器
3. 你的码
你的测量数据走哪条路
每条连接都从你这边向外发起。没有任何东西进来。
每个箭头都朝外。你的协调器和设备都留在你自己的网络里。
三样东西
一个受支持的协调器
凡是 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 协调器已连接。接下来这样做。 添加设备、批准它，并知道它去了哪里。以及之后我们替你盯着什么。 添加你的第一台设备
你的自动化也能一起过来
接上协调器，读数就搬过来了。没必要就此打住。
FairGrow 可以去问你的 Home Assistant 正在跑哪些自动化，并把它们复制到工作流编辑器里，原件丝毫不动，每份副本在你另行决定之前都是关着的。问题不在于 Home Assistant 做得不好。问题在于，在这里同一条自动化还能看一眼 Sentinel-2 影像、一个 FAO-56 蒸发量数字或者一个虫害模型，而这些你不必先自己搭出来。
大家常问我们的
我得放弃 Home Assistant 吗？
不用，我们也没这么要求。你的 Zigbee 网络留在原地，家里的那套继续跑在上面。我们说的是另一回事：对地里的活儿来说，FairGrow 是安放你读数更合适的地方。Copernicus、NASA POWER、FAO-56 和按 EPPO 代码组织的作物保护在这里是标配，而在 Home Assistant 里，这每一样都是一个要你自己维护的项目。你现有的自动化一键就能跟过来。
我能接哪些协调器？
Zigbee2MQTT 和 Home Assistant ZHA，今天都可以，而且都能自己来：下载桥接程序，在安装时选择你用的是哪一个，取一个配对码，就完成了。如果你用的是 ZHA，就完全不需要安装 Zigbee2MQTT，你现有的配置也不用改动。这两者在真实硬件上的最后一轮验收我们仍在收尾，遇到问题请告诉我们。接下来轮到 deCONZ / Phoscon，那个还不能选。列表里没有你的？告诉我们你用的是哪一个。
我的网络里有什么出去？
你协调器的数据，以及在你这次会话中配对的设备的数据：地址、品牌、型号和它们的测量值。已经在你 Zigbee2MQTT 里且没有配对的设备不在其中。
需要开端口吗？
不需要。桥只建立向外的连接。我们这边没有任何东西进入你的网络。
我要停用怎么办？
在 FairGrow 里断开协调器。钥匙立刻作废。你的设备仍留在列表里，只是不再收到新的测量值。
如果我的桥关了一阵子呢？
什么都不会坏。测量停下，桥一回来就继续。卡片上你会看到距上一条消息的时间在增加。
如果有设备掉线会怎样？
网桥每五分钟报告一次协调器看到的情况。某台设备不再上报时，会显示在你的协调器处，旁边写明原因：是设备本身，还是它所挂靠的路由器。如果是网桥停止上报，我们会先说这一点，否则看上去像全都掉了，其实只是网桥停了。
接入你自己的协调器
告诉我们你用的是哪根接收棒、想测什么。配对这一步我们陪你走一遍。