**Zigbee2MQTT** 是一个强大的开源工具，用于将 Zigbee 设备桥接到 MQTT，从而实现跨品牌设备的统一管理。 --- ## 🧩 兼容性 Zigbee2MQTT 支持多种 Zigbee 适配器以及大量不同品牌的 Zigbee 设备。 --- ## 🔗 集成性 由于 Zigbee2MQTT 使用 **MQTT 协议**，它能够很好地与大多数家庭自动化解决方案（如 Home Assistant、OpenHAB、Domoticz 等）实现无缝集成。 --- ## ⚙️ 安装应用注意事项 - 本应用需要一个 **USB Zigbee 协调器**。 - 固定的设备路径为：**`/dev/ttyUSB0`** --- ## 🚀 引导页配置指南 1. **Device（设备）** 请选择 **`/dev/ttyUSB0`** > ⚠️ 注意：设备名称通常以 `usb-***-USB-Serial-***` 开头。 2. **Network（网络）** 请选择合适的 Zigbee 频段。 3. **MQTT 配置** 请配置 **MQTT 服务器地址** 与认证信息（用户名和密码）。 - 如果使用商店中的应用 **emqx**，推荐地址为： `mqtt://emqx.<设备名>.heiyu.space` 4. **Serial（串口）设置** 在 **Serial** 选项卡中： - 如果是 TI(德州仪器) 芯片 **CC** 系列，请选择 **zstack**。 - 其他芯片请根据实际硬件选择合适的适配器类型。 5. 提交后等待设备初始化, 如果初始化成功, 需要重新打开应用访问, 原窗口跳转后的url 无法访问 --- ## ⚠️ 注意事项 请 **勿将 USB Zigbee2MQTT 协调器直接插在微服背后的 USB 接口上。** 建议使用 **USB 延长线** 或 **带延长线的扩展坞** 进行连接， 以避免 USB 3.0 接口信号干扰造成设备通信异常。 --- ## 📚 文档与排错指南 - 官方入门指南：[https://www.zigbee2mqtt.io/guide/getting-started/](https://www.zigbee2mqtt.io/guide/getting-started/) - 启动失败或运行异常排查文档： [https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html](https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html) 如果在提交引导页后应用启动失败： 1. 请查看应用日志以定位问题； 2. 按照官方文档排查； 3. 停止应用后重新启动，即可重新进入引导页面。