This Homebrige plugin connects to the Daikin Cloud and loads all your devices to be controled via Homebridge and Homekit.
The plugin supports some basic Daikin airco settings:
- Current room temperature
- Set airco to cooling, heating or auto + the required temperature**
- Set the fan speed
- Swing mode (if supported by your device)
- Enable special modes (if supported by your device and enabled in config):
- powerful mode
- econo mode
- streamer mode
- outdoor silent mode
- indoor silent/quiet mode
** HomeKit does not support all operation modes of Daikin (for example dry and fan only).
Add config object to the platform array in your Homebridge config.json
.
{
"bridge": {
...
},
"accessories": [],
"platforms": [
{
"clientId": "<clientId>",
"clientSecret": "<clientSecret>",
"redirectUri": "<redirectUri>",
"port": "<redirectUri>",
"platform": "DaikinCloud",
"showExtraFeatures": false, // boolean, default: false
"excludedDevicesByDeviceId": [], // array of strings, find you deviceId in the logs when homekit starts
}
]
}
The following parameters are required:
- Client ID
- Client Secret
- Redirect URI
- Port
First 2 values you will get when you set up your App in the Daikin Europe Developer Portal. The last 2 values are the Redirect URI and port where the Daikin Cloud API will send the tokens to.
- Go to https://developer.cloud.daikineurope.com/
- In the upper right corner click your name and select "My Apps"
- Click "+ New App"
- Fill in your application name, auth strategy (Onecta OIDC) and redirect URI (see "The Redirect URI and port" below)
- Click create
You will receive a Client ID and Client Secret (keep it with you, you'll only see it once). The Redirect URI is the one you entered in step 4.
This plugin uses daikin-controller-cloud. This package will set up a small https server where the Authentication flow will finish, so it can get the required tokens. Because the server is running in our Homebridge instance this URI domain will match the one of your Homebridge instance, the port is any free port.
For example is you are running Homebridge on a Raspberry Pi with IP 192.168.0.160
and port 51826
, the Redirect URI will be https://192.168.0.160:51827
.
The port will be 51827
(or any other free port).
You can change the fan speed from the accessory settings screen.
Daikin fan speeds are expressed in a number from 1 to many, for example 1 to 5. In Home you need to express the fan speed in a percentage from 1% to 100%.
Example: if you have a Daikin airco with fan speed 1 to 5, you need to set the fan speed to 50% in Home to set the fan speed to 3 on your airco.
If your Daikin device support it you can enable swing mode from the accessory settings screen.
If your device supports vertical and horizontal swing both will be started and stopped. Via the Daikin app you can also have a silent swing, this is not yet supported because you can't select this from the Home app.
By default, this plugin creates a default HeaterCooler Service with the above possibilities. If you want you can add showExtraFeatures: true
to the config. This will create extra switches to enable more special modes of your Daikin (if available).
Supported:
- Streamer mode
- Econo mode
- Powerful mode
- Outdoor silent mode
- Indoor silent/quiet mode
Extra info and example: #8 (comment)
Install from NPM: https://www.npmjs.com/package/homebridge-daikin-cloud
Devices supported by Daikin Onecta app: https://www.daikin.eu/en_us/product-group/control-systems/onecta/connectable-units.html
- BRP069C4x
- BRP069A8x
- BRP069A78 - Altherma heatpump, we import this as a HeaterCooler (to be validated)
In HomeKit you expose an accessory which has one or more services, available services are:
- https://developer.apple.com/documentation/homekit/hmservice/accessory_service_types (HomeKit docs)
- https://developers.homebridge.io/#/service (Homebridge)
Each service has one or more characteristics, check both HomeKit and Homebridge docs to find out which are compatible. A service can have multiple child services, for example a HeaterCooler service can also have multiple Switch services. But not all services can be combined. Use HomeKit Accessory Simulator to find out which are compatible or via the HomeKit docs you can also find links from the service to other services.
For running a local Homebridge setup: https://github.com/oznu/homebridge-config-ui-x#installation-instructions
sudo hb-service start
sudo hb-service stop
Credits for the Daikin Cloud API goes to @Apollon77 for https://github.com/Apollon77/daikin-controller-cloud