BYD Smart-Home-Integration, kostenlos und Open Source
Ihr BYD in Gladys: Batterie, Reichweite, Laden, Verriegelung, Klima, Reifen und Szenen.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.1
- ★ 0
Überblick
Diese Integration bringt Ihre BYD-Fahrzeuge über die Cloud der internationalen BYD-App (nicht die App für China) in Gladys: Batterie, Reichweite, Laden, Verriegelung, Türen, Fenster, Klimatisierung, Reifendruck, Warnungen und Position. Mit der Fernsteuerungs-PIN der App kann Gladys das Fahrzeug auch ver- und entriegeln, das Klima starten oder stoppen, die Lichter blinken lassen und „Fahrzeug finden“ auslösen.
BYD veröffentlicht keine API: Die Integration spricht das Protokoll der App, nach der freien Bibliothek pyBYD (die die Home-Assistant-Integration nutzt). BYD kann es jederzeit ändern.
Voraussetzungen
- Gladys Assistant 5.1.1 oder neuer.
- Ein BYD-Fahrzeug, verbunden mit der BYD-App, sowie E-Mail-Adresse und Passwort des App-Kontos.
- Empfohlen: ein zweites BYD-Konto, mit dem das Fahrzeug geteilt wird (Teilen erfolgt in der App). Die App kann Ihr Telefon abmelden, wenn Gladys sich mit demselben Konto anmeldet.
- Für Befehle: die 6-stellige Fernsteuerungs-PIN, die das von Gladys genutzte Konto in der BYD-App festgelegt hat (ein geteiltes Konto legt seine eigene fest).
Konfiguration
| Feld | Bedeutung |
|---|---|
| E-Mail-Adresse | Das Konto der BYD-App. |
| Passwort | Sein Passwort, als Geheimnis gespeichert. |
| Land des Kontos | Zweibuchstabencode des Landes, in dem das Konto angelegt wurde (DE, AT, CH…): bestimmt den Server. |
| Fernsteuerungs-PIN | Die 6 Ziffern der App. Leer: nur Lesen. |
| Abfrageintervall | 5 bis 480 Minuten (Standard 15). Jedes Lesen weckt das Fahrzeug und kostet etwas Batterie. |
| Klimatemperatur | 15 bis 31 °C, beim Start des Klimas aus Gladys angefordert. |
| Klimadauer | 10, 15, 20, 25 oder 30 Minuten. |
| Radius um das Zuhause | Unter dieser Entfernung zu einem Haus in Gladys (mit Position) ist das Fahrzeug zu Hause. |
| Sprache der Texte | Sprache der Namen, Zustände und Szenen-Zusammenfassungen. |
Speichern und dann Verbindung testen klicken: Es listet die Fahrzeuge des Kontos auf.
Verwendung
Geräte
Fügen Sie unter Entdecken Ihre Fahrzeuge hinzu. Jedes Fahrzeug bietet die Funktionen an, die es meldet: Batterie, elektrische Reichweite (und Kraftstoff bei Plug-in-Hybriden), Kilometerstand, Ladekabel, Ladestatus, Zeit bis voll geladen, Innentemperatur, Verriegelung, Türen und Kofferraum, Fenster, Klimatisierung, Druck der vier Reifen (in bar), Warnungen und Entfernung von zu Hause. Scannen Sie nach einer ersten Fahrt erneut, wenn eine Funktion fehlt.
Verriegelung und Klima sind Befehle: Sie benötigen die PIN. Ein Befehl wird im Hintergrund gesendet; das Fahrzeug antwortet innerhalb einer Minute und wird 30 Sekunden später erneut gelesen.
Dashboard-Widget
Das Widget BYD-Fahrzeug zeigt das Bild des Modells, Batterie, Reichweite, Verriegelung, Öffnungen, Laden, Innentemperatur, Klima, Position, Warnungen und das Alter der Daten, mit Tasten zum Ver- oder Entriegeln, Klima starten oder stoppen, Lichtsignal und Karte.
Szenen
Auslöser: ver- oder entriegelt, verriegelt, aber offen, Laden gestartet oder beendet, Kabel ein- oder ausgesteckt, zu Hause angekommen oder abgefahren, Warnleuchte an, Kontoproblem. Aktionen: Befehl senden (wartet auf das Fahrzeug), Fahrzeugstatus lesen.
- Wenn das Fahrzeug zu Hause ankommt → senden „Fahrzeug anstecken: {{triggerEvent.data.battery_level}} %“.
- Wenn das Fahrzeug verriegelt, aber offen ist → {{triggerEvent.data.summary}} senden.
- Jeden Werktag um 7:40 → den Befehl „Klimatisierung starten“ senden.
Transport
Alles läuft über die BYD-Cloud Ihrer Region (Abzeichen Cloud). Ein oranger Punkt bedeutet, dass BYD das Fahrzeug als offline sieht: Die Werte können veraltet sein.
Fehlerbehebung
- Anmeldung abgelehnt: E-Mail-Adresse, Passwort und Land prüfen. Nach einer Ablehnung wartet die Integration 15 Minuten (dann 30, bis zu 4 Stunden) vor einem neuen Versuch, damit BYD das Konto nicht sperrt; Speichern der Konfiguration versucht es sofort erneut.
- PIN abgelehnt: Alle Befehle stoppen, bis Sie die PIN in der Konfiguration ändern. Wiederholte falsche PINs sperren die Fernsteuerung des Fahrzeugs für den Tag.
- Ihr Telefon wurde abgemeldet: Nutzen Sie ein zweites Konto, mit dem das Fahrzeug geteilt wird.
- Veraltete Werte, „Fahrzeug offline“: Das Fahrzeug hat keinen Mobilfunk (Tiefgarage) oder schläft tief; Befehle können bis zur Wiederverbindung fehlschlagen.
- Ein Wert fehlt oder wirkt falsch: In der Konfiguration auf Diagnose klicken und die Zeilen mit „BYD diagnostic“ aus dem Tab Protokolle in ein GitHub-Issue kopieren (VIN, Kennzeichen und Position sind entfernt).
Konfigurationseinstellungen
Diese Einstellungen fragt BYD in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| 1. BYD-Konto | section | Nein | Gladys liest Ihre Fahrzeuge über die Cloud der BYD-App (die internationale App, nicht die für China) mit dem Konto der App. Tipp: Die BYD-App kann Ihr Telefon abmelden, wenn Gladys sich mit demselben Konto anmeldet; legen Sie ein zweites Konto an, teilen Sie das Fahrzeug in der App damit und tragen Sie dieses Konto hier ein. |
| E-Mail-Adresse | string | Ja | |
| Passwort | secret | Ja | |
| Land des Kontos | string | Ja | Zweibuchstabencode des Landes, in dem das Konto angelegt wurde (DE, AT, CH…): Er bestimmt den BYD-Server. |
| 2. Fernsteuerung (optional) | section | Nein | Um aus Gladys zu verriegeln, zu entriegeln, das Klima zu starten oder die Lichter blinken zu lassen, geben Sie die 6-stellige Fernsteuerungs-PIN aus der BYD-App ein (ein geteiltes Konto legt seine eigene fest). Ohne sie liest Gladys nur. Eine abgelehnte PIN stoppt die Befehle, bis Sie sie hier ändern: Wiederholte falsche PINs sperren die Fernsteuerung des Fahrzeugs für den Tag. |
| Fernsteuerungs-PIN | secret | Nein | |
| Optionen | section | Nein | |
| Abfrageintervall (min) | number | Nein | Zwischen 5 und 480 Minuten. Jedes Lesen weckt das Fahrzeug und kostet etwas Batterie: Gehen Sie nicht ohne Grund unter 15 Minuten. |
| Klimatemperatur (°C) | number | Nein | Wird beim Start des Klimas aus Gladys angefordert, 15 bis 31 °C. |
| Klimadauer | select | Nein | |
| Radius um das Zuhause (m) | number | Nein | Ein Fahrzeug, das näher als dieser Wert an einem Haus in Gladys (mit hinterlegter Position) ist, gilt als zu Hause: Entfernung und Szenen für Ankunft/Abfahrt. |
| Sprache der Texte | select | Nein | Sprache der Gerätenamen, des Ladestatus, der Warnungen und der Szenen-Zusammenfassungen. Automatisch: die Sprache Ihres Dashboards. |
So installierst du BYD in Gladys
- Öffne in Gladys Integrationen: BYD erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-byd:0.1.0) 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/William-De71/gladys-byd.
BYD benötigt Gladys >=5.1.1. 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
BYD 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 William-De71 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