四個步驟，一次就好
之後你的協調器就像其他裝置一樣，以卡片的形式立在 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 協調器已連線。接下來這樣做。 新增裝置、批准它，並知道它去了哪裡。以及之後我們替你盯著什麼。 新增你的第一臺裝置
大家常問我們的
我可以接哪些協調器？
Zigbee2MQTT 和 Home Assistant ZHA，今天都可以，而且都能自己來：下載橋接程式，在安裝時選擇你用的是哪一個，取一個配對碼，就完成了。如果你用的是 ZHA，就完全不需要安裝 Zigbee2MQTT，你現有的配置也不用改動。這兩者在真實硬體上的最後一輪驗收我們仍在收尾，遇到問題請告訴我們。接下來輪到 deCONZ / Phoscon，那個還不能選。清單裡沒有你的？告訴我們你用的是哪一個。
我的網路裡有什麼出去？
你協調器的資料，以及在你這次連線期間配對的裝置的資料：位址、品牌、型號和它們的量測值。已經在你 Zigbee2MQTT 裡且沒有配對的裝置不在其中。
需要開連接埠嗎？
不需要。橋只建立向外的連線。我們這邊沒有任何東西進入你的網路。
我要停用怎麼辦？
在 FairGrow 裡中斷協調器。金鑰立刻失效。你的裝置仍留在清單裡，只是不再收到新的量測值。
如果我的橋關了一陣子呢？
什麼都不會壞。量測停下，橋一回來就繼續。卡片上你會看到距上一則訊息的時間在增加。
如果有裝置掉線會怎樣？
橋接器每五分鐘回報一次協調器看到的情況。某台裝置不再回報時，會顯示在你的協調器處，旁邊寫明原因：是裝置本身，還是它所掛接的路由器。如果是橋接器停止回報，我們會先說這一點，否則看起來像全都掉了，其實只是橋接器停了。
接上你自己的協調器
告訴我們你用的是哪根接收棒、想量什麼。配對這一步我們陪你走一遍。