DKN Cloud NA — Home Assistant Integration
Control your Daikin mini-split air conditioners through Home Assistant using the DKN Cloud NA cloud service.
This integration is a port of the homebridge-dkncloudna plugin by @plecong, adapted for Home Assistant and distributed via HACS.
Supported Hardware
Any Daikin mini-split system connected to the DKN Cloud NA WiFi adapter (North America). The adapter must be set up and working in the official DKN Cloud NA mobile app before using this integration.
Prerequisites
- A working DKN Cloud NA account
- Your Daikin unit(s) already set up and visible in the DKN Cloud NA app
- Home Assistant 2024.1 or later
- HACS 2.0 or later
Installation
Via HACS (recommended)
- Open HACS in your Home Assistant instance
- Go to Integrations
- Click the ⋮ menu → Custom repositories
- Add
https://github.com/lavoiesl/homeassistant-dkncloudnaas an Integration - Search for DKN Cloud NA and install it
- Restart Home Assistant
Manual
Copy the custom_components/dkncloudna/ directory into your Home Assistant config/custom_components/ directory and restart.
Configuration
- Go to Settings → Devices & Services → Add Integration
- Search for DKN Cloud NA
- Enter your DKN Cloud NA email and password
- Optionally adjust the scan interval (default: 60 seconds)
- Optionally enable Show tokens after login to view your access and refresh tokens
All discovered devices are added automatically.
Entities
Each device exposes the following entities:
| Entity | Type | Description |
|---|---|---|
| AC unit | climate |
On/off, mode (auto/cool/heat/dry/fan), target temperature, fan speed, swing |
| Room temperature | sensor |
Current room temperature (°C) |
| Exterior temperature | sensor |
Outdoor temperature (°C) — disabled by default |
| Wi-Fi signal | sensor |
RSSI in dBm — diagnostic |
| Error code | sensor |
Active error code — diagnostic |
| Connected | binary_sensor |
Whether the device is online — diagnostic |
| Machine ready | binary_sensor |
Whether the device is ready to receive commands — diagnostic |
Known Limitations & Roadmap
- Login and device discovery are implemented. The integration authenticates against the DKN Cloud NA API and discovers configured devices.
- Device control is not yet implemented. This release establishes the integration scaffolding and entity structure. Setting temperature, mode, fan speed, and swing will be implemented in a future release.
- Real-time updates via Socket.IO are not used; the integration polls the cloud API on a configurable interval (default 60s).
- Temperature units follow what the device reports; Fahrenheit devices are converted to Celsius for Home Assistant.
Credits
- Original Homebridge plugin: homebridge-dkncloudna by @plecong
- EU counterpart inspiration: DKNCloud-HASS by @eXPerience83