Releases: acesyde/hassio_mylight_integration
v0.9.0
🇬🇧 Release Notes — v0.9.0
New: Subscribed Power Sensor
A new sensor Subscribed Power is now available in the MyLight Systems device, showing your contracted electrical power in kVA:
- At a glance — see your subscription level (e.g. 9 kVA) directly in your energy dashboard
- Conditional creation — the sensor only appears if your MyLight account exposes this information; nothing breaks if it is absent
- Static value — the value reflects your current contract and is refreshed whenever you use the Reconfigure flow (no unnecessary API calls)
- Fully translated — available in English, French, German, Spanish, and Portuguese
Existing installations: the sensor won't appear automatically. Go to Settings → Devices & Services → MyLight Systems → Reconfigure, enter your password and confirm. The integration will reload and the new sensor will appear.
🇫🇷 Notes de version — v0.9.0
Nouveau : Capteur Puissance souscrite
Un nouveau capteur Puissance souscrite est désormais disponible dans l'appareil MyLight Systems, affichant votre puissance électrique contractuelle en kVA :
- Visible d'un coup d'œil — consultez votre niveau de souscription (ex. 9 kVA) directement depuis votre tableau de bord énergie
- Création conditionnelle — le capteur n'apparaît que si votre compte MyLight expose cette information ; rien ne se casse si elle est absente
- Valeur statique — la valeur reflète votre contrat en cours et est rafraîchie lors du flux Reconfigurer (aucun appel API inutile)
- Entièrement traduit — disponible en anglais, français, allemand, espagnol et portugais
Installations existantes : le capteur n'apparaîtra pas automatiquement. Rendez-vous dans Paramètres → Appareils et services → MyLight Systems → Reconfigurer, saisissez votre mot de passe et confirmez. L'intégration se rechargera et le nouveau capteur apparaîtra.
v0.8.0
🇬🇧 Release Notes — v0.8.0
New: CSV Export Service
A new service action export_measures_csv lets you export your daily energy measures to a CSV file directly from Home Assistant:
- Easy to trigger — call the service with a
from_dateandto_date(YYYY-MM-DD) from the Developer Tools or an automation - Ready to download — the file is written to
/config/www/mylight_systems/and the local URL is returned in the service response (pathkey), so you can link to it directly in a dashboard card - Dynamic columns — the CSV columns are automatically built from the measure types returned by the API (e.g.
produced_energy (Wh),grid_energy (Wh)) - Maximum 31-day range — to keep exports fast and lightweight, the gap between
from_dateandto_datecannot exceed 31 days
🇫🇷 Notes de version — v0.8.0
Nouveau : Service d'export CSV
Une nouvelle action de service export_measures_csv permet d'exporter vos mesures d'énergie quotidiennes dans un fichier CSV directement depuis Home Assistant :
- Facile à déclencher — appelez le service avec une
from_dateet uneto_date(format YYYY-MM-DD) depuis les Outils développeur ou une automatisation - Prêt à télécharger — le fichier est écrit dans
/config/www/mylight_systems/et l'URL locale est retournée dans la réponse du service (clépath), afin de pouvoir y créer un lien directement depuis une carte du tableau de bord - Colonnes dynamiques — les colonnes du CSV sont construites automatiquement à partir des types de mesures renvoyés par l'API (ex.
produced_energy (Wh),grid_energy (Wh)) - Maximum 31 jours — pour garder les exports rapides et légers, l'écart entre
from_dateetto_datene peut pas dépasser 31 jours
v0.8.0-beta.1
🇬🇧 Release Notes — v0.8.0-beta.1
New: CSV Export Service
A new service action export_measures_csv lets you export your daily energy measures to a CSV file directly from Home Assistant:
- Easy to trigger — call the service with a
from_dateandto_date(YYYY-MM-DD) from the Developer Tools or an automation - Ready to download — the file is written to
/config/www/mylight_systems/and the local URL is returned in the service response (pathkey), so you can link to it directly in a dashboard card - Dynamic columns — the CSV columns are automatically built from the measure types returned by the API (e.g.
produced_energy (Wh),grid_energy (Wh)) - Maximum 31-day range — to keep exports fast and lightweight, the gap between
from_dateandto_datecannot exceed 31 days
Note
This is a pre-release. Please test and report any issues before the final v0.8.0 release.
🇫🇷 Notes de version — v0.8.0-beta.1
Nouveau : Service d'export CSV
Une nouvelle action de service export_measures_csv permet d'exporter vos mesures d'énergie quotidiennes dans un fichier CSV directement depuis Home Assistant :
- Facile à déclencher — appelez le service avec une
from_dateet uneto_date(format YYYY-MM-DD) depuis les Outils développeur ou une automatisation - Prêt à télécharger — le fichier est écrit dans
/config/www/mylight_systems/et l'URL locale est retournée dans la réponse du service (clépath), afin de pouvoir y créer un lien directement depuis une carte du tableau de bord - Colonnes dynamiques — les colonnes du CSV sont construites automatiquement à partir des types de mesures renvoyés par l'API (ex.
produced_energy (Wh),grid_energy (Wh)) - Maximum 31 jours — pour garder les exports rapides et légers, l'écart entre
from_dateetto_datene peut pas dépasser 31 jours
Note
Il s'agit d'une pré-version. Merci de tester et de signaler tout problème avant la version finale v0.8.0.
v0.7.0
🇬🇧 Release Notes — v0.7.0
Improved: Diagnostics
The diagnostics download has been completely reworked to make troubleshooting easier and more reliable:
- Full API data included — diagnostics now capture the complete raw responses from 6 API endpoints (profile, devices, measures, states, rooms), giving a much clearer picture when investigating issues
- Better privacy — personal information (name, date of birth, address, phone number…) is now properly redacted without accidentally hiding useful device or room names
- Device IDs shortened — MAC addresses and device identifiers are truncated so they remain recognisable but not fully exposed
Tip
If you report a bug, attaching the diagnostics file will help us investigate much faster.
🇫🇷 Notes de version — v0.7.0
Amélioration : Diagnostics
Le téléchargement des diagnostics a été entièrement retravaillé pour faciliter le dépannage :
- Données API complètes — les diagnostics capturent désormais les réponses brutes de 6 endpoints API (profil, appareils, mesures, états, pièces), offrant une vision bien plus claire lors de l'investigation de problèmes
- Meilleure confidentialité — les informations personnelles (nom, date de naissance, adresse, téléphone…) sont correctement masquées sans cacher accidentellement les noms d'appareils ou de pièces
- Identifiants raccourcis — les adresses MAC et identifiants d'appareils sont tronqués pour rester reconnaissables sans être entièrement exposés
Tip
Si vous signalez un bug, joindre le fichier de diagnostics nous aidera à investiguer beaucoup plus rapidement.
v0.7.0-beta.1
🇬🇧 Release Notes — v0.7.0-beta.1
Improved: Diagnostics
The diagnostics download has been completely reworked to make troubleshooting easier and more reliable:
- Full API data included — diagnostics now capture the complete raw responses from 6 API endpoints (profile, devices, measures, states, rooms), giving a much clearer picture when investigating issues
- Better privacy — personal information (name, date of birth, address, phone number…) is now properly redacted without accidentally hiding useful device or room names
- Device IDs shortened — MAC addresses and device identifiers are truncated so they remain recognisable but not fully exposed
Tip
If you report a bug, attaching the diagnostics file will help us investigate much faster.
🇫🇷 Notes de version — v0.7.0-beta.1
Amélioration : Diagnostics
Le téléchargement des diagnostics a été entièrement retravaillé pour faciliter le dépannage :
- Données API complètes — les diagnostics capturent désormais les réponses brutes de 6 endpoints API (profil, appareils, mesures, états, pièces), offrant une vision bien plus claire lors de l'investigation de problèmes
- Meilleure confidentialité — les informations personnelles (nom, date de naissance, adresse, téléphone…) sont correctement masquées sans cacher accidentellement les noms d'appareils ou de pièces
- Identifiants raccourcis — les adresses MAC et identifiants d'appareils sont tronqués pour rester reconnaissables sans être entièrement exposés
Tip
Si vous signalez un bug, joindre le fichier de diagnostics nous aidera à investiguer beaucoup plus rapidement.
v0.6.0
🇬🇧 Release Notes — v0.6.0
New: Proper Entity Naming & Translations
Entity names are now handled through Home Assistant's native translation system. Sensors and switches use has_entity_name and a translation_key, which means their labels are properly localised and follow HA naming conventions.
Supported languages: English, French, Portuguese, German, and Spanish.
Note
Existing entity IDs are unchanged. The new naming only applies to newly added sensors or fresh integrations.
New: Richer Diagnostics
The diagnostics download now includes the full raw data returned by the two measure endpoints:
measures_grouping— all measures for today from the grouping endpoint (type / value / unit)measures_total— all measures from the total endpoint (type / value / unit)
If the API is unreachable when the diagnostic is requested, these sections appear as null so the download always succeeds.
What Improved
- Cleaner sensor names — the word "total" has been removed from sensor names where it was redundant or misleading
- New translations — entity names are now also available in German 🇩🇪 and Spanish 🇪🇸
- Stabler auth sessions — the authentication token is now guarded more carefully, reducing the risk of unexpected disconnections
- Better type safety — internal improvements to how API responses are handled, making the integration more robust
🇫🇷 Notes de version — v0.6.0
Nouveau : Nommage des entités et traductions
Les noms des entités passent désormais par le système de traduction natif de Home Assistant. Les capteurs et interrupteurs utilisent has_entity_name et une translation_key, ce qui signifie que leurs libellés sont correctement localisés et respectent les conventions de nommage de HA.
Langues disponibles : anglais, français, portugais, allemand et espagnol.
Note
Les identifiants des entités existantes restent inchangés. Le nouveau nommage s'applique uniquement aux nouveaux capteurs ou aux nouvelles installations.
Nouveau : Diagnostics enrichis
Le téléchargement des diagnostics inclut désormais les données brutes retournées par les deux endpoints de mesures :
measures_grouping— toutes les mesures du jour issues de l'endpoint de regroupement (type / valeur / unité)measures_total— toutes les mesures issues de l'endpoint total (type / valeur / unité)
Si l'API est inaccessible au moment de la demande, ces sections apparaissent en null afin que le téléchargement aboutisse toujours.
Ce qui a été amélioré
- Noms de capteurs plus clairs — le mot « total » a été retiré des noms de capteurs où il était redondant ou trompeur
- Nouvelles traductions — les noms des entités sont désormais disponibles en allemand 🇩🇪 et en espagnol 🇪🇸
- Sessions d'authentification plus stables — le jeton d'authentification est désormais mieux protégé, réduisant le risque de déconnexions inopinées
- Meilleure sûreté des types — améliorations internes dans la gestion des réponses API, rendant l'intégration plus robuste
v0.6.0-beta.2
🇬🇧 Release Notes — v0.6.0-beta.2
⚠️ This is a pre-release beta. It may contain rough edges — please report any issues you encounter.
New: Proper Entity Naming & Translations
Entity names are now handled through Home Assistant's native translation system. Sensors and switches use has_entity_name and a translation_key, which means their labels are properly localised and follow HA naming conventions.
Supported languages: English, French, Portuguese, German, and Spanish.
Note
Existing entity IDs are unchanged. The new naming only applies to newly added sensors or fresh integrations.
New: Richer Diagnostics
The diagnostics download now includes the full raw data returned by the two measure endpoints:
measures_grouping— all measures for today from the grouping endpoint (type / value / unit)measures_total— all measures from the total endpoint (type / value / unit)
If the API is unreachable when the diagnostic is requested, these sections appear as null so the download always succeeds.
What Improved
- Cleaner sensor names — the word "total" has been removed from sensor names where it was redundant or misleading
- New translations — entity names are now also available in German 🇩🇪 and Spanish 🇪🇸
- Stabler auth sessions — the authentication token is now guarded more carefully, reducing the risk of unexpected disconnections
- Better type safety — internal improvements to how API responses are handled, making the integration more robust
🇫🇷 Notes de version — v0.6.0-beta.2
⚠️ Il s'agit d'une version bêta. Elle peut contenir des imperfections — n'hésitez pas à signaler tout problème rencontré.
Nouveau : Nommage des entités et traductions
Les noms des entités passent désormais par le système de traduction natif de Home Assistant. Les capteurs et interrupteurs utilisent has_entity_name et une translation_key, ce qui signifie que leurs libellés sont correctement localisés et respectent les conventions de nommage de HA.
Langues disponibles : anglais, français, portugais, allemand et espagnol.
Note
Les identifiants des entités existantes restent inchangés. Le nouveau nommage s'applique uniquement aux nouveaux capteurs ou aux nouvelles installations.
Nouveau : Diagnostics enrichis
Le téléchargement des diagnostics inclut désormais les données brutes retournées par les deux endpoints de mesures :
measures_grouping— toutes les mesures du jour issues de l'endpoint de regroupement (type / valeur / unité)measures_total— toutes les mesures issues de l'endpoint total (type / valeur / unité)
Si l'API est inaccessible au moment de la demande, ces sections apparaissent en null afin que le téléchargement aboutisse toujours.
Ce qui a été amélioré
- Noms de capteurs plus clairs — le mot « total » a été retiré des noms de capteurs où il était redondant ou trompeur
- Nouvelles traductions — les noms des entités sont désormais disponibles en allemand 🇩🇪 et en espagnol 🇪🇸
- Sessions d'authentification plus stables — le jeton d'authentification est désormais mieux protégé, réduisant le risque de déconnexions inopinées
- Meilleure sûreté des types — améliorations internes dans la gestion des réponses API, rendant l'intégration plus robuste
v0.6.0-beta.1
🇬🇧 Release Notes — v0.6.0-beta.1
⚠️ This is a pre-release beta. It may contain rough edges — please report any issues you encounter.
New: Proper Entity Naming & Translations
Entity names are now handled through Home Assistant's native translation system. Sensors and switches use has_entity_name and a translation_key, which means their labels are properly localised and follow HA naming conventions.
Supported languages: English, French, Portuguese, German, and Spanish.
Note
Existing entity IDs are unchanged. The new naming only applies to newly added sensors or fresh integrations.
What Improved
- Cleaner sensor names — the word "total" has been removed from sensor names where it was redundant or misleading
- New translations — entity names are now also available in German 🇩🇪 and Spanish 🇪🇸
- Stabler auth sessions — the authentication token is now guarded more carefully, reducing the risk of unexpected disconnections
- Better type safety — internal improvements to how API responses are handled, making the integration more robust
🇫🇷 Notes de version — v0.6.0-beta.1
⚠️ Il s'agit d'une version bêta. Elle peut contenir des imperfections — n'hésitez pas à signaler tout problème rencontré.
Nouveau : Nommage des entités et traductions
Les noms des entités passent désormais par le système de traduction natif de Home Assistant. Les capteurs et interrupteurs utilisent has_entity_name et une translation_key, ce qui signifie que leurs libellés sont correctement localisés et respectent les conventions de nommage de HA.
Langues disponibles : anglais, français, portugais, allemand et espagnol.
Note
Les identifiants des entités existantes restent inchangés. Le nouveau nommage s'applique uniquement aux nouveaux capteurs ou aux nouvelles installations.
Ce qui a été amélioré
- Noms de capteurs plus clairs — le mot « total » a été retiré des noms de capteurs où il était redondant ou trompeur
- Nouvelles traductions — les noms des entités sont désormais disponibles en allemand 🇩🇪 et en espagnol 🇪🇸
- Sessions d'authentification plus stables — le jeton d'authentification est désormais mieux protégé, réduisant le risque de déconnexions inopinées
- Meilleure sûreté des types — améliorations internes dans la gestion des réponses API, rendant l'intégration plus robuste
v0.5.0
🇬🇧 Release Notes — v0.5.0
New: Water Heater Energy Tracking
If your installation includes a water heater, you can now monitor its energy consumption directly in Home Assistant. The sensor is disabled by default — users without a water heater are unaffected. To enable it, go to Settings → Devices → MyLight → your water heater entity and toggle it on.
What Improved
- Faster updates — sensor values now refresh up to 4× faster, especially noticeable on slower connections
- Stabler sessions — your connection to the MyLight API is renewed a little before it expires, avoiding brief "unavailable" gaps during the day
- Grid energy without a battery — users who don't have a MySmartBattery were seeing no value for the grid return sensor; this is now fixed
- Options flow fixed — changing the scan interval from the integration settings no longer causes an error requiring a restart
🇫🇷 Notes de version — v0.5.0
Nouveau : suivi de l'énergie du chauffe-eau
Si votre installation dispose d'un chauffe-eau, vous pouvez désormais suivre sa consommation directement dans Home Assistant. Le capteur est désactivé par défaut — les utilisateurs sans chauffe-eau ne sont pas impactés. Pour l'activer, rendez-vous dans Paramètres → Appareils → MyLight → entité chauffe-eau et activez-la.
Ce qui a été amélioré
- Mises à jour plus rapides — les valeurs des capteurs se rafraîchissent jusqu'à 4× plus vite, particulièrement notable sur les connexions lentes
- Sessions plus stables — la connexion à l'API MyLight est renouvelée un peu avant son expiration, évitant les brèves périodes « indisponible » dans la journée
- Énergie réseau sans batterie — les utilisateurs sans MySmartBattery ne voyaient aucune valeur pour le capteur de retour réseau ; c'est maintenant corrigé
- Flux d'options corrigé — modifier l'intervalle d'actualisation depuis les paramètres de l'intégration ne provoque plus d'erreur nécessitant un redémarrage
v0.5.0-beta.1
🇬🇧 Release Notes — v0.5.0-beta.1
New: Water Heater Energy Tracking
If your installation includes a water heater, you can now monitor its energy consumption directly in Home Assistant. The sensor is disabled by default — users without a water heater are unaffected. To enable it, go to Settings → Devices → MyLight → your water heater entity and toggle it on.
What Improved
- Faster updates — sensor values now refresh up to 4× faster, especially noticeable on slower connections
- Stabler sessions — your connection to the MyLight API is renewed a little before it expires, avoiding brief "unavailable" gaps during the day
- Grid energy without a battery — users who don't have a MySmartBattery were seeing no value for the grid return sensor; this is now fixed
- Options flow fixed — changing the scan interval from the integration settings no longer causes an error requiring a restart
⚠️ This is a beta release. Core functionality is stable, but feedback is welcome before the final v0.5.0.
🇫🇷 Notes de version — v0.5.0-beta.1
Nouveau : suivi de l'énergie du chauffe-eau
Si votre installation dispose d'un chauffe-eau, vous pouvez désormais suivre sa consommation directement dans Home Assistant. Le capteur est désactivé par défaut — les utilisateurs sans chauffe-eau ne sont pas impactés. Pour l'activer, rendez-vous dans Paramètres → Appareils → MyLight → entité chauffe-eau et activez-la.
Ce qui a été amélioré
- Mises à jour plus rapides — les valeurs des capteurs se rafraîchissent jusqu'à 4× plus vite, particulièrement notable sur les connexions lentes
- Sessions plus stables — la connexion à l'API MyLight est renouvelée un peu avant son expiration, évitant les brèves périodes « indisponible » dans la journée
- Énergie réseau sans batterie — les utilisateurs sans MySmartBattery ne voyaient aucune valeur pour le capteur de retour réseau ; c'est maintenant corrigé
- Flux d'options corrigé — modifier l'intervalle d'actualisation depuis les paramètres de l'intégration ne provoque plus d'erreur nécessitant un redémarrage
⚠️ Il s'agit d'une version bêta. Les fonctionnalités principales sont stables, mais vos retours sont les bienvenus avant la version finale v0.5.0.