Zum Hauptinhalt springen

Nissan Connect Smart-Home-Integration, kostenlos und Open Source

Nissan Connect-Integration für Gladys Assistant

Akku, Reichweite, Laden und Klima deines Nissan-Elektroautos (Leaf, Ariya…).

Diese Integration bringt dein Nissan-Elektroauto über die Cloud NissanConnect Services in Gladys — derselbe Dienst wie die Nissan-App. Du siehst Akku, Reichweite, Ladevorgang und Klimatisierung, kannst die Klimatisierung oder das Laden starten und all das in Szenen und auf dem Dashboard verwenden.

Bevor du beginnst​

  • Gladys 5.3 oder neuer.
  • Ein NissanConnect-Services-Konto (Europa), mit deinem Auto in der App aktiviert. Wenn die App dein Auto und seinen Akku anzeigt, kann diese Integration das auch.
  • Die Integration arbeitet nur über die Nissan-Cloud: Sie spricht nie im lokalen Netzwerk mit dem Auto und braucht einen Internetzugang.

Nissan bietet keine öffentliche API. Die Integration spricht dieselbe Sprache wie die offizielle App, die Nissan ohne Vorankündigung ändern kann. Nicht jedes Modell beantwortet jede Anfrage: Ein LEAF zum Beispiel meldet keinen Verriegelungsstatus der Türen.

Konfiguration​

Öffne Integrationen → Nissan Connect → Konfiguration.

FeldWas einzutragen ist
NissanConnect-Anmeldung (E-Mail)Die E-Mail, mit der du dich in der NissanConnect-Services-App anmeldest.
NissanConnect-PasswortDas zugehörige Passwort. Gladys speichert es als Geheimnis; es wird nie in die Protokolle geschrieben.
Aktualisierungsintervall (s)Wie oft Gladys liest, was das Auto zuletzt an die Nissan-Cloud gesendet hat. Standard 900 (15 min), mindestens 300. Das weckt das Auto nicht auf.
Weckintervall des Autos (min)Wie oft das Auto selbst gebeten wird, frische Daten zu senden. Standard 0 = nur auf Anfrage. Jedes Wecken belastet die 12-V-Batterie: Wenn du es einschaltest, wähle einen großen Wert (zum Beispiel 240).
EntfernungseinheitKilometer oder Meilen, für Reichweite und Kilometerstand.
Klimatemperatur (°C)Innenraumtemperatur, wenn die Klimatisierung ohne Angabe gestartet wird (16 bis 30 °C).

Klicke dann auf Verbindung testen: Die Antwort listet die in deinem Konto gefundenen Autos auf.

Dein Auto hinzufügen​

Öffne Integrationen → Nissan Connect → Erkennung und lege das Auto an. Ein Gladys-Gerät pro Auto des Kontos, benannt nach dem in der App gewählten Spitznamen.

Wenn du die Entfernungseinheit später änderst, öffne Erkennung erneut und aktualisiere das Auto, damit Reichweite und Kilometerstand die neue Einheit zeigen.

Was das Auto-Gerät zeigt​

FunktionBeschreibungSteuerung
AkkuLadezustand in %.—
ReichweiteGeschätzte Reichweite in km oder Meilen.—
AngestecktOb das Ladekabel angeschlossen ist.—
LädtOb das Auto lädt.Starten / stoppen
KlimatisierungOb die Klimatisierung (Vorheizen / Vorkühlen) läuft.Starten / stoppen
KlimatemperaturGewünschte Temperatur für den nächsten Klimastart.16 bis 30 °C
InnenraumtemperaturTemperatur im Auto, wenn das Auto sie meldet.—
KilometerstandGesamtstrecke in km oder Meilen.—
VerriegeltOb die Türen verriegelt sind, wenn das Auto es meldet.—

Fernbefehle werden vom Auto etwas später ausgeführt: Gladys zeigt sofort den gewünschten Zustand und liest das Auto etwa 90 Sekunden später erneut, um ihn zu bestätigen.

