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

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.
| Feld | Was einzutragen ist |
|---|---|
| NissanConnect-Anmeldung (E-Mail) | Die E-Mail, mit der du dich in der NissanConnect-Services-App anmeldest. |
| NissanConnect-Passwort | Das 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). |
| Entfernungseinheit | Kilometer 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
| Funktion | Beschreibung | Steuerung |
|---|---|---|
| Akku | Ladezustand in %. | — |
| Reichweite | Geschätzte Reichweite in km oder Meilen. | — |
| Angesteckt | Ob das Ladekabel angeschlossen ist. | — |
| Lädt | Ob das Auto lädt. | Starten / stoppen |
| Klimatisierung | Ob die Klimatisierung (Vorheizen / Vorkühlen) läuft. | Starten / stoppen |
| Klimatemperatur | Gewünschte Temperatur für den nächsten Klimastart. | 16 bis 30 °C |
| Innenraumtemperatur | Temperatur im Auto, wenn das Auto sie meldet. | — |
| Kilometerstand | Gesamtstrecke in km oder Meilen. | — |
| Verriegelt | Ob 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
| Symptom | Was 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 nie | Das 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 abgelehnt | Das 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.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Diese 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) | string | Ja | Die E-Mail-Adresse, mit der du dich in der NissanConnect-Services-App anmeldest. |
| NissanConnect-Passwort | secret | Ja | Von Gladys als Geheimnis gespeichert, nie in die Protokolle geschrieben. |
| Aktualisierungsintervall (s) | number | Nein | Wie 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) | number | Nein | Alle 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. |
| Entfernungseinheit | select | Nein | Einheit der Reichweite und des Kilometerstands. Eine spätere Änderung erfordert ein Update des Autos im Bildschirm Erkennung. |
| Klimatemperatur (°C) | number | Nein | Innenraumtemperatur, wenn die Klimatisierung ohne Angabe gestartet wird (16 bis 30 °C). |
So installierst du Nissan Connect in Gladys
- Öffne in Gladys Integrationen: Nissan Connect erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- 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). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- 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.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation