Aller au contenu principal

Intégration domotique Nissan Connect, gratuite et open source

Intégration Nissan Connect pour Gladys Assistant

Batterie, autonomie, charge et clim de votre Nissan électrique (Leaf, Ariya…).

Cette intégration amène votre voiture électrique Nissan dans Gladys via le cloud NissanConnect Services — le même service que l’application mobile Nissan. Vous voyez la batterie, l’autonomie, la charge et la climatisation, vous pouvez lancer la clim ou la charge, et utiliser tout cela dans les scènes et sur le tableau de bord.

Avant de commencer​

  • Gladys 5.3 ou plus récent.
  • Un compte NissanConnect Services (Europe), avec votre voiture activée dans l’application mobile. Si l’application affiche votre voiture et sa batterie, cette intégration le peut aussi.
  • L’intégration passe uniquement par le cloud Nissan : elle ne parle jamais à la voiture sur votre réseau local, et elle a besoin d’un accès à internet.

Nissan ne propose pas d’API publique. L’intégration parle le même langage que l’application officielle, que Nissan peut changer sans prévenir. Tous les modèles ne répondent pas à toutes les demandes : une LEAF, par exemple, ne donne pas l’état du verrouillage des portes.

Configuration​

Ouvrez Intégrations → Nissan Connect → Configuration.

ChampCe qu’il faut mettre
Identifiant NissanConnect (e-mail)L’e-mail avec lequel vous vous connectez à l’application NissanConnect Services.
Mot de passe NissanConnectSon mot de passe. Gladys le garde comme un secret ; il n’est jamais écrit dans les journaux.
Intervalle de rafraîchissement (s)Fréquence à laquelle Gladys lit ce que la voiture a envoyé en dernier au cloud Nissan. Par défaut 900 (15 min), minimum 300. Cela ne réveille pas la voiture.
Intervalle de réveil de la voiture (min)Fréquence à laquelle on demande à la voiture elle-même d’envoyer des données fraîches. Par défaut 0 = seulement à la demande. Chaque réveil puise dans la batterie 12 V : si vous l’activez, choisissez une grande valeur (par exemple 240).
Unité de distanceKilomètres ou miles, pour l’autonomie et le compteur.
Température de la clim (°C)Température de l’habitacle utilisée quand la clim est lancée sans en préciser une (16 à 30 °C).

Cliquez ensuite sur Tester la connexion : la réponse liste les voitures trouvées dans votre compte.

Ajouter votre voiture​

Ouvrez Intégrations → Nissan Connect → Découverte et créez la voiture. Un appareil Gladys par voiture du compte, nommé d’après le surnom choisi dans l’application.

Si vous changez plus tard l’unité de distance, rouvrez Découverte et mettez la voiture à jour, pour que son autonomie et son compteur affichent la nouvelle unité.

Ce que montre l’appareil voiture​

FonctionnalitéDescriptionCommande
BatterieNiveau de charge, en %.—
AutonomieAutonomie estimée, en km ou en miles.—
BranchéeLe câble de charge est-il branché.—
En chargeLa voiture charge-t-elle.Lancer / arrêter
ClimatisationLa clim (préchauffage / prérefroidissement) tourne-t-elle.Lancer / arrêter
Température de la climTempérature demandée au prochain lancement de la clim.16 à 30 °C
Température de l’habitacleTempérature dans la voiture, quand la voiture la donne.—
CompteurDistance totale, en km ou en miles.—
VerrouilléeLes portes sont-elles verrouillées, quand la voiture le donne.—

Les commandes à distance sont exécutées par la voiture un peu plus tard : Gladys affiche tout de suite l’état demandé, puis relit la voiture environ 90 secondes après pour le confirmer.

Le badge de transport de l’appareil indique la fraîcheur des données :

  • Cloud : la dernière lecture a fonctionné.
  • Injoignable : le cloud Nissan n’a pas répondu à la dernière lecture.
  • Cloud avec un point orange : le cloud répond, mais la voiture n’a rien envoyé depuis plus de 24 heures (en veille, garée en sous-sol, hors couverture). Utilisez Réveiller une voiture.

Lire ou réveiller ?​

  • Une lecture demande au cloud Nissan ce que la voiture a signalé en dernier. Elle ne coûte rien et a lieu à chaque intervalle de rafraîchissement.
  • Un réveil demande à la voiture elle-même d’envoyer des données fraîches. Il passe par le réseau mobile et puise dans la batterie 12 V. Les nouvelles données arrivent dans Gladys quelques minutes plus tard.

Réveillez la voiture avec le bouton Réveiller une voiture, le bouton Actualiser du widget, l’action de scène Lire l’état d’une Nissan (avec « Réveiller la voiture d’abord »), ou automatiquement avec l’intervalle de réveil de la voiture.

Boutons de l’écran de configuration​

  • Tester la connexion : se connecte et liste les voitures du compte.
  • Réveiller une voiture : demande à la voiture choisie d’envoyer des données fraîches (batterie et position).
  • Identifier une voiture (feux clignotants) : la voiture fait clignoter ses feux, pratique sur un parking.

Scènes​

Déclencheurs​

  • Une Nissan commence ou arrête de charger — filtres : la voiture, l’événement (charge démarrée, charge arrêtée).
  • Une Nissan est branchée ou débranchée — filtres : la voiture, l’événement (branchée, débranchée).

