Intégration domotique Solakon ONE, gratuite et open source
Batterie de balcon Solakon ONE en Modbus TCP local : solaire, batterie, sortie, énergie, pilotage.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration affiche une batterie de balcon Solakon ONE dans Gladys, lue sur votre réseau local par Modbus TCP (port 502), sans cloud. Elle peut aussi la piloter, seulement si vous l’autorisez.
Jamais testé avec un vrai appareil. Construit à partir de la table des registres que le fabricant publie dans sa propre intégration Home Assistant (solakon-one-homeassistant 1.7.0) et testé contre un appareil simulé. Non officiel, sans lien avec Solakon.
Avant de commencer
- Activez le Modbus TCP sur le Solakon ONE (application Solakon ou réglages de l’appareil) et donnez-lui une adresse IP fixe sur votre box.
- Le Modbus TCP n’a pas de mot de passe : tout appareil de votre réseau peut lire et piloter la batterie. Gardez-la sur un réseau de confiance (aucune redirection de port vers internet).
Configuration
| Champ | Rôle |
|---|---|
| Adresse IP | L’adresse du Solakon ONE, port 502 sauf si vous en ajoutez un (192.168.1.70:502). |
| Identifiant d’unité Modbus | En général 1. |
| Autoriser le pilotage | Désactivé par défaut : voir « Pilotage » plus bas. |
| Durée d’un mode forcé | 1 à 60 minutes (15 par défaut), écrite dans la minuterie de l’appareil avant chaque charge ou décharge forcée. |
| Intervalle de rafraîchissement | Secondes entre deux lectures (30 par défaut, 10 au moins). |
| Langue | Noms de l’appareil et des fonctionnalités ajoutés désormais, statut et erreurs. |
Enregistrez, puis ajoutez l’appareil depuis l’onglet Découverte. L’appareil est identifié par son numéro de série (relu à chaque lecture) : si un autre Solakon ONE répond un jour à cette adresse, il apparaît comme un autre appareil, et les commandes envoyées au premier sont refusées. Sans numéro de série lisible, rien n’est publié (le statut le dit).
Le bouton Tester la connexion lit l’appareil une fois, jamais avant l’intervalle de rafraîchissement depuis la dernière lecture (il affiche alors le dernier résultat).
Ce que vous obtenez
| Fonctionnalité | Catégorie Gladys | Remarque |
|---|---|---|
| Niveau de la batterie | stockage, % | |
| Puissance de charge / de décharge | stockage, W | toutes deux >= 0 (l’appareil donne une valeur signée : > 0 en décharge) |
| Puissance solaire | production, W | |
| Énergie solaire | production, index (kWh) | compteur à vie |
| Énergie chargée / déchargée | stockage, index (kWh) | compteurs à vie, côté batterie |
| Énergie fournie en AC | sortie vers la maison, index (kWh) | compteur à vie |
| Puissance AC à la prise | capteur d’énergie, W, signée | le fabricant ne documente pas son signe : affichée telle que l’appareil la donne |
| Tension AC, puissance de la sortie de secours, température de l’appareil | quand l’appareil les donne | |
| Mode de pilotage | liste | automatique, charge forcée, décharge forcée, autre (réglé par un autre outil) |
| Puissance de charge/décharge forcée (W) | nombre | la puissance d’un mode forcé |
| Temps restant du mode forcé | durée, minutes | la minuterie de l’appareil |
| État de charge minimum / maximum (%) | nombre | |
| Sortie de secours (EPS) | liste | désactivée, EPS, UPS |
Une valeur invraisemblable ou non lue reste inconnue, jamais publiée à 0 ni comme une ancienne valeur. Si les compteurs d’énergie ou les réglages ne répondent pas, les autres valeurs sont publiées quand même (le statut dit ce qui n’a pas été lu) ; après 3 échecs de suite, ce bloc est sauté pendant 10 lectures.
Compteurs d’énergie
Gladys compte chaque hausse d’un index comme de l’énergie. Les compteurs ne sont donc jamais publiés à 0 (un compteur qui ne compte pas), et une baisse (remise à zéro, appareil remplacé) ou un saut plus grand que ce que l’appareil peut faire est retenu : rien n’est publié pour ce compteur, le statut dit lequel et ses valeurs, quel que soit le temps écoulé. Si c’est réel, appuyez sur Accepter les compteurs retenus : un premier appui les liste, un second dans les 2 minutes accepte exactement les valeurs listées (un compteur qui a bougé entre-temps n’est pas accepté). Les autres compteurs continuent.
Pilotage
Désactivé par défaut. Avec Autoriser le pilotage, Gladys peut :
- forcer une charge ou une décharge (mode de pilotage). Avant le mode, il écrit toujours la minuterie de l’appareil (la durée de la configuration) : à son terme l’appareil revient seul en mode automatique, même si Gladys est arrêté. Recliquer le même mode forcé réécrit la minuterie. Une puissance forcée au-dessus de 800 W est ramenée à 800 W avant une décharge ;
- régler la puissance forcée (en watts entiers) : 800 W au plus quand une décharge est forcée ou peut l’être (autre mode distant réglé ailleurs, mode inconnu), 1200 W au plus sinon. Ce sont les limites du fabricant ; la puissance forcée est écrite dans les deux consignes de puissance de l’appareil, comme le fait l’intégration du fabricant ;
- régler les états de charge minimum et maximum, de 10 à 100 %, le minimum jamais au-dessus du maximum relu juste avant ;
- régler la sortie de secours (désactivée, EPS, UPS).
Chaque commande est vérifiée à son arrivée et de nouveau juste avant chaque écriture (l’option, la configuration, un retour en mode automatique cliqué entre-temps), décidée sur les valeurs relues juste avant sur l’appareil cliqué (son numéro de série), et confirmée seulement par une relecture montrant les valeurs demandées. Sinon Gladys répond « envoyée, sans confirmation » (vérifiez dans quelques secondes) ou « non envoyée ». Les commandes partent une à une, dans leur ordre ; une scène qui règle plusieurs valeurs les règle toutes.
Retour en mode automatique (l’arrêt)
Choisir Automatique dans le mode de pilotage arrête une charge ou une décharge forcée. Cela ne dépend pas de l’option, ni d’une lecture en cours (elle est interrompue), ni d’une commande en attente (l’arrêt passe devant ; les commandes cliquées avant lui et pas encore parties sont abandonnées), ni d’une lecture échouée, ni des bornes, ni d’une configuration que Gladys ne peut pas encore lire (il part alors vers l’appareil de la dernière lecture).
Il n’est refusé que si Gladys ne connaît aucune adresse (aucune dans la configuration, ou configuration illisible et aucun appareil jamais lu). Il peut échouer si l’appareil est injoignable : la connexion est réessayée pendant 3 s, puis Gladys répond « pas encore envoyé » et le garde.
Un arrêt pas encore vu appliqué est gardé (y compris après un redémarrage : il est réécrit au démarrage, avant toute autre chose) et vérifié toutes les 15 s : réécrit tant que l’appareil montre le mode forcé qu’il remplace, un mode inconnu ou rien. Il n’est abandonné que si l’appareil montre le mode automatique, si un autre mode forcé réglé ailleurs est lu deux fois de suite après l’écriture de l’arrêt (un choix plus récent est respecté ; un arrêt pas encore écrit n’est jamais abandonné ainsi : il est d’abord écrit, quel que soit le mode affiché), si vous cliquez un mode forcé dans Gladys (avec l’option), ou si un arrêt est cliqué pour une autre adresse (après un changement de configuration). Il ne s’arrête jamais avec le temps ; le statut indique qu’il est gardé. Pendant l’envoi d’un arrêt, un mode forcé cliqué dans Gladys est refusé.
Pas fait dans cette version
- La limite d’injection, les courants de la batterie, les alarmes et le détail des BMS que l’appareil donne aussi.
- L’énergie prise en AC (charge depuis la maison) : non publiée, la nature de ce compteur reste à confirmer.
- Un vrai appareil : le signe de la puissance AC, le décompte de la minuterie, et le fait que l’appareil garde la puissance forcée dans les deux consignes restent à confirmer.
Paramètres de configuration
Voici les paramètres demandés par Solakon ONE dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre Solakon ONE | section | Non | Affiche votre batterie de balcon Solakon ONE dans Gladys par Modbus TCP (port 502) sur votre réseau local, sans cloud : niveau de batterie, puissances de charge et de décharge, puissance solaire, puissance AC, sortie de secours, compteurs d’énergie, mode de pilotage. Activez le Modbus TCP sur l’appareil, saisissez son adresse IP, enregistrez, puis ajoutez-le depuis l’onglet Découverte. Charge ou décharge forcée, puissance forcée, bornes d’état de charge et sortie de secours ne changent que si vous autorisez le pilotage ci-dessous ; un mode forcé part toujours avec la minuterie de l’appareil (il revient seul en mode automatique), et Gladys n’écrit jamais plus de 800 W en décharge ni de 1200 W en charge. Le retour en mode automatique ne dépend jamais de cette option. Le Modbus TCP n’a pas de mot de passe : gardez l’appareil sur un réseau de confiance. Jamais testé avec un vrai appareil. Sans lien avec Solakon. |
| Adresse IP du Solakon ONE | string | Oui | Une adresse IPv4 ou un nom d’hôte (port 502 sauf si vous en ajoutez un, par exemple 192.168.1.70:502). |
| Identifiant d’unité Modbus | number | Non | L’identifiant d’appareil Modbus du Solakon ONE : en général 1. |
| Autoriser le pilotage | boolean | Non | Désactivé par défaut. Activé : Gladys peut forcer une charge ou une décharge, régler la puissance forcée (800 W en décharge, 1200 W en charge au plus), les états de charge minimum et maximum (10 à 100 %) et la sortie de secours. Désactivé : ces commandes sont refusées. Le retour en mode automatique ne dépend jamais de cette option. |
| Durée d’un mode forcé (min) | number | Non | Écrite dans la minuterie de l’appareil avant chaque charge ou décharge forcée, de 1 à 60 minutes (15 par défaut) : à son terme, l’appareil revient seul en mode automatique, même si Gladys n’est plus là. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture du Solakon ONE, en secondes. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms de l’appareil et des fonctionnalités ajoutés désormais, au statut et aux erreurs des commandes. |
Comment installer Solakon ONE dans Gladys
- Dans Gladys, ouvrez Intégrations : Solakon ONE apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-solakon:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-solakon.
Solakon ONE nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Solakon ONE est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation