homebridge-dooya-dt360e 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +65 -0
  2. package/index.js +1499 -0
  3. package/package.json +41 -0
package/README.md ADDED
@@ -0,0 +1,65 @@
1
+ # homebridge-dooya-dt360e
2
+
3
+ Homebridge plugin for Dooya DT360E curtain motors controlled directly over Wi-Fi.
4
+
5
+ ## What this does
6
+
7
+ - Exposes each curtain as a HomeKit `WindowCovering`
8
+ - Talks to the Dooya controller over local BroadLink UDP
9
+ - Supports real status polling for DT360E local mode
10
+ - Supports BroadLink DT360E devices such as type `20334` (`0x4f6e`)
11
+
12
+ ## Installation
13
+
14
+ ### Homebridge plugin folder
15
+
16
+ Install this package in the same Homebridge environment where Homebridge runs.
17
+
18
+ If your Homebridge is in Docker, the plugin must be present inside the Homebridge container or its persistent `node_modules` volume, not only on your local machine.
19
+
20
+ ### Docker example
21
+
22
+ If your Homebridge container stores plugins in a persistent data folder, install the plugin there:
23
+
24
+ ```bash
25
+ cd /path/to/homebridge/data/homebridge
26
+ npm install git+ssh://git@github.com/sanychonline/homebridge-broadlink-dooya.git
27
+ ```
28
+
29
+ Then restart the Homebridge container.
30
+
31
+ ## Example config
32
+
33
+ ```json
34
+ {
35
+ "platform": "DooyaDT360E",
36
+ "name": "Dooya DT360E",
37
+ "devices": [
38
+ {
39
+ "name": "Living Room Curtain",
40
+ "host": "192.168.1.50",
41
+ "mac": "aa:bb:cc:dd:ee:ff",
42
+ "type": 20334,
43
+ "protocol": "dt360e",
44
+ "invertPosition": false
45
+ }
46
+ ]
47
+ }
48
+ ```
49
+
50
+ ## Config fields
51
+
52
+ - `name`: accessory name
53
+ - `host`: device IP address
54
+ - `mac`: device MAC address
55
+ - `type`: BroadLink device type, use `20334` for DT360E (`0x4f6e`)
56
+ - `protocol`: use `dt360e`
57
+ - `invertPosition`: optional, set to `true` when the motor reports open/closed backwards
58
+
59
+ ## Notes
60
+
61
+ - This plugin is for direct Wi-Fi control of the Dooya controller.
62
+ - The BroadLink mobile app is only needed to pair the curtain motor to Wi-Fi. After that, the Homebridge plugin connects to the device locally.
63
+ - Local DT360E mode reads real status with `010b` frames and sends target position with `020b` frames.
64
+ - DT360E type `20334` (`0x4f6e`) expects the encrypted BroadLink `0x6a` payload to be prefixed with the little-endian inner frame length, for example `0c00 + a5a55a5a...` for status.
65
+ - If BroadLink returns `65529` (`-7`), check that the curtain is paired on the same WLAN and that device lock is disabled in the BroadLink mobile app, then restart Homebridge.