Intégration domotique Renault / Dacia, gratuite et open source
Voitures électriques et hybrides Renault et Dacia : batterie, charge, préconditionnement.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez vos voitures électriques et hybrides rechargeables Renault et Dacia dans Gladys : batterie, autonomie, charge, préconditionnement, kilométrage, et la position si vous le souhaitez. L'intégration utilise le cloud des applications MY Renault / MY Dacia, comme l'application officielle et l'intégration Home Assistant.
Sans lien avec Renault ou Dacia. Développée sans le matériel : vos retours sont les bienvenus.
Prérequis
- Gladys 5.1.0 ou plus récent.
- Une voiture liée à un compte MY Renault ou MY Dacia, visible dans l'application officielle, avec ses services connectés actifs : Zoe, Megane E-Tech, Scenic E-Tech, Renault 5, Renault 4, Twingo Electric, Master E-Tech, Dacia Spring, Captur et Megane hybrides rechargeables… Les voitures hybrides et essence du compte apparaissent aussi, avec ce que le cloud donne pour elles (kilométrage, autonomie carburant).
- L'adresse e-mail et le mot de passe du compte.
Configuration
Dans Gladys, Intégrations → Renault / Dacia → Configuration :
| Champ | Quoi saisir |
|---|---|
| Pays du compte | Le pays et la langue de votre application (ex. « France — Français »). Ils déterminent les serveurs du compte. |
| Adresse e-mail | L'adresse e-mail du compte. |
| Mot de passe | Son mot de passe. Il sert uniquement à se connecter : la session ouverte est ensuite conservée dans le stockage de l'intégration. |
| Compte (facultatif) | Vide : les voitures de tous les comptes de la personne. Pour n'en garder qu'un, saisissez l'identifiant donné par « Tester la connexion ». |
| Langue des noms d'appareils | La langue des noms de fonctionnalités (français par défaut). Gladys garde un nom une fois l'appareil créé. |
| Relevé | Fréquence de lecture du cloud : toutes les 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 par la voiture est lue et affichée. |
Enregistrez, puis cliquez sur Tester la connexion : le résultat liste les voitures du compte, ou dit en rouge ce qui ne va pas. Ouvrez ensuite l'onglet Découverte et ajoutez vos voitures.
Vérification en deux étapes
Certains comptes demandent un code envoyé par e-mail à chaque nouvelle connexion. La page de configuration affiche alors « Votre compte demande un code envoyé par e-mail » :
- cliquez sur Envoyer le code de vérification : le résultat indique l'adresse (masquée) à laquelle il est parti ;
- dans les minutes qui suivent, cliquez sur Saisir le code et tapez le code de l'e-mail.
L'installation est ensuite reconnue par le compte pendant 30 jours environ, et la session est conservée : aucun code n'est demandé à chaque redémarrage. Un code faux peut être saisi à nouveau ; un code trop ancien demande un nouvel Envoyer le code de vérification.
Appareils
Un appareil par voiture, nommé d'après le modèle et l'immatriculation (ex. « Renault Zoe (AB-123-CD) »). Chaque voiture reçoit les fonctionnalités que son modèle propose :
| Fonctionnalité | Signification |
|---|---|
| Niveau de batterie | État de charge, en %. |
| Autonomie | Autonomie électrique estimée par la voiture, en km. |
| État de la charge | En charge, branchée, en attente de la borne, débranchée (états de borne de recharge de Gladys). |
| Branchée | 1 quand un câble est branché. |
| Charge | 1 pendant la charge. Une commande sur les modèles dont l'application peut lancer la charge (et l'arrêter sur certains). |
| Puissance de charge | En kW, pendant la charge (modèles qui la donnent). |
| Temps de charge restant | En minutes, pendant la charge (modèles qui le donnent). |
| Température de la batterie | En °C (modèles qui la donnent). |
| Mode de charge | Charge immédiate ou programmée, une commande (modèles qui le proposent, ex. Zoe, Captur et Megane hybrides rechargeables). |
| Préconditionnement | 1 pendant que la voiture chauffe ou rafraîchit l'habitacle. Une commande : marche le lance, arrêt l'arrête. |
| Température de préconditionnement | La température envoyée avec le prochain préconditionnement (15 à 25 °C, 21 °C par défaut), conservée par l'intégration. |
| Température extérieure / intérieure | En °C (modèles qui la donnent). |
| Kilométrage | En km. |
| Autonomie carburant | En km (hybrides). |
| Verrouillée / portière ou coffre ouvert | Les rares modèles qui donnent leurs serrures (pas de verrouillage à distance : le cloud ne le propose pas). |
| Position GPS | « latitude, longitude », seulement quand la position GPS est activée. |
Une commande acceptée par le cloud n'est pas une commande exécutée par la voiture. La voiture l'exécute de son côté, souvent une ou deux minutes plus tard. L'intégration garde la valeur demandée dix minutes au plus, relit la voiture deux et six minutes après la commande, puis publie ce que la voiture indique. Si la voiture ne l'indique jamais, l'état réel revient et le widget affiche « Pas signalée par la voiture ».
Lancer une charge sur la Renault 5, la Renault 4, les Scenic, Megane et Master E-Tech et l'Alpine A290 désactive les programmes de charge, comme le fait l'application officielle : réactivez-les dans l'application si vous les utilisez. Ces modèles ne peuvent pas arrêter une charge à distance : arrêtez-la depuis la borne ou la voiture.
Widget
Ma Renault / Dacia (choisissez le véhicule dans ses réglages) : batterie et autonomie, une liste d'états (charge, mode de charge, préconditionnement, serrures, dernier relevé) et jusqu'à quatre boutons, libellés selon ce que fait un appui maintenant : préconditionner (demande confirmation) ou l'arrêter, lancer ou arrêter la charge, charger maintenant ou revenir à la charge programmée, actualiser. Une commande affiche « Demandé, en attente de la voiture » jusqu'à ce que la voiture l'indique.
Déclencheur de scène
Charge terminée : la voiture a cessé de charger en restant branchée (charge complète, ou arrêtée par la voiture ou la borne). Filtre facultatif : le véhicule. Variables : niveau de batterie (%) et autonomie (km). Une charge arrêtée depuis Gladys ne le déclenche pas.
Branchée, débranchée, batterie sous un seuil : utilisez les fonctionnalités de l'appareil dans un déclencheur « changement d'état d'un appareil », elles le font déjà.
Actions de scène
- Actualiser une Renault / Dacia : lit maintenant l'état que la voiture a envoyé au cloud (sans la réveiller), et donne le niveau de batterie, l'autonomie, branchée et en charge aux actions suivantes.
- Préconditionner une Renault / Dacia : lance le préconditionnement à la température de l'action (15 à 25 °C ; vide : la température de préconditionnement du véhicule). Sortie : la température envoyée.
La charge (Charge) et le mode de charge sont des fonctionnalités de l'appareil : une scène les règle avec « Contrôler un appareil ».
Exemples de scènes
- Voiture tiède à 7 h 30 en semaine : à 7 h 15, du lundi au vendredi, « Préconditionner une Renault / Dacia » à 21 °C.
- Charger en heures creuses : à 22 h, si Branchée vaut 1, mettre le Mode de charge sur Immédiate ; à 6 h, le remettre sur Programmée. Ou avec une condition Tempo : Programmée les jours rouges.
- Penser à brancher : à 20 h, « Actualiser une Renault / Dacia », puis si la sortie niveau de batterie est sous 30 et branchée est faux, envoyer le message « Pense à brancher la voiture ».
- Charge terminée : envoyer le message « La Zoe est chargée ({{triggerEvent.data.battery_level}} %) ».
Relevés et quota du cloud
L'intégration lit le cloud avec son propre minuteur (elle ne dépend pas de l'interrogation par Gladys). Chaque lecture renvoie l'état que la voiture a envoyé en dernier au cloud : elle ne réveille jamais la voiture. Une voiture envoie son état quand on l'éteint, pendant la charge et après une commande ; garée et endormie, elle peut rester des heures sans nouvelles, quel que soit le relevé choisi.
Une lecture coûte un appel par point d'accès que la voiture propose (batterie, kilométrage, climatisation, mode de charge, serrures, position : 1 à 6). Comme Home Assistant, l'intégration reste sous 60 appels par heure et par compte : avec plusieurs voitures, les lectures s'espacent au-delà du relevé choisi s'il le faut. Quand le cloud répond « quota atteint », les lectures s'arrêtent 15 minutes. Une valeur qui ne change pas est renvoyée à Gladys toutes les 12 heures, pour ne jamais paraître périmée.
Vie privée et données conservées
- Le mot de passe reste dans la configuration de Gladys ; il sert uniquement à se connecter.
- La session (jeton de connexion, identifiant du compte, identifiants de cette installation après
une vérification en deux étapes) et les températures de préconditionnement sont conservées dans le
volume
/datade l'intégration, fichier lisible par l'intégration seule. Rien de tout cela, ni l'adresse e-mail, n'apparaît dans les journaux. - La position GPS est désactivée par défaut ; désactivée, elle n'est jamais lue.
- L'intégration ne parle qu'au cloud Renault (Gigya pour la connexion, Kamereon pour les voitures).
Dépannage
- « Le compte a refusé la connexion » : vérifiez le pays, l'adresse e-mail et le mot de passe (ceux de l'application), puis enregistrez. L'intégration ne réessaie pas d'elle-même, pour ne pas bloquer le compte.
- « Votre compte demande un code envoyé par e-mail » : voir Vérification en deux étapes.
- « Le service de connexion refuse pour le moment » : trop de tentatives ; patientez quelques heures, puis enregistrez à nouveau.
- Une voiture manque : vérifiez qu'elle apparaît dans l'application officielle avec le même compte et le même pays ; avec plusieurs comptes, videz le champ Compte.
- Une fonctionnalité manque : le modèle ne la propose pas, ou n'a jamais envoyé la valeur. Le cloud répond « interdit » ou « introuvable » pour ce qu'un modèle n'a pas ; ce point d'accès n'est alors plus lu.
- « Le mode confidentialité de la voiture est activé » : désactivez-le dans la voiture.
- Valeurs anciennes : la voiture n'a pas envoyé son état depuis (endormie, pas de réseau là où elle est garée). La ligne « Dernier relevé » du widget donne la date du dernier état.
- Plus de détails : mettez
LOG_LEVEL=debugsur le conteneur.
Limites
- Développée sans voiture ni compte, à partir du protocole et des vraies réponses rassemblées par
renault-api: vos retours sont les bienvenus sur le forum ou dans les issues. - Pas de verrouillage, de klaxon ni d'appel de phares à distance : le cloud ne propose pas le verrouillage, et klaxon et phares ont été laissés de côté (un bouton de tableau de bord s'appuie vite par erreur).
- Pas de modification des programmes de charge, pas de limite de charge, pas d'historique des charges.
- Les commandes passent par le cloud Renault : quand il est en panne, rien ne marche, et il peut changer sans prévenir.
- La position est publiée en texte ; pas de distance au domicile.
Crédits
Le protocole, la table des points d'accès par modèle et les fixtures de test viennent de
hacf-fr/renault-api (MIT), la bibliothèque de
l'intégration Home Assistant renault, dont le comportement (quota, points d'accès refusés selon le
modèle) a été suivi.
Paramètres de configuration
Voici les paramètres demandés par Renault / Dacia dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Cette intégration se connecte à votre compte MY Renault ou MY Dacia, comme l'application officielle, et lit l'état que vos voitures ont envoyé au cloud (elle ne les réveille jamais). Si votre compte demande un code envoyé par e-mail : enregistrez, cliquez sur « Envoyer le code de vérification », puis « Saisir le code ». Sans lien avec Renault ou Dacia. |
| Pays du compte | select | Oui | Le pays et la langue de votre application MY Renault / MY Dacia : ils déterminent les serveurs du compte. |
| Adresse e-mail | string | Oui | L'adresse e-mail de votre compte MY Renault ou MY Dacia. |
| Mot de passe | secret | Oui | Sert uniquement à se connecter : la session ouverte est ensuite conservée dans le stockage de l'intégration. |
| Compte (facultatif) | string | Non | Vide : les voitures de tous les comptes de la personne. Pour n'en garder qu'un, saisissez l'identifiant donné par « Tester la connexion ». |
| 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 ; plusieurs voitures l'allongent pour rester dans le quota du cloud. |
| 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 lue et affichée dans Gladys. |
Comment installer Renault / Dacia dans Gladys
- Dans Gladys, ouvrez Intégrations : Renault / Dacia 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-renault: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-renault.
Renault / Dacia 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
Renault / Dacia 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