Mehrere BMW- und MINI-Fahrzeuge und Konten in Home Assistant

BavarianData entstand rund um ein Fahrzeug in einem BMW-Konto, und seitdem ging es darum, die anderen Konstellationen genauso gut zu bedienen. Diese Seite zeigt das Gesamtbild: was ein Konfigurationseintrag abdeckt, was sich mit einem zweiten Fahrzeug oder einem zweiten Konto ändert, und an welchen wenigen Stellen du weiterhin sagen musst, welches Auto gemeint ist.

Ein Eintrag pro Konto, nicht pro Fahrzeug#

Ein Konfigurationseintrag ist ein BMW-Konto: eine Client-ID, eine OAuth-Anmeldung, ein MQTT-Stream, ein Tageskontingent von 50 Anfragen — und alle Fahrzeuge dieses Kontos. Jede FIN wird zu einem eigenen Gerät mit eigenen Entitäten, eigener Historie, eigenem Ladekonto und eigener Reifenakte.

Also:

Zwei Fahrzeuge in einem Konto → die Integration einmal hinzufügen. Beide Autos erscheinen.
Zwei Konten (deins und das des Partners, oder ein BMW- und ein MINI-Konto) → die Integration zweimal hinzufügen, je Client-ID einmal.
Ein Konto zweimal wird abgelehnt. Seit v0.9.11-beta.4 bricht die Einrichtung mit „Dieses BMW-Konto ist bereits eingerichtet” ab, wenn ein anderer Eintrag dasselbe Konto nutzt — auch dann, wenn du dafür im Portal eine zweite Client-ID erzeugt hast. Das ist keine selbst erfundene Einschränkung: BMW erlaubt eine Stream-Verbindung pro Konto, zwei Einträge würden sich also gegenseitig endlos trennen, und das Kontingent von 50 Anfragen zählt pro Konto, nicht pro Client-ID.

Ein Fahrzeug kann nur in einem Konto sein, daher wird keine FIN je von zwei Einträgen bedient.

Ein Fahrzeug später hinzufügen#

Kaufst du einen zweiten BMW oder meldest ein vorhandenes Auto erst nach der Einrichtung bei CarData an, taucht es einfach auf: Es läuft über denselben Stream, seine Entitäten erscheinen also von selbst, sobald das Auto etwas sendet.

Zwei Dinge fehlten dabei früher und sind ab v0.9.11-beta.4 abgedeckt:

Name und Modell. Alles, was aus einer FIN einen „i5 eDrive40” macht, stammt aus einem einmaligen REST-Aufruf, der bisher nur bei der Einrichtung lief — ein später hinzugekommenes Auto blieb auf der Geräteseite eine nackte FIN. Er erfolgt jetzt, sobald das Fahrzeug zum ersten Mal im Stream auftaucht (eine Anfrage aus dem Tageskontingent, einmalig).
Die Schonfrist der Abdeckungsprüfung. Der Stream-Selbsttest gibt einer frischen Installation eine Woche, bevor er einen Cluster als stumm meldet. Diese Uhr läuft jetzt pro Fahrzeug — ein nach zwei Jahren hinzugefügtes Auto gilt also nicht ab dem ersten Tag als unvollständig.

Die Felder des neuen Fahrzeugs musst du weiterhin im BMW-Portal ankreuzen: Die Datenauswahl gilt je Fahrzeug und hat keine API. Rufe dafür erneut Konfigurieren → Gestreamte Daten auswählen auf und wähle auf der Portalseite, die der Aktivator öffnet, das neue Auto (Schritt 4). Danach sucht die Integration das Auto selbst und legt es samt Entitäten an — du musst weder auf eine Fahrt warten noch Fahrzeuge suchen drücken. (Eine erneute Autorisierung des Kontos tut dasselbe.)

Sonderfälle#

