用途:通过 MQTT 自动发现机制,把自定义 IoT 设备与传感器自动注册到 Home Assistant,避免手动编写 YAML 配置。适用于 ESP32/ESP8266/树莓派等自注册传感器、多传感器设备归组、以及设备频繁变动的部署场景。
主要能力:发布 JSON 发现配置到发现主题,HA 自动创建实体;支持设备类、单位、状态类、图标等字段;支持把多个传感器归入同一设备条目;提供带离线队列与自动重连的健壮 MQTT 模式。
必要用法:发现主题格式为 homeassistant/{component}/{node_id}/{object_id}/config,状态主题格式为 {node_id}/{sensor_type}/state。使用 paho-mqtt 连接 broker 后,向发现主题以 retain=True 发布配置,再向状态主题发布数值。必填字段包括 name、unique_id、state_topic;推荐字段包括 device_class、unit_of_measurement、state_class、icon;device 块可包含 identifiers、name、manufacturer、model、sw_version。
限制:若已有官方 Home Assistant 集成应优先使用;无 MQTT broker 基础设施时不适用;需要极低延迟实时控制时应考虑直接 API。资料未提供具体收费、价格与平台支持信息。