Intégration domotique Toyota / Lexus, gratuite et open source
Voitures Toyota et Lexus (Europe, MyToyota) : carburant, batterie, charge, autonomie, portes.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration amène vos voitures Toyota et Lexus dans Gladys par les services connectés MyToyota de Toyota Motor Europe (l'application MyToyota, et Lexus Link pour une Lexus) : niveaux de carburant et de batterie, charge, autonomies, kilométrage, verrouillage, portes et fenêtres, voyants d'alerte et dernier trajet. Elle utilise le compte de l'application. Non officielle, sans lien avec Toyota ni Lexus.
Version de développement (0.1). Construite à partir du protocole de pytoyoda (la bibliothèque de l'intégration Home Assistant ha_toyota) et testée avec des réponses simulées, pas encore avec une vraie voiture. Les retours sont les bienvenus sur le dépôt GitHub.
Europe uniquement : les voitures d'Amérique du Nord utilisent une autre API (application Toyota, pas MyToyota) et ne sont pas prises en charge.
Ce que vous obtenez
Un appareil par voiture du compte (nommé d'après le surnom donné dans l'application), avec les fonctionnalités que la voiture remonte :
| Fonctionnalité | Voitures | Dans Gladys |
|---|---|---|
| Niveau de carburant | thermique, hybride, PHEV | pourcentage |
| Autonomie carburant | thermique, hybride, PHEV | km |
| Niveau de batterie | hybride rechargeable, élec. | pourcentage (jauge de batterie) |
| Autonomie électrique | hybride rechargeable, élec. | km |
| Autonomie totale | hybride rechargeable | km, carburant + électrique (climatisation en marche, comme l'appli) |
| Kilométrage | toutes | km |
| État de la charge | hybride rechargeable, élec. | en charge, véhicule branché, inactif (charge finie ou débranché) |
| Branchée | hybride rechargeable, élec. | oui / non |
| Temps de charge restant | hybride rechargeable, élec. | minutes |
| Verrouillée | si remonté | verrouillée quand toutes les portes et le coffre le sont |
| Porte, coffre, capot ouvert | si remonté | ouvert / fermé (n'importe quelle porte pour « Porte ouverte ») |
| Fenêtre ouverte | si remonté | ouverte / fermée (n'importe quelle fenêtre) |
| Position de stationnement | option, si remontée | texte « latitude, longitude » de la dernière position garée |
| Voyants d'alerte | toutes | nombre de voyants d'alerte remontés |
| Dernier trajet | toutes | texte : fin, distance, durée, L/100 km, % électrique, score |
| Distance et carburant du trajet | toutes (carburant : pas élec.) | km et litres, enregistrés une fois par trajet, à sa fin |
| Dernière remontée de la voiture | toutes | quand la voiture a envoyé ses données à Toyota |
Les distances en miles sont converties en km. Lecture seule : pas encore de commande de verrouillage, déverrouillage, climatisation ou charge (voir « Commandes à distance » plus bas).
Installation
- Utilisez une fois l'application MyToyota (ou Lexus Link) : la voiture doit être ajoutée au compte et ses services connectés actifs.
- Dans Gladys, installez l'intégration, puis saisissez dans sa configuration l'e-mail et le mot de passe de l'application et choisissez la marque (Toyota ou Lexus).
- Cliquez sur Tester la connexion : elle liste les voitures du compte.
- Ouvrez l'onglet Découverte et ajoutez les voitures.
Scènes
- Déclencheur « Trajet terminé » : un nouveau trajet est apparu dans MyToyota (lu après l'arrêt de la voiture, à la lecture suivante). Filtre : la voiture. Variables : nom de la voiture, distance (km), durée (min), carburant consommé (L), consommation (L/100 km), part roulée en électrique (%), score de conduite, fin du trajet.
- Action « Lire les voitures maintenant » : lit tout de suite les dernières valeurs connues de Toyota, pour toutes les voitures ou une seule, voyants et dernier trajet compris (au plus une fois toutes les deux minutes). Utile en arrivant à la maison, par exemple.
- Chaque fonctionnalité peut aussi déclencher une scène de la façon habituelle (voiture déverrouillée, coffre ouvert, batterie sous 20 %, charge terminée…).
Fréquence de lecture
- Toutes les 15 minutes par défaut (5 minutes minimum, voir les options), une requête à la fois avec une pause entre deux : Toyota répond « trop de requêtes » aux comptes lus trop souvent, et aux rafales.
- Chaque voiture ne lit que ce que le compte annonce : télémétrie (carburant, kilométrage), état électrique (batterie, charge), portes et verrouillage, et la position de stationnement seulement si vous avez activé l'option.
- Les voyants toutes les 6 heures ; le dernier trajet quand le kilométrage a changé (et toutes les 6 heures) ; la liste des voitures une fois par jour et à chaque Scan.
- La voiture n'est jamais réveillée : les valeurs sont celles que Toyota garde, envoyées par la voiture d'elle-même (arrêt du moteur, verrouillage, charge…). Sa batterie 12 V est épargnée, mais une valeur peut dater de quelques heures : voir « Dernière remontée de la voiture ». L'application MyToyota affiche les mêmes valeurs.
Options
| Option | Par défaut | Effet |
|---|---|---|
| Marque du compte | Toyota | Toyota (application MyToyota) ou Lexus (application Lexus Link) |
| Intervalle de rafraîchissement (s) | 900 | fréquence de lecture des voitures (300 à 86400) |
| Position de stationnement | désactivée | ajoute la dernière position garée ; désactivée, elle est oubliée |
| Langue des noms de fonctionnalités | français | noms des fonctionnalités des appareils ajoutés (ou mis à jour) ensuite |
Commandes à distance
L'API de Toyota a des commandes (verrouiller, déverrouiller, climatisation, charge), mais elles ne sont pas dans cette version : en Europe elles dépendent de l'abonnement aux services à distance de chaque voiture, Toyota est en train de déplacer leurs adresses, les démarrages de climatisation sont limités par cycle de contact, et elles n'ont pas pu être vérifiées sur une vraie voiture. Elles sont prévues, en option, une fois confirmées.
Dépannage
- « MyToyota a refusé l'e-mail ou le mot de passe » : vérifiez-les dans l'application, puis dans la configuration. L'intégration ne réessaie pas d'elle-même (Toyota peut bloquer un compte qui insiste) : elle attend une modification ou un clic sur Tester la connexion.
- « demande de ralentir » : augmentez l'intervalle de rafraîchissement, et arrêtez si possible les autres outils qui lisent le même compte (Home Assistant, Node-RED…).
- « La connexion MyToyota a répondu de façon inattendue » : Toyota a peut-être modifié sa connexion ; l'intégration réessaie toutes les 6 heures. Merci d'ouvrir un ticket sur GitHub.
- Une fonctionnalité n'a jamais de valeur : la voiture ou son abonnement ne la remonte pas (les portes de certains modèles, la position, l'état électrique de certaines hybrides). Un service que Toyota refuse pour une voiture n'est redemandé qu'une fois par jour.
- Valeurs anciennes : la voiture ne remonte ses données qu'à certains moments ; roulez ou verrouillez-la, puis utilisez l'action de scène « Lire les voitures maintenant ».
Vie privée
L'e-mail et le mot de passe sont gardés par Gladys comme un secret (jamais
renvoyés au navigateur). L'intégration ne les envoie qu'à
b2c-login.toyota-europe.com, la connexion de l'application MyToyota, pour
ouvrir une session ; elle garde les jetons d'accès et de renouvellement et
l'identifiant utilisateur dans son dossier /data (avec une empreinte de
l'e-mail, jamais le mot de passe), et lit les voitures sur
ctpa-oneapi.tceu-ctp-prd.toyotaconnectedeurope.io. Les journaux ne montrent
que les quatre derniers caractères d'un VIN, jamais la position. La position
de stationnement n'est lue que si vous activez l'option. Toyota, Lexus et
MyToyota sont des marques de leurs propriétaires ; cette intégration est sans
lien avec Toyota ni Lexus.
Paramètres de configuration
Voici les paramètres demandés par Toyota / Lexus dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte MyToyota | section | Non | Amène vos voitures Toyota ou Lexus dans Gladys par les services connectés MyToyota (Europe) : niveau de carburant, niveau de batterie, charge et branchement des hybrides et électriques, autonomies, kilométrage, verrouillage, portes, coffre, capot et fenêtres, voyants d'alerte, dernier trajet, et un déclencheur de scène « trajet terminé ». Saisissez l'e-mail et le mot de passe de l'application MyToyota (Lexus Link pour une Lexus), puis ajoutez les voitures depuis l'onglet Découverte. Lecture toutes les 15 minutes par défaut, une requête à la fois : Toyota limite les requêtes, et la voiture n'est jamais réveillée (sa batterie 12 V n'est pas sollicitée), les valeurs sont donc les dernières envoyées par la voiture. Lecture seule : pas encore de commande à distance. L'Amérique du Nord n'est pas prise en charge (autre API). Non officiel, sans lien avec Toyota ni Lexus. |
| E-mail MyToyota | string | Oui | |
| Mot de passe MyToyota | secret | Oui | |
| Marque du compte | select | Non | Toyota pour l'application MyToyota, Lexus pour l'application Lexus Link. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture des voitures, en secondes (5 minutes minimum, 15 minutes par défaut). Toyota répond « trop de requêtes » aux comptes lus trop souvent. |
| Position de stationnement | boolean | Non | Ajoute la dernière position de stationnement de chaque voiture (latitude, longitude) en texte. Désactivé par défaut : c'est une donnée personnelle. Désactivée, la position est oubliée. |
| Langue des noms de fonctionnalités | select | Non |
Comment installer Toyota / Lexus dans Gladys
- Dans Gladys, ouvrez Intégrations : Toyota / Lexus 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-toyota: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-toyota.
Toyota / Lexus 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
Toyota / Lexus 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