Ein geparktes Auto kann tagelang unsichtbar bleiben. Der Stream von BMW enthält nur, was das Auto jetzt sendet, und hebt nichts für später auf. Ein schlafendes Auto sagt also nichts, bis etwas es weckt — eine Tür, das Laden, eine Fahrt. Deshalb fragt die Integration BMW nach der Fahrzeugliste des Kontos, statt zu warten: beim Abschluss von Gestreamte Daten auswählen, bei einer erneuten Autorisierung und auf Abruf mit Fahrzeuge suchen.
Ein gefundenes Auto startet mit REST-Werten, nicht mit Live-Werten. Die Suche legt das Auto als Gerät an und füllt seine Entitäten aus einem Telematik-Abruf (Name und Modell aus einer zweiten Anfrage). Live-Werte — Position, Türen, Ladeleistung — kommen erst, wenn das Auto streamt, und nur wenn seine Felder im Portal angekreuzt sind.
Nur primäre Fahrzeuge werden hinzugefügt. Ein Auto, das BMW für das Konto mit dem Status SECONDARY führt, wird nicht übernommen.
Es kostet Kontingent, einmal pro Auto. Zwei Anfragen aus den 50 pro 24 h, nur wenn ein neues Auto gefunden wird; ohne neues Auto wird nichts verbraucht. Ist das Kontingent aufgebraucht, wird das Auto übersprungen; Fahrzeuge suchen versucht es später erneut.
Ein fehlgeschlagener Versuch wird nicht von selbst wiederholt. Hat BMW für ein Auto noch keine Daten, versucht die Integration es bis zum nächsten Neustart von Home Assistant nicht erneut, damit ein Auto, für das BMW nicht antworten kann, das Kontingent nicht leert. Mit Fahrzeuge suchen stößt du es neu an.
Ein Auto, das bereits streamt, wird nicht noch einmal abgerufen. Hat es zuerst gesendet, wird es durch diese Nachricht angelegt und der zusätzliche Abruf entfällt.
Dasselbe Konto erneut hinzuzufügen behält alles. Gerät hinzufügen mit einer bereits eingerichteten Client-ID autorisiert den vorhandenen Eintrag an Ort und Stelle neu, samt Verlauf (seit v0.9.14-beta.4); zuvor löschte es den Eintrag samt aufgezeichneter Fahrten und Ladevorgänge.

Kontingent mit mehreren Fahrzeugen#

Die 50 Anfragen pro 24 h gehören dem Konto, und die tägliche Aktualisierung kostet 2 Anfragen je Fahrzeug (Telematik-Container plus Reifendiagnose). Drei Autos in einem Konto sind 6 von 50 pro Tag — reichlich Luft. Zwei getrennte Konten haben je 50, weil BMW pro Konto zählt. Siehe API-Kontingent.

Die Fahrzeuge auseinanderhalten#

Wo	Was zu tun ist
Die Karte	Eine Karte je Fahrzeug: `device:` setzen (die Auswahl bietet jedes Auto mit Namen an) oder `vin:`. Ohne Angabe wird das erste gefundene Fahrzeug genommen.
Dienste	Mit `vin:` ein bestimmtes Auto ansprechen. `bavariandata.fetch_telematic_data` ohne FIN aktualisiert alle Fahrzeuge des Eintrags; die übrigen `fetch_*`-Dienste wählen eines aus, nenne dort also die FIN. Bei zwei eingerichteten Konten zusätzlich `entry_id:` angeben — oder eine `vin:`, die das Konto bereits eindeutig bestimmt. Siehe Dienste.
Automatisierungen	Geräte-Auslöser gehören zu einem Auto: Auto wählen, und nur seine Ereignisse lösen die Automation aus. Die `bavariandata_*`-Ereignisse enthalten `vin` und `entry_id`; filtere auf `trigger.event.data.vin`. Die mitgelieferten Blueprints lösen sonst für jedes Fahrzeug aus.
Die evcc-Brücke	Topics laufen je FIN (`<prefix>/<vin>/soc`), mehrere Autos teilen sich also kollisionsfrei ein Präfix. Den evcc-Block je Fahrzeug erzeugt `bavariandata.get_evcc_config` mit dessen `vin`. Ein gebundener Wallbox-Zähler gilt allerdings pro Eintrag: Können zwei Autos gleichzeitig zu Hause laden, lassen sich die gemessenen kWh keinem von beiden zuordnen.
Debug-Protokollierung	Der Log-Level ist ein Schalter für die ganze Integration — er kann nicht je Konto gelten. Die ausführliche Protokollierung bleibt aktiv, solange irgendein Eintrag sie anhat, und protokolliert währenddessen die Daten aller Konten.
Reparaturen & Hinweise	Abdeckungs- und Stream-Reparaturen nennen das Fahrzeug. Die Kontingent-Reparatur nennt kein Konto — prüfe bei zwei Einträgen die Diagnose-Entität Verbleibendes API-Kontingent am jeweiligen Debug-Gerät.

Einen Eintrag entfernen#

Das Entfernen eines Eintrags lässt den anderen unberührt weiterlaufen: Stream, Dienste und Karte bleiben, wie sie sind. Der entfernte Eintrag nimmt seine gespeicherte Historie, seinen Abdeckungsstand und seine Reifendaten mit und räumt zurückgehaltene evcc-Topics für jedes Fahrzeug ab, das er je hatte — auch für eines, das nur gestreamt und nie Basisdaten geliefert hat.

Mehrere Fahrzeuge & Konten