Das Transport-Abzeichen des Geräts zeigt, wie frisch die Daten sind:

  • Cloud: Das letzte Lesen hat funktioniert.
  • Nicht erreichbar: Die Nissan-Cloud hat beim letzten Lesen nicht geantwortet.
  • Cloud mit orangem Punkt: Die Cloud antwortet, aber das Auto hat seit mehr als 24 Stunden nichts gesendet (Ruhezustand, Tiefgarage, kein Empfang). Nutze Ein Auto aufwecken.

Lesen oder aufwecken?​

  • Ein Lesen fragt die Nissan-Cloud, was das Auto zuletzt gemeldet hat. Es kostet nichts und geschieht bei jedem Aktualisierungsintervall.
  • Ein Wecken bittet das Auto selbst, frische Daten zu senden. Es läuft über das Mobilfunknetz und belastet die 12-V-Batterie. Die neuen Daten erreichen Gladys einige Minuten später.

Wecke das Auto mit dem Knopf Ein Auto aufwecken, dem Knopf Aktualisieren im Widget, der Szenenaktion Status eines Nissan lesen (mit „Auto zuerst aufwecken“) oder automatisch mit dem Weckintervall des Autos.

Knöpfe im Konfigurationsbildschirm​

  • Verbindung testen: meldet sich an und listet die Autos des Kontos auf.
  • Ein Auto aufwecken: bittet das gewählte Auto, frische Daten zu senden (Akku und Position).
  • Auto identifizieren (Lichter blinken): Das Auto lässt seine Lichter blinken, praktisch auf einem Parkplatz.

Szenen​

Auslöser​

  • Ein Nissan beginnt oder beendet das Laden — Filter: das Auto, das Ereignis (Laden gestartet, Laden beendet).
  • Ein Nissan wird angesteckt oder abgesteckt — Filter: das Auto, das Ereignis (angesteckt, abgesteckt).

Beide geben der Szene diese Variablen: den Namen des Autos, das Ereignis, den Akkustand (%) und die Reichweite. Sie werden beim nächsten Lesen des Autos erkannt, also mit einer Verzögerung von bis zum Aktualisierungsintervall, nicht auf die Sekunde genau. Beim ersten Lesen nach dem Start von Gladys lösen sie nie aus.

Für einen Schwellwert („Akku unter 20 %“) nutze den Standard-Auslöser Gerätezustand von Gladys auf der Funktion Akku.

Aktionen​

  • Klima eines Nissan starten oder stoppen — das Auto, starten oder stoppen, und eine optionale Temperatur. Ausgabe: Befehl angenommen.
  • Laden eines Nissan starten oder stoppen — das Auto muss angesteckt sein. Ausgabe: Befehl angenommen.
  • Status eines Nissan lesen — liest das Auto jetzt, auf Wunsch nach einem Wecken. Ausgaben: Akku (%), Reichweite, angesteckt, lädt — nutze sie in den nächsten Aktionen („wenn Akku < 30, schick mir eine Nachricht“).
  • Lichter eines Nissan blinken lassen — nur Lichter, oder Lichter und Hupe. Ausgabe: Befehl angenommen.

Eine Ablehnung durch Nissan stoppt die Szene nicht: Die Ausgabe Befehl angenommen ist dann falsch, und du kannst sie in einer Bedingung prüfen.

Beispiele:

  • Jeden Werktag um 7:40 die Klimatisierung starten auf 21 °C.
  • Wenn das Auto abgesteckt wird und sein Akku unter 50 % liegt, eine Nachricht senden.
  • Wenn das Auto das Laden beendet, den Status lesen und die Reichweite ansagen.

Dashboard-Widget​

Füge das Widget Nissan-Auto zu einem Dashboard hinzu. Einstellungen:

  • Auto: das anzuzeigende Auto (das erste des Kontos, wenn leer).
  • Kartenknopf anzeigen: fügt einen Knopf hinzu, der die letzte Position des Autos auf OpenStreetMap öffnet. Standardmäßig aus: Lass es aus auf einem Dashboard, das andere sehen.

