Source Code von battery.ebiene.de Website und API.

Battery Status Progressive Web App für BMW i-Modelle ermittelt und zeigt Live-Informationen rund um den Fahrzeug-Akku. Die App bedient sich an gleicher Schnittstelle, die auch von der deutschsprachigen BMW ConnectedDrive Website verwendet wird. Für die Nutzung der Schnittstelle wird ein Bearer-Token benötigt, den die App von der BMW ConnectedDrive Website automatisch einholt.

Die Webseite nach Einrichtung im Smartphone-Browser aufrufen und zum Homescreen hinzufügen. Ab diesem Zeitpunkt lässt sich die Web App vom Homescreen heraus im Vollbildmodus starten.

Battery Statusanzeige

Keine Garantie für Richtigkeit und Aktualität. Inbetriebnahme auf eigene Gefahr und Verantwortung. Implementierung ausschließlich zu Demozwecken.

• Apache-Webserver mit PHP
• BMW ConnectedDrive Zugangsdaten

1. Datei .htaccess nach Wünschen anpassen, insbesondere Zeilen 20-21.
2. Datei cache.json im Ordner api/ beschreibbar anlegen.
3. Datei token.json im Ordner api/ beschreibbar anlegen.
4. Datei auth.json im Ordner api/ mit BMW ConnectedDrive Zugangsdaten anlegen:

{
    "username": "XYZ",
    "password": "XYZ",
    "vehicle": "XYZ"
}

Auf Wunsch kann der aktuelle Ladestatus des Fahrzeugs beobachtet und bei Änderungen (Ladevorgang gestartet, Ladevorgang beendet) eine Benachrichtigung gesendet werden. Folgende Voraussetzungen sind zu erwarten:

1. Cronjob (serverseitig oder extern)
2. Webhook(s) für Slack und/oder IFTTT

Via Cronjob prüft ein Skript auf die Veränderung des Ladezustandes (chargingSystemStatus). Bei einer Änderung wird ein Webhook aufgerufen/kontaktiert. Der aufgerufene Webhook (Slack und/oder IFTTT) stößt eine Benachrichtigung auf der entsprechenden (Smartphone/Desktop) App aus.

Ziel-URL für den Cronjob: https://battery.ebiene.de/notify

1. Datei webhooks.json im Ordner notify/ mit angepassten Webhook-URLs anlegen:

{
    "ifttt": "https://maker.ifttt.com/trigger/EVENT/with/key/KEY",
    "slack": "https://hooks.slack.com/services/XXX/YYY/ZZZ"
}

Webhook-URL baut sich wie folgt zusammen: https://maker.ifttt.com/trigger/EVENT/with/key/KEY

Der Wert EVENT kommt aus dem Punkt 3, der KEY aus 8 (siehe nachfolgende Einrichtung).

1. https://ifttt.com/my_applets → New Applet
2. if this → Webhooks → Receive a web request
3. Event Name → z.B. i3_charging → Create trigger
4. then that → Notifications → Send a notification from the IFTTT app
5. Message → {{Value1}} → Create action
6. Review and finish
7. Den Schalter auf On stellen, falls nicht geschehen
8. https://ifttt.com/maker_webhooks → Documentation → Your key is

Incoming Webhooks für Slack

Um Zugriffe auf sensible (JSON-)Dateien mit Zugangs- und Token-Daten zu unterbinden, muss in .htaccess folgender Code-Snippet aufgenommen werden (in der Installationsdatei .htaccess bereits vorhanden):

<FilesMatch "(^\.|\.(json|md)$)">
    order deny,allow
    deny from all
</FilesMatch>

Nachfolgende Datenwerte zeigt die Battery Status Web App aktuell an:

• Charge Status (Prozent)
• Electric Range (Kilometer)
• Fully Charged (Reststunden)
• State of Charge (kWh)
• State of Charge Max (kWh)

Von Makeable