🌐 English | Français | Português | Deutsch | Español
Integration to integrate with MyLight Systems.
Warning
This integration currently only supports the MyHome customer area. The MyLight150 customer area is not yet supported.
This integration will set up the following platforms.
| Entity ID | Description | Unit | State Class |
|---|---|---|---|
sensor.total_solar_production |
Cumulative energy produced by solar panels | Wh | total_increasing |
sensor.total_grid_consumption |
Grid energy drawn (accounting for virtual battery) | Wh | total_increasing |
sensor.total_grid_without_battery_consumption |
Grid energy drawn (excluding virtual battery) | Wh | total_increasing |
sensor.total_autonomy_rate |
% of consumption covered by solar + battery | % | measurement |
sensor.total_self_conso |
% of solar production consumed locally | % | measurement |
sensor.total_msb_charge |
Cumulative energy charged into the Smart Battery | Wh | total_increasing |
sensor.total_msb_discharge |
Cumulative energy discharged from the Smart Battery | Wh | total_increasing |
sensor.total_green_energy |
Solar energy consumed directly by your home | Wh | total_increasing |
sensor.battery_state |
Current energy stored in the Smart Battery | kWh | measurement |
sensor.grid_returned_energy |
Solar energy exported back to the grid | Wh | total_increasing |
| Entity ID | Description | Notes |
|---|---|---|
switch.master_relay |
Controls the master relay on your installation | Only available when a relay device is paired |
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. 3In thecustom_componentsdirectory (folder) create a new folder calledmylight_systems. - Download all the files from the
custom_components/mylight_systems/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "MyLight Systems"
See ARCHITECTURE.md for the full component diagram and data flow.
The switch.master_relay entity is only created when a relay device (sw type) is paired to your installation. If you do not have a relay, this entity will not appear.
The coordinator polls the API every 15 minutes. If values stop updating:
- Open Settings → Devices & Services → MyLight Systems and check for an error banner.
- Enable debug logging and check the Home Assistant logs:
# configuration.yaml
logger:
default: warning
logs:
custom_components.mylight_systems: debug- Look for
CommunicationErrororUpdateFailedentries — these indicate a network issue or an API change.
If you change your MyLight password externally, the integration will show an authentication error. Go to Settings → Devices & Services → MyLight Systems and use the Re-authenticate option to enter your new credentials.
If you want to contribute to this please read the Contribution guidelines