Anleitung für: Daikin FVXM25B2V1B mit BRP069C4x WLAN-Gateway
Diese Schritt-für-Schritt-Anleitung zeigt, wie du deine Daikin Luft-zu-Luft-Wärmepumpe über Homebridge (auf Umbrel) in Apple HomeKit integrierst.
Voraussetzungen
- Umbrel-Server läuft und ist erreichbar
- Homebridge ist auf Umbrel installiert
- Daikin Wärmepumpe mit BRP069C4x WLAN-Gateway
- Wärmepumpe ist in der Daikin Onecta App eingerichtet
- Account bei Daikin Onecta vorhanden
⚠️ Wichtiger Hinweis zum BRP069C4x Gateway
Das BRP069C4x Gateway nutzt NICHT die alte lokale Daikin API. Eine lokale Steuerung über homebridge-daikin-local ist nicht möglich. Du musst die Cloud-basierte Integration nutzen.
Teil 1: Daikin Developer Portal einrichten
Schritt 1.1: Developer Portal Account erstellen
- Gehe zu:
- Klicke auf „Sign Up“ oder „Register“
- WICHTIG: Registriere dich mit exakt denselben Zugangsdaten (E-Mail und Passwort), die du auch in der Daikin Onecta App nutzt
- Bestätige deine E-Mail-Adresse
⚠️ Häufiger Fehler: Unterschiedliche Accounts für Developer Portal und Onecta App führen dazu, dass keine Geräte gefunden werden!
Schritt 1.2: Neue App erstellen
- Logge dich im Developer Portal ein
- Klicke oben rechts auf deinen Namen → „My Apps“
- Klicke auf „+ New App“ oder „Create Application“
- Fülle das Formular aus:
- Application Name: z.B. „Homebridge Integration“
- Application Type/Auth Strategy: „Onecta OIDC“
- Redirect URI:
https://[DEINE-UMBREL-IP]:8582
Beispiel:https://192.168.0.105:8582
- Klicke auf „Create“ oder „Save“
Schritt 1.3: Client ID und Secret notieren
Nach dem Erstellen der App werden dir angezeigt:
- Client ID (z.B.
HIHZJ-2z_RNOVX8OwA0s0GvT) - Client Secret (z.B.
TpGeIef...)
🔴 Wichtig: Das Client Secret wird nur einmal angezeigt! Notiere beide Werte sofort.
Teil 2: Homebridge Plugin installieren
Schritt 2.1: Plugin installieren
- Öffne die Homebridge UI in Umbrel (normalerweise unter
http://[UMBREL-IP]:8581) - Gehe zu „Plugins“
- Suche nach: homebridge-daikin-cloud
- Klicke auf „Install“ beim Plugin von @jeroenvdb
Schritt 2.2: Plugin konfigurieren
Nach der Installation klicke auf „Settings“ und trage folgende Werte ein:
{
"clientId": "DEINE-CLIENT-ID",
"clientSecret": "DEIN-CLIENT-SECRET",
"callbackServerExternalAddress": "192.168.0.105",
"callbackServerPort": "8582",
"oidcCallbackServerBindAddr": "0.0.0.0",
"showExtraFeatures": false,
"updateIntervalInMinutes": 15,
"forceUpdateDelay": 60000,
"debug": true,
"platform": "DaikinCloud"
}❌ Häufige Konfigurationsfehler
http://192.168.0.105:8582in „Redirect URI address“ → Falsch! Nur die IP ohne http://127.0.0.1als Callback Server Listener → Falsch! Muss0.0.0.0sein- URL mit doppeltem Port (z.B.
:8581:8582) → Entsteht durch falsches Eintragen der Felder
Teil 3: OAuth-Autorisierung durchführen
Schritt 3.1: Autorisierungs-URL aus dem Log holen
- Gehe in Homebridge UI zu „Logs“
- Suche nach einer Zeile wie:
Please navigate to https://192.168.0.105:8582 to start the authorisation flow - Kopiere diese URL
Schritt 3.2: Autorisierung im Browser durchführen
- Öffne die URL in einem Browser im selben Netzwerk (nicht über Umbrel-UI)
- Du siehst eine Sicherheitswarnung (selbst-signiertes Zertifikat) – das ist normal
- Akzeptiere die Warnung:
- Chrome/Edge: „Erweitert“ → „Weiter zu [IP] (unsicher)“
- Firefox: „Erweitert“ → „Risiko akzeptieren und fortfahren“
- Safari: „Details“ → „Diese Website besuchen“
- Logge dich mit deinen Daikin Onecta Zugangsdaten ein
- Bestätige die Berechtigungen
- Du wirst zurück zu
https://[UMBREL-IP]:8582weitergeleitet - Erfolg: „Authorization complete – Thank you for authorizing daikin-controller-cloud“
Schritt 3.3: Erfolg überprüfen
Gehe zu Homebridge UI → „Logs“. Du solltest nach ca. 30 Sekunden sehen:
[homebridge-daikin-cloud] Create Device dx4
[homebridge-daikin-cloud] Device found with id: [...]
[homebridge-daikin-cloud] name: DaikinAP03482
[homebridge-daikin-cloud] modelInfo: BRP069C4xTeil 4: Gerät in HomeKit hinzufügen
- Öffne die Home App auf iPhone/iPad
- Tippe auf „+“ → „Gerät hinzufügen“
- Scanne den QR-Code aus der Homebridge UI oder gib den Code manuell ein
- Akzeptiere die Warnung „Nicht zertifiziertes Zubehör“
- Deine Wärmepumpe erscheint automatisch in der Home App
Steuerungsmöglichkeiten in HomeKit
- Ein/Aus: Gerät aktivieren/deaktivieren
- Modus: Heizen, Kühlen, Auto
- Zieltemperatur: Heizen 10–30°C / Kühlen 18–32°C (0,5°C Schritte)
- Anzeige: Raumtemperatur, Luftfeuchtigkeit, Außentemperatur
- Lüftergeschwindigkeit: 0–100% (wird auf Daikin-Stufen umgerechnet)
Fehlerbehebung
Problem: Keine Geräte gefunden
Prüfe, ob du denselben Account im Developer Portal UND in der Onecta App nutzt. Lösche ggf. die Token-Datei und autorisiere neu:
rm /var/lib/homebridge/.daikin-controller-cloud-tokensetProblem: ERR_CONNECTION_REFUSED
Der Callback Server Listener muss 0.0.0.0 sein (nicht 127.0.0.1). Port 8582 darf nicht von einer anderen Anwendung belegt sein.
Problem: API Rate Limit
Die Daikin Cloud API erlaubt 200 Aufrufe/Tag und 20 Aufrufe/Minute. Erhöhe das Update-Intervall auf mindestens 15 Minuten:
"updateIntervalInMinutes": 30Problem: Token wird nicht gespeichert
Deaktiviere den „Child Bridge“ Modus in den Plugin-Einstellungen und stelle sicher dass Homebridge Schreibrechte auf /var/lib/homebridge/ hat.
Wichtige Hinweise
- 🌐 Cloud-abhängig: Funktioniert nur mit Internetverbindung – keine lokale Steuerung möglich
- ⏱️ Rate Limits: Max. 200 API-Aufrufe/Tag → Intervall nicht zu niedrig setzen
- 🔑 Account: Developer Portal und Onecta App müssen denselben Account verwenden
Weiterführende Links
Verwandte Artikel
Hast du eine Frage zu diesem Artikel?
Schreib uns – wir antworten in der Regel innerhalb eines Werktages.