@plecong/homebridge-dkncloudna NPM

Homebridge DKN Cloud NA

This Homebridge plugin provides a platform for connecting devices using DKN Cloud NA to Apple's HomeKit.

Installation

Prerequisites

A DKN Cloud Wifi Adapter (e.g. AZAI6WSCDKA) that utilizes the DKN Cloud NA app from the iOS App Store or Google Play Store.
Node.js and Homebridge installed. Follow the instructions on the Homebridge Wiki to install Node.js and Homebridge.

Using the Homebridge Config UI X

The plugin can be installed using the Homebridge Config UI X

Manually

To install the plugin manually, run the following command:

npm -g i @plecong/homebridge-dkncloudna

Configuration

Using the Configuration UI

This plugin has a custom configuration UI. Open the configuration UI and enter your login information for the DKN Cloud NA app and select "Retrieve Tokens" to save access and refresh tokens needed to connect. These tokens are saved within the Homebrdge config.json and are automatically refreshed.

The configuration UI also has the option to save your login information including your password. Select "Remember Login" to save the password directly within the Homebridge configuration file.

Note: The configuration file is NOT secure, however saving your login information will ensure the plugin can always connect to DKN Cloud NA.

Manually

This plugin can be configured manually using your email and password used to login to DKN Cloud NA. To manually configure, add the following to the Homebridge config.json under platforms:

{
    "platform": "dkncloudna",
    "email": "<your email address>"
    "password": "<your password>"
}

Configuration Options

Option	Description	Type	Required
`platform`	Must be `dkncloudna` for Homebridge to recognize the configuration	N/A	`true`
`email`	Email address to login to DKN Cloud NA app	`string`	`false`
`password`	Password to login to DKN Cloud NA app	`string`	`false`
`token`	Token used to access DKN Cloud NA API. This will be set by the configuration UI by providing your `email`/`password`	`string`	`false`
`refreshToken`	Token used to refresh the Access Token when expired. This does not need to be manually set.	`string`	`false`
`enableExterior`	Enable the Exterior Temperature Sensor (restart required)	`boolean`	`false`
`enableFan`	Enable the EXPERIMENTAL Fan V2 control (restart required)	`boolean`	`false`

Features

Fan Control (EXPERIMENTAL)

By enabling the fan control in the configuration, a separate Fan V2 service is associated with the accessory. This allows for controlling the fan state (Auto/Manual), rotation speed (20%, 40%, 60%, 80%, 100%), and swing mode. The HomeKit Fan service does not map cleanly to the DKN Cloud NA app and the DKN Cloud NA app doesn't provide raw rotation speed, so the current implementation of the fan control is EXPERIMENTAL.

Release Notes

v0.1.0

Initial Release

v0.1.1

#6 Fix for issue loading on HOOBS due to import of homebridge

v0.2.0

#5 Feature request to expose the exterior temperature sensor
Added experimental fan control

Credits

homebridge-plugin homekit airzone DKN

@homebridge/plugin-ui-utils backo2 node-fetch socket.io-client

@everything-registry/sub-chunk-726 @infinitebrahmanuniverse/nolb-_ple

0.2.0

2 years ago

0.1.1

2 years ago

0.1.0

2 years ago