Utiliser l’API Tesla pour automatiser la charge de sa batterie.

Clara, propriétaire d’un véhicule électrique et installatrice de panneaux solaires, a transformé son garage en laboratoire domotique pour maîtriser la gestion énergie et l’optimisation charge de sa Tesla. Grâce à l’API Tesla elle a relié son automobile à Home Assistant, automatisé la charge batterie selon le surplus photovoltaïque et piloté la climatisation à distance depuis son application mobile. Ce récit explique, pas à pas, comment Clara a franchi les étapes techniques — installation de HACS, ajout de la Tesla Custom Integration, extraction du Refresh token — tout en mesurant la puissance en watts sans matériel supplémentaire et en restant vigilante sur la connectivité et la sécurité. Le guide aborde aussi les limites liées aux récents changements d’API (depuis fin 2023 certains nouveaux véhicules ne permettent plus de commandes, seulement la lecture), et donne des automatisations concrètes pour réveiller la voiture, adapter la charge au surplus solaire et déclencher des alertes pression pneus. Suivez le parcours de Clara : chaque étape est assortie d’exemples concrets, d’astuces de programmation et d’éléments pratiques pour intégrer votre Tesla à votre écosystème de domotique.

Intégration de l’API Tesla à Home Assistant : exigences, risques et premières actions

Pour démarrer, le prérequis incontournable est HACS, car l’intégration que nous utilisons s’y trouve. Installez HACS comme pour n’importe quel add-on communautaire puis redémarrez Home Assistant. Clara a installé Tesla Custom Integration via HACS et a pu immédiatement voir apparaître une nouvelle tuile dans la page des intégrations.

Important : Home Assistant ne propose plus d’intégration Tesla native. Il faut donc recourir à un outil tiers pour extraire le Refresh token nécessaire à la connexion à l’API. Cela implique de confier temporairement vos identifiants à une extension tierce pour générer le jeton — une opération qui comporte un risque de confidentialité. Clara a choisi une extension de navigateur qu’elle a auditée et exécutée hors ligne pour limiter cette exposition.

Phrase-clé : maîtriser le processus d’extraction et conserver votre Refresh token dans un lieu sûr est la première garantie de contrôle.

Extraction du token et connexion pas à pas

Clara a utilisé l’extension nommée Access Token Generator for Tesla. Après installation (Chrome ou navigateur Chromium), l’extension ouvre auth.tesla.com, vous demande vos identifiants Tesla et fournit un Refresh token long : copiez-le et stockez-le hors ligne (bloc-notes chiffré, gestionnaire de mots de passe).

Ensuite, dans Home Assistant, ajoutez une nouvelle intégration et saisissez votre adresse e‑mail Tesla et le Refresh token. Une fois validée, l’intégration crée automatiquement des entités pour le véhicule, le Wall Connector ou le Powerwall selon vos équipements.

Phrase-clé : un token bien stocké vous donne la connectivité nécessaire pour vos automatisations sans exposer vos identifiants.

Quelles entités sont disponibles et comment suivre la charge en Watts

Pour un modèle 3, l’intégration expose environ 55 entités. Ces entités couvrent l’état du véhicule, la batterie, la charge, les ouvertures, la position GPS, la sécurité, et des capteurs détaillés (par ex. intensité et voltage instantanés). Clara a utilisé ces données pour remonter la puissance instantanée sans capteur externe : la puissance en watts se calcule directement à partir de l’intensité et de la tension.

Mesures pratiques : en comparant la valeur calculée à une pince ampèremétrique, les écarts observés sont généralement marginaux (quelques watts), suffisants pour un suivi domestique et pour alimenter le tableau énergie de Home Assistant.

Entité	Usage	Exemple
sensor.car_charger_power ⚡	Puissance instantanée (calcule Amps × Volts) 🔋	Intégration au tableau énergie 🏠
device_tracker.car_location 📍	Détecte si la voiture est à la maison 🏡	Filtre d’enregistrement sur tableau énergie 📊
button.car_wake_up ⏰	Réveille le véhicule pour forcer une mise à jour 🔄	Automatisations de démarrage/arrêt de charge 🔋

Phrase-clé : exploiter les attributs de charge (ampères et volts) permet d’obtenir une mesure en watts fiable pour la gestion énergie.

Calculer la puissance et enregistrer l’énergie pour le dashboard

Plutôt que d’installer du matériel, Clara a créé un capteur template qui multiplie l’intensité par la tension uniquement quand la voiture est à domicile. Exemple de logique (à adapter aux noms d’entités de votre installation) :

{% if states.device_tracker.model3_location.state == « home » %} {{ (state_attr(‘sensor.model3_charger’, ‘charger_amps_actual’) | int(0)) * (state_attr(‘sensor.model3_charger’, ‘charger_volts’) | int(0)) }} {% endif %}

