Daikin Wärmepumpe in HomeKit integrieren (Umbrel/Homebridge)

Autor

Andreas Olbricht

Datum 08. März 2026

Kategorie Hardware & Netzwerk

Inhalt

Voraussetzungen
Teil 1: Daikin Developer Portal einrichten
Teil 2: Homebridge Plugin installieren
Teil 3: OAuth-Autorisierung durchführen
Teil 4: Gerät in HomeKit hinzufügen
Steuerungsmöglichkeiten in HomeKit
Fehlerbehebung
Wichtige Hinweise
Weiterführende Links

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:8582 in „Redirect URI address“ → Falsch! Nur die IP ohne http://
127.0.0.1 als Callback Server Listener → Falsch! Muss 0.0.0.0 sein
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]:8582 weitergeleitet
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: BRP069C4x

Teil 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-tokenset

Problem: 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": 30

Problem: 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