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

Klimaanlage zeigt aktuelle Temperatur an
Inhalt

    Anleitung für: Daikin FVXM25B2V1B mit BRP069C4x WLAN-Gateway

    Diese Schritt-für-Schritt-Anleitung zeigt, wie Sie Ihre Daikin Luft-zu-Luft-Wärmepumpe über Homebridge (auf Umbrel) in Apple HomeKit integrieren.

    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. Sie müssen die Cloud-basierte Integration nutzen.

    Teil 1: Daikin Developer Portal einrichten

    Schritt 1.1: Developer Portal Account erstellen

    1. Gehen Sie zu: https://developer.cloud.daikineurope.com/
    2. Klicken Sie auf „Sign Up“ oder „Register“
    3. WICHTIG: Registrieren Sie sich mit exakt denselben Zugangsdaten (E-Mail und Passwort), die Sie auch in der Daikin Onecta App auf Ihrem iPhone/Android nutzen
    4. Bestätigen Sie Ihre E-Mail-Adresse

    ⚠️ Häufiger Fehler: Unterschiedliche Accounts für Developer Portal und Onecta App führen dazu, dass keine Geräte gefunden werden!

    Bildschirmfoto 2025 11 10 um 23.12.16

    Schritt 1.2: Neue App erstellen

    1. Loggen Sie sich im Developer Portal ein
    2. Klicken Sie oben rechts auf Ihren Namen → „My Apps“
      Bildschirmfoto 2025 11 10 um 23.12.26
    3. Klicken Sie auf „+ New App“ oder „Create Application“
    4. Füllen Sie das Formular aus:
      • Application Name: z.B. „Homebridge Integration“
      • Application Type/Auth Strategy: „Onecta OIDC“
      • Redirect URI: https://[IHRE-UMBREL-IP]:8582
        • Beispiel: https://192.168.0.105:8582
        • Tragen Sie die lokale IP-Adresse Ihres Umbrel-Servers ein
        • Port 8582 ist wichtig (nicht 8581!)
    5. Klicken Sie auf „Create“ oder „Save“

    Schritt 1.3: Client ID und Secret notieren

    Nach dem Erstellen der App werden Ihnen angezeigt:

    • Client ID (z.B. HIHZJ-2z_RNOVX8OwA0s0GvT)
    • Client Secret (z.B. TpGeIef...)

    ⚠️ Wichtig: Das Client Secret wird nur einmal angezeigt! Notieren Sie beide Werte sofort.

    Schritt 1.4: Redirect URI überprüfen

    Stellen Sie sicher, dass in Ihrer App die Redirect URI korrekt eingetragen ist:

    https://[IHRE-UMBREL-IP]:8582

    Beispiel: https://192.168.0.105:8582

    Teil 2: Homebridge Plugin installieren

    Schritt 2.1: Plugin suchen und installieren

    1. Öffnen Sie Homebridge UI in Umbrel (normalerweise unter http://[UMBREL-IP]:8581)
    2. Gehen Sie zu „Plugins“
    3. Suchen Sie nach: „homebridge-daikin-cloud“
    4. Klicken Sie auf „Install“ beim Plugin von @jeroenvdb
    5. Warten Sie bis die Installation abgeschlossen ist

    Schritt 2.2: Plugin konfigurieren

    1. Nach der Installation klicken Sie auf „Settings“ beim Plugin
    2. Tragen Sie folgende Werte ein:

    Pflichtfelder:

    • Client ID: [Ihre Client ID aus dem Developer Portal]
    • Client Secret: [Ihr Client Secret aus dem Developer Portal]
    • Redirect URI address: [IHRE-UMBREL-IP] (nur die IP, z.B. 192.168.0.105)
    • Redirect URI port: 8582
    • Callback Server address listener: 0.0.0.0

    Optionale Felder:

    • Show Extra Features: false (oder true wenn Sie Powerful Mode, Quiet Mode etc. als separate Schalter wollen)
    • Update Interval (Minutes): 15 (Standard – nicht zu niedrig wegen API-Limits!)
    • Debug Mode: true (für Fehlersuche, später auf false setzen)

    ⚠️ Häufige Fehler:

    • ❌ 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
    • ❌ Zwei Ports in der URL (z.B. :8581:8582) → Entsteht durch falsches Eintragen der Felder

    Korrekte Konfiguration (JSON-Ansicht):

    json
    {
    "clientId": "IHRE-CLIENT-ID",
    "clientSecret": "IHR-CLIENT-SECRET",
    "callbackServerExternalAddress": "192.168.0.105",
    "callbackServerPort": "8582",
    "oidcCallbackServerBindAddr": "0.0.0.0",
    "showExtraFeatures": false,
    "updateIntervalInMinutes": 15,
    "forceUpdateDelay": 60000,
    "debug": true,
    "platform": "DaikinCloud"
}
    1. Klicken Sie auf „Save“
    2. Starten Sie Homebridge neu

    Teil 3: OAuth-Autorisierung durchführen

    Schritt 3.1: Autorisierungs-URL aus dem Log holen

    1. Gehen Sie in Homebridge UI zu „Logs“
    2. Suchen Sie nach einer Zeile wie:
    Please navigate to https://192.168.0.105:8582 to start the authorisation flow
    1. Kopieren Sie diese URL

    Schritt 3.2: Autorisierung im Browser durchführen

    1. Wichtig: Öffnen Sie die URL in einem Browser auf einem Gerät im selben Netzwerk (nicht über Umbrel-UI)
    2. Öffnen Sie: https://[IHRE-UMBREL-IP]:8582
    3. Sie sehen eine Sicherheitswarnung (selbst-signiertes Zertifikat) – das ist normal!

    So akzeptieren Sie die Warnung:

    • Chrome/Edge: Klicken Sie auf „Erweitert“ → „Weiter zu [IP] (unsicher)“
    • Firefox: Klicken Sie auf „Erweitert“ → „Risiko akzeptieren und fortfahren“
    • Safari: Tippen Sie auf „Details“ → „Diese Website besuchen“
    1. Nach dem Akzeptieren werden Sie zur Daikin Login-Seite weitergeleitet
    2. Loggen Sie sich mit Ihren Daikin Onecta Zugangsdaten ein
    3. Bestätigen Sie die Berechtigungen für die App
    4. Sie werden zurück zu https://[IHRE-UMBREL-IP]:8582 weitergeleitet
    5. Sie sehen: „Authorization complete – Thank you for authorizing daikin-controller-cloud“

    ⚠️ Häufige Fehler:

    • ❌ „ERR_CONNECTION_REFUSED“ → Callback Server Listener falsch konfiguriert (muss 0.0.0.0 sein)
    • ❌ „Website nicht erreichbar“ → Port 8582 ist nicht frei oder Firewall blockiert
    • ❌ Keine Geräte gefunden nach Autorisierung → Falscher Account im Developer Portal (muss mit Onecta App übereinstimmen)

    Schritt 3.3: Erfolg überprüfen

    1. Gehen Sie zurück zu Homebridge UI → „Logs“
    2. Warten Sie ca. 30 Sekunden
    3. Sie sollten sehen:
    [homebridge-daikin-cloud] Create Device dx4
[homebridge-daikin-cloud] Device found with id: [...]
[homebridge-daikin-cloud] name: DaikinAP03482
[homebridge-daikin-cloud] modelInfo: BRP069C4x
    1. Wenn Sie diese Zeilen sehen: Erfolg! 🎉

    Teil 4: Gerät in HomeKit hinzufügen

    Schritt 4.1: HomeKit Pairing

    Falls Homebridge noch nicht mit HomeKit verbunden ist:

    1. Öffnen Sie die Home App auf iPhone/iPad
    2. Tippen Sie auf „+“ (oben rechts)
    3. Wählen Sie „Gerät hinzufügen“
    4. Scannen Sie den QR-Code aus der Homebridge UI oder geben Sie den Code manuell ein (z.B. 205-21-576)
    5. Akzeptieren Sie die Warnung „Nicht zertifiziertes Zubehör“

    Schritt 4.2: Daikin Wärmepumpe finden

    Nach dem Pairing sollte Ihre Wärmepumpe automatisch in der Home App erscheinen:

    • Name: DaikinAP03482 (kann umbenannt werden)
    • Typ: Heizung/Kühlung
    • Aktueller Status: Temperatur wird angezeigt

    Teil 5: Steuerungsmöglichkeiten in HomeKit

    Grundfunktionen

    • Ein/Aus: Gerät aktivieren/deaktivieren
    • Modus wählen:
      • Heizen
      • Kühlen
      • Auto
    • Zieltemperatur einstellen:
      • Heizen: 10°C – 30°C (0,5°C Schritte)
      • Kühlen: 18°C – 32°C (0,5°C Schritte)
    • Aktuelle Raumtemperatur: Wird angezeigt
    • Luftfeuchtigkeit: Wird angezeigt (50%)
    • Außentemperatur: Wird angezeigt

    Erweiterte Funktionen

    In den Zubehör-Einstellungen in der Home App:

    Lüftergeschwindigkeit:

    • Prozentual einstellbar (0% – 100%)
    • Wird auf Daikin-Stufen umgerechnet:
      • 0-9%: Silent Mode
      • 10-20%: Auto
      • 21-40%: Stufe 3
      • 41-60%: Stufe 4
      • 61-80%: Stufe 5
      • 81-100%: Stufe 6 (Max)

    Swing-Modus (Oszillation):

    • Aktivierbar in den Einstellungen
    • Steuert die vertikale Luftstromrichtung

    Extra Features (wenn aktiviert)

    Falls Sie showExtraFeatures: true gesetzt haben, erscheinen zusätzliche Schalter:

    • Powerful Mode: Maximale Leistung
    • Indoor Quiet Mode: Leiser Betrieb
    • Dry Mode: Entfeuchtung
    • Fan Only Mode: Nur Ventilator

    Fehlerbehebung

    Problem: Keine Geräte gefunden

    Symptom: Nach Autorisierung erscheint im Log:

    Failed to get cloud devices from Daikin Cloud

    Lösung:

    1. Prüfen Sie, ob Sie denselben Account im Developer Portal UND in der Onecta App nutzen
    2. Öffnen Sie die Daikin Onecta App und stellen Sie sicher, dass Ihre Wärmepumpe dort sichtbar ist
    3. Löschen Sie die Token-Datei:
    bash
       rm /var/lib/homebridge/.daikin-controller-cloud-tokenset
    1. Starten Sie Homebridge neu
    2. Autorisieren Sie erneut über https://[UMBREL-IP]:8582

    Problem: „ERR_CONNECTION_REFUSED“ beim Öffnen der Autorisierungs-URL

    Ursache: Der Callback Server ist nicht richtig konfiguriert oder nicht erreichbar.

    Lösung:

    1. Prüfen Sie die Homebridge-Konfiguration
    2. Callback Server address listener muss 0.0.0.0 sein (NICHT 127.0.0.1)
    3. Port 8582 darf nicht von einer anderen Anwendung belegt sein
    4. Starten Sie Homebridge neu
    5. Versuchen Sie die URL erneut

    Problem: Falsche URL mit doppeltem Port

    Symptom: URL sieht so aus: https://192.168.0.105:8581:8582

    Ursache: Sie haben http://192.168.0.105 in das Feld „Redirect URI address“ eingetragen.

    Lösung:

    1. Tragen Sie im Feld „Redirect URI address“ NUR die IP ein: 192.168.0.105
    2. Das Feld „Redirect URI port“ enthält: 8582
    3. Das Plugin baut die URL automatisch zusammen
    4. Speichern und Homebridge neu starten

    Problem: API Rate Limit erreicht

    Symptom: Im Log erscheint:

    Rate Limit exceeded

    Ursache: Die Daikin Cloud API erlaubt nur 200 Aufrufe pro Tag.

    Lösung:

    1. Erhöhen Sie das Update-Intervall in der Konfiguration:
    json
       "updateIntervalInMinutes": 30
    1. Reduzieren Sie die Anzahl der manuellen Updates
    2. Warten Sie bis zum nächsten Tag (das Limit wird täglich zurückgesetzt)

    Problem: Gerät reagiert nicht auf Befehle

    Symptom: Befehle in HomeKit werden akzeptiert, aber das Gerät reagiert nicht.

    Lösung:

    1. Prüfen Sie die Internetverbindung (Cloud-basierte Steuerung!)
    2. Öffnen Sie die Daikin Onecta App und testen Sie die Steuerung dort
    3. Prüfen Sie im Homebridge Log nach Fehlermeldungen
    4. Starten Sie Homebridge neu
    5. Falls das Problem weiterhin besteht, löschen Sie die Token-Datei und autorisieren Sie neu

    Problem: Token wird nicht gespeichert

    Symptom: Nach jedem Neustart muss neu autorisiert werden.

    Lösung:

    1. Prüfen Sie die Berechtigungen im Homebridge Storage Directory:
    bash
       ls -la /var/lib/homebridge/
    1. Die Datei .daikin-controller-cloud-tokenset sollte existieren
    2. Falls nicht, prüfen Sie ob Homebridge Schreibrechte hat
    3. Deaktivieren Sie den „Child Bridge“ Modus:
      • Homebridge UI → Plugins → homebridge-daikin-cloud → Settings
      • Entfernen Sie den Haken bei „Child Bridge“
      • Speichern und neu starten

    Wichtige Hinweise

    API Rate Limits

    Die Daikin Cloud API hat folgende Beschränkungen:

    • 200 Aufrufe pro Tag
    • 20 Aufrufe pro Minute

    Das Plugin ruft standardmäßig alle 15 Minuten Updates ab. Das entspricht:

    • 96 Aufrufe pro Tag (innerhalb des Limits)

    ⚠️ Vermeiden Sie:

    • Zu häufige manuelle Updates
    • Mehrere Homebridge-Instanzen mit demselben Account
    • Automatisierungen, die sehr häufig den Status abfragen

    Cloud-Abhängigkeit

    Diese Integration funktioniert ausschließlich über die Daikin Cloud:

    • ✅ Steuerung von überall möglich (über iCloud/HomeKit)
    • ❌ Benötigt ständige Internetverbindung
    • ❌ Reagiert nicht sofort (Cloud-Latenz)
    • ❌ Funktioniert nicht bei Internetausfall

    Empfohlene HomeKit-Automatisierungen

    Beispiel 1: Heizen wenn niemand zuhause ist

    Wenn: Letzter Bewohner verlässt Zuhause
Dann: Setze Wärmepumpe auf Heizen, 18°C

    Beispiel 2: Nachtabsenkung

    Wenn: Zeit ist 22:00
Dann: Setze Wärmepumpe auf Heizen, 20°C

    Beispiel 3: Temperaturbasierte Steuerung

    Wenn: Raumtemperatur unter 19°C
Dann: Aktiviere Wärmepumpe (Heizen, 22°C)

    Technische Details

    Ihr spezifisches System

    • Inneneinheit: FVXM25B2V1B (Wandgerät)
    • Außeneinheit: RXM25A5V1B9
    • WLAN-Gateway: BRP069C4x
    • Gateway-Firmware: 2.0.0
    • Regler: DaikinAP03482

    Unterstützte Modi

    Ihre Wärmepumpe unterstützt folgende Betriebsmodi:

    • ✅ Heizen (Heating)
    • ✅ Kühlen (Cooling)
    • ✅ Auto
    • ✅ Entfeuchten (Dry)
    • ✅ Nur Ventilator (Fan Only)

    Lüftereinstellungen

    Verfügbare Modi:

    • Auto
    • Quiet (Leise)
    • Fixed (Manuell 1-5)

    Swing-Modus (Vertikal):

    • Stop
    • Swing
    • Floor Heating Airflow (nur im Heizmodus)

    Zusammenfassung der kritischen Punkte

    ✅ Verwenden Sie denselben Account für Developer Portal und Onecta App ✅ Callback Server Listener muss 0.0.0.0 sein ✅ Redirect URI im Developer Portal: https://[IP]:8582 ✅ Port 8582 für OAuth-Callback (nicht 8581!) ✅ Sicherheitswarnung beim Browser ist normal – akzeptieren Sie sie ✅ Rate Limits beachten – nicht zu häufig updaten ✅ Token-Datei wird in /var/lib/homebridge/ gespeichert

    Support und weitere Informationen

    Plugin-Repository: https://github.com/JeroenVdb/homebridge-daikin-cloud

    Issues/Probleme melden: https://github.com/JeroenVdb/homebridge-daikin-cloud/issues

    Daikin Developer Portal: https://developer.cloud.daikineurope.com/

    Unterstützte Geräte: https://www.daikin.eu/en_us/product-group/control-systems/onecta/connectable-units.html

    Changelog dieser Anleitung

    Version 1.0 – November 2025

    • Erstversion für FVXM25B2V1B mit BRP069C4x Gateway
    • Umbrel/Homebridge spezifisch
    • Alle bekannten Fehlerquellen dokumentiert

    Viel Erfolg bei der Integration! 🏡✨

    Aktualisiert am15. November 2025
    Tagged: , , ,
    War das hilfreich?
    Ja Nein

    Ähnliche Artikel

    Schreibe einen Kommentar

    Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

    Contents