Zigbee2MQTT

Zigbee2MQTT ？ ？

讓您在沒有供應商網橋或閘道的情況下使用 Zigbee 設備。

它橋接事件並允許您透過 MQTT 控制 Zigbee 設備。透過這種方式，您可以將 Zigbee 設備與您正在使用的任何智慧家庭基礎設施整合。

入門

該文件為您提供了啟動和運行所需的所有資訊！如果這是您第一次訪問，請確保不要跳過某些部分，因為其中可能有重要的詳細資訊。

如果您不熟悉Zigbee術語，請務必閱讀本文以幫助您解決問題。

整合

Zigbee2MQTT 與（幾乎）每個家庭自動化解決方案都能很好地集成，因為它使用 MQTT。然而，以下整合值得一提：

家庭助理

• Home Assistant OS：使用官方插件
• 其他安裝：使用此處的說明

溫馨

• 在 Homey 應用程式中實現集成
• Homey 論壇中的文件和支持

多莫蒂茨

• 在 Domoticz 中實現的整合（文件）。

格拉迪斯助理

• 整合在 Gladys Assistant 中本地實現（文檔）。

物聯網經紀商

• 在 IoBroker（文件）中實現整合。

建築學

內部架構

Zigbee2MQTT 由三個模組組成，每個模組都在自己的 Github 專案中開發。從硬體（適配器）開始，向上移動； zigbee-herdsman 連接到您的 Zigbee 適配器，並使 API 可供更高層級的堆疊使用。例如，對於 Texas Instruments 硬件，zigbee-herdsman 使用 TI zStack 監控和測試 API 與適配器進行通訊。 Zigbee-herdsman 處理核心 Zigbee 通訊。 zigbee-herdsman-converters 模組處理從單一裝置模型到它們支援的 Zigbee 叢集的對應。 Zigbee 集群是基本協定之上的 Zigbee 協定層，定義了諸如燈、感測器和交換器如何透過 Zigbee 網路相互通訊等內容。最後，Zigbee2MQTT模組驅動zigbee-herdsman並將zigbee訊息對應到MQTT訊息。 Zigbee2MQTT 也追蹤系統的狀態。它使用database.db檔案來儲存這個狀態；包含連接設備及其功能的 JSON 資料庫的文字檔案。 Zigbee2MQTT 提供基於 Web 的介面，允許監控和設定。

發展

Zigbee2MQTT 使用 TypeScript（目前部分使用）。因此，在對lib/目錄中的檔案進行變更後，您需要重新編譯 Zigbee2MQTT。這可以透過執行npm run build來完成。為了更快地開發，您可以在另一個終端機會話中執行npm run build npm run build-watch ，這將在您變更檔案時重新編譯。在第一次建置之前，您需要執行npm install --include=dev在提交變更之前執行npm run test-with-coverage 、 npm run pretty:check和npm run eslint

支援的設備

請參閱支援的設備以檢查您的設備是否受支援。清單相當廣泛，包括來自小米、宜家、飛利浦、歐司朗等供應商的設備。

如果它未在支援的設備中列出，則可以（相當）輕鬆地添加支持，請參閱如何支援新設備。

支持與幫助

如果您需要協助，可以檢查未解決的問題。當您能夠修復問題或添加新設備或只是在社交媒體上分享愛時，請隨時幫助處理拉取請求。