Renault / Dacia Smart-Home-Integration, kostenlos und Open Source
Elektro- und Plug-in-Hybridautos von Renault und Dacia: Batterie, Laden, Vorklimatisierung.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge deine Elektro- und Plug-in-Hybridautos von Renault und Dacia in Gladys: Batterie, Reichweite, Laden, Vorklimatisierung, Kilometerstand und, wenn du willst, die Position. Die Integration nutzt die Cloud der Apps MY Renault / MY Dacia, wie die offizielle App und die Home-Assistant-Integration.
Nicht mit Renault oder Dacia verbunden. Ohne die Hardware entwickelt: Rückmeldungen willkommen.
Voraussetzungen
- Gladys 5.1.0 oder neuer.
- Ein Auto, das mit einem MY-Renault- oder MY-Dacia-Konto verbunden ist, in der offiziellen App sichtbar und mit aktiven Online-Diensten: Zoe, Megane E-Tech, Scenic E-Tech, Renault 5, Renault 4, Twingo Electric, Master E-Tech, Dacia Spring, Captur und Megane als Plug-in-Hybrid… Hybrid- und Benzinautos des Kontos erscheinen auch, mit dem, was die Cloud für sie liefert (Kilometerstand, Kraftstoffreichweite).
- Die E-Mail-Adresse und das Passwort des Kontos.
Konfiguration
In Gladys Integrationen → Renault / Dacia → Konfiguration:
| Feld | Was du einträgst |
|---|---|
| Land des Kontos | Land und Sprache deiner App (z. B. „Deutschland — Deutsch“). Davon hängen die Server des Kontos ab. |
| E-Mail-Adresse | Die E-Mail-Adresse des Kontos. |
| Passwort | Sein Passwort. Es dient nur zur Anmeldung: Die geöffnete Sitzung wird danach im Speicher der Integration aufbewahrt. |
| Konto (optional) | Leer: die Autos aller Konten der Person. Um nur ein Konto zu nutzen, gib die von „Verbindung testen“ angezeigte ID ein. |
| Sprache der Gerätenamen | Die Sprache der Funktionsnamen (standardmäßig Französisch). Gladys behält einen Namen, sobald das Gerät erstellt ist. |
| Abfrage | Wie oft die Cloud gelesen wird: alle 10, 15 (Standard), 30 oder 60 Minuten. |
| GPS-Position | Standardmäßig aus. An: Die zuletzt vom Auto gesendete Position wird gelesen und angezeigt. |
Speichere und klicke dann auf Verbindung testen: Das Ergebnis listet die Autos des Kontos auf oder sagt in Rot, was nicht stimmt. Öffne dann den Reiter Entdecken und füge deine Autos hinzu.
Zwei-Schritt-Bestätigung
Manche Konten verlangen bei jeder neuen Anmeldung einen per E-Mail gesendeten Code. Die Konfigurationsseite zeigt dann „Dein Konto verlangt einen per E-Mail gesendeten Code“:
- Klicke auf Bestätigungscode senden: Das Ergebnis zeigt die (maskierte) Adresse, an die er ging;
- klicke in den nächsten Minuten auf Code eingeben und tippe den Code aus der E-Mail ein.
Die Installation wird danach etwa 30 Tage lang vom Konto wiedererkannt, und die Sitzung bleibt erhalten: Bei einem Neustart wird kein Code verlangt. Einen falschen Code kannst du erneut eingeben; ein zu alter Code braucht ein neues Bestätigungscode senden.
Geräte
Ein Gerät pro Auto, benannt nach Modell und Kennzeichen (z. B. „Renault Zoe (AB-123-CD)“). Jedes Auto bekommt die Funktionen, die sein Modell bietet:
| Funktion | Bedeutung |
|---|---|
| Batteriestand | Ladezustand in %. |
| Reichweite | Vom Auto geschätzte elektrische Reichweite in km. |
| Ladezustand | Lädt, angeschlossen, wartet auf die Ladestation, nicht angeschlossen (Ladestationszustände von Gladys). |
| Angeschlossen | 1, wenn ein Kabel steckt. |
| Laden | 1, solange das Auto lädt. Ein Befehl bei den Modellen, deren App das Laden starten kann (und bei manchen stoppen). |
| Ladeleistung | In kW, während des Ladens (Modelle, die sie melden). |
| Verbleibende Ladezeit | In Minuten, während des Ladens (Modelle, die sie melden). |
| Batterietemperatur | In °C (Modelle, die sie melden). |
| Lademodus | Sofortiges oder geplantes Laden, ein Befehl (Modelle, die ihn anbieten, z. B. Zoe, Captur und Megane als Plug-in-Hybrid). |
| Vorklimatisierung | 1, solange das Auto den Innenraum heizt oder kühlt. Ein Befehl: An startet sie, Aus stoppt sie. |
| Vorklimatisierungstemperatur | Die mit der nächsten Vorklimatisierung gesendete Temperatur (15 bis 25 °C, standardmäßig 21 °C), von der Integration gespeichert. |
| Außen- / Innentemperatur | In °C (Modelle, die sie melden). |
| Kilometerstand | In km. |
| Kraftstoffreichweite | In km (Hybride). |
| Verriegelt / Tür oder Heckklappe offen | Die wenigen Modelle, die ihre Schlösser melden (kein Verriegeln aus der Ferne: Die Cloud bietet es nicht an). |
| GPS-Position | „Breitengrad, Längengrad“, nur wenn die GPS-Position eingeschaltet ist. |
Ein von der Cloud angenommener Befehl ist kein vom Auto ausgeführter Befehl. Das Auto führt ihn selbst aus, oft ein oder zwei Minuten später. Die Integration hält den angefragten Wert höchstens zehn Minuten, liest das Auto zwei und sechs Minuten nach dem Befehl erneut und veröffentlicht dann, was das Auto meldet. Meldet das Auto ihn nie, kommt der echte Zustand zurück, und das Widget zeigt „Vom Auto nicht gemeldet“.
Das Starten des Ladens beim Renault 5, Renault 4, Scenic, Megane und Master E-Tech und beim Alpine A290 schaltet die Ladeprogramme aus, wie es die offizielle App tut: Schalte sie in der App wieder ein, wenn du sie nutzt. Diese Modelle können das Laden nicht aus der Ferne stoppen: Stoppe es an der Ladestation oder im Auto.
Widget
Renault / Dacia (wähle das Fahrzeug in seinen Einstellungen): Batterie und Reichweite, eine Statusliste (Laden, Lademodus, Vorklimatisierung, Schlösser, letzte Meldung) und bis zu vier Tasten, beschriftet mit dem, was ein Tippen jetzt bewirkt: vorklimatisieren (mit Rückfrage) oder stoppen, Laden starten oder stoppen, jetzt laden oder den Zeitplan nutzen, aktualisieren. Ein Befehl zeigt „Angefragt, wartet auf das Auto“, bis das Auto ihn meldet.
Szenen-Auslöser
Laden beendet: Das Auto hat aufgehört zu laden und ist noch angeschlossen (voll oder vom Auto oder der Ladestation gestoppt). Optionaler Filter: das Fahrzeug. Variablen: Batteriestand (%) und Reichweite (km). Ein aus Gladys gestopptes Laden löst ihn nicht aus.
Angeschlossen, abgezogen, Batterie unter einer Schwelle: Nutze die Funktionen des Geräts in einem Auslöser „Gerätezustand ändert sich“, sie können das schon.
Szenen-Aktionen
- Renault / Dacia aktualisieren: liest jetzt den Zustand, den das Auto zuletzt an die Cloud gesendet hat (ohne es zu wecken), und gibt Batteriestand, Reichweite, angeschlossen und lädt an die nächsten Aktionen weiter.
- Renault / Dacia vorklimatisieren: startet die Vorklimatisierung mit der Temperatur der Aktion (15 bis 25 °C; leer: die Vorklimatisierungstemperatur des Fahrzeugs). Ausgabe: die gesendete Temperatur.
Das Laden (Laden) und der Lademodus sind Funktionen des Geräts: Eine Szene setzt sie mit „Gerät steuern“.
Szenen-Beispiele
- Warmes Auto um 7:30 an Werktagen: um 7:15, Montag bis Freitag, „Renault / Dacia vorklimatisieren“ mit 21 °C.
- Laden zur Nebenzeit: um 22 Uhr, wenn Angeschlossen 1 ist, den Lademodus auf Sofort setzen; um 6 Uhr wieder auf Geplant.
- Erinnerung ans Anstecken: um 20 Uhr „Renault / Dacia aktualisieren“, dann, wenn die Ausgabe Batteriestand unter 30 und angeschlossen falsch ist, die Nachricht „Denk daran, das Auto anzustecken“ senden.
- Laden beendet: die Nachricht „Die Zoe ist geladen ({{triggerEvent.data.battery_level}} %)“ senden.
Abfragen und Cloud-Kontingent
Die Integration liest die Cloud mit ihrem eigenen Timer (sie verlässt sich nicht auf die Abfrage durch Gladys). Jede Abfrage liefert den Zustand, den das Auto zuletzt an die Cloud gesendet hat: Das Auto wird dabei nie geweckt. Ein Auto sendet seinen Zustand, wenn es ausgeschaltet wird, während es lädt und nach einem Befehl; geparkt und schlafend kann es stundenlang nichts melden, egal welche Abfrage gewählt ist.
Eine Abfrage kostet einen Aufruf pro Endpunkt, den das Auto bietet (Batterie, Kilometerstand, Klima, Lademodus, Schlösser, Position: 1 bis 6). Wie Home Assistant bleibt die Integration unter 60 Aufrufen pro Stunde und Konto: Bei mehreren Autos werden die Abfragen bei Bedarf über die gewählte Abfrage hinaus gestreckt. Antwortet die Cloud „Kontingent erreicht“, pausieren die Abfragen 15 Minuten. Ein Wert, der sich nicht ändert, wird alle 12 Stunden erneut an Gladys gesendet, damit er nie veraltet wirkt.
Privatsphäre und gespeicherte Daten
- Das Passwort bleibt in der Konfiguration von Gladys; es dient nur zur Anmeldung.
- Die Sitzung (Anmelde-Token, Konto-ID, die Kennungen dieser Installation nach einer
Zwei-Schritt-Bestätigung) und die Vorklimatisierungstemperaturen werden im Volume
/datader Integration gespeichert, in einer Datei, die nur die Integration lesen kann. Nichts davon, auch nicht die E-Mail-Adresse, erscheint in den Logs. - Die GPS-Position ist standardmäßig aus; ausgeschaltet wird sie nie gelesen.
- Die Integration spricht nur mit der Renault-Cloud (Gigya für die Anmeldung, Kamereon für die Autos).
Fehlerbehebung
- „Das Konto hat die Anmeldung abgelehnt“: Prüfe Land, E-Mail-Adresse und Passwort (die der App) und speichere dann. Die Integration versucht es nicht von selbst erneut, um das Konto nicht zu sperren.
- „Dein Konto verlangt einen per E-Mail gesendeten Code“: siehe Zwei-Schritt-Bestätigung.
- „Der Anmeldedienst lehnt die Verbindung gerade ab“: zu viele Versuche; warte einige Stunden und speichere dann erneut.
- Ein Auto fehlt: Prüfe, ob es in der offiziellen App mit demselben Konto und Land erscheint; bei mehreren Konten leere das Feld Konto.
- Eine Funktion fehlt: Das Modell bietet sie nicht an oder hat den Wert nie gesendet. Die Cloud antwortet „verboten“ oder „nicht gefunden“ für das, was einem Modell fehlt; dieser Endpunkt wird dann nicht mehr gelesen.
- „Der Privatsphäre-Modus des Autos ist an“: Schalte ihn im Auto aus.
- Alte Werte: Das Auto hat seinen Zustand seitdem nicht gesendet (schläft, kein Netz am Parkplatz). Die Zeile „Letzte Meldung“ des Widgets gibt das Datum des letzten Zustands an.
- Mehr Details: Setze
LOG_LEVEL=debugam Container.
Grenzen
- Ohne Auto und ohne Konto entwickelt, nach dem Protokoll und den echten Antworten, die
renault-apigesammelt hat: Rückmeldungen im Forum oder in den Issues willkommen. - Kein Verriegeln, keine Hupe und keine Lichthupe aus der Ferne: Die Cloud bietet kein Verriegeln an, Hupe und Lichter wurden weggelassen (eine Dashboard-Taste ist schnell aus Versehen gedrückt).
- Keine Bearbeitung der Ladeprogramme, kein Ladelimit, kein Ladeverlauf.
- Die Befehle laufen über die Renault-Cloud: Fällt sie aus, geht nichts, und sie kann sich ohne Vorwarnung ändern.
- Die Position wird als Text veröffentlicht; keine Entfernung zum Zuhause.
Danksagung
Das Protokoll, die Endpunkt-Tabelle pro Modell und die Test-Fixtures stammen aus
hacf-fr/renault-api (MIT), der Bibliothek der
Home-Assistant-Integration renault, deren Verhalten (Kontingent, je nach Modell abgelehnte
Endpunkte) übernommen wurde.
Konfigurationseinstellungen
Diese Einstellungen fragt Renault / Dacia in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Bevor du loslegst | section | Nein | Diese Integration meldet sich wie die offizielle App bei deinem MY-Renault- oder MY-Dacia-Konto an und liest den Zustand, den deine Autos zuletzt an die Cloud gesendet haben (sie weckt sie nie). Verlangt dein Konto einen per E-Mail gesendeten Code: Speichere, klicke auf „Bestätigungscode senden“, dann auf „Code eingeben“. Nicht mit Renault oder Dacia verbunden. |
| Land des Kontos | select | Ja | Land und Sprache deiner MY-Renault-/MY-Dacia-App: Davon hängen die Server des Kontos ab. |
| E-Mail-Adresse | string | Ja | Die E-Mail-Adresse deines MY-Renault- oder MY-Dacia-Kontos. |
| Passwort | secret | Ja | Dient nur zur Anmeldung: Die geöffnete Sitzung wird danach im Speicher der Integration aufbewahrt. |
| Konto (optional) | string | Nein | Leer: die Autos aller Konten der Person. Um nur ein Konto zu nutzen, gib die von „Verbindung testen“ angezeigte ID ein. |
| Sprache der Gerätenamen | select | Nein | Sprache der Funktionsnamen neuer Geräte (Gladys behält einen Namen, sobald das Gerät erstellt ist). |
| Abfrage | select | Nein | Wie oft die Cloud gelesen wird. Das weckt das Auto nie; mehrere Autos verlängern den Abstand, um im Kontingent der Cloud zu bleiben. |
| GPS-Position | boolean | Nein | Standardmäßig aus (Privatsphäre). An: Die zuletzt vom Auto gesendete Position wird gelesen und in Gladys angezeigt. |
So installierst du Renault / Dacia in Gladys
- Öffne in Gladys Integrationen: Renault / Dacia erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-renault:1.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/guim31/gladys-renault.
Renault / Dacia benötigt Gladys >=5.1.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
Renault / Dacia 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 guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation