FordPass Smart-Home-Integration, kostenlos und Open Source

Ihre Ford-Fahrzeuge in Gladys: Tank, Akku, Schloss, Reifen, Position und Fernbefehle.

• Veröffentlicht von gboulvin
• Geräte
• Version 1.0.3
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Bringt Ihre Ford-Fahrzeuge in Gladys: Tank- oder Akkustand, Reichweite, Kilometerstand, Verriegelung, Alarmanlage, Türen und Fenster, Reifendruck, Position und die Fernbefehle der FordPass-App (verriegeln, entriegeln, Fernstart, Laden).

Diese Integration nutzt dieselben Server wie die FordPass-App. Ford bietet dafür keine öffentliche API an: Ford kann sie jederzeit ändern, und die Integration braucht dann eventuell ein Update.

Voraussetzungen

• Ein FordPass-Konto, in dem Ihre Fahrzeuge hinzugefügt und aktiviert sind (die vernetzten Dienste müssen eingeschaltet sein).
• Ein Computer mit Desktop-Browser (Chrome, Edge, Firefox…) für die einmalige Anmeldung.

Konto verbinden

Ford meldet Sie auf seiner eigenen Seite an und versucht dann, die FordPass-App zu öffnen. Ein Browser kann die App nicht öffnen, deshalb kopieren Sie die letzte Adresse von Hand. Das dauert zwei Minuten, einmalig.

1. Öffnen Sie in Gladys den Tab Konfiguration der Integration und wählen Sie die Region Ihres FordPass-Kontos. Speichern.
2. Klicken Sie neben Ford-Konto auf Verbinden. Die Ford-Anmeldeseite öffnet sich in einem neuen Tab. Melden Sie sich dort nicht an: Kopieren Sie die Adresse dieser Seite aus der Adressleiste und schließen Sie den Tab.
3. Öffnen Sie einen neuen Tab, öffnen Sie die Entwicklertools des Browsers (F12, oder Strg+Umschalt+I / Cmd+Option+I auf dem Mac), wählen Sie den Tab Netzwerk und aktivieren Sie Log beibehalten (Firefox: ⚙ → Logs nicht leeren). Die Entwicklertools zeichnen nur den Tab auf, in dem sie geöffnet wurden, und die Anmeldung durchläuft mehrere Seiten (darunter die des Bestätigungscodes): Ohne dieses Kästchen wird die Liste unterwegs geleert.
4. Fügen Sie die kopierte Adresse in die Adressleiste dieses Tabs ein und drücken Sie Enter. Melden Sie sich mit der E-Mail-Adresse und dem Passwort Ihres FordPass-Kontos an und geben Sie dann den Bestätigungscode ein, den Ford Ihnen schickt (Zwei-Faktor-Authentifizierung).
5. Die Seite scheint dann endlos zu laden: Das ist normal. Im Tab Netzwerk wird die letzte Anfrage rot angezeigt; ihr Initiator ist authorize?redirect_uri=fordapp://userauthorized&… und ihre Adresse beginnt mit fordapp://userauthorized/?code= (geben Sie code= in das Filterfeld ein, um sie zu finden). Rechtsklick → Kopieren → URL kopieren. In Firefox erscheint die Adresse eventuell stattdessen in der Konsole als Fehler („Öffnen verhindert“): Kopieren Sie sie von dort.
6. Führen Sie in Gladys die Aktion Anmeldung abschließen aus und fügen Sie die Adresse ein. Sofort: Der Code ist nur wenige Minuten gültig, und die Anmeldung muss innerhalb von 10 Minuten nach dem Klick auf Verbinden abgeschlossen sein.
7. Die Antwort listet die gefundenen Fahrzeuge auf. Öffnen Sie den Tab Erkennung und fügen Sie sie hinzu.

Ihr Passwort erreicht Gladys nie: Die Integration erhält nur einen Einmalcode, der gegen Tokens getauscht wird, die in der Konfiguration der Integration gespeichert sind. Ford hält die Sitzung monatelang aufrecht; läuft sie ab (Passwort geändert, zu lange unbenutzt), zeigt der Konfigurationsbildschirm es an: Wiederholen Sie die Schritte oben.

Das Fahrzeug in Gladys

Jedes Fahrzeug ist ein Gerät. Seine Funktionen hängen vom Antrieb ab:

Funktion	Benzin / Diesel / Hybrid	Elektro / Plug-in-Hybrid
Kilometerstand	✓	✓
Tankfüllstand, Reichweite (Kraftstoff)	✓	✓ (nur Plug-in-Hybrid)
Akkustand, elektrische Reichweite		✓
Ladevorgang (steuerbar), angesteckt, Leistung		✓
12-V-Batterie	✓	✓
Zentralverriegelung (steuerbar)	✓	✓
Alarmanlage scharf	✓	✓
Tür offen, Fenster offen	✓	✓
Fernstart (steuerbar)	✓	✓
Öl-Restlebensdauer	✓	✓ (nur Plug-in-Hybrid)
Außentemperatur	✓	✓
Druck jedes Reifens	✓	✓

Ein Wert, den Ihr Fahrzeug nicht meldet, bleibt einfach leer.

Die Funktion Zentralverriegelung verriegelt (ein) und entriegelt (aus) das Fahrzeug, Fernstart startet den Motor bzw. die Vorklimatisierung (ein) oder stoppt sie (aus), Ladevorgang startet oder stoppt das Laden. Ford leitet einen Befehl in 10 bis 60 Sekunden an das Auto weiter; die Funktion zeigt danach den vom Auto bestätigten Zustand.

Einstellungen

• Aktualisierungsintervall: wie oft jedes Fahrzeug gelesen wird (standardmäßig 5 Minuten, mindestens 1 Minute). Das Lesen holt nur, was die Ford-Server schon kennen: Es weckt das Auto nie auf und entlädt seine Batterie nicht. Das Auto schickt selbst neue Werte, wenn es fährt, verriegelt wird, lädt…
• Entfernungseinheit und Einheit des Reifendrucks.
• Schwelle niedriger Tank / Akku: der Wert, der den Szenen-Auslöser Tank oder Akku niedrig auslöst (standardmäßig 15 %).
• Sprache der Funktionsnamen: Englisch, Französisch, Deutsch oder Spanisch, angewendet beim Hinzufügen eines Fahrzeugs.

Aktionen

• Anmeldung abschließen — siehe oben.
• Verbindung testen — listet die Fahrzeuge des Kontos auf.
• Von Ford abmelden — löscht die gespeicherten Tokens. Die Fahrzeuge bleiben mit ihrem Verlauf in Gladys.

Szenen

Die Integration fügt dem Szenen-Editor eigene Karten hinzu (Gladys 5.1 oder neuer).

Auslöser:

• Tank oder Akku niedrig — der Stand ist unter die eingestellte Schwelle gefallen. Filter: Fahrzeug und Energie (Kraftstoff, Akku). Variablen: {{triggerEvent.data.energy}}, {{triggerEvent.data.level}}.
• Alarm ausgelöst — die Diebstahlwarnanlage wurde ausgelöst. Variablen: latitude und longitude des Fahrzeugs.
• Reifendruckwarnung — die Reifendruckkontrolle hat ein Rad gemeldet. Variablen: wheel (z. B. rear_left), pressure.
• Laden beendet — ein Elektro- oder Plug-in-Hybridfahrzeug hat das Laden beendet. Variablen: level, range.
• Zündung ein- oder ausgeschaltet — Beginn oder Ende einer Fahrt. Filter: Eingeschaltet / Ausgeschaltet. Variablen: state, odometer.

Die Gerätefunktionen funktionieren auch mit dem Standard-Auslöser Ein Gerät ändert seinen Zustand (z. B. „Zentralverriegelung wechselt auf 0“).

Aktionen:

• Befehl an ein Ford-Fahrzeug senden — verriegeln, entriegeln, Fernstart, Fernstart stoppen, Laden starten oder stoppen oder Daten aktualisieren (Letzteres weckt das Fahrzeug auf: begrenzt auf 24 pro Tag). Ausgaben: success und status, damit die nächsten Aktionen prüfen können, ob das Auto gehorcht hat.
• Status eines Ford-Fahrzeugs lesen — die letzten bei Ford bekannten Werte für die nächsten Aktionen: odometer, fuel_level, battery_level, range, locked, doors_open, windows_open, charging, latitude, longitude.

Beispiel: jeden Abend um 22 Uhr → Status des Fahrzeugs lesen → wenn locked falsch ist → Befehl „Verriegeln“ senden und benachrichtigen.

Dashboard

• Ford-Fahrzeug — wählen Sie ein Fahrzeug: Energie, Reichweite und Kilometerstand live, der Zustand von Verriegelung, Alarm, Türen, Fenstern, Reifen und Ladung, die Zeit der letzten Aktualisierung, und Schaltflächen zum Verriegeln, Entriegeln (mit Bestätigung), Aktualisieren und Öffnen der Position auf einer Karte.
• Ford-Fahrzeuge — alle Fahrzeuge des Kontos mit Stand, Reichweite, Verriegelung und einem Kartenlink.

Fehlerbehebung

• „Ford hat die Anmeldung abgelehnt“: Der Code ist abgelaufen oder wurde schon benutzt. Klicken Sie erneut auf Verbinden und fügen Sie die neue Adresse sofort ein. Prüfen Sie die Region.
• „Keine Anmeldung läuft“: Seit dem Klick auf Verbinden sind mehr als 10 Minuten vergangen: Klicken Sie erneut.
• Kein Fahrzeug gefunden: Das Fahrzeug muss mit demselben Konto in der FordPass-App hinzugefügt und aktiviert sein.
• „Vehicle not authorized“ in den Logs: Akzeptieren Sie die vernetzten Dienste erneut in der FordPass-App.
• Ein Befehl schlägt fehl: Das Fahrzeug ist vielleicht im Tiefschlaf (tagelang unbenutzt, schwache 12-V-Batterie), ohne Mobilfunkempfang, oder verweigert den Befehl (Fernstart bei offener Tür, Alarm…). Das Widget zeigt „Befehle pausiert“ während des Tiefschlafs.
• Die Werte ändern sich nicht: Das Auto schickt neue Werte nur bei Benutzung; lösen Sie im Widget Aktualisieren aus, um neue anzufordern.

Die Logs der Integration (Gladys → Integrationen → FordPass) enthalten nie Ihre Tokens oder Ihr Passwort.

Konfigurationseinstellungen

Diese Einstellungen fragt FordPass in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
FordPass-Konto verbinden	section	Nein	1. Wählen Sie Ihre Region und speichern Sie. 2. Klicken Sie auf Verbinden, kopieren Sie die Adresse der sich öffnenden Ford-Seite und schließen Sie sie. 3. Öffnen Sie in einem neuen Tab die Entwicklertools (F12), Tab Netzwerk, aktivieren Sie „Log beibehalten“ und fügen Sie dann die Adresse ein. 4. Melden Sie sich mit Ihrem FordPass-Konto und dem Bestätigungscode an, den Ford schickt. 5. Die Seite lädt nie fertig: Kopieren Sie die rote Anfrage, die mit fordapp://userauthorized/?code= beginnt, und fügen Sie sie in die Aktion „Anmeldung abschließen“ unten ein. Ihr Passwort erreicht Gladys nie.
Region des FordPass-Kontos	select	Ja	Das Land, in dem Ihr FordPass-Konto erstellt wurde.
Ford-Konto	account_link	Nein	Öffnet die Ford-Anmeldeseite. Führen Sie danach „Anmeldung abschließen“ aus.
Aktualisierungsintervall (s)	number	Nein	Wie oft jedes Fahrzeug gelesen wird, in Sekunden (mindestens eine Minute). Das Lesen weckt das Auto nie auf.
Entfernungseinheit	select	Nein
Einheit des Reifendrucks	select	Nein
Schwelle niedriger Tank / Akku (%)	number	Nein	Unter diesem Wert löst der Szenen-Auslöser „Tank oder Akku niedrig“ aus.
Sprache der Funktionsnamen	select	Nein	Wird beim Hinzufügen eines Fahrzeugs verwendet.

So installierst du FordPass in Gladys

1. Öffne in Gladys Integrationen: FordPass erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gboulvin/gladys-fordpass:1.0.3) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-FordPass.

FordPass benötigt Gladys >=5.1.0. 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

FordPass 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 gboulvin 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

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