Das Widget zeigt Akku und Reichweite live, ob das Auto angesteckt ist und lädt (mit der Restzeit), die Klimatisierung, die Türen und die Uhrzeit der letzten Fahrzeugdaten. Seine Knöpfe: Aktualisieren (weckt das Auto), Klima starten / stoppen, Laden starten / stoppen (nur wenn angesteckt) und die Karte. Die Klima- und Ladeknöpfe fragen nach einer Bestätigung.

Fehlerbehebung​

SymptomWas tun
„Nissan hat die Anmeldedaten oder das Passwort abgelehnt“Prüfe sie, indem du dich in der NissanConnect-Services-App anmeldest, und gib sie in Gladys erneut ein.
„Verbunden, aber dieses NissanConnect-Konto hat kein Auto“Aktiviere das Auto zuerst in der App, dann erneut Verbindung testen.
Die Werte ändern sich nieDas Auto hat nichts Neues gemeldet: Nutze Ein Auto aufwecken und warte einige Minuten.
Eine Funktion bleibt leer (Innenraum, verriegelt)Dein Modell meldet sie nicht an die Nissan-Cloud.
Ein Befehl wird abgelehntDas Auto schläft vielleicht, hat keinen Empfang oder unterstützt ihn nicht (Ladesteuerung bei manchen Modellen).
„NissanConnect Services nicht erreichbar“Die Nissan-Cloud ist gestört oder hat sich geändert: Versuche es später erneut und prüfe, ob es ein Update der Integration gibt.

Die Protokolle der Integration (Integrationen → Nissan Connect → Protokolle) enthalten nie dein Passwort oder deine Tokens; Fehlerzeilen nennen die Anfrage und die FIN des Autos.

Datenschutz​

  • Deine Anmeldedaten und dein Passwort werden nur an den Identitätsserver von Nissan gesendet, über HTTPS.
  • Die Zugriffstokens bleiben im Arbeitsspeicher, nie auf der Festplatte.
  • Die Position des Autos dient nur dem optionalen Kartenknopf des Widgets.
  • Die Integration verriegelt oder entriegelt nie die Türen und fragt nie nach der PIN des Autos.

Konfigurationseinstellungen​

Diese Einstellungen fragt Nissan Connect in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinDiese Integration nutzt die NissanConnect-Services-Cloud (Europa), dieselbe wie die mobile App: Gib die Anmeldedaten und das Passwort dieser App ein. Dein Auto muss zuerst in der App aktiviert sein. Nissan bietet keine öffentliche API: Die Integration spricht die Sprache der App, die Nissan ohne Vorankündigung ändern kann.
NissanConnect-Anmeldung (E-Mail)stringJaDie E-Mail-Adresse, mit der du dich in der NissanConnect-Services-App anmeldest.
NissanConnect-PasswortsecretJaVon Gladys als Geheimnis gespeichert, nie in die Protokolle geschrieben.
Aktualisierungsintervall (s)numberNeinWie oft Gladys in Sekunden liest, was dein Auto zuletzt an die Nissan-Cloud gesendet hat. Das weckt das Auto nicht auf.
Weckintervall des Autos (min)numberNeinAlle wie viele Minuten das Auto selbst gebeten wird, frische Daten zu senden. Jedes Wecken belastet die 12-V-Batterie: Lass 0 (nur auf Anfrage) oder einen großen Wert wie 240.
EntfernungseinheitselectNeinEinheit der Reichweite und des Kilometerstands. Eine spätere Änderung erfordert ein Update des Autos im Bildschirm Erkennung.
Klimatemperatur (°C)numberNeinInnenraumtemperatur, wenn die Klimatisierung ohne Angabe gestartet wird (16 bis 30 °C).

So installierst du Nissan Connect in Gladys​

  1. Öffne in Gladys Integrationen: Nissan Connect erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-nissanconnect:0.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-nissanconnect.

Nissan Connect benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Nissan Connect ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