连接 Home Assistant

核对型号和固件

• LANBON 联网版与开关实体

  按下方清单核对机身型号和固件。多模式面板会按当前配置发布兼容开关。通过 MQTT 自动发现可添加开关实体。

通过 MQTT 自动发现接入

1. 准备 MQTT Broker

   如果已有 Broker，记下局域网地址、端口、用户名和密码。如果第一次设置，可按下方 Home Assistant 官方说明安装 Mosquitto。面板和 Home Assistant 都需要能访问这个地址。

2. 让 Home Assistant 和面板连接同一个 Broker

   在 Home Assistant 的「设置 → 设备与服务 → 添加集成」中搜索 MQTT，填入 Broker 的连接信息。在面板打开「设置 → 开放集成」，开启总开关和「开放 MQTT」，填入同一个 Broker 的连接信息。面板使用 Broker 在局域网上的地址。

3. 开启自动发现

   在 Home Assistant 的 MQTT 设置中启用自动发现，保留默认前缀 homeassistant。在面板开启 Discovery，再回到 Home Assistant 的 MQTT 集成查看开关实体。

Home Assistant Broker 安装说明 · 查看面板 Broker 配置与 MQTT 开发文档

验证开关与状态

1. 从 Home Assistant 切换开关

   切换一个可安全测试的回路，核对面板或负载的实际动作。

2. 从面板切换同一路开关

   在面板改变同一路状态，确认 Home Assistant 实体同步更新。

排查发现或控制问题

• 没有发现开关

  核对双方是否连接同一个 Broker、面板 Discovery 是否开启，以及 Home Assistant 是否启用自动发现并使用 homeassistant 前缀。再核对面板当前模式和固件是否提供开关实体。

• 避免重复实体

  同一个面板在同一个 Home Assistant 实例中选一条接入路径。切换到 LANBON 自定义集成时，先关闭面板的 MQTT Discovery，再核对原有自动化。

资料与下载