Les deux donnent à la scène ces variables : le nom de la voiture, l’événement, le niveau de batterie (%) et l’autonomie. Ils sont vus à la lecture suivante de la voiture, donc avec un retard pouvant aller jusqu’à l’intervalle de rafraîchissement, pas à la seconde près. Ils ne se déclenchent jamais à la première lecture après le démarrage de Gladys.

Pour un seuil (« batterie sous 20 % »), utilisez le déclencheur standard état d’un appareil de Gladys sur la fonctionnalité Batterie.

Actions​

  • Lancer ou arrêter la clim d’une Nissan — la voiture, lancer ou arrêter, et une température facultative. Sortie : ordre accepté.
  • Lancer ou arrêter la charge d’une Nissan — la voiture doit être branchée. Sortie : ordre accepté.
  • Lire l’état d’une Nissan — lit la voiture maintenant, en la réveillant d’abord si vous le voulez. Sorties : batterie (%), autonomie, branchée, en charge — utilisez-les dans les actions suivantes (« si batterie < 30, envoie-moi un message »).
  • Faire clignoter les feux d’une Nissan — feux seuls, ou feux et klaxon. Sortie : ordre accepté.

Un refus de Nissan n’arrête pas la scène : la sortie ordre accepté vaut alors faux, et vous pouvez la tester dans une condition.

Exemples :

  • Chaque jour de semaine à 7 h 40, lancer la clim à 21 °C.
  • Quand la voiture est débranchée et que sa batterie est sous 50 %, envoyer un message.
  • Quand la voiture arrête de charger, lire l’état et annoncer l’autonomie.

Widget du tableau de bord​

Ajoutez le widget Voiture Nissan à un tableau de bord. Réglages :

  • Voiture : la voiture à afficher (la première du compte si laissé vide).
  • Afficher le bouton carte : ajoute un bouton qui ouvre la dernière position de la voiture sur OpenStreetMap. Désactivé par défaut : laissez-le désactivé sur un tableau de bord visible par d’autres.

Le widget affiche la batterie et l’autonomie en direct, si la voiture est branchée et en charge (avec le temps restant), la clim, les portes et l’heure des dernières données de la voiture. Ses boutons : Actualiser (réveille la voiture), Lancer / Arrêter la clim, Lancer / Arrêter la charge (seulement si branchée), et la carte. Les boutons de clim et de charge demandent une confirmation.

Dépannage​

SymptômeQue faire
« Nissan a refusé l’identifiant ou le mot de passe »Vérifiez-les en vous connectant à l’application NissanConnect Services, puis retapez-les dans Gladys.
« Connecté, mais ce compte NissanConnect n’a aucune voiture »Activez d’abord la voiture dans l’application mobile, puis Tester la connexion à nouveau.
Les valeurs ne changent jamaisLa voiture n’a rien signalé de nouveau : utilisez Réveiller une voiture, puis attendez quelques minutes.
Une fonctionnalité reste vide (habitacle, verrouillée)Votre modèle ne la transmet pas au cloud Nissan.
Une commande est refuséeLa voiture est peut-être en veille, hors couverture, ou ne la prend pas en charge (commande de charge sur certains modèles).
« NissanConnect Services injoignable »Le cloud Nissan est en panne ou a changé : réessayez plus tard, et vérifiez s’il existe une mise à jour de l’intégration.

Les journaux de l’intégration (Intégrations → Nissan Connect → Journaux) ne contiennent jamais votre mot de passe ni vos jetons ; les lignes d’erreur nomment la requête et le VIN de la voiture.

Vie privée​

  • Votre identifiant et votre mot de passe ne sont envoyés qu’au serveur d’identité de Nissan, en HTTPS.
  • Les jetons d’accès restent en mémoire, jamais sur disque.
  • La position de la voiture ne sert qu’au bouton carte facultatif du widget.
  • L’intégration ne verrouille ni ne déverrouille jamais les portes et ne demande jamais le code PIN de la voiture.

Paramètres de configuration​

Voici les paramètres demandés par Nissan Connect dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonCette intégration passe par le cloud NissanConnect Services (Europe), le même que l’application mobile : renseignez l’identifiant et le mot de passe de cette application. Votre voiture doit d’abord être activée dans l’application. Nissan ne propose pas d’API publique : l’intégration parle le langage de l’application, que Nissan peut changer sans prévenir.
Identifiant NissanConnect (e-mail)stringOuiL’adresse e-mail avec laquelle vous vous connectez à l’application NissanConnect Services.
Mot de passe NissanConnectsecretOuiConservé par Gladys comme un secret, jamais écrit dans les journaux.
Intervalle de rafraîchissement (s)numberNonFréquence, en secondes, à laquelle Gladys lit ce que votre voiture a envoyé en dernier au cloud Nissan. Cela ne réveille pas la voiture.
Intervalle de réveil de la voiture (min)numberNonToutes les combien de minutes on demande à la voiture elle-même d’envoyer des données fraîches. Chaque réveil puise dans la batterie 12 V : gardez 0 (seulement à la demande) ou une grande valeur comme 240.
Unité de distanceselectNonUnité de l’autonomie et du compteur. La changer ensuite demande de mettre à jour la voiture depuis l’écran Découverte.
Température de la clim (°C)numberNonTempérature de l’habitacle demandée quand la clim est lancée sans en préciser une (16 à 30 °C).

Comment installer Nissan Connect dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Nissan Connect apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-nissanconnect:0.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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-nissanconnect.

Nissan Connect nécessite Gladys >=5.3.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​

Nissan Connect 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 prohand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