Zigbee2MQTT 🌉 🐝协议

允许你在没有供应商的桥接器或网关的情况下使用 Zigbee 设备。

它桥接事件，并允许你通过MQTT控制Zigbee设备。通过这种方式，你可以将 Zigbee 设备与你正在使用的任何智能家居基础设施集成。

开始

该文档为你提供了启动和运行所需的所有信息！如果这是你第一次访问，请确保你不要跳过部分，因为那里可能有重要的细节供你使用。

如果你不熟悉 Zigbee 术语，请务必阅读本文以帮助你。

集成

Zigbee2MQTT 与（几乎）每个家庭自动化解决方案很好地集成，因为它使用 MQTT。但是，以下集成值得一提：

家庭助理

• Home Assistant OS：使用官方插件
• 其他安装：使用说明在这里

兄弟

• 在 Homey 应用程序中实现集成
• Homey 论坛中的文档和支持

多莫蒂奇

• 在 Domoticz 中实现集成（文档）。

格拉迪斯助理

• 在 Gladys Assistant 中原生实现集成（文档）。

IoBroker的

• 在 IoBroker 中实现的集成（文档）。

建筑

内部架构

Zigbee2MQTT 由三个模块组成，每个模块都在自己的 Github 项目中开发。从硬件（适配器）开始，向上移动;zigbee-herdsman 连接到你的 Zigbee 适配器，并使 API 可用于堆栈的更高级别。例如，对于德州仪器 （TI） 的硬件，zigbee-herdsman 使用 TI zStack 监控和测试 API 与适配器进行通信。Zigbee-herdsman 处理核心 Zigbee 通信。zigbee-herdsman-converters 模块处理从单个设备型号到它们支持的 Zigbee 集群的映射。Zigbee 集群是 Zigbee 协议在基本协议之上的层，用于定义灯、传感器和交换机如何通过 Zigbee 网络相互通信等内容。最后，Zigbee2MQTT 模块驱动 zigbee-herdsman，并将 zigbee 消息映射到 MQTT 消息。Zigbee2MQTT 还跟踪系统的状态。它使用文件来存储此状态;一个文本文件，其中包含已连接设备及其功能的 JSON 数据库。Zigbee2MQTT 提供了一个基于 Web 的界面，允许监控和配置。

database.db

发展

Zigbee2MQTT 使用 TypeScript（目前部分使用）。因此，在对目录中的文件进行更改后，你需要重新编译 Zigbee2MQTT。这可以通过执行 来完成。为了加快开发速度而不是运行，你可以在另一个终端会话中运行，这将在你更改文件时重新编译。

lib/

npm run build

npm run build

npm run build-watch

支持的设备

请参阅支持的设备以检查你的设备是否受支持。有一个相当广泛的列表，包括来自小米、宜家、飞利浦、欧司朗等供应商的设备。

如果未在支持的设备中列出，则可以（公平地）轻松添加支持，请参阅如何支持新设备。

支持与帮助

如果你需要帮助，可以检查已打开的问题。当你能够解决问题或添加新设备或只是在社交媒体上分享爱时，请随时帮助处理拉取请求。