Intégration domotique Blue Current, gratuite et open source
Bornes Blue Current (NL, BE) par l'API officielle : état, puissance, énergie ; commandes en option.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=4.86.0
- ★ 0
Affiche vos bornes Blue Current (Pays-Bas, Belgique) dans Gladys, en temps réel, par l'API officielle que Blue Current propose pour la domotique (celle de son intégration Home Assistant).
Jamais testée avec un vrai compte : cette intégration a été écrite à partir de la bibliothèque que Blue Current publie pour Home Assistant, et testée seulement sur des réponses simulées. Sans lien avec Blue Current.
Ce que vous obtenez
Un appareil Gladys par borne, avec :
- État : disponible, en charge, bloquée, erreur, hors ligne ;
- Connecteur et état de charge (les fonctionnalités « borne de recharge » de Gladys) ;
- Véhicule : aucun véhicule, véhicule branché, prêt à charger, erreur ;
- Puissance (W), courant et tension par phase (L1, L2, L3) ;
- Énergie de la session (kWh), durée de la session (minutes), coût de la session (€, quand Blue Current le donne : il documente cette valeur comme désactivée pour l'instant), courant maximal (A).
Et, seulement si vous les autorisez (voir plus bas) :
- Démarrer une session et Arrêter la session (boutons) ;
- Disponibilité (une liste : disponible / bloquée), pour bloquer ou débloquer la borne ;
- Redémarrer la borne (un bouton), derrière son option à part.
Les commandes sont des boutons et une liste, jamais des interrupteurs : un « éteins tout » d'un assistant vocal ou d'une scène ne peut pas les atteindre.
Créer le jeton d'API
- Connectez-vous au portail conducteur de Blue Current, my.bluecurrent.nl, avec le compte de votre borne.
- Ouvrez les paramètres, puis Avancé (« Advanced »), et créez le jeton d'API Home Assistant (« Home Assistant API token »). (L'application Blue Current le propose peut-être aussi ; non vérifié.)
- Copiez le jeton.
Configuration
- Dans Gladys, ouvrez l'intégration, collez le jeton dans Jeton d'API Blue Current, enregistrez. Le jeton est gardé par Gladys dans sa base, jamais réaffiché, et envoyé seulement à Blue Current.
- Le statut indique combien de bornes Blue Current liste. Ouvrez l'onglet Découverte et ajoutez-les.
- Pour utiliser les commandes, activez Autoriser les commandes (démarrer, arrêter, bloquer, débloquer) et, à part, Autoriser le redémarrage de la borne. Les deux sont désactivées par défaut.
Bon à savoir
- Une seule connexion : Blue Current envoie les changements, rien n'est interrogé en boucle. Une connexion perdue revient seule, après quelques secondes puis de plus en plus espacé (jusqu'à 10 minutes).
- Limite quotidienne de requêtes : Blue Current limite les requêtes par jour. Une fois atteinte, l'intégration attend minuit (heure d'Amsterdam) avant de se reconnecter, même après un redémarrage.
- « Déjà ouverte ailleurs » : Blue Current peut refuser une deuxième connexion (un autre Gladys, un Home Assistant sur le même compte). L'intégration attend alors au moins deux minutes entre deux essais.
- « Ralentissez » (HTTP 429) : l'intégration attend le temps que Blue Current demande (entre 1 minute et 6 heures, 15 minutes s'il ne dit rien), même après un redémarrage.
- Jeton refusé : quand Blue Current refuse le jeton, ou refuse la connexion moins de 30 minutes après l'avoir accepté, l'intégration s'arrête et réessaie au bout de 6 heures, puis toutes les 24 heures. Enregistrez un nouveau jeton, ou cliquez sur Tester la connexion, pour réessayer tout de suite.
- Comment l'intégration se présente : l'API Blue Current demande à
chaque client son type dans son premier message (
HELLO). L'intégration envoiehomeassistant, la seule valeur que Blue Current documente (celle de la bibliothèque qu'il publie pour Home Assistant), et n'en essaie jamais d'autre ; son propre nom,gladys-blue-currentet sa version, figure dans le User-Agent de la connexion. - Commandes : avant chacune, l'état de la borne est relu ; la commande est refusée s'il ne peut pas être lu ou si la borne est hors ligne. Rien n'est envoyé s'il n'y a rien à faire (démarrer pendant une charge, arrêter sans véhicule, bloquer une borne déjà bloquée) : Gladys affiche alors un succès. Une session n'est démarrée qu'avec un véhicule branché (sinon « branchez d'abord le véhicule »), avec la carte de recharge par défaut de la borne, telle que Blue Current la donne. Une commande à la fois, sauf Arrêter la session, qui n'attend jamais. Gladys attend 5 secondes : si Blue Current n'a pas confirmé d'ici là, Gladys affiche « Commande envoyée, sans confirmation » (ou « envoyée et reçue, sans résultat de la borne ») : la commande a pu être exécutée, l'état suivra.
- Redémarrage : la borne redémarre et une session en cours est coupée.
- La puissance est la somme, sur les phases, de la tension par le courant (l'intégration Home Assistant affiche une estimation un peu différente).
- Pas encore géré : charge intelligente, « plug and charge », cartes liées seulement, choix de la carte de recharge, état du réseau (charge du bâtiment).
Confidentialité
L'intégration ne parle qu'à Blue Current (wss://motown.bluecurrent.nl).
Elle n'écrit jamais le jeton dans les journaux. Dans /data, elle garde
seulement la fin d'une pause pour limite de requêtes et, après un refus, une
empreinte du jeton refusé avec l'heure du prochain essai.
Paramètres de configuration
Voici les paramètres demandés par Blue Current dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Blue Current | section | Non | Affiche vos bornes Blue Current dans Gladys par l'API officielle de Blue Current (celle de Home Assistant), en temps réel : état, véhicule, puissance, courant et tension par phase, énergie, durée et coût de la session. Créez un jeton d'API sur my.bluecurrent.nl (Avancé, jeton d'API Home Assistant), collez-le ci-dessous, enregistrez, puis ajoutez les bornes depuis l'onglet Découverte. Démarrer, arrêter, bloquer et redémarrer depuis Gladys demandent les options ci-dessous, désactivées par défaut. Jamais testé avec un vrai compte. Sans lien avec Blue Current. |
| Jeton d'API Blue Current | secret | Oui | Créé sur my.bluecurrent.nl, Avancé, jeton d'API Home Assistant. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Blue Current. |
| Autoriser les commandes | boolean | Non | Désactivé par défaut. Activé : Gladys peut démarrer une session (avec la carte de recharge par défaut de la borne), l'arrêter, et bloquer ou débloquer la borne. Désactivé : ces fonctionnalités refusent toute commande. |
| Autoriser le redémarrage de la borne | boolean | Non | Désactivé par défaut. Action lourde : la borne redémarre et une session en cours est coupée. Activé : le bouton Redémarrer de chaque borne fonctionne. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des appareils ajoutés désormais, aux textes d'état et aux erreurs des commandes. |
Comment installer Blue Current dans Gladys
- Dans Gladys, ouvrez Intégrations : Blue Current 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-blue-current: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-blue-current.
Blue Current nécessite Gladys >=4.86.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
Blue Current 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