Home Assistant Integration for Daikin devices using the Daikin Onecta API, requires Home Assistant 2024.1.0 as minimum HA version.
Important
Starting with v4.0.0 the cloud API has changed to the Daikin provided official API. In order to use this new API you need to create an account on the Daikin Developer Portal at https://developer.cloud.daikineurope.com/login.
Warning
Sharing, selling, or distribution access and refresh tokens is strictly prohibited according to the Daikin developer terms of use. Sharing them could case serious issues for you as user!
Copy the daikin_onecta
folder and all of its contents into your Home Assistant's custom_components
folder. This is often located inside of your /config
folder. If you are running Hass.io, use SAMBA to copy the folder over. If you are running Home Assistant Supervised, the custom_components
folder might be located at /usr/share/hassio/homeassistant
. It is possible that your custom_components
folder does not exist. If that is the case, create the folder in the proper location, and then copy the daikin_onecta
folder and all of its contents inside the newly created custom_components
folder. Then you have to restart Home Assistant for the component to be loaded properly.
Visit https://developer.cloud.daikineurope.com and sign up for a developer account. Enter the email of your login for the Onecta App from Daikin.
Start by going to Settings - Devices & Services and pressing the + ADD INTEGRATION
button to create a new Integration, then select Daikin Onecta
in the drop-down menu.
Follow the instructions, you have to login at Daikin and authorize the application. After pressing the "Submit" button, the integration will be added, and the Daikin devices connected to your cloud account will be created.
The OAuth Client ID
and OAuth Client Secret
need to be obtained from Daikin, see https://developer.cloud.daikineurope.com/docs/b0dffcaa-7b51-428a-bdff-a7c8a64195c0/getting_started for the id/secret keys which are valid Spring 2024. The Name
is user defined, for example Daikin
. You must create a Daikin Developer account to obtain the id/secret.
This integration supports the following configuration settings to reduce the amount of polling to Daikin
- High frequency period update interval (minutes)
- Low frequency period update interval (minutes)
- High frequency period start time
- Low frequency period start time
- Number of seconds that a data refresh is ignored after a command
If you'd like to see more granular logs, to investigate the communication or for other debugging purposes, you can set the log level in the Home Assistant config. The following lines can be added to set the overall log level for the component and the oauth2 helper which this integration uses:
logger:
logs:
custom_components.daikin_onecta: debug
homeassistant.helpers.config_entry_oauth2_flow: debug
If you only want to change log level on a per module basis, you can do that as well, for example if you only want debug logs for the climate:
logger:
logs:
custom_components.daikin_onecta.climate: debug
This code is based on @rospogrigio and @speleolontra work which is based on @Apollon77 work.