How quangtrung89vp/lumentree works
Lumentree is a Home Assistant integration for monitoring hybrid solar inverters. The principal workflow is device-ID setup and authentication, followed by MQTT-based live telemetry and HTTP-based historical statistics, which Home Assistant exposes as sensor entities. Statistics also support cached historical backfill and user-triggered maintenance services. The supplied tree omits the referenced API, MQTT, aggregator, coordinator, cache, and entity implementation modules; those nodes and links are based on README claims or setup code, with paths left null where no source path is present.
Main entry points: __init__.py Integration setup · config_flow.py Config flow · sensor (1).py Live sensors · const.py Integration constants
Components 19
Setup
- Config flow
config_flow.py - HTTP API client
- Integration setup
__init__.py - Device API
- Integration constants
const.py
Live telemetry
- MQTT client
- Lumentree broker
- Live sensors
sensor (1).py - Status sensors
binary_sensor.py
Statistics
- Stats aggregator
- Historical API
- History cache
- Stats coordinators
- Stats sensors
- Backfill services
__init__.py
Home Assistant
- Home Assistant
- Diagnostics
diagnostics.py
Other components
- Integrator
- Inverter
Connections 25
- Integrator → Config flow: starts setup
- Config flow → HTTP API client: authenticates
- HTTP API client → Device API: requests device info
- Config flow → Home Assistant: creates entry
- Home Assistant → Integration setup: sets up entry
- Integration setup → HTTP API client: fetches device info
- Integration setup → MQTT client: connects
- MQTT client → Lumentree broker: subscribes
- Inverter → Lumentree broker: publishes telemetry
- Lumentree broker → MQTT client: delivers messages
- MQTT client → Live sensors: dispatches updates
- Home Assistant → Live sensors: forwards platform
- Home Assistant → Status sensors: forwards platform
- Integration setup → Stats aggregator: creates
- Stats aggregator → Historical API: fetches history
- Stats aggregator → History cache: reads and writes
- Integration setup → Stats coordinators: creates
- Stats coordinators → Stats aggregator: requests statistics
- Home Assistant → Stats sensors: forwards platform
- Stats coordinators → Stats sensors: provides updates
- Home Assistant → Backfill services: registers services
- Backfill services → Stats aggregator: runs backfill
- Backfill services → History cache: maintains cache
- Home Assistant → Diagnostics: requests diagnostics
- Integration setup → Integration constants: uses settings