EV-COCKPIT — dein BYD auf deinem eigenen Rechner (Linux/macOS)
================================================

SO STARTEST DU (Linux / macOS / Raspberry Pi)
--------------------------------------------
1. Terminal in diesem Ordner oeffnen
2.   ./start.sh
   (beim ersten Mal wird die BYD-Bibliothek automatisch nachinstalliert)
3. Browser oeffnet sich. Sonst: http://127.0.0.1:8099
4. Zum Beenden: Strg+C im Terminal

Voraussetzung: Python 3 (bei Linux/macOS praktisch immer schon dabei).
Pruefen mit:  python3 --version


WICHTIG: BITTE EINEN ZWEITEN BYD-ACCOUNT ANLEGEN
------------------------------------------------
Die BYD-Cloud erlaubt pro Account nur EINE aktive Sitzung.

Nimmst du hier denselben Account wie in deiner BYD-App am Handy, stören sich
beide gegenseitig (Fehlermeldung 6024) — dein Cockpit spinnt, oder deine App.

So geht es richtig:
   1. In der BYD-App einen zweiten Account anlegen (andere E-Mail-Adresse)
   2. Diesen zweiten Account im Auto als "Zusatznutzer" freigeben
   3. Im Assistenten den ZWEITEN Account eintragen

Dann laufen App und Cockpit friedlich nebeneinander.


DEINE DATEN
-----------
Alles bleibt auf DEINEM Rechner (im Ordner .evcockpit in deinem Benutzerordner).
Das Programm schickt NICHTS an den Entwickler. Die einzige Gegenstelle ist die
BYD-Cloud selbst — also der Dienst, dessen Daten du ohnehin abrufst.

Einzige Ausnahme: die freiwillige, anonyme Nutzungszählung. Die ist standardmäßig
AUS, und was sie sendet, steht im Assistenten wörtlich dabei.

Das Cockpit ist normalerweise NUR auf diesem Rechner erreichbar. Willst du es
auch am Tablet, setz im Assistenten den Haken "Auch im Heimnetz öffnen".


HOME ASSISTANT? DANN HIER WEITERLESEN
-------------------------------------
Im Assistenten (Schritt 5) gibt es das Haekchen "Ans Home Assistant senden".
Damit taucht dein Auto in HA von selbst auf - mit allen Werten und den
Klima-Knoepfen. Kein YAML, nichts konfigurieren.

Du brauchst dafuer einen MQTT-Broker. In Home Assistant ist das meist das
Add-on "Mosquitto broker" - einmal installieren, fertig.

Im Assistenten eintragen:
   Broker  = die Adresse deines Home Assistant (z.B. 192.168.0.10)
   Port    = 1883
   Benutzer/Passwort = nur falls dein Broker welche verlangt
Dann auf "Verbindung testen".


AUTOSTART: DAMIT ES NACH DEM NEUSTART WEITERLAEUFT
--------------------------------------------------
Wichtig fuer Home-Assistant-Nutzer: Dieses Programm ist der Abfrager. Laeuft es
nicht, bekommt HA keine Daten. Am besten laesst du es auf dem Geraet laufen, auf
dem auch HA laeuft (Raspberry, NAS, Mini-PC) - dann ist es immer da.

So richtest du den Autostart ein (Linux mit systemd):

1. Datei anlegen:
     nano ~/.config/systemd/user/evcockpit.service

2. Das hier hineinkopieren (Pfad ggf. anpassen):

     [Unit]
     Description=EV-Cockpit
     After=network-online.target

     [Service]
     ExecStart=/usr/bin/python3 %h/ev-cockpit/evcockpit.py
     Restart=always
     RestartSec=15

     [Install]
     WantedBy=default.target

3. Einschalten:
     systemctl --user daemon-reload
     systemctl --user enable --now evcockpit
     loginctl enable-linger       # laeuft auch ohne Anmeldung weiter

4. Nachschauen ob es laeuft:
     systemctl --user status evcockpit

Willst du das Cockpit auch vom Tablet aus sehen, setz im Assistenten zusaetzlich
das Haekchen "Auch im Heimnetz oeffnen".


HAFTUNG (bitte lesen)
---------------------
Kein offizielles Produkt der BYD Auto Co. Ltd., keine Verbindung zu BYD.
Kostenlos und ohne jede Gewähr. Nutzung auf eigene Gefahr — das Programm kann
die Klimaanlage deines Autos steuern. Der Zugriff auf die BYD-Cloud über eine
fremde Anwendung kann BYDs Nutzungsbedingungen widersprechen; im ungünstigsten
Fall kann BYD einen Account einschränken. Das entscheidest du selbst.

Volles Impressum, Haftung und Datenschutz: im Programm unten auf
"Impressum · Haftungsausschluss · Datenschutz" klicken.


HILFE
-----
Green Chili Productions by Alfred Aigner — office@photo-aigner.at
https://byd.serveone.at/ev-cockpit/

Gebaut für die BYD-Community. Viel Freude damit.
