Important
Die "alte" API wird von Daikin am 03.07.2024 abgeschaltet bzw. der bisher benutzte API-KEY für ungültig erklärt. Ab diesem Zeitpunkt wird das Modul bis einschließlich der Version 1.3.6 nicht mehr funktionieren. Es ist dann zwingend ein Update auf die neue Modul-Version 2.x.x erforderlich, um die neue OPEN-API nutzen zu können.
Es handelt sich um ein Modul für FHEM, um Klimageräte von Daikin über die Daikin-Cloud zu steuern.
Damit die Klimageräte gesteuert werden können, ist es erforderlich, dass der Registrierungsprozess in der ONECTA-App abgeschlossen worden ist. Das heißt die Innengeräte sind mit dem Internet verbunden und in der Daikin-Cloud ersichtlich.
Alle Geräte (z.B. Klimasplitgeräte, Multisplitgeräte, Altherma), die über die ONECTA-App mit der DaikinCloud verbunden worden sind, sollten mit diesem Modul angezeigt bzw. gesteuert werden können.
Um die Schnittstelle (API) von Daikin nutzen zu können, muss zunächst das Daikin Developer Portal https://developer.cloud.daikineurope.com/login aufgerufen werden. Dort meldest du dich mit den Zugangsdaten für die ONECTA-App an.
Im Daikin Developer Portal legst du wie folgt eine neue APP an: Rechts oben bei deiner E-Mail-Adresse öffnest du das Drop-Down-Menü und wählst My Apps -> New App. Du vergibst einen frei wählbaren Application Name (z.B. FHEM - DaikinCloud). Ferner definierst du die REDIRECT_URI. Am einfachsten ist es, dort die Adresse https://my.home-assistant.io/redirect/oauth zu verwenden.
Es besteht auch die Möglichkeiten, eine individuelle REDIRECT_URI für FHEM zu definieren. Diese muss nach folgendem Schema erstellt/definiert werden: https://<IP-FHEM-Server>:8083/fhem?cmd=set%20<Master-Device-Name>%20AuthCode%20. Hierbei ist zu beachten, dass nur sichere Verbindungen (also https) als REDIRECT_URI akzeptiert werden. IP-FHEM-Server und Master-Device-Name sind durch die entsprechende IP und Device-Namen zu ersetzen. Ferner ist zu beachten, dass bei Nutzung des csrfToken in FHEM (Standard ab FHEM-Version 5.8) noch ein &fwcsrf=<dein CSRF-Token> angehangen wird (zu ersetzen durch den jeweiligen CSRF-Token -> vgl. INTERNAL CSRFTOKEN im Device FHEMWEB). Da die individuelle Konfiguration der REDIRECT_URI mit vielen Fallstricken verbunden ist, kann ich jedem Einsteiger nur empfehlen stattdessen https://my.home-assistant.io/redirect/oauth als REDIRECT_URI zu verwenden.
Im Anschluss werden dir die CLIENT_ID und (einmal!) das CLIENT_SECRET angezeigt. Kopiere und speichere dir diese beiden Werte. Achte insbesondere darauf, das CLIENT_SECRET zu speichern, da es nur dieses eine Mal angezeigt wird!
-
Damit das Modul in FHEM verwendet werden kann, ist der folgende update-Befehl in FHEM auszuführen:
update all https://raw.githubusercontent.com/frank-lie/DaikinCloud/main/controls_DaikinCloud.txtAlternativ kann auch die Datei "FHEM/58_DaikinCloud.pm" manuell in den Ordner fhem/FHEM kopiert werden.
Tip
Um automatisch immer die aktuelle Version des Moduls im Rahmen des FHEM-Befehls update zu erhalten, kann man den Link auch generell als Update-Quelle hinzufügen:
update add https://raw.githubusercontent.com/frank-lie/DaikinCloud/main/controls_DaikinCloud.txt
-
Nach einem Update von FHEM sollte in der Regel ein Neustart von FHEM gemacht werden, damit alle Änderungen ordnungsgemäß geladen werden:
shutdown restart -
Für die Kommunikation mit der Daikin-Cloud ist in FHEM zunächst ein Master-Device anzulegen:
define Daikin_Master DaikinCloud <CLIENT_ID> <CLIENT_SECRET> <REDIRECT_URI>Verwende hierfür die unter Vorbereitung gespeicherten Werte für CLIENT_ID und CLIENT_SECRET. Achte darauf, dass die REDIRECT_URI zu 100% identisch mit der im Daikin Developer Portal angegebenen REDIRECT_URI ist. Ansonsten wird die Authorisierung fehlschlagen.
-
Sobald das Master-Device erstellt worden ist, kann der AUTHORIZATION_LINK (zu finden als INTERNAL im Master-Device) aufgerufen werden, um den Authorisierungsprozess zu starten. Ihr werdet auf die Seite von Daikin geleitet, müsst euch dort einloggen, den Nutzungsbedingungen zustimmen und die Freigabe der Daten erlauben. Anschließend werdet ihr auf die REDIRECT_URI weitergeleitet.
-
Wenn ihr eine individuelle REDIRECT_URI für FHEM konfiguriert habt, wird der Authorisierungscode automatisch an FHEM übergeben. Wenn dies nicht funktioniert, überprüft eure REDIRECT_URI oder verwendet die oben angegebene allgemeime REDIRECT_URI. Bei Verwendung der allgemeinen REDIRECT_URI erfolgt eine Weiterleitung/Mitbenutzung von
https://my.home-assistant.io/redirect/oauth, um den Authorisierungscode zu bekommen. Bevor ihr eine Fehlermeldung wie"Invalid paramaters given"wegklickt, muss der komplette Link der Internetseite aus dem Browser (https://my.home-assistant.io/redirect/oauth/?code=xxxxxxxxxxxx) in die Zwischenablage kopiert und in FHEM als set-command eingegeben werden:set Daikin_Master AuthCode <kompletter Link der Rückgabe-URL> -
Mit dem Setzen des Authorisierungscodes bekommt FHEM die erforderlichen Token für den Zugriff auf die Daikin-Cloud übermittelt. Die Einrichtung des Master-Devices ist damit abgeschlossen. Die Innengeräte werden standardmäßig beim Abruf der Daten aus der Cloud als Device in FHEM angelegt. Standardmäßig werden die Daten aus der Cloud alle 900 Sekunden abgerufen / aktualisiert.
-
Aktuell hat Daikin Request-Limits für das Abrufen der Cloud-Daten und das Senden von Kommandos hinterlegt. Pro Tag können maximal 200 Anfragen und pro Minute maximal 20 Anfragen gesendet werden. Sowohl bei dem 24-Stunden-Limit als auch dem 1-Minuten-Limit handelt es sich um gleitende Zeitfenster, die fortlaufend aktualisiert bzw. immer zeitweise zurückgesetzt werden.
-
Aktuell sind (noch) nicht alle Datenpunkte in der neuen OPEN-API enthalten. Es fehlen insbesondere: dryKeepSetting, fanMotorRotationSpeed, heatExchangerTemperature, suctionTemperature und diverse wifi-readings. Ferner sind z.B. demandControl und demandValue nicht vorhanden, so dass aktuell auch keine Bedarfssteuerung möglich ist. Es handelt sich hierbei um Einschränkungen, die die neue OPEN-API mit sich bringt und damit durch das Modul auch nicht behoben oder beseitigt werden können. Sobald Daikin die Daten in der neuen OPEN-API zur Verfügung stellt, stehen diese automatisch auch (wieder) in FHEM zur Verfügung.