Intégration domotique Tesla Wall Connector, gratuite et open source
Borne Tesla Wall Connector gen 3 lue sur le réseau local : puissance, énergie, charge.
Publiée par guim31
- Appareils
- Version 1.3.0
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez votre borne Tesla Wall Connector gen 3 dans Gladys : état de la borne et de la charge, puissance, énergie de la session et énergie totale délivrée, tension, courant, température de la poignée. La borne est lue directement sur votre réseau local : ni compte Tesla, ni cloud, ni abonnement.
Testée sur une borne gen 3 en monophasé ; triphasé non testé. Un utilisateur l'a essayée sur sa borne, avec une Tesla et une hybride rechargeable d'une autre marque : recherche, puissance (recoupée avec l'application Tesla et un compteur), consommation et coût. Le triphasé et le biphasé nord-américain n'ont pas encore été vérifiés sur une vraie borne. Si quelque chose vous semble faux, dites-le sur le forum Gladys.
Cette intégration n'est pas affiliée à Tesla, Inc.
Ce qu'il faut
- Gladys 5.1 ou plus récent.
- Une Wall Connector gen 3 (le modèle Wi-Fi), connectée à votre Wi-Fi (application Tesla One). La gen 2 et l'Universal Wall Connector n'ont pas cette API locale et ne sont pas prises en charge.
- Gladys et la borne sur le même réseau local.
Mise en route
- Installez l'intégration depuis le catalogue, puis ouvrez son onglet Configuration.
- Indiquez où est la borne, au choix :
- vous connaissez son adresse IP (dans l'interface de votre box) : saisissez-la dans Adresses des bornes (plusieurs bornes : séparées par des virgules), enregistrez ;
- vous ne la connaissez pas : cliquez sur Rechercher les bornes en bas de la page (voir Recherche automatique).
- Ouvrez l'onglet Découverte et ajoutez la borne.
- Facultatif : cliquez sur Tester les bornes : chaque adresse affiche la fin du numéro de série de la borne, son firmware et son état, ou pourquoi elle ne répond pas.
Donnez à la borne une adresse fixe dans votre box, pour qu'elle ne change pas. La borne est identifiée par son numéro de série : si son adresse change quand même, saisissez la nouvelle (ou relancez la recherche) et le même appareil continue, avec son historique.
Réglages
| Réglage | Rôle |
|---|---|
| Adresses des bornes | Adresse IP (ou nom d'hôte) de chaque borne, séparées par des virgules. La recherche la remplit aussi. |
| Plage de recherche (avancé) | À laisser vide en général : la recherche prend le réseau de Gladys. Sinon un réseau (192.168.1.0/24), une plage (192.168.1.10-192.168.1.60) ou des adresses, séparés par des virgules. Adresses privées uniquement, 1 024 au plus. |
| Unité de température | Unité de la température de la poignée telle que les scènes la comparent : automatique (°F sur une borne nord-américaine, °C sinon), °C ou °F. Le tableau de bord convertit toujours. |
| Langue des noms d'appareils | Noms anglais, français, allemands ou espagnols des fonctionnalités des nouveaux appareils. Gladys garde le nom d'une fonctionnalité une fois l'appareil créé. |
Recherche automatique
La Wall Connector ne s'annonce pas sur le réseau (ni mDNS, ni SSDP : Home
Assistant la trouve grâce au serveur DHCP, ce que Gladys n'offre pas aux
intégrations). Le bouton Rechercher les bornes essaie donc chaque adresse
d'une plage : il tente une connexion rapide sur le port 80 de chacune, puis
interroge l'API de la borne (/api/1/version et /api/1/vitals) sur les
seules adresses qui répondent, et ne garde que les réponses qui ont la forme
d'une Wall Connector.
Les bornes trouvées sont ajoutées à la configuration et lues aussitôt : elles apparaissent dans l'onglet Découverte. Une borne déjà connue trouvée à une nouvelle adresse remplace son ancienne adresse. Rechargez la page avant d'enregistrer à nouveau le formulaire de configuration, sinon il remettrait les anciennes adresses.
Quelle plage ? L'intégration tourne dans un conteneur isolé, sur un réseau
Docker à part : elle ne voit pas directement sur quel réseau se trouve Gladys.
Elle le demande donc à Gladys : Gladys lance une recherche SSDP sur votre
réseau local (c'est la seule capture réseau que l'intégration demande, affichée
à l'installation) et les appareils qui répondent (box internet, télévision,
enceinte…) donnent le réseau, par exemple 10.0.0.0/24. Sans Plage de
recherche, la recherche essaie, dans cet ordre :
- le réseau des bornes déjà configurées ;
- le réseau de Gladys, trouvé ainsi (le message de la recherche l'affiche : « Réseau de Gladys : 10.0.0.0/24 ») ;
- si aucun appareil n'a répondu à Gladys :
192.168.1.0/24et192.168.0.0/24, les réseaux domestiques les plus courants, et le message le dit.
Le champ Plage de recherche ne sert que si la borne est sur un autre réseau
que Gladys, ou si la recherche ne trouve pas le bon. Le bloc « Recherche sur le
réseau » de la configuration affiche l'adresse par laquelle votre navigateur
joint Gladys : si c'est 192.168.1.20, la plage de ce réseau est
192.168.1.0/24 (les adresses de 192.168.1.1 à 192.168.1.254).
Une recherche dure de quelques secondes à une minute. Elle ne sort jamais du réseau local : seules les adresses privées sont acceptées, 1 024 au plus. Quand aucune borne ne répond, le résultat s'affiche en rouge, avec ce qu'il faut vérifier.
Ce que vous obtenez
| Fonctionnalité | Détails |
|---|---|
| Connecteur | Disponible, occupé (une voiture est branchée), indisponible, en défaut |
| État de charge | En charge, véhicule connecté, en pause (voiture ou borne), inactif (aussi dès que la voiture est débranchée) |
| Statut | L'état propre de la borne en toutes lettres (voir États) |
| Puissance de charge | W |
| Énergie de la session | kWh délivrés depuis le branchement de la voiture |
| Énergie totale délivrée | Index cumulé en kWh, pour le suivi d'énergie de Gladys |
| Tension du réseau, courant | V, A |
| Température de la poignée | °C ou °F (réglage Unité de température) |
Tout est en lecture seule : l'API locale de la borne ne lance, n'arrête ni ne limite une charge (faites-le depuis la voiture ou l'application Tesla).
La borne est lue toutes les 15 secondes (le compteur total toutes les minutes), et seul ce qui change est envoyé à Gladys. Après trois lectures manquées de suite, la borne apparaît injoignable (pastille sur l'appareil).
Historique. Gladys garde chaque valeur reçue. La tension du réseau, le courant, la température de la poignée et la puissance bougent un peu à chaque lecture : ils ne sont envoyés que s'ils changent nettement depuis la dernière valeur envoyée :
| Mesure | Envoyée quand elle bouge de |
|---|---|
| Puissance de charge | 50 W, ou 2 % pendant une charge (150 W à 7,4 kW) ; et au retour à 0 W |
| Courant du véhicule | 0,5 A ; et au retour à 0 A |
| Tension du réseau | 2 V |
| Température de la poignée | 1 °C (1,8 °F) |
Chacune est aussi renvoyée une fois par heure, même sans bouger, pour que Gladys ne la voie jamais comme périmée. Comptez quelques dizaines de valeurs par jour pour chacune, plus quelques-unes pendant une charge, au lieu d'une toutes les 15 secondes (5 760 par jour). Les tuiles puissance et courant du widget affichent ces valeurs ; sa tuile de session et sa ligne Total sont lues directement sur la borne.
La borne donne des tensions et des courants, pas la puissance : celle-ci est calculée phase par phase (triphasé en Europe), ou comme tension × courant sur une alimentation nord-américaine 240 V biphasée (reconnue à son réseau 60 Hz).
États de la borne
La borne donne un numéro d'état (evse_state). Leur sens vient de Home
Assistant, corrigé par ce qu'un utilisateur a relevé sur sa borne en monophasé
(octobre 2026) :
| État | Statut affiché | Situation observée |
|---|---|---|
| 1 | Véhicule non branché | Aucun véhicule |
| 4 | Prête à charger | Tesla branchée, sans charge |
| 7 | Branchée, hors plage de charge | Tesla branchée hors de son planning de charge : normal, pas un défaut |
| 8 | Charge terminée | (non observé) |
| 9 | En attente du véhicule | Tesla branchée, planning ouvert ; aussi après l'arrêt d'une charge |
| 10 | En charge (non Tesla probable) | Charge du véhicule non Tesla |
| 11 | En charge | Charge de la Tesla |
| 12 | Branchée (non Tesla probable) | Branchement du véhicule non Tesla |
| 13 | Fin de session (non Tesla probable) | Fin de charge et débranchement du véhicule non Tesla |
| 21 | Fin de session | Débranchement de la Tesla |
L'état 7 n'est affiché comme Erreur (connecteur « en défaut », en rouge
dans le widget) que si aucune voiture n'est branchée ou si la borne signale une
alerte (current_alerts).
Tesla ou autre véhicule ? Les états 10, 12 et 13 n'ont été vus qu'avec le véhicule d'une autre marque, et 4, 9, 11 et 21 qu'avec la Tesla. Cela vient d'un seul test : le statut dit donc « non Tesla probable », sans plus.
Suivi d'énergie
L'énergie totale délivrée est le compteur propre de la borne. Gladys en calcule la consommation par demi-heure et son coût, et la range sous votre compteur électrique principal : la borne est un sous-compteur de votre compteur principal (Linky…), puisque son énergie passe aussi par lui.
Dans un widget de consommation, ne cochez pas à la fois le compteur principal et la borne si vous voulez un total juste : l'énergie de la borne serait comptée deux fois. Affichez-les dans deux widgets, ou cochez le compteur principal seul pour le total de la maison.
Tableau de bord
Le widget Borne Tesla Wall Connector (Gladys 5.1+), réglé avec la borne à afficher :
- en haut, trois tuiles côte à côte : puissance et courant de charge, et l'énergie de Cette session quand une voiture est branchée, de la Session finie sinon (la borne garde l'énergie de la session terminée), en kWh avec une décimale ;
- en dessous, le Total délivré, en kWh entiers (en MWh à partir de 100 000 kWh ; la fonctionnalité garde la valeur exacte) ;
- l'état de la borne et de la voiture, et, voiture branchée, Branché depuis (compté par la borne depuis le branchement) et Durée de charge (suivie par l'intégration : le temps où la borne a réellement délivré du courant pendant ce branchement, remis à zéro au débranchement).
Le total s'affiche en ligne sous les tuiles, et non en quatrième tuile : Gladys 5.1.4 range toutes les tuiles d'un widget sur une seule rangée qui passe à la ligne après trois, sans réglage du nombre de colonnes, et quatre tuiles s'afficheraient en trois plus une.
Pas de bouton : l'API locale ne fait que lire.
Scènes
Déclencheurs, chacun limitable à une borne, avec l'énergie de la session en kWh :
- Wall Connector : voiture branchée (y compris hors du planning de charge)
- Wall Connector : voiture débranchée
- La Wall Connector a commencé à charger
- Charge de la Wall Connector terminée : la charge s'arrête alors que la voiture reste branchée (fin de charge, planning fermé…) ou se termine par le débranchement (états 13 et 21)
Ils ne se déclenchent que sur un changement observé : un redémarrage de l'intégration ne rejoue ni ne perd un événement. Toutes les fonctionnalités ci-dessus s'utilisent aussi dans les scènes de la façon habituelle (« quand la puissance de charge dépasse 7 000 W »…).
Vous utilisiez la borne dans l'intégration Tesla/Teslemetry ?
La borne avait été ajoutée à l'intégration Tesla (version 1.1.0), qui sert surtout aux voitures et au Powerwall via le service Teslemetry. Elle a désormais sa propre intégration, celle-ci, comme dans Home Assistant. Le code de lecture est le même, ainsi que les fonctionnalités, les noms des déclencheurs et le widget.
Gladys rattache chaque appareil à son intégration : la borne de cette intégration est donc un nouvel appareil, et l'historique de l'ancien ne lui est pas transféré. Pour passer de l'une à l'autre :
- Installez cette intégration, saisissez l'adresse de la borne (la même que dans l'intégration Tesla) ou lancez Rechercher les bornes, puis ajoutez la borne depuis l'onglet Découverte.
- Reprenez vos scènes, widgets et suivi d'énergie : choisissez les déclencheurs de cette intégration (mêmes noms), le widget Borne Tesla Wall Connector de cette intégration, et la nouvelle borne dans les widgets de consommation.
- Retirez l'ancienne borne : dans l'intégration Tesla, videz le champ Adresses des bornes Wall Connector et enregistrez, puis supprimez l'ancien appareil Wall Connector. Supprimer l'appareil supprime aussi son historique : gardez-le le temps qu'il vous faut si vous y tenez.
Les deux intégrations peuvent lire la borne en même temps sans gêne pour elle, mais l'énergie serait alors comptée deux fois dans le suivi d'énergie, et les déclencheurs partiraient deux fois : ne gardez la borne que d'un côté. Si vous n'utilisiez l'intégration Tesla que pour la borne, vous pouvez la désinstaller.
Dépannage
- « Aucune Wall Connector ne répond » : vérifiez l'adresse IP dans votre box et que la borne est bien sur le Wi-Fi (application Tesla One), puis cliquez sur Tester les bornes.
- La recherche ne trouve rien : regardez le réseau qu'elle a exploré (dans son message) ; si ce n'est pas celui de la borne, indiquez-le dans Plage de recherche (voir plus haut). Une borne sur un autre réseau (un Wi-Fi « objets connectés » séparé, un VLAN) se cherche avec la plage de ce réseau, si Gladys peut le joindre. Un pare-feu strict sur la machine de Gladys (ufw) peut aussi bloquer le trafic des intégrations vers le réseau local.
- La borne répond lentement : c'est fréquent avec ce firmware ; l'intégration attend jusqu'à 10 secondes et ne la déclare injoignable qu'après trois échecs de suite.
- L'intégration journalise ce qu'elle fait (recherches, réponses de la borne) : ouvrez ses logs depuis l'onglet de l'intégration dans Gladys.
Paramètres de configuration
Voici les paramètres demandés par Tesla Wall Connector dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Pour la borne Tesla Wall Connector gen 3 (le modèle Wi-Fi). Elle est lue directement sur votre réseau local : ni compte Tesla, ni cloud, ni abonnement. La borne doit être connectée à votre Wi-Fi (application Tesla One). Saisissez son adresse IP ci-dessous, ou cliquez sur « Rechercher les bornes » en bas de cette page. Fixez-lui une adresse dans votre box, pour qu’elle garde toujours la même. |
| Adresses des bornes | string | Non | Adresse IP (ou nom d’hôte) de chaque borne, séparées par des virgules. Remplie aussi par la recherche. |
| Recherche sur le réseau (avancé) | section | Non | La borne ne s’annonce pas sur le réseau : la recherche essaie donc chaque adresse du réseau de Gladys. Gladys demande aux appareils de votre réseau local (box internet, télévision…) de répondre à une recherche SSDP et en déduit le réseau d’après leurs adresses. Elle essaie aussi le réseau des bornes déjà configurées. Seulement si votre borne est sur un autre réseau, indiquez la plage ci-dessous. Votre navigateur joint Gladys à l’adresse {{gladys_host}} : si c’est une adresse comme 192.168.1.20, la plage de ce réseau est 192.168.1.0/24 (toutes les adresses de 192.168.1.1 à 192.168.1.254). |
| Plage de recherche (avancé) | string | Non | Laissez vide pour chercher sur le réseau de Gladys. Sinon un réseau (192.168.1.0/24), une plage (192.168.1.10-192.168.1.60) ou des adresses, séparés par des virgules. Adresses privées uniquement, 1 024 au plus. |
| Unité de température | select | Non | Unité de la température de la poignée, telle que les scènes la comparent. Le tableau de bord convertit toujours selon la préférence de chacun. |
| Langue des noms d'appareils | select | Non | Langue des noms de fonctionnalités des nouveaux appareils (Gladys garde un nom une fois l'appareil créé). |
Comment installer Tesla Wall Connector dans Gladys
- Dans Gladys, ouvrez Intégrations : Tesla Wall Connector 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/guim31/gladys-tesla-wall-connector:1.3.0), 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/guim31/gladys-tesla-wall-connector.
Tesla Wall Connector 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
Tesla Wall Connector 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 guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation