WB55cgu/docs/HOME_ASSISTANT_INTEGRATION.md

Home Assistant integration plan for WB55cgu

This project currently uses direct Zigbee endpoint reports in App/ and STM32_WPAN.

To connect data to Home Assistant, do this:

1. Keep the current Zigbee role logic in place.
2. Add a small gateway path from local Zigbee payload -> MQTT JSON by using:
   • WB55cgu/App report callbacks
   • a publisher to local gateway (if your setup is via USB/serial) or via TCP socket from a bridge.
3. Use existing Home Assistant server files at:
   • ..\home-assistant-server\homeassistant\configuration.yaml
   • ..\home-assistant-server\mosquitto\config\mosquitto.conf
   • ..\home-assistant-server\zigbee2mqtt\configuration.yaml
4. Push the telemetry payload to:
   • home/stm32wb55/device_001/telemetry
5. Status topic:
   • home/stm32wb55/device_001/status
6. Optional command topic:
   • home/stm32wb55/device_001/commands

Recommended first milestone:

• send fields: temperature, humidity, battery, rssi, uptime, fw_version
• value JSON example:

{
  "device_id": "stm32wb55_001",
  "temperature": 23.4,
  "humidity": 48.2,
  "battery": 3.01,
  "rssi": -67,
  "uptime": 123456,
  "fw_version": "0.1.0"
}

The template protocol definition for this format is in:

• ..\stm32wb55\protocol.md