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)

1. Open HACS in your Home Assistant instance
2. Go to Integrations
3. Click the ⋮ menu → Custom repositories
4. Add https://github.com/lavoiesl/homeassistant-dkncloudna as an Integration
5. Search for DKN Cloud NA and install it
6. Restart Home Assistant

Manual

Copy the custom_components/dkncloudna/ directory into your Home Assistant config/custom_components/ directory and restart.

---

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for DKN Cloud NA
3. Enter your DKN Cloud NA email and password
4. Optionally adjust the scan interval (default: 60 seconds)
5. 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