Pour convertir ce flux en kWh et l’afficher dans le tableau énergie, il faut déclarer une entité énergie qui intègre la puissance (somme de Riemann / intégration temporelle). Clara a configuré un capteur « sensor.energy_car_kwh » et l’a ajouté comme source d’énergie dans HA.

Phrase-clé : une conversion simple Amps×Volts suffit pour obtenir des données utilisables en domotique.

Automatisations pratiques : réveil, charge adaptative et alertes

Clara a construit plusieurs automatisations fiables en s’appuyant sur l’API pour piloter la charge batterie et la climatisation. Les plus utiles :

• 🔔 Réveil automatique : appeler button.car_wake_up avant une action critique pour forcer la mise à jour.
• ☀️ Charge solaire adaptative : ajuster number.car_charging_amps en fonction du surplus PV pour éviter l’import réseau.
• 🛡️ Alerte pression pneus : capteur binaire qui s’active si un pneu < 2.70 bar.
• 🕒 Programmation nocturne : démarrer la charge pendant les heures creuses via la programmation horaire.
• 📲 Notifications : envoi d’alertes sur application mobile lors d’anomalies ou de fin de charge.

Phrase-clé : ces automatisations combinent l’API Tesla, la programmation logique et la connectivité pour une gestion fine de la charge.

Mise en œuvre d’un capteur binaire pour la pression des pneus

Pour simplifier les alertes, Clara a créé un capteur binaire qui devient actif si l’un des capteurs TPMS passe sous 2.70 bar. Le principe : vérifier chaque capteur et retourner « on » si l’un est en-deçà du seuil, sinon « off ». Ce capteur est classé en « Sécurité » dans Home Assistant et déclenche des notifications vocales ou push.

Phrase-clé : un seul capteur binaire centralise plusieurs vérifications et simplifie les automatisations.

Automatisation	But	Action
☀️ Charge solaire	Éviter l’import réseau	Moduler amps via API Tesla 🔁
⏰ Charge horaire	Profiter heures creuses	Programmation horaire et wake_up 📅
🔧 Vérif. sécurité	État pneus / serrures	Capteur binaire + notifications 🚨

Phrase-clé : automatiser, c’est orchestrer des entités pour obtenir un comportement prédictible et sûr.

Boîte à outils, cartes et astuces pratiques pour la domotique Tesla

Clara recommande quelques ressources et cartes pour améliorer l’interface et l’expérience utilisateur. La carte « EV Charger Card » disponible via HACS offre une représentation visuelle du chargeur pour les bornes non connectées. Le bouton « test d’émission » peut devenir un jeu ludique pour la famille — ou un outil de vérification rapide.

Autres astuces : appeler button.car_force_data_update avant une lecture critique, limiter l’enregistrement d’énergie aux périodes « à la maison » pour éviter les entrées multiples, et auditer périodiquement les extensions utilisées pour l’extraction du token.

Phrase-clé : des outils simples rendent la programmation et la supervision de la Tesla plus conviviales.

Liste rapide : automatisations recommandées par Clara

• 🔋 Planification nocturne de charge pour heures creuses.
• ☀️ Ajustement dynamique de l’ampérage en fonction du surplus PV.
• 📍 Enregistrement d’énergie uniquement si le véhicule est « home ».
• ⏰ Wake-up automatique avant chaque action importante.
• 🛑 Alertes instantanées pour la pression pneus et serrures.

Phrase-clé : commencez par une automatisation simple, puis complexifiez progressivement.

Comment obtenir le Refresh token pour l’API Tesla ?

Utilisez une extension type Access Token Generator for Tesla depuis un navigateur Chromium. Elle ouvre auth.tesla.com, vous authentifie et affiche un Refresh token. Copiez-le et conservez-le de manière sécurisée.

Est-ce sécurisé d’utiliser un outil tiers pour récupérer le token ?

Il y a un risque inhérent : l’outil a accès à vos identifiants pour générer le token. Restreignez l’exposition en choisissant un outil open-source audité, en l’exécutant hors ligne et en stockant le token dans un gestionnaire sécurisé.

Peut-on piloter la charge sur tous les véhicules Tesla ?

Depuis fin 2023, certains véhicules récents ne permettent plus d’exécuter des commandes via l’API et ne fournissent que des données en lecture. Vérifiez votre modèle et la documentation de l’intégration pour connaître les capacités exactes.

Comment intégrer la consommation de la voiture au tableau énergie de Home Assistant ?

Créez un capteur calculant la puissance en watts (ampères × volts) et déclarez-le ensuite comme source d’énergie. Filtrez les enregistrements pour n’inclure que les périodes où le véhicule est à domicile afin d’éviter les charges sur bornes externes.