1. Préparation
Vérifiez d'abord les exigences en matière de réseau et d'accès. L'intégration utilise la détection locale et la communication de données locale.
Même réseau local
Home Assistant et la batterie domestique plug-in Lunergy doivent être sur le même sous-réseau. Le réseau ne doit pas bloquer la diffusion mDNS/UDP.
Accès à /config
Utilisez par exemple Samba share, File Editor, Studio Code Server ou un terminal SSH pour placer des fichiers dans le répertoire de configuration de Home Assistant.
2. Téléchargement et placement des fichiers
Téléchargez le pack d'installation actuel, vérifiez la structure du pack, puis placez les dossiers appropriés dans Home Assistant.
Extraire le ZIP vers /config
Extrayez Lunergy_HA.zip directement dans /config. Après extraction, ces deux dossiers doivent exister :
Vous pouvez également copier manuellement les deux dossiers vers les mêmes emplacements ; le résultat est identique.
Vérifier les fichiers importants
Après la copie, vérifiez que ces fichiers sont présents :
/config/custom_components/ha_ems/manifest.json /config/custom_components/ha_ems/local_mdns.py /config/www/ha_ems/ha-ems-local-devices-card.js /config/www/ha_ems/ha_ems.yaml3. Activation du tableau de bord et redémarrage
Activer le tableau de bord dans configuration.yaml
Ouvrez /config/configuration.yaml et ajoutez cette configuration de tableau de bord YAML autonome :
Vous pouvez ignorer cette étape pour l'instant et l'ajouter plus tard. Si vous ajoutez cette configuration ultérieurement, redémarrez à nouveau Home Assistant.
Redémarrer Home Assistant une fois
Allez dans Paramètres → Système → Contrôle du serveur et cliquez sur Redémarrer Home Assistant. C'est normalement le seul redémarrage requis pendant l'installation.
Après le redémarrage, les fichiers d'intégration sont chargés. Si vous avez activé le tableau de bord, HA EMS apparaît dans la barre latérale. Il est normal qu'aucune donnée ne soit encore visible tant que l'intégration n'est pas ajoutée.
4. Ajout de l'intégration
Ajouter HA EMS
Allez dans Paramètres → Appareils et services → Ajouter une intégration. Recherchez HA EMS et confirmez la configuration.
Le processus de configuration crée immédiatement une entrée de configuration locale. Vous n'avez pas besoin de saisir de compte ou de mot de passe.
Après l'ajout, la détection de la batterie et les données du tableau de bord démarrent automatiquement. Aucun redémarrage supplémentaire n'est nécessaire.
5. Ressource frontend et vérification
Vérifier la ressource frontend
Après le chargement, l'intégration enregistre automatiquement la ressource frontend locale. Si la page indique que la carte personnalisée n'est pas trouvée, ajoutez manuellement cette ressource via Paramètres → Tableaux de bord → Ressources :
URL: /local/ha_ems/ha-ems-local-devices-card.js?v=0.6.2 Type: JavaScript ModuleN'ajoutez la même ressource qu'une seule fois. Après avoir mis à jour les fichiers de carte, vous pouvez utiliser Ctrl+F5 dans le navigateur pour rafraîchir le cache.
Vérifier l'installation
Ouvrez Outils de développement → États et recherchez ces entités :
sensor.ha_ems_mode sensor.ha_ems_local_devices sensor.ha_ems_local_device_issuesDans les attributs de sensor.ha_ems_local_devices, devices doit afficher les batteries trouvées. Pour chaque batterie supportée, une entité sensor.ha_ems_<device>_energy_parameters dédiée est créée.
Si vous voyez un message dans le tableau de bord indiquant qu'il attend des données EnergyParameter, vérifiez d'abord la connexion de la batterie et le port, puis consultez les journaux de Home Assistant.
6. Foire aux questions
Vérifications rapides pour les notifications d'installation les plus courantes.
| Situation | Vérification ou solution |
|---|---|
| HA EMS est introuvable dans les intégrations. | Vérifiez que /config/custom_components/ha_ems/manifest.json existe et redémarrez Home Assistant. |
| Aucune batterie trouvée. | Vérifiez que Home Assistant et la batterie domestique plug-in Lunergy sont sur le même sous-réseau et que la diffusion mDNS/UDP n'est pas bloquée. |
| La batterie est connectée, mais le flux d'énergie est absent. | Le flux d'énergie nécessite une réponse EnergyParameter. Vérifiez protocol_status, protocol_error et les journaux. |
| NoM ou AI dans l'application Lunergy ne fonctionne pas après l'utilisation de Home Assistant. | Home Assistant peut entrer en conflit avec la stratégie de régulation de l'application Lunergy. Déconnectez d'abord la connexion Home Assistant, puis réactivez AI ou NoM via l'application Lunergy. |
| La page indique que la carte personnalisée est manquante. | Vérifiez que le fichier JS est dans /config/www/ha_ems/, utilisez JavaScript Module comme type et rafraîchissez avec Ctrl+F5. |
Les entités indiquent non disponible. |
Consultez la première erreur Python dans les journaux de Home Assistant, résolvez cette erreur, puis redémarrez l'intégration. |
7. Désinstallation
Supprimer l'entrée de configuration
Supprimez l'entrée de configuration HA EMS via Paramètres → Appareils et services. Cela arrête le scan local et la connexion TCP.
Supprimer les dossiers
Supprimez ces deux dossiers de /config :
Redémarrez ensuite Home Assistant pour finaliser la suppression.
8. Projet communautaire : intégration TCP locale
Outre le pack d'intégration officiel HA-EMS, un projet communautaire externe est également disponible pour les utilisateurs souhaitant connecter leur batterie localement via TCP.