Intégration domotique TechnoVE, gratuite et open source
Bornes TechnoVE par l'API locale : état, puissance, énergie, courant ; commandes en option.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Affiche votre borne de recharge TechnoVE (bornes québécoises i-Series, s-Series) dans Gladys, par son API locale : sans cloud, sans compte, directement sur votre réseau.
API non officielle, module jamais testé avec une vraie borne. Sans lien avec TechnoVE. Il parle à l'API locale de la borne comme la bibliothèque python-technove (utilisée par Home Assistant). TechnoVE peut la changer sans prévenir.
Ce que vous obtenez
Un appareil par borne avec :
| Fonctionnalité | Contenu |
|---|---|
| État | Débranchée, Branchée en attente, En charge, défauts, hors période d'activation, tarif élevé |
| Connecteur | Libre, occupé, en défaut ou indisponible (catégorie « borne de recharge » de Gladys) |
| État de charge | En charge, véhicule branché, en pause (charge non autorisée), inactif |
| Puissance (estimée) | En W : courant × tension de sortie (la borne ne donne pas la puissance) |
| Courant | En A |
| Tension d'entrée, de sortie | En V |
| Énergie de la session | En kWh, un simple capteur |
| Courant maximal | En A, le réglage actuel de la borne |
| Charge autorisée | Oui / non |
| Charge automatique | Oui / non (réglée dans l'application TechnoVE) |
| Partage de charge | Oui / non, et « conflit de partage de charge » : en lecture seule |
| Démarrer la charge | Bouton (commandes autorisées seulement) |
| Arrêter la charge | Bouton (commandes autorisées seulement) |
| Régler le courant maximal | Liste de 8 A au courant nominal de la borne (commandes autorisées seulement) |
Lecture toutes les 30 secondes par défaut (de 10 s à 10 min, réglable).
Énergie : l'énergie de la session est un simple capteur, jamais un index : elle n'entre pas dans l'onglet Énergie de Gladys (la borne est déjà comptée par votre compteur principal). Aucune consommation journalière n'est publiée.
Installation
- Donnez à la borne une adresse IP fixe dans votre box ou routeur.
- Installez l'intégration depuis le store de Gladys.
- Dans sa configuration, saisissez l'adresse IP de la borne (plusieurs bornes en partage de charge : séparées par des virgules, quatre au plus).
- Enregistrez, puis ajoutez la borne depuis l'onglet Découverte.
Le bouton Tester la connexion lit chaque borne une fois (au plus toutes les 10 secondes). L'API locale n'a pas de mot de passe : toute machine de votre réseau peut la lire, Gladys comprise.
Commandes (désactivées par défaut)
« Démarrer la charge », « Arrêter la charge » et « Régler le courant maximal » refusent toute commande tant que l'option Autoriser les commandes est désactivée. Activée :
- Démarrer autorise la charge (le véhicule charge dès qu'il le demande) ; refusé si la borne signale un défaut ou un état inconnu ;
- Arrêter interdit la charge ;
- Courant maximal : de 8 A au courant nominal que la borne annonce
(
maxStationCurrent), en ampères entiers.
Démarrer et arrêter sont refusés quand la charge automatique est activée (réglage de l'application TechnoVE) ; le courant maximal est refusé en partage de charge (c'est le partage qui le fixe).
Ce sont des boutons et une liste, jamais des interrupteurs : un « éteins tout » (depuis Gladys, Google Home, Alexa ou HomeKit) ne les touche pas. Une scène peut les déclencher, mais seulement par une action explicite, et seulement si les commandes sont autorisées. Attention : le chat IA de Gladys (MCP) peut créer et lancer une telle scène : tant que les commandes sont autorisées, il peut démarrer ou arrêter la charge.
Avant chaque commande, l'intégration relit la borne et décide sur cette lecture seule ; l'option est revérifiée juste avant l'envoi. Une commande inutile (déjà dans cet état) n'est pas envoyée. Une commande qui ne peut pas partir dans les 3,5 secondes est refusée sans être envoyée. Si la borne ne confirme pas (silence, erreur 5xx), Gladys affiche « Commande envoyée, sans confirmation » : vérifiez l'état, relu 5 puis 20 secondes plus tard. Une commande à la fois par borne : une autre est refusée tout de suite, sauf un arrêt, jamais bloqué : il attend la commande en cours au plus le temps de son échéance, puis part ; il est renvoyé une fois quand elle se termine, et un démarrage pas encore parti s'efface devant lui.
Erreurs et limites
- Borne injoignable : seuls le connecteur (« indisponible ») et l'état (« Borne injoignable ») changent ; la puissance, le courant, l'état de charge et les autres valeurs gardent leur dernière valeur (un « en charge » peut rester affiché : regardez l'état). Une borne retirée de la configuration, ou qui n'a jamais répondu depuis le démarrage, s'affiche de même sur son appareil, et l'écran de configuration la nomme. Nouvel essai après 30 s, 1, 2 puis 5 minutes, jamais plus vite que l'intervalle.
- 429 (trop de requêtes), peu probable sur une borne locale : pause de
1 minute à 6 heures pour tout (lectures, bouton, commandes), jamais plus
courte que l'intervalle de rafraîchissement, gardée dans
/dataaprès un redémarrage. - La puissance est estimée (courant × tension, facteur de puissance supposé 1) : la borne ne la donne pas.
- Ni la planification (heures creuses / tarif élevé), ni la charge automatique, ni le pourcentage de charge maximal ne se changent depuis Gladys.
- Les journaux ne contiennent jamais le texte des réponses de la borne.
Crédits
Portage de python-technove (Christophe Gagnier, MIT, version 2.1.3), dont le code de requête s'inspire de python-wled (Franck Nijhof, MIT). Licence Apache-2.0.
Paramètres de configuration
Voici les paramètres demandés par TechnoVE dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre borne TechnoVE | section | Non | Affiche votre borne de recharge TechnoVE dans Gladys par son API locale, sans cloud : état (débranchée, branchée en attente, en charge, défauts), puissance (estimée), courant, tensions, énergie de la session, courant maximal et partage de charge. Saisissez l'adresse IP de la borne (donnez-lui une adresse fixe dans votre box), enregistrez, puis ajoutez-la depuis l'onglet Découverte. Démarrer, arrêter et le courant maximal ne se changent depuis Gladys que si vous autorisez les commandes ci-dessous. API non officielle, jamais testée avec une vraie borne. Sans lien avec TechnoVE. |
| Adresse IP de la borne | string | Oui | Une adresse IPv4 ou un nom d'hôte. Plusieurs bornes (partage de charge) : séparez-les par des virgules, quatre au plus. |
| Autoriser les commandes | boolean | Non | Désactivé par défaut. Activé : Gladys peut démarrer et arrêter la charge et régler le courant maximal (de 8 A au courant nominal de la borne). Désactivé : ces trois fonctionnalités refusent toute commande. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de chaque borne, en secondes. |
| 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 TechnoVE dans Gladys
- Dans Gladys, ouvrez Intégrations : TechnoVE 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-technove: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-technove.
TechnoVE 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
TechnoVE 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