Zigbee2MQTT 是一个流行的项目，使 Zigbee 设备能够与 MQTT 代理进行通信，进而允许各种智能家居平台（如 Home Assistant）与 Zigbee 设备进行交互。下面是在 Home Assistant 中使用 Zigbee2MQTT 的完整指南：

1. 安装 Mosquitto MQTT broker

首先，如果您还没有 MQTT broker，需要安装一个。在 Home Assistant 中，转到 设置 → 插件 → 插件商店，然后安装 Mosquitto broker 插件。

2. 添加 Zigbee2MQTT 仓库

  • 回到插件商店，点击 ⋮ → 仓库。
  • 输入以下地址：https://github.com/zigbee2mqtt/hassio-zigbee2mqtt，然后点击 添加 → 关闭。
  • 在 Home Assistant 实例中，您将看到预填充了特定仓库 URL 的插件仓库对话框。

3. 选择并安装 Zigbee2MQTT 插件

  • Zigbee2MQTT：这是稳定版本，追踪 Zigbee2MQTT 的已发布版本，推荐大多数用户使用。
  • Zigbee2MQTT Edge：这是开发版本，有一些未正式发布的特性和修复。

选择所需的版本，点击 安装 并等待完成。

4. 配置 Zigbee2MQTT

  • 转到 配置。
  • 如果不使用 Mosquitto broker 插件，请填写您的 MQTT 详细信息。使用 Mosquitto broker 插件时，请留空。
mqtt:
  server: mqtt://localhost:1883
  user: my_user
  password: "my_password"
  • 填写串行详情，如您的 USB 协调器的端口。
serial:
  port: /dev/ttyUSB0
  • 点击 保存。
  • 通过转到 信息 并点击 开始 来启动插件。
  • 等待 Zigbee2MQTT 启动，然后按 打开 WEB UI 以验证是否正确启动。

5. 从独立安装中恢复数据（如有需要）

  • 确保两个环境都运行相同版本。
  • 备份您的独立环境。
  • 使用 HA 插件配置 UI 来配置串行端口。
  • 恢复数据。
  • 确保配置文件的串行端口部分与 UI 的配置匹配。
  • 启动插件。

6. 注意事项与故障排除

  • 如果遇到 502: Bad Gateway 错误，请稍等片刻后刷新页面。
  • 如果插件启动时间过长，检查 日志 选项卡以查看出了什么问题。
  • 如果您在插件中发现任何问题，请首先检查问题跟踪器中是否有类似的问题。

7. 更多资源

总之，Zigbee2MQTT 为 Home Assistant 用户提供了与 Zigbee 设备通信的强大工具。通过遵循上述步骤，您可以轻松地将 Zigbee 设备集成到您的智能家居环境中。

打赏微海报分享