Skip to content

docs: expand Home Assistant MQTT integration section#16

Merged
guillaumedelre merged 1 commit into
developfrom
docs/ha-mqtt-integration
May 14, 2026
Merged

docs: expand Home Assistant MQTT integration section#16
guillaumedelre merged 1 commit into
developfrom
docs/ha-mqtt-integration

Conversation

@guillaumedelre
Copy link
Copy Markdown
Owner

Summary

  • Add ASCII end-to-end flow diagram: BME280 → driver → Flask API → MQTT broker → Home Assistant
  • Add prerequisites section: Mosquitto add-on install, dedicated MQTT user creation, HA MQTT integration setup, .env credentials
  • Add Option A — MQTT auto-discovery (recommended): three mosquitto_pub commands to register entities automatically without touching configuration.yaml
  • Rename existing config to Option B — Manual MQTT sensors
  • Add troubleshooting table (unavailable entity, 502 error, discovery not working, wrong values)
  • Add [ha-mqtt-discovery] reference link

Test plan

  • README renders correctly on GitHub
  • Auto-discovery commands work on a real HA + Mosquitto setup
  • All links are valid

Add end-to-end flow diagram (sensor → driver → API → broker → HA),
prerequisites (Mosquitto add-on, user creation, MQTT integration setup),
MQTT auto-discovery commands (Option A) as the recommended approach
alongside the existing manual configuration.yaml config (Option B),
and a troubleshooting table. Add ha-mqtt-discovery reference link.

Co-authored-by: agilicode <agilicode@gmail.com>
@guillaumedelre guillaumedelre merged commit c87e837 into develop May 14, 2026
3 checks passed
@guillaumedelre guillaumedelre deleted the docs/ha-mqtt-integration branch May 14, 2026 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant