Daikin Onecta

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. The status of the Daikin Cloud can be found online at https://daikincloudsolutions.statuspage.io.

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!

Installation

When using HACS add daikin_onecta as custom repository, select HACS, select Integrations, press the three dots in the upper right corner, select Custom Repositories and add https://github.com/jwillemsen/daikin_onecta as new repository. Now continue the installation as described at Using config flow

You can install the code manually by copying 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.

Prerequisites

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.

Using config flow

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. See https://www.home-assistant.io/integrations/application_credentials for more information about application credentials within Home Assistant.

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.

When you try to reinstall this integration check if you don't have an old client id and secret configured within Home Assistant, see Application Credentials for more information.

At this moment only https://my.home-assistant.io/redirect/oauth is supported as redirect_uri, see https://www.home-assistant.io/integrations/home_connect/ for some additional documentation about using My Home Assistant.

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

Setting the log level

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

Thanks to:

This code is based on @rospogrigio and @speleolontra work which is based on @Apollon77 work.