Intégration domotique Peugeot / Citroën / DS / Opel, gratuite et open source
Voitures Peugeot, Citroën, DS, Opel et Vauxhall : batterie, autonomie, charge, carburant.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez vos voitures Peugeot, Citroën, DS, Opel et Vauxhall dans Gladys : batterie, autonomie, charge, carburant, kilométrage, verrouillage. L'intégration se connecte à votre compte MyPeugeot, MyCitroën, MyDS, MyOpel ou MyVauxhall, comme l'application, et lit l'état que vos voitures ont envoyé au cloud Stellantis.
Cette intégration n'est pas affiliée à Stellantis ni à ses marques. Elle a été développée sans voiture ni compte, à partir du travail de la communauté Home Assistant : vos retours sont bienvenus, sur le forum ou dans les issues GitHub.
Ce qu'elle fait
- Un appareil Gladys par voiture du compte : électrique, hybride rechargeable ou thermique.
- Ses valeurs sont lues dans le cloud Stellantis toutes les 15 minutes (au choix de 10 à 60). Une lecture ne réveille jamais la voiture : elle renvoie ce que la voiture a envoyé en dernier (à l'arrêt du moteur, pendant la charge, de temps en temps à l'arrêt).
- Rien n'est encore piloté depuis Gladys : préconditionnement, charge et verrouillage sont affichés, pas commandés (voir Limites).
- La position GPS est désactivée par défaut ; vous l'activez dans la configuration.
Prérequis
- Une voiture du groupe Stellantis (Peugeot, Citroën, DS, Opel, Vauxhall) avec services connectés, déjà ajoutée dans l'application de la marque (MyPeugeot, MyCitroën, MyDS, MyOpel, MyVauxhall) et dont l'état s'y affiche.
- L'adresse e-mail et le mot de passe du compte de cette application.
- Aucun abonnement payant : l'intégration ne fait que lire l'état de la voiture, ce que l'application gratuite et les services connectés de base permettent (sur une électrique neuve, le pack Connect One est inclus plusieurs années). Les offres payantes (e-Remote Control, Remote Control, Connect Plus) ne servent qu'aux commandes à distance, que cette version ne fait pas.
- Un ordinateur avec Chrome, Edge, Firefox ou Safari pour la connexion (une fois, puis seulement si la session prend fin) : le code se lit dans les outils de développement du navigateur.
- Gladys 5.1 ou plus récent, avec accès à Internet.
Fiat, Jeep, Alfa Romeo et les autres marques du groupe passent par d'autres applications et un autre cloud : elles ne sont pas couvertes.
Configuration
Ouvrez Intégrations, trouvez Peugeot / Citroën / DS / Opel et ouvrez l'onglet Configuration.
1. Application et pays
| Réglage | Que choisir |
|---|---|
| Application de la voiture | L'application que vous utilisez : MyPeugeot, MyCitroën, MyDS, MyOpel ou MyVauxhall. |
| Pays du compte | Le pays choisi dans l'application. Vauxhall n'existe qu'au Royaume-Uni. |
| Langue des noms d'appareils | Langue des noms de fonctionnalités des nouveaux appareils (français par défaut). |
| Relevé | Fréquence de lecture du cloud : 10, 15 (par défaut), 30 ou 60 minutes. |
| Position GPS | Désactivée par défaut. Activée : la dernière position envoyée s'affiche, avec un bouton Carte. |
Enregistrez avant de vous connecter : la page de connexion dépend de l'application et du pays.
Connexion
La page de connexion des marques est faite pour leur application mobile : à la fin, elle remet un
code à l'application par une adresse que seule l'application ouvre (mymap://… pour MyPeugeot,
mymacsdk://… pour MyCitroën, mymdssdk://… pour MyDS, mymopsdk://… pour MyOpel,
mymvxsdk://… pour MyVauxhall). Sur un ordinateur, le navigateur ne sait pas l'ouvrir et semble ne
rien faire, mais l'adresse, avec le code, apparaît dans ses outils de développement. Vous la copiez
dans Gladys.
- Cliquez sur Connecter (champ « Compte de l'application ») : la page de connexion de la marque s'ouvre dans un nouvel onglet.
- Dans cet onglet, ouvrez les outils de développement avant de vous connecter :
F12, ouCtrl+Maj+I(Cmd+Option+Isur Mac). Choisissez l'onglet Console. - Connectez-vous avec l'adresse e-mail et le mot de passe de l'application, et acceptez si la page le demande.
- La page semble ne rien faire : c'est normal. Copiez la ligne de la console qui contient
code=(voir ci-dessous, navigateur par navigateur). - Dans les deux minutes (le code expire vite et ne sert qu'une fois), collez-la dans l'action Terminer la connexion en bas de la page de configuration, et cliquez dessus.
- L'action répond « Connecté : N véhicule(s) ». Ouvrez l'onglet Découverte et ajoutez vos voitures.
Gladys ne voit jamais votre mot de passe : il est saisi sur la page de la marque. Le code est échangé contre une session qui se renouvelle seule ; elle est conservée dans le stockage de l'intégration.
Chrome et Edge
Dans l'onglet Console, une ligne rouge apparaît après la connexion :
Failed to launch 'mymap://oauth2redirect/fr?code=…&scope=…' because the scheme does not have a registered handler.
Copiez toute la ligne, ou seulement l'adresse entre les apostrophes.
Pas de ligne ? Ouvrez l'onglet Network (Réseau), cochez Preserve log (Conserver le
journal), reconnectez-vous depuis l'étape 1, puis cliquez sur la dernière requête (statut 302, ou
celle en rouge nommée oauth2redirect…) et copiez l'adresse de son en-tête location, ou son URL.
Firefox
Dans la Console, Firefox écrit :
Prevented navigation to “mymap://oauth2redirect/fr?code=…” due to an unknown protocol. (ou son
équivalent en français). Copiez l'adresse entre les guillemets, ou toute la ligne. Si la console se
vide quand la page change, activez Journaux persistants dans ses paramètres (roue dentée) et
reconnectez-vous.
Safari
Activez d'abord les outils de développement : Safari → Réglages → Avancés → Afficher les
fonctionnalités pour les développeurs web. Puis, dans l'onglet de connexion, Développement →
Afficher l'inspecteur web, onglet Réseau, et cochez Conserver le journal. Après la
connexion, cliquez sur la dernière requête et copiez l'adresse mymap://… de son en-tête
Location. Safari affiche parfois aussi l'adresse dans un message d'erreur de la page.
Que coller
Au choix : toute la ligne de la console, l'adresse mymap://oauth2redirect/fr?code=…, ou le code
seul (ce qui suit code=, jusqu'au &). L'intégration en extrait le code.
Si l'action répond « Code refusé » : le code a déjà servi, a expiré, ou vient d'une autre application ou d'un autre pays que ceux enregistrés. Cliquez à nouveau sur Connecter et collez vite le nouveau code.
Les autres actions : Tester la connexion liste les voitures du compte (aucune n'est réveillée) ; Se déconnecter supprime la session enregistrée (les appareils restent dans Gladys, sans nouvelle valeur).
Appareils
Chaque voiture est un appareil nommé d'après son modèle et la fin de son VIN, par exemple
Peugeot e-208 (…0208) : le VIN complet n'apparaît jamais dans Gladys ni dans les journaux. Une
voiture reçoit les fonctionnalités que permettent sa motorisation et ses réponses :
| Fonctionnalité | Voitures | Valeur |
|---|---|---|
| Niveau de batterie | électriques, hybrides rech. | % |
| Autonomie électrique | électriques, hybrides rech. | km |
| État de la charge | électriques, hybrides rech. | en charge, véhicule connecté (charge terminée), suspendue (véhicule, en attente), suspendue (borne, échec), inactive (débranchée) |
| Branchée | électriques, hybrides rech. | oui / non |
| En charge | électriques, hybrides rech. | oui / non |
| Vitesse de charge | si la voiture l'envoie | km d'autonomie gagnés par heure (ce qu'affiche l'application ; le cloud ne donne pas de puissance en kW) |
| Temps de charge restant | si la voiture l'envoie | minutes (0 hors charge) |
| Niveau de carburant | thermiques, hybrides rech. | % |
| Autonomie carburant | thermiques, hybrides rech. | km |
| Autonomie totale | hybrides rechargeables | km, électrique plus carburant |
| Kilométrage | si la voiture l'envoie | km |
| Verrouillée | si la voiture l'envoie | verrouillée / déverrouillée (une porte déverrouillée compte comme déverrouillée) |
| Portière ou coffre ouvert | si la voiture l'envoie | oui / non |
| Préconditionnement | si la voiture l'envoie | en marche / arrêté |
| Température extérieure | si la voiture l'envoie | °C |
| Position GPS | si elle est activée | texte latitude, longitude |
Toutes les fonctionnalités sont en lecture seule. Une valeur qui ne change pas est renvoyée deux fois par jour, pour que Gladys la montre toujours comme récente. Une valeur que la voiture cesse d'envoyer garde son dernier état.
Widget
Ma voiture (Stellantis) montre une voiture : tuiles batterie (ou carburant) et autonomie, puis une liste avec la charge (avec sa vitesse et l'heure de fin prévue pendant la charge), les portes, le préconditionnement et l'heure du dernier relevé. Son bouton Actualiser relit le cloud (sans réveiller la voiture) ; un bouton Carte apparaît quand la position GPS est activée. Choisissez la voiture dans les réglages du widget.
Déclencheur de scène
Charge terminée se déclenche quand une voiture signale une charge complète après une charge en cours. Une charge arrêtée, en échec ou interrompue en débranchant ne le déclenche pas. Ses variables : le niveau de batterie (%) et l'autonomie électrique (km). Laissez le filtre de véhicule vide pour toutes les voitures.
Branchée, débranchée, batterie faible : utilisez les valeurs de l'appareil dans une scène (déclencheur « valeur d'un appareil », par exemple Niveau de batterie inférieur à 20 avec « seulement au franchissement du seuil ») : aucun déclencheur dédié n'est nécessaire.
Action de scène
Relire une voiture Stellantis lit tout de suite l'état que la voiture a envoyé au cloud, et donne aux actions suivantes son niveau de batterie, son niveau de carburant, son autonomie totale et ses valeurs branchée, en charge et verrouillée. Elle ne réveille pas la voiture.
Exemples de scènes
- Rappel de charge : chaque soir à 21 h, Relire une voiture Stellantis, puis si le niveau de batterie est inférieur à 30 % et que la voiture n'est pas branchée, envoyer « Pensez à brancher la voiture » à la famille.
- Charge terminée : déclencheur Charge terminée, envoyer « La voiture est chargée : {{triggerEvent.data.battery_level}} %, {{triggerEvent.data.range_km}} km ».
- Voiture restée ouverte : déclencheur Verrouillée passe à « déverrouillée », attendre 10 minutes, puis si elle l'est toujours, envoyer une notification.
Relevés et quotas
L'intégration lit le cloud avec son propre minuteur (un appel par voiture et par relevé, plus un renouvellement de la session environ une fois par heure), jamais par le sondage de Gladys. Stellantis ne publie aucun quota pour cette API ; l'intégration Home Assistant lit toutes les minutes sans problème connu. Si le cloud répond « trop de requêtes », les relevés s'arrêtent 30 minutes. Une panne du cloud est retentée après 1, 2, 5, 10 puis toutes les 15 minutes.
Dépannage
- « Pas connecté » : la connexion n'a pas été terminée. Suivez Connexion.
- « Code refusé » : le code sert une fois, deux minutes environ, pour l'application et le pays enregistrés. Cliquez à nouveau sur Connecter, puis collez vite.
- « Aucun code trouvé » : collez la ligne ou l'adresse qui contient
code=. - « L'application de cette marque n'existe pas dans ce pays » : choisissez le pays de votre compte (Vauxhall : Royaume-Uni).
- « La session Stellantis a pris fin » : la session a été refusée à son renouvellement (mot de passe changé, compte réinitialisé, long arrêt de Gladys). Reconnectez-vous ; les appareils et leur historique restent.
- Pas de ligne dans la console : les outils de développement ont été ouverts après la connexion. Ouvrez-les avant, ou passez par l'onglet Réseau avec « Conserver le journal », et reconnectez-vous.
- Une voiture n'a pas de valeur, ou de vieilles valeurs : l'application montre la même chose : la voiture envoie son état à l'arrêt du moteur, pendant la charge et de temps en temps ; une voiture inutilisée depuis des jours en envoie moins (sa batterie 12 V est protégée). Une voiture en mode confidentialité ne partage rien : le widget l'indique.
- Journaux : l'intégration n'écrit que son cycle de vie au niveau info. Réglez
LOG_LEVEL=debugpour voir chaque relevé. Jetons, codes, VIN et positions ne sont jamais écrits.
Limites
- Pas encore de commande à distance : le préconditionnement, le démarrage ou l'arrêt de la charge, la limite de charge, le verrouillage, le déverrouillage et le réveil de la voiture passent par un autre service Stellantis (MQTT) qui demande un enrôlement par code SMS et le code PIN de l'application. Les seules implémentations ouvertes de cet enrôlement sont sous licence GPL ; cette intégration, sous Apache 2.0, ne les recopie pas. Elles pourront venir dans une version suivante.
- Lecture de l'état du cloud seulement : pas de « réveiller et relire ». Les valeurs sont aussi récentes que le dernier message de la voiture.
- Connexion par copie d'un code : Stellantis ne donne pas d'accès à son API aux particuliers, l'intégration se connecte comme l'application de la marque ; si Stellantis change la connexion de l'application, l'intégration peut cesser de fonctionner jusqu'à sa mise à jour.
- Vitesse de charge en km/h : le cloud ne donne pas de puissance en kW.
- Développée et testée sans voiture ni compte, sur des réponses construites d'après l'intégration Home Assistant : merci de signaler ce que vous observez.
Crédits
- andreadegiovine/homeassistant-stellantis-vehicles (MIT) : la connexion de chaque application, les identifiants des applications par pays, les appels à l'API et le sens des champs.
- flobz/psa_car_controller (GPL-3.0) : lu pour comprendre l'API et ses commandes à distance ; rien n'en est recopié ici.
Paramètres de configuration
Voici les paramètres demandés par Peugeot / Citroën / DS / Opel dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Cette intégration se connecte à votre compte MyPeugeot, MyCitroën, MyDS, MyOpel ou MyVauxhall, comme l'application, et lit l'état que vos voitures ont envoyé au cloud Stellantis : elle ne les réveille jamais. Les commandes à distance (préconditionnement, charge, verrouillage) ne sont pas encore prises en charge. Développée sans voiture : retours bienvenus. Sans lien avec Stellantis ni ses marques. |
| Application de la voiture | select | Oui | L'application que vous utilisez pour votre voiture : le compte et la page de connexion en dépendent. |
| Pays du compte | select | Oui | Le pays choisi dans l'application : il détermine les identifiants de l'application. Vauxhall : Royaume-Uni seulement. |
| Connexion | section | Non | Sur un ordinateur : 1. Choisissez l'application et le pays ci-dessus, puis enregistrez. 2. Cliquez sur Connecter : la page de connexion de la marque s'ouvre dans un nouvel onglet. Dans cet onglet, ouvrez les outils de développement (F12, ou Cmd+Option+I sur Mac), onglet Console. 3. Connectez-vous avec l'adresse e-mail et le mot de passe de l'application. La page semble ensuite ne rien faire : c'est normal. 4. Dans la console, une ligne rouge cite une adresse qui commence par mymap:// (mymacsdk://, mymdssdk://, mymopsdk:// ou mymvxsdk:// pour les autres marques) et contient code=. Copiez cette adresse. 5. Dans les deux minutes, collez-la dans l'action « Terminer la connexion » en bas de cette page. Gladys ne voit jamais votre mot de passe. Le guide montre où trouver l'adresse dans chaque navigateur. |
| Compte de l'application | account_link | Non | |
| 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é | select | Non | Fréquence de lecture du cloud. Elle ne réveille jamais la voiture : elle obtient le dernier état envoyé par la voiture. |
| Position GPS | boolean | Non | Désactivée par défaut (vie privée). Activée : la dernière position envoyée par la voiture est affichée dans Gladys. |
Comment installer Peugeot / Citroën / DS / Opel dans Gladys
- Dans Gladys, ouvrez Intégrations : Peugeot / Citroën / DS / Opel 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-stellantis:1.0.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/guim31/gladys-stellantis.
Peugeot / Citroën / DS / Opel 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
Peugeot / Citroën / DS / Opel 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, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation