homebridge-deye
TypeScript icon, indicating that this package has built-in type declarations

1.0.2 • Public • Published

Homebridge Deye

homebridge-deye license

Connects the Deye dehumidifier to HomeKit and allows control via the native iOS Home App and Siri. This plug-in theoretically supports most Deye dehumidifiers.

中文说明 | English

Function

  • Access to HomeKit as a dehumidifier device

  • Ambient temperature and humidity display

  • Dehumidifier water level display

  • Dehumidifier target humidity adjustment

  • Set the mode of dehumidifier. Sleep, Manual and Dry

  • Control fan speed (some models do not support this function)

  • Child lock (physical control lock)

  • HomeKit Automation

Supported devices

Theoretically, most Deye dehumidifiers can be connected.

The following devices have been tested.

  • Deye DYD-D50A3 (Touch Panel version) Link

  • Deye DYD-E12A3 Link

Screenshot

Installation

If you are new to Homebridge, please follow the documentation here to complete the installation of Homebridge and Homebridge Config UI X.

Installing the Dehumidifier plugin

sudo npm install -g homebridge-deye

Configuration

This plugin can be configured in Homebridge Config UI X, or manually.

You can use the Deye Device Information Getter to get the configuration information of your device.

Open Deye Device Information Getter, enter the cell phone number and password of your Deye account, and click Login. This page should display the server connection information and device information.

Please note: Since the Deye account only supports single-side login, it is normal that your App may receive a notification that "Your account is logged in elsewhere". This is normal.

Add the DEYE platform to config.json in the home directory within .homebridge.

Example configuration

{
    "`platforms`: [
        {
            "platform": "DEYE"
            "mqttBaseInfo": {
                "mqttHost": "yourmqtthost.com",
                "mqttPort": "1883",
                "endPoint": "b374fbd89bba44b28399d975fc82d8f5",
                "username": "b374fbd89bba44b28399d975fc82d8f5/9c2056e3f115459e9c88394217ee52fc",
                "password": "9c2056e3f115459e",
                "clientId": "app_34bc46389bc011ecb9090242ac120002"
            },
            "devices": [
                {
                    "name": "DYD-D50A3",
                    "model": "DYD-D50A3",
                    "productId": "97e85d3856c54a1ab090c8541101a050",
                    "deviceId": "5111127c8d6f4beca10861dfc5942949",
                    "fanControl": true,
                    "temperatureSensor": true,
                    "dryClothes": true,
                    "sleepMode": true
                }
            ]
        }
    ]
}

Platform configuration field

platform [Required] should be "DEYE".

Server connection configuration field mqttBaseInfo

mqttHost [Required] The address of the MQTT server.

mqttPort [Required] MQTT server port.

endPoint [Required] MQTT endPoint.

username [required] MQTT username.

password [required] MQTT password.

clientId [Required] MQTT client ID.

Device connection configuration fields devices

name [required] The name of the custom accessory.

model [Required] The device model. For example DYD-D50A3

productId [required] The productId you got.

deviceId [required] The deviceId you got.

fanControl [Required] Whether to enable the wind speed control function. Only supported by some models.

temperatureSensor [Required] Whether to enable the temperature sensor. May only be supported by some models.

Please note: When the temperature sensor is enabled, it will merge the accessories due to Apple HomeKit policy and you may not be able to see the humidifier control interface directly.

If this happens, tap the "Accessories" option in the Home App under Accessories and you will see information about the dehumidifier. Alternatively, you can choose to enable DryClothes mode or Sleep mode, and then click on "Show as separate panel" in Accessories in the Home App.

dryClothes [Required] Whether to enable the dry mode switch. May only be supported by some models.

sleepMode [Required] Whether to enable the sleep mode switch. May only be supported by some models.

Special Thanks

@yamisenyuki - Writing the code and Deye Device Information Getter

HAP-NodeJS and homebridge - for making this possible.

Package Sidebar

Install

npm i homebridge-deye

Weekly Downloads

6

Version

1.0.2

License

AGPL-3.0

Unpacked Size

115 kB

Total Files

25

Last publish

Collaborators

  • icesandsora