Screenshots Aus der README von JustChr/BavarianData.
Überblick
BavarianData: Connect Home Assistant to BMW CarData bringt Live-Fahrzeugdaten von BMW und MINI in Home Assistant. Es liest die Cloud von BMW über einen Live-MQTT-Stream und eine REST API mit einer persönlichen Client-ID und ist schreibgeschützt, sodass es das Auto nicht steuern kann. Jeder Deskriptor, den BMW sendet, wird zu einer Entität und erscheint als Sensoren, Binärsensoren, ein Standort-Tracker, ein Servicekalender und ein Fahrzeugbild. Darüber hinaus leitet es einen Ladeverlauf mit Kosten, den Batteriezustand, ein Fahrtenbuch, einen gemessenen realen Reichweitenwert und Langzeitstatistiken für das Energie-Dashboard ab. Es kann den Ladezustand über MQTT für evcc oder openWB veröffentlichen, bietet Geräteauslöser für Lade-, Park- und Fahrtereignisse und exportiert den Verlauf als CSV oder druckbares HTML. Die Einrichtung läuft über die Home Assistant Oberfläche, nachdem im BMW-Portal eine Client-ID erstellt wurde.
Zusammenfassung der README und des Codes von JustChr/BavarianData, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Geräteauslöser Die Geräte können Automationen direkt starten.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Sensoren
- Anwesenheit
- Kalender
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
BMW CarData verbinden
- Client-IDDie CarData Client-ID aus dem BMW-Portal — eine lange Zeichenfolge im UUID-Format.
Daten aktivieren und Ergebnis einfügen
- Setup-ErgebnisDer BAVARIANDATA…-Text, den die Copy-Schaltfläche in die Zwischenablage gelegt hat.
Gestreamte Daten auswählen
- DatengruppenBelasse die Vorauswahl für den empfohlenen Satz, oder beschränke sie auf die Daten, die dich wirklich interessieren (z. B. nur Elektrofahrzeug und Fahrzeugstatus).
Daten aktivieren und Ergebnis einfügen
- Aktivierungs-ErgebnisDer BAVARIANDATA…-Text, den die Copy-Schaltfläche in die Zwischenablage gelegt hat. Leer lassen, um ohne Aktivierung abzuschließen.
Client-ID ändern
- Client-IDDie Client-ID eines CarData Client im BMW-Portal, abonniert für CarData API und CarData Streaming.
Nach der Einrichtung
- DatengruppenBelasse die Vorauswahl für den empfohlenen Satz, oder beschränke sie auf die Daten, die dich wirklich interessieren (z. B. nur Elektrofahrzeug und Fahrzeugstatus).
- Aktivierungs-ErgebnisDer BAVARIANDATA…-Text, den die Copy-Schaltfläche in die Zwischenablage gelegt hat.
- BildquelleOffiziell: eine Seitenansicht, 1 deiner 50 täglichen BMW-Anfragen pro Auto. Konfigurator: genau dein Auto in 360° mit echter Lackfarbe, keine Anfragen, aber ein inoffizieller BMW-Dienst, der ausfallen kann.
- FahrzeugDie nächste Seite beginnt mit den eigenen Einstellungen dieses Fahrzeugs.
- PreisquelleKeine zeichnet Ladevorgänge ohne Kosten auf. Fester Preis berechnet jede kWh zum selben Satz; Preis-Entität folgt einem Live-Tarif (Tibber, Nordpool, …), während das Auto lädt.
- Fester Preis pro kWhWird nur bei der Preisquelle „Fester Preis“ verwendet.
- Preis-EntitätWird nur bei der Preisquelle „Preis-Entität“ verwendet. Ihr Zustand muss ein Preis pro kWh sein.
- WährungISO-Code für die Kosten-Sensoren, z. B. EUR, GBP, CHF.
- Wallbox-EnergiesensorOptional. Der Gesamtzähler deiner Wallbox, der nur aufwärts zählt. Wird nur für Ladevorgänge in deiner Zone Zuhause gelesen. Ein gemessener Wert schlägt die Schätzung auf Akkuseite und verbessert auch die Ladestand-Schätzung zu Hause.
- Ladeverluste (%)Optional. Die Energie wird am Akku gemessen, etwas unter dem, was das Netz geliefert hat; das rechnet sie hoch. Mit Wallbox-Zähler bei 0 lassen.
- Verlauf aufbewahren (Monate)0 behält alles. Ältere Ladevorgänge werden verworfen.
- In Langzeitstatistiken übernehmenSpiegelt Energie, Kosten und Strecke in Statistiken, die du im Energie-Dashboard hinzufügen kannst. Bleibt lokal; beim Ausschalten werden sie wieder gelöscht.
- Ladeorte merkenOptional. Speichert, wo jeder Ladevorgang stattfand, damit die Dashboard-Karte deine Ladeorte auf einer Landkarte zeigt. Schreibt Koordinaten auf die Festplatte; Ausschalten löscht sie. Ab dem nächsten Laden.
- PreisquelleKeine zeichnet Ladevorgänge ohne Kosten auf. Fester Preis berechnet jede kWh zum selben Satz; Preis-Entität folgt einem Live-Tarif (Tibber, Nordpool, …), während das Auto lädt.
- Fester Preis pro kWhWird nur bei der Preisquelle „Fester Preis“ verwendet.
- Preis-EntitätWird nur bei der Preisquelle „Preis-Entität“ verwendet. Ihr Zustand muss ein Preis pro kWh sein.
- WährungISO-Code für die Kosten-Sensoren, z. B. EUR, GBP, CHF.
- Verlauf aufbewahren (Monate)0 behält alles. Ältere Ladevorgänge werden verworfen.
- In Langzeitstatistiken übernehmenSpiegelt Energie, Kosten und Strecke in Statistiken, die du im Energie-Dashboard hinzufügen kannst. Bleibt lokal; beim Ausschalten werden sie wieder gelöscht.
- PV-LeistungGesamterzeugung deiner Wechselrichter.
- Netzleistung (+ Bezug / − Einspeisung)Vorzeichenbehaftete Leistung am Zähler: positiv beim Bezug, negativ bei der Einspeisung.
- Hausspeicher-Leistung (optional)Leer lassen, wenn es keinen Hausspeicher gibt. Erwartet wird positiv beim Entladen — sonst das Feld darunter ankreuzen.
- Mein Speichersensor ist beim Laden positivViele Integrationen liefern die Speicherleistung positiv beim Laden. Am Wert selbst ist das nicht erkennbar, deshalb die Nachfrage.
- Wert des eigenen Solarstroms pro kWhLeer lassen, um Solarstrom mit dem Bezugspreis zu bewerten. Mit der Einspeisevergütung zeigt die Ladung, was sie wirklich gekostet hat.
- FahrzeugDie nächste Seite beginnt mit den eigenen Einstellungen dieses Fahrzeugs.
- Dieses Auto per MQTT veröffentlichenStandardmäßig aus: es legt VIN und Fahrzeugzustand auf einen Broker, den auch anderes lesen kann.
- Topic-PrefixDie Topics lauten dann PREFIX/VIN/soc usw. Lass bavariandata stehen, sofern es nicht mit etwas kollidiert.
- Mit Retain veröffentlichenLass das an: So findet evcc den Ladestand sofort beim Start. Nur ausschalten, wenn dein Broker Retained-Nachrichten ablehnt.
- Topic-PrefixDie Topics lauten dann PREFIX/VIN/soc usw. Lass bavariandata stehen, sofern es nicht mit etwas kollidiert.
- Mit Retain veröffentlichenLass das an: So findet evcc den Ladestand sofort beim Start. Nur ausschalten, wenn dein Broker Retained-Nachrichten ablehnt.
Texte aus dem Code von JustChr/BavarianData.
Entitäten
- BinärsensorenLadeanschluss-Verbindungsstatus, Status der Ladesteckverbindung (nur DC), Verriegelungszustand des Ladesteckers nach vollständiger Ladung, Ladesitzungs-ID, Verriegelungszustand des Ladeanschlusses, ID des Einsteck-Ereignisses am Ladeanschluss, Status der Ladesteckverbindung, Status-Text des Ladeanschlusses, Zustand der Ladeklappe, Schließzustand der Ladeklappe, Status der Motorhaube, Zustand der Lichter und 284 weitere
- KalenderServicekalender
- AnwesenheitStandort
- BilderFahrzeugbild
- SensorenLadeanschluss-Verbindungsstatus, Status der Ladesteckverbindung (nur DC), Verriegelungszustand des Ladesteckers nach vollständiger Ladung, Ladesitzungs-ID, Verriegelungszustand des Ladeanschlusses, ID des Einsteck-Ereignisses am Ladeanschluss, Status der Ladesteckverbindung, Status-Text des Ladeanschlusses, Zustand der Ladeklappe, Schließzustand der Ladeklappe, Status der Motorhaube, Zustand der Lichter und 306 weitere
Aktionen
- Telematikdaten abrufenTelematikdaten aller Fahrzeuge des Kontos über die gespeicherten Container abrufen und die Antwort protokollieren. Zwei Anfragen pro Fahrzeug.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Fahrzeugzuordnungen abrufenZuordnungsinformationen für das konfigurierte Konto abrufen und die Antwort protokollieren.Felder: Konto, Konfigurationseintrag
- Fahrzeug-Stammdaten abrufenStatische Fahrzeugdaten (Modellname, Baureihe usw.) für eine FIN abrufen und die Antwort protokollieren.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Ladehistorie abrufenDie Historie der Ladevorgänge für eine FIN (seitenweise) von BMW abrufen und in die lokale Historie importieren, damit vergangene Ladungen auf der Karte und in den Monatsübersichten erscheinen. Überlappende live aufgezeichnete Ladevorgänge werden dabei um die von BMW gemessene Netzenergie ergänzt. Zählt als ein oder mehrere API-Aufrufe gegen das Kontingent von 50/24 h.Felder: Fahrzeug, Konfigurationseintrag, FIN, Von, Bis
- Smart-Maintenance-Reifendiagnose abrufenDie Smart-Maintenance-Reifendiagnose für eine FIN abrufen und die Antwort protokollieren.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Standortbasierte Ladeeinstellungen abrufenDie standortbasierten Ladeeinstellungen für eine FIN (seitenweise) abrufen und die Antwort protokollieren.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Fahrzeugbild abrufenDas Fahrzeugbild für eine FIN abrufen und Größe/Inhaltstyp protokollieren.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Ladevorgänge abfragenAufgezeichnete Ladevorgänge zurückgeben, neueste zuerst. Liest die eigene Historie der Integration und verbraucht daher – anders als die Abruf-Aktionen – kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN, Von, Bis, Maximale Anzahl
- Ladeorte abrufenGibt die Orte zurück, an denen ein Auto geladen hat, die häufigsten zuerst, mit der durchschnittlichen Leistung und der typischen Standzeit je Ort. Liest den eigenen Verlauf der Integration und kostet daher kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN, Von, Bis
- Fahrten abfragenAufgezeichnete Fahrten zurückgeben, neueste zuerst. Liest die eigene Historie der Integration und verbraucht daher – wie die Ladevorgänge – kein BMW-API-Kontingent. Start- und Zielpunkte werden als Ortsnamen gespeichert, nie als Koordinaten. Eine gerade laufende Fahrt wird separat als offene Fahrt zurückgegeben (ohne Ende, mit vorläufiger Distanz), sofern kein Zeitraum angegeben wurde.Felder: Fahrzeug, Konfigurationseintrag, FIN, Von, Bis, Maximale Anzahl
- Fahrtenübersicht abfragenDie Monatsübersicht der Fahrten zurückgeben: Distanz, Aufteilung nach geschäftlich/privat/Pendeln, Verbrauch, Rekuperation, Fahrstil-Score, häufigste Ziele und (mit hinterlegtem Tarif) geschätzte Fahrtkosten. Liest den lokalen Speicher und verbraucht kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN, Monat
- Kilometerbericht abrufenLiefert die Fahrleistung des Autos (dieser Monat, dieses Jahr, die letzten 12 Monate, das Tempo) und, mit einem Kilometerkontingent, den Stand dazu. Liest den lokalen Speicher und kostet daher kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Effizienz und reale Reichweite abrufenLiefert den gemessenen Verbrauch (kWh/100 km), die daraus folgende reale Reichweite beim aktuellen Ladezustand, den Ladeverlust zwischen Netz und Batterie sowie einen Monatsverlauf der Effizienz. Alles stammt aus der Ladehistorie und kostet daher kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Tankverlauf abrufenGibt die Tankvorgänge eines Benziners, Diesels oder Plug-in-Hybrids zurück, erkannt am Tankinhalt, mit dem Verbrauch zwischen ihnen, dem Durchschnitt des letzten Jahres und BMWs Verbrauch über die Lebensdauer, wo das Auto ihn sendet. Kostet kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN
- evcc-Konfiguration abrufenGibt die evcc-Konfiguration (Fahrzeugtyp 'custom') für dieses Auto zurück, fertig zum Einfügen in die evcc.yaml, dazu die MQTT-Topics der Brücke und welche davon aktuell bespielt werden. Liest nur lokale Daten und verbraucht daher kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, VIN
- Fahrtkategorie setzenDie Kategorie einer Fahrt überschreiben (geschäftlich, privat oder Pendeln). Damit lässt sich die automatische Zonen-Erkennung korrigieren. Schreibt nur in den lokalen Speicher.Felder: Fahrzeug, Konfigurationseintrag, FIN, Fahrt-ID, Kategorie
- Fahrtbeginn markierenVermerkt, dass jetzt eine Fahrt beginnt, für ein Auto, das erst nach dem Parken meldet: Die Fahrt, die sein nächster Bericht beendet, beginnt dann zu dieser Zeit. Wird nur genutzt, wenn die Fahrterkennung auf Berichte am Fahrtende steht. Schreibt nur in den lokalen Speicher.Felder: Fahrzeug, Konfigurationseintrag, FIN, Zeit
- Historie exportierenEinen Monat aufgezeichneter Ladevorgänge und/oder Fahrten als Dateien zurückgeben: CSV für Tabellenkalkulationen oder ein eigenständiger HTML-Bericht, den sich im Browser als PDF drucken lässt. Der Dateiinhalt kommt in der Antwort zurück; nichts wird auf die Festplatte geschrieben. Liest den lokalen Speicher und verbraucht kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN, Monat, Typ, Format, Sprache
- Descriptor-Abdeckungsbericht abfragenDen Selbsttest zur Descriptor-Abdeckung ausführen: für jedes Fahrzeug vergleichen, welche Descriptors die gewählten Stream-Cluster liefern sollten und welche tatsächlich angekommen sind, und fehlende auflisten. Beantwortet die Frage „Ich habe einen Cluster aktiviert, aber es sind keine Entitäten erschienen – liegt es an meiner Auswahl, an meinem Auto oder an einem Fehler?“. Liest nur den lokalen Speicher und den laufenden Stream und verbraucht kein BMW-API-Kontingent.Felder: Fahrzeug, Konfigurationseintrag, FIN
- Stream-Felder aktivierenErsetzen, welche CarData-Attribute BMW für ein Fahrzeug per MQTT streamt – durch dieselbe Anfrage, die die Stream-Setup-Seite des BMW-Portals beim Speichern der Datenauswahl sendet. Für die Stream-Auswahl gibt es keine CarData-API, daher wird eine mitgeschnittene Portal-Browsersitzung benötigt (sie kann nicht automatisch erneuert werden – die Sitzung ist kurzlebig). Verbraucht kein BMW-API-Kontingent. Liefert die Anzahl der angefragten und akzeptierten Attribute zurück.Felder: Konto, Konfigurationseintrag, Portal-Basisadresse, Gebietsschema, Zugeordnete Fahrzeug-ID, Cookie-Header, Attribute, Bereiche
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:BMW-Motorräder können ihre Daten nicht streamen, Ein ausgewählter Daten-Cluster hat nie gestreamt, Ist nicht mehr in deinem BMW-Konto
Aus der README
Bring your BMW's or MINI's live data into Home Assistant — straight from BMW CarData, no third-party cloud in between.
BMW CarData is BMW's own telematics service: an MQTT stream that pushes vehicle data in real time and a REST API for on-demand snapshots. This integration talks to both directly, using your personal BMW client ID. There is no intermediate server and no MyBMW screen-scraping — Home Assistant is the only client, and it's read-only (CarData cannot command the car).
Erscheint in Vulpo
Kalender-Karte, Diagrammkarte, Apple Watch.Informationen
- Installationen
- 397 teilen Analysedaten
- GitHub-Sterne
- 22
- Verbindung
- Nutzt die Cloud des Herstellers
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v0.9.23,
- Kategorie
- Fahrzeuge und Verkehr, Autos und E-Autos
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
bavariandata- Probleme
- Problem melden
