Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
27 lines (23 loc) · 1023 Bytes

ARCHITECTURE.md

File metadata and controls

27 lines (23 loc) · 1023 Bytes

Architecture

The integration follows the standard Home Assistant coordinator pattern:

flowchart TD
    CF["Config Flow\nconfig_flow.py\n(credentials + device discovery)"]
    INIT["Entry Setup\n__init__.py\n(async_setup_entry)"]
    COORD["Coordinator\ncoordinator.py\n(polls every 15 min)"]
    CLIENT["API Client\napi/client.py\n(aiohttp)"]
    API["MyLight Systems\nCloud API"]
    SENSOR["Sensor Entities\nsensor.py\n(10 sensors)"]
    SWITCH["Switch Entity\nswitch.py\n(master relay)"]

    CF -->|"creates"| INIT
    INIT -->|"creates"| COORD
    INIT -->|"creates"| CLIENT
    COORD -->|"uses"| CLIENT
    CLIENT -->|"HTTPS"| API
    COORD -->|"pushes data"| SENSOR
    COORD -->|"pushes data"| SWITCH
Loading

Data flow per update cycle:

  1. Coordinator calls async_get_measures_grouping (daily energy values) and async_get_measures_total (rates) sequentially
  2. Optionally fetches battery state and relay state if devices are paired
  3. Aggregated data is pushed to all sensor and switch entities