Intégration domotique Teslemetry, gratuite et open source
Voitures Tesla et Powerwall via Teslemetry : charge, clim, verrous, solaire, flux d'énergie.
Publiée par guim31
- Appareils
- Version 1.3.0
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez et pilotez vos voitures Tesla, votre Powerwall et vos panneaux solaires depuis Gladys via Teslemetry : batterie, autonomie, charge, climatisation, verrouillage, mode Sentinelle, et les flux d'énergie de la maison en temps réel.
Développée sans le matériel : retours bienvenus. Cette intégration a été construite sans voiture, sans Powerwall ni compte Teslemetry, et testée sur des exemples de réponses de l'API adaptés des tests de l'intégration Teslemetry de Home Assistant et de la documentation de l'API Fleet de Tesla. Si quelque chose vous semble faux, dites-le sur le forum Gladys.
Cette intégration n'est affiliée ni à Tesla, Inc. ni à Teslemetry.
Elle porte le nom du service par lequel elle passe. Les autres façons de joindre une Tesla (Tessie, TeslaMate, l'API Fleet en direct…) pourront avoir leur propre intégration.
Wall Connector : désormais une intégration à part
La version 1.1.0 de cette intégration (alors nommée « Tesla ») lisait aussi la borne Tesla Wall Connector sur le réseau local. La borne a maintenant sa propre intégration, Tesla Wall Connector, qui se passe complètement de Teslemetry. Si vous en aviez configuré une :
- Installez Tesla Wall Connector depuis le store de Gladys et saisissez l'adresse de la borne dans son onglet Configuration.
- L'appareil borne, son historique et les tableaux de bord qui l'affichent sont conservés : la nouvelle intégration utilise les mêmes identifiants d'appareil.
- Les scènes qui utilisaient les déclencheurs Wall Connector, et le widget Borne Tesla Wall Connector, sont à refaire avec la nouvelle intégration.
D'ici là, cette intégration affiche un rappel dans son état de connexion et ses journaux, et laisse la borne de côté.
Comment elle se connecte
L'API officielle de Tesla (l'API Fleet) s'adresse aux développeurs : chaque utilisateur devrait enregistrer une application de développeur, héberger une clé publique sur un nom de domaine et signer chaque commande. Teslemetry fait tout cela pour vous et vous donne un seul jeton d'accès. C'est un service payant, avec un abonnement par véhicule et par site d'énergie (voir teslemetry.com/pricing) et une enveloppe mensuelle de crédits de commande incluse.
La lecture des données ne réveille jamais la voiture. Une voiture endormie garde ses dernières valeurs connues dans Gladys ; seule une commande que vous envoyez (lancer la charge, la clim, verrouiller…) la réveille.
Ce qu'il faut
- Gladys 5.1 ou plus récent.
- Un compte Teslemetry lié à votre compte Tesla, avec un abonnement pour chaque voiture et chaque site d'énergie à suivre.
- Pour les commandes : la clé virtuelle Teslemetry ajoutée à chaque voiture (Teslemetry vous guide, cela prend une minute depuis l'application Tesla).
- Pour les données de la voiture en temps réel : le flux Fleet Telemetry, que les voitures récentes savent envoyer (il demande une version logicielle récente ; les Model S et Model X d'avant 2021 n'en disposent pas). Les voitures sans flux fonctionnent quand même, avec les données en cache de Teslemetry.
Mise en route
- Dans la console Teslemetry, créez un jeton d'accès avec l'accès à vos véhicules et sites d'énergie. Copiez-le.
- Dans Gladys, ouvrez l'onglet Configuration de l'intégration Teslemetry, collez le jeton dans Jeton d'accès Teslemetry, vérifiez les autres réglages, enregistrez.
- Ouvrez l'onglet Découverte : chaque voiture et chaque site d'énergie y figure. Ajoutez ceux que vous voulez.
- Facultatif : cliquez sur Tester la connexion pour voir ce à quoi Teslemetry donne accès, et si le flux temps réel est connecté.
L'intégration active aussi, chez Teslemetry, le flux des quelques valeurs de la voiture qu'elle lit (batterie, autonomie, charge, climatisation, verrouillage, mode Sentinelle, compteur, unités d'affichage). Elle ne fait qu'ajouter des champs, elle ne retire jamais les vôtres.
Réglages
| Réglage | Rôle |
|---|---|
| Unités | Unités des distances et températures telles que les scènes les stockent et les comparent : celles de l'écran de la voiture (par défaut), miles et °F, ou kilomètres et °C. Le tableau de bord affiche toujours les unités de chacun. |
| 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éé. |
| Relevé de secours des voitures | Fréquence de lecture d'une voiture éveillée qui n'envoie rien par le flux (30 ou 60 minutes, ou jamais). Jamais pendant qu'elle dort. |
| Envoyer la consommation de la maison au tableau de bord énergie | Désactivé par défaut. Ajoute l'index de consommation aux sites Powerwall (voir plus bas). |
Changer les Unités d'une voiture déjà ajoutée : l'onglet Découverte propose une Mise à jour. Tant que vous ne l'acceptez pas, la voiture continue d'être publiée dans ses anciennes unités, rien ne se mélange.
Vos voitures
| Fonctionnalité | Détails |
|---|---|
| Niveau de batterie | % |
| Autonomie | Autonomie nominale, en km ou en miles |
| État de charge | En charge, véhicule connecté, en pause (voiture), en pause (borne sans courant), inactif |
| Puissance de charge | kW, en courant alternatif ou continu (Superchargeur) |
| Limite de charge | 50 à 100 %, réglable |
| Charge | Lancer / arrêter la charge |
| Courant de charge | Ampères demandés à la borne, réglable (pratique pour charger sur le surplus solaire) |
| Branchée | Oui / non |
| Climatisation | Marche / arrêt |
| Consigne de climatisation | Réglable, 15–28 °C (59–82 °F) |
| Températures intérieure / extérieure | °C ou °F |
| Verrouillage | Verrouiller / déverrouiller |
| Mode Sentinelle | Marche / arrêt |
| Kilométrage | km ou miles |
| En ligne (réveillée) | Allumé quand la voiture est éveillée, éteint quand elle dort ou n'a pas de réseau |
Cette version de l'intégration ne lit jamais la position de la voiture.
Votre Powerwall et vos panneaux solaires
Chaque site d'énergie reçoit les fonctionnalités de ce qu'il possède : un site uniquement solaire n'a pas de batterie, un Powerwall sans panneaux pas de production solaire.
| Fonctionnalité | Détails |
|---|---|
| Production solaire | W |
| Consommation de la maison | W, mesurée par la passerelle |
| Réseau (soutirage +, injection −) | W, signé : positif quand vous tirez du réseau, négatif quand vous y injectez |
| Charge / décharge de la batterie | W, deux fonctionnalités (toutes deux positives) |
| Charge du Powerwall | % |
| Réseau présent | Éteint pendant une coupure (la maison tourne sur le Powerwall) |
| Mode de fonctionnement | Autoconsommation ou Contrôle horaire, réglable |
| Index d'énergie | kWh cumulés : production solaire, soutirage et injection, batterie (maison : plus bas) |
Le mode « Secours uniquement » n'est pas proposé : Tesla l'a retiré sur de nombreux sites. Un site réglé ainsi depuis l'application Tesla l'affiche dans le widget énergie.
L'index de consommation de la maison est désactivé par défaut : activez Envoyer la consommation de la maison au tableau de bord énergie dans les réglages, puis acceptez la Mise à jour du site dans l'onglet Découverte. Gladys en calcule alors la consommation par demi-heure et son coût, avec votre contrat d'énergie. Gladys le rattache au compteur électrique principal défini dans les réglages énergie : si votre compteur (Linky…) est déjà dans Gladys, le Powerwall mesure la même maison, laissez donc l'option désactivée plutôt que de compter la maison deux fois. L'index continue de compter tant que l'option est désactivée : l'activer plus tard ne repart pas de zéro. Les index commencent à compter à l'installation de l'intégration : Tesla ne donne pas de totaux depuis la mise en service, ils sont construits à partir des totaux journaliers que Teslemetry diffuse.
Tableau de bord
Deux widgets (Gladys 5.1+), chacun réglé avec l'appareil qu'il affiche :
- Véhicule Tesla : batterie, autonomie, puissance de charge et température de l'habitacle en temps réel, l'état de la charge, de la clim, du verrouillage, du mode Sentinelle et de la connexion, et des boutons pour lancer ou arrêter la clim, lancer ou arrêter la charge (voiture branchée), verrouiller ou déverrouiller (le déverrouillage demande une confirmation).
- Flux d'énergie Tesla : solaire, maison, réseau et Powerwall en temps réel, les dernières 24 heures en courbe, l'état du réseau, le mode de fonctionnement, la réserve de secours et l'alerte tempête (Storm Watch).
Scènes
Déclencheurs (chacun limitable à une voiture ou à un site d'énergie) :
- La Tesla a commencé à charger, Charge de la Tesla terminée, Tesla branchée, Tesla débranchée — avec le niveau de batterie.
- Coupure réseau (Powerwall) et Retour du réseau (Powerwall) — avec la charge du Powerwall, et si la coupure est un passage volontaire hors réseau.
Action :
- Régler la réserve du Powerwall — par exemple 100 % quand une tempête est annoncée, puis retour à 20 %.
Toutes les fonctionnalités des voitures ci-dessus s'utilisent aussi dans les scènes de la façon habituelle (« quand la batterie passe sous 30 % », « lancer la clim à 7 h 30 », « régler la limite de charge à 90 % »…).
Fraîcheur des données et coûts Teslemetry
Ce qui suit reprend les règles publiées par Teslemetry (2026). Elles n'ont pas
pu être mesurées sur un vrai compte pendant le développement : pour connaître
vos propres coûts, l'intégration écrit une ligne dans ses logs à chaque appel
facturé, avec votre solde restant (Teslemetry credits: … cost 1, balance 498),
et Tester la connexion affiche le solde.
| Quoi | Quand | Coût |
|---|---|---|
| Flux temps réel (voitures, Powerwall, totaux journaliers) | En continu, une seule connexion pour tout le compte | Inclus dans les abonnements, aucun crédit |
| Lecture d'une voiture au démarrage | Une fois par voiture au lancement de l'intégration | Gratuite depuis le cache Teslemetry ; jusqu'à 2 crédits si la voiture est éveillée et son cache vieux de plus de 20 min |
| Lecture de secours d'une voiture | Voiture éveillée qui n'a rien envoyé pendant le délai choisi (30 min par défaut) | Idem. Jamais pour une voiture endormie, jamais pour une voiture qui envoie son flux |
| Liste des véhicules, état du Powerwall | Toutes les 15 / 10 minutes, seulement quand le flux est coupé | Gratuit a priori (appels de lecture, non vérifié) |
| Commande (charge, clim, verrouillage, limite, réserve…) | À votre demande | 1 crédit ; si la voiture dort, elle est d'abord réveillée (environ 20 crédits de plus) |
En pratique, avec une voiture qui envoie son flux, le coût propre de l'intégration se limite aux commandes envoyées. L'enveloppe mensuelle de Teslemetry est de 500 crédits par véhicule et par site d'énergie : environ 500 commandes à une voiture éveillée, ou environ 24 à une voiture endormie. Gladys acquitte une commande au bout de 4 secondes même si la voiture se réveille encore ; la commande continue et son résultat s'affiche quand la voiture répond.
Limites
- Développée sans voiture, sans Powerwall et sans compte Teslemetry (voir plus haut).
- Pas de position, de navigation, de coffre, de fenêtres ni de sièges chauffants dans cette version.
- Gladys n'a pas de puissance de batterie signée : celle du Powerwall est séparée en « charge » et « décharge ». La réserve de secours n'a pas non plus de fonctionnalité d'appareil : elle s'affiche dans le widget énergie et se règle par l'action de scène.
- Les voitures anciennes sans Fleet Telemetry ne sont rafraîchies que depuis le cache de Teslemetry (toutes les 30 ou 60 minutes quand elles sont éveillées).
- Les noms des fonctionnalités sont fixés à la création de l'appareil et ne suivent pas un changement de langue ultérieur.
Dépannage
- « Teslemetry a refusé le jeton d'accès » : le jeton est mal recopié, révoqué ou expiré. Créez-en un nouveau dans la console Teslemetry.
- « Un abonnement est nécessaire » : la voiture ou le site n'a pas d'abonnement Teslemetry actif.
- Une commande échoue avec « vehicle unavailable » : la voiture n'a pas de réseau, ou la clé virtuelle n'y est pas installée.
- Les valeurs de la voiture ne changent que toutes les 30 minutes : la voiture n'envoie pas de flux. Vérifiez dans la console Teslemetry que le flux est activé pour elle, et que son logiciel est à jour.
- L'intégration journalise tout ce qu'elle fait : ouvrez ses logs depuis
l'interface de Gladys, avec
LOG_LEVEL=debugpour le détail complet. Les jetons ne sont jamais journalisés.
Paramètres de configuration
Voici les paramètres demandés par Teslemetry dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Cette intégration accède à votre compte Tesla via Teslemetry, un service payant qui relaie l'API Fleet officielle de Tesla (pas de compte développeur Tesla nécessaire). Créez un compte Teslemetry, liez votre compte Tesla, ajoutez la clé virtuelle à votre voiture, puis créez un jeton d'accès dans la console Teslemetry et collez-le ci-dessous. La lecture des données ne réveille jamais la voiture ; une commande envoyée à une voiture endormie la réveille. |
| Jeton d'accès Teslemetry | secret | Oui | Créé dans la console Teslemetry, avec l'accès à vos véhicules et sites d'énergie. |
| Unités | select | Non | Unités des valeurs du véhicule (distances, températures), telles que les scènes les 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éé). |
| Relevé de secours des voitures | select | Non | Les voitures sont suivies en temps réel par le flux Teslemetry. Quand une voiture éveillée n'envoie rien (anciens modèles, flux désactivé), ses données sont lues à ce rythme. Jamais pendant qu'elle dort. |
| Envoyer la consommation de la maison au tableau de bord énergie | boolean | Non | Ajoute un index de consommation de la maison (kWh) à chaque site Powerwall, dont Gladys calcule la consommation et le coût. Gladys le rattache à votre compteur électrique principal : laissez-le désactivé si votre compteur (Linky…) est déjà dans Gladys, sinon la maison est comptée deux fois. |
Comment installer Teslemetry dans Gladys
- Dans Gladys, ouvrez Intégrations : Teslemetry 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: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.
Teslemetry 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
Teslemetry 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