homebridge-gree-ac 2.1.0 → 2.1.2

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,55 @@
1
1
  # Changelog
2
2
 
3
+ ## [2.1.2] - 2024-10-01
4
+
5
+ **<ins>Reminder:</ins> New (v2) network encryption protocol supported since v2.1.0**
6
+
7
+ When upgrading from v2.0.0 - v2.1.1 to v2.1.2 configuration settings should be updated.
8
+
9
+ #### Configuration update steps
10
+
11
+ - <ins>Recommended:</ins> Using the graphical user interface of Homebridge ([Homebridge Config UI X](https://www.npmjs.com/package/homebridge-config-ui-x))
12
+ 1) Open plugin configuration
13
+ 1) Review and update settings if needed
14
+ 1) Save changes _(pressing the Save button is required to update the configuration to new version even if no changes needed in the displayed values)_
15
+ 1) Restart Homebridge
16
+ - **OR** <ins>Alternative:</ins> Edit the configuration file directly
17
+ 1) Remove the following parameters from the platform section:
18
+ - port _(it may be kept if you want to set the UDP port manually)_
19
+ - scanAddress
20
+ - scanCount
21
+ - scanTimeout
22
+ 1) Optionally you can add the following parameter to the platform section:
23
+ - scanInterval _(default is 60 if missing, needed only if other value required)_
24
+ 1) Save changes
25
+ 1) Restart Homebridge
26
+
27
+ #### Updated dependencies
28
+ - homebridge-config-ui-x 4.59.0 or later required
29
+ - added homebridge 2.0.0-beta.0 and later to supported versions
30
+
31
+ ### New features
32
+
33
+ - Simplified configuration
34
+ - Broadcast address not needed any more
35
+ - UDP port is optional
36
+ - Scan count and scan timeout replaced with scan interval parameter
37
+ - AC units can have dynamic addresses
38
+
39
+ ### Fixes
40
+
41
+ - Fixed "Failed to save cached accessories to disk: Converting circular structure to JSON" error
42
+
43
+ ## [2.1.1] - 2024-06-25
44
+
45
+ **New (v2) network encryption protocol supported since v2.1.0**
46
+
47
+ - Updated dependencies (homebridge-config-ui-x 4.56.3 or later required)
48
+
49
+ ### Fixes
50
+
51
+ - Do not show error on unknown network packets received from non GREE devices
52
+
3
53
  ## [2.1.0] - 2024-06-23
4
54
 
5
55
  ### New features
package/README.md CHANGED
@@ -6,35 +6,39 @@
6
6
  > _*** Breaking changes ***_
7
7
  >
8
8
  > Please read the [**Upgrade section**](#upgrade) before upgrading from version earlier than **v2.0.0** !
9
+ >
10
+ > _It is also recommended to read the upgrade section before any upgrade. It contains useful information regarding the latest version._
9
11
 
10
12
  # Homebridge GREE Air Conditioner Platform Plugin
11
13
 
12
- [Homebridge GREE Air Conditioner Platform Plugin](https://github.com/eibenp/homebridge-gree-airconditioner) is a dynamic platform plugin for [Homebridge](https://github.com/homebridge/homebridge) which allows control of GREE Air Conditioner devices from [Apple's Home App](https://www.apple.com/home-app/). (Make GREE Air Conditioner HomeKit compatible.)
14
+ [Homebridge GREE Air Conditioner Platform Plugin](https://github.com/eibenp/homebridge-gree-airconditioner) is a dynamic platform plugin for [Homebridge](https://github.com/homebridge/homebridge) which allows control of GREE Air Conditioner devices from [Apple's Home App](https://www.apple.com/home-app/). (Makes GREE Air Conditioner HomeKit compatible.)
13
15
 
14
- You can add all of your GREE Air Conditioner devices to the Home App by specifying the network broadcast address, and Homebridge will find all connected devices. Each device appears in the Home App as a Heater Cooler device. It is also possible to add a separate Termperature Sensor (if temperature sensor is supported by the physical device). This allows to define automations (e.g. turn on) based on current temperature in the room. Be careful, if the device does not support internal temperature sensor but is added as a separate accessory, Home App will display the target temperature not the measured one. Child accessory does not appear in Home App if physical sensor is not available in the AC unit.
16
+ You can add all of your GREE Air Conditioner devices to the Home App by specifying the device's MAC address, and Homebridge will find all connected devices. Each device appears in the Home App as a Heater Cooler device. It is also possible to add a separate Termperature Sensor (if temperature sensor is supported by the physical device). This allows to define automations (e.g. turn on) based on current temperature in the room. Be careful, if the device does not support internal temperature sensor but is added as a separate accessory, Home App will display the target temperature not the measured one. Child accessory does not appear in Home App if physical sensor is not available in the AC unit.
15
17
 
16
18
  Quiet / Auto / Powerful mode is supported by the fan speed control. Zero means off. Minimum value turns on Quiet mode. Next value is Auto mode. Maximum value is Powerful mode. All other values between them are exact fan speeds (Low, MediumLow**, Medium, MediumHigh**, High)
17
19
 
18
20
  ** these values are supported only on 5-speed models
19
21
 
20
- You have to add all devices to the Homebridge configuration, so that you can control all their parameters. If you don't want to control all of the devices in Home App, then you need to add to the configuration and disable the ones you don't need. Devices are identified by MAC Address (Serial Number). It can be queried using the official [GREE+ mobile app](https://apps.apple.com/us/app/gree/id1167857672). (The app is required to connect the devices to the local WiFi network for the first time.)
22
+ You have to add all devices to the Homebridge configuration. Devices are identified by MAC Address (Serial Number). It can be queried using the official [GREE+ mobile app](https://apps.apple.com/us/app/gree/id1167857672). (The app is required to connect the devices to the local WiFi network for the first time.) If an AC unit's MAC address is not added to the configuration then it will be skipped by the plugin. You can also skip a device by adding it to the configuration and setting the "disabled" parameter to true. _(This is useful if you want to temporarily remove the device but you want to keep it's parameters, e.g. changing the name is not possible without removal.)_
21
23
 
22
24
  xFan function is also supported, but it works automatically if enabled in Homebridge configuration. If xFan is enabled for the device, it is automatically turned on when you select a supported operating mode in Home App. If xFan is disabled, the Home App will not modify its actual setting in any case.
23
25
 
24
26
  Temperature display units of the physical device can be controlled using the Home App. (Configuration settings are required to be specified always in Degrees Celsius, independently from the display units.)
25
27
 
26
- Vertical swing mode can be turned on/off, but special swing settings can't be controlled using the Home App. If device default vertical swing position is not acceptable in disabled swing mode it can be overridden to a pre selected position by configuration settings. (Only default position is overridden when this feature is enabled. Other positions selected by remote control are kept and not modified by Home App.)
28
+ Vertical swing mode can be turned on/off, but special swing settings can't be controlled using the Home App. If device default vertical swing position is not acceptable in disabled swing mode, it can be overridden to a pre selected position by configuration settings. (Only default position is overridden when this feature is enabled. Other positions selected by remote control are kept and not modified by Home App. The AC unit may keep the actual vertical swing position on turning off oscillation in Home App.)
27
29
 
28
30
  This plugin is designed to be as simple and clear as possible and supports primarily the functions of the Home App's Heater Cooler accessory.
29
31
 
30
32
  ## Requirements
31
33
 
32
34
  * Node.js (>= 18.15.0 || >= 20.8.0) with NPM
33
- * Homebridge (>= 1.8.0)
35
+ * Homebridge (>= 1.8.0 || >= 2.0.0-beta.0)
36
+
37
+ Homebridge and all AC units have to be on the same subnet. The plugin finds all supported units automatically but controls only those which MAC address is added to configuration.
34
38
 
35
- You need to specify the local network broadcast address (192.168.1.255 in many home environments) and it is also recommended to add the device and specify its MAC address (Serial Number) in the configuration file. Homebridge and all AC units have to be on the same subnet.
39
+ IPv4 address is required. GREE Air Conditioners do not support IPv6 nor other network protocols.
36
40
 
37
- It is highly recommended to use static IP addresses for connected devices. Using a dynamic IP address may require a restart of the Homebridge service on an address change to reconnect the device. Most routers offer static DHCP leases. (Please look at your router's documentation!)
41
+ This is not plugin dependency but its good to know that Homebridge server host address must be static. If the host address changes Homebridge looses connection with Home App and only Homebridge restart restores the connection.
38
42
 
39
43
  ## Supported devices
40
44
 
@@ -44,7 +48,7 @@ It is highly recommended to use static IP addresses for connected devices. Using
44
48
 
45
49
  > If you get _"error:1C80006B:Provider routines::wrong final block length"_ error message then your device is not supported.
46
50
  >
47
- > If you get _"Device not bound:..."_ warning message then your device is not supported.
51
+ > If you don't get _"Device is bound ..."_ message within a few minutes after Homebridge startup and the correct MAC address is added to the configuration and the AC unit is accessible on the same subnet then your device is not supported.
48
52
 
49
53
  By default this plugin tries to auto detect the network protocol encryption version. If not the right version is selected there can get errors and the AC device will not correctly work. It is possible to force a network protocol encryption version in configuration file. If auto detection does not work then it is recommended to try all possible values to check if the device is compatible or not.
50
54
 
@@ -75,15 +79,39 @@ If successfully installed and configured, your devices will appear on the Homebr
75
79
 
76
80
  ## Upgrade
77
81
 
82
+ ### v2.0.0 - v2.1.1 to v2.1.2 or later
83
+
84
+ The upgrade is automatic by installing the latest version but configuration settings should be updated.
85
+
86
+ #### Configuration update steps
87
+
88
+ - <ins>Recommended:</ins> Using the graphical user interface of Homebridge ([Homebridge Config UI X](https://www.npmjs.com/package/homebridge-config-ui-x))
89
+ 1) Open plugin configuration
90
+ 1) Review and update settings if needed
91
+ 1) Save changes _(pressing the Save button is required to update the configuration to new version even if no changes needed in the displayed values)_
92
+ 1) Restart Homebridge
93
+ - **OR** <ins>Alternative:</ins> Edit the configuration file directly
94
+ 1) Remove the following parameters from the platform section:
95
+ - port _(it may be kept if you want to set the UDP port manually)_
96
+ - scanAddress
97
+ - scanCount
98
+ - scanTimeout
99
+ 1) Optionally you can add the following parameter to the platform section:
100
+ - scanInterval _(default is 60 if missing, needed only if other value required)_
101
+ 1) Save changes
102
+ 1) Restart Homebridge
103
+
104
+ ### v1.x.x to v2.0.0 or later
105
+
78
106
  There is no clean way to update the plugin to release v2.0.0 or later if you are using an older version (v1.x.x). You need to remove and reinstall the plugin during upgrade.
79
107
 
80
- ### Upgrade steps
108
+ #### Upgrade steps
81
109
 
82
- 1. Check out your current settings in Homebridge and also in Homekit (including scenes and automation rules)
110
+ 1. Check out your current settings in Homebridge and also in Home App (including scenes and automation rules)
83
111
  2. Uninstall the old version (this will remove all settings also)
84
112
  3. Install the new version
85
113
  4. Configure plugin in Homebridge
86
- 5. Assign accessories to rooms and recreate scenes and automations in Homekit
114
+ 5. Assign accessories to rooms and recreate scenes and automations in Home App
87
115
 
88
116
  ## Example configuration
89
117
  _Only the relevant part of the configuration file is displayed:_
@@ -93,9 +121,7 @@ _Only the relevant part of the configuration file is displayed:_
93
121
  "name": "Gree Air Conditioner",
94
122
  "platform": "GREEAirConditioner",
95
123
  "port": 7002,
96
- "scanAddress": "192.168.1.255",
97
- "scanCount": 5,
98
- "scanTimeout": 10,
124
+ "scanInterval": 60,
99
125
  "devices": [
100
126
  {
101
127
  "mac": "502cc6000000",
@@ -117,27 +143,27 @@ _Only the relevant part of the configuration file is displayed:_
117
143
  }
118
144
  ]
119
145
  ```
146
+ _It's not recommended to add the port parameter. The above example contains it but only for showing all optional parameters also._
147
+
120
148
  * name - Unique name of the platform plugin
121
149
  * platform - **GREEAirConditioner** (fixed name, it identifies the plugin)
122
- * port - free UDP port (homebridge will use this port for network communication; it is recommended to select a port which is not used and the next 256 ports are also available because devices will be bound to a separate port based on the last part of the device's IPv4 address and the port specified in the configuration; valid values: 1025 - 65279)
123
- * scanAddress - local network broadcast address (some network knowledge is required to determine this address; in many cases its default value is 192.168.1.255)
124
- * scanCount - number of retries for locating devices on the network (minimum 3 retries have to be specified)
125
- * scanTimeout - time period in seconds between device query retries
150
+ * port - free UDP port (optional) (homebridge will use this port for network communication; select a port which is not used and the next 256 ports are also available because devices will be bound to a separate port based on the last part of the device's IPv4 address and the port specified in the configuration; valid values: 1025 - 65279); **Do not specify a port unless you have trouble with automatic port assignment!**
151
+ * scanInterval - time period in seconds between device query retries (defaults to 60 sec if missing)
126
152
  * devices - devices should be listed in this block (specify as many devices as you have on your network)
127
- * mac - MAC address (Serial Number) of the device
128
- * name - custom name of the device (optional)
129
- * model - model name, information only (optional)
130
- * speedSteps - fan speed steps of the unit (valid values are: 3 and 5)
131
- * encryptionVersion - Auto (0) is fine for most AC units. If auto does not work then you can force v1 (1) or v2 (2) encryption version to use in network communication
132
- * statusUpdateInterval - device status will be refreshed based on this interval (in seconds)
133
- * sensorOffset - device temperature sensor offset value for current temperature calibration (default is 40 °C, must be specified in °C)
134
- * minimumTargetTemperature - minimum target temperature accepted by the device (default is 16 °C, must be specified in °C, valid values: 16-30)
135
- * maximumTargetTemperature - maximum target temperature accepted by the device (default is 30 °C, must be specified in °C, valid values: 16-30)
136
- * xFanEnabled - automatically turn on xFan functionality in supported device modes (xFan actual setting is not modified by the Home App if disabled)
137
- * temperatureSensor - control additional temperature sensor accessory in Home App (disabled = do not add to Home App / child = add as a child accessory / separate = add as a separate (independent) accessory)
138
- * overrideDefaultVerticalSwing - by default this plugin does not change the vertical swing position of the AC unit but some devices do not keep the original vertical position set by the remote control if controlled from Homebridge and return back to device default position; this setting allows to override the default position -> if AC unit is set to default vertical swing position Homebridge modifies it to a predefined position (set by defaultVerticalSwing) (Never (0) = turn off override, let device use default / After power on (1) = override default position on each power on / After power on and swing disable (2) = override default position on each power on and each time when swing is switched to disabled)
139
- * defaultVerticalSwing - specify the vertical swing position to be used instead of device default when overriding is enabled (Device default (0) = use device default, same position as used by device by default without overriding / one of the following 5 positions: fixed Highest (2), fixed Higher (3), fixed Middle (4), fixed Lower (5), fixed Lowest (6))
140
- * disabled - set to true if you do not want to control this device in the Home App (old devices can be removed using this parameter)
153
+ * mac - MAC address (Serial Number) of the device
154
+ * name - custom name of the device (optional) Please use only alphanumeric, space, and apostrophe characters. Ensure it starts and ends with an alphabetic or numeric character, and avoid emojis.
155
+ * model - model name, information only (optional)
156
+ * speedSteps - fan speed steps of the unit (valid values are: 3 and 5)
157
+ * encryptionVersion - Auto (0) is fine for most AC units. If auto does not work then you can force v1 (1) or v2 (2) encryption version to use in network communication
158
+ * statusUpdateInterval - device status will be refreshed based on this interval (in seconds)
159
+ * sensorOffset - device temperature sensor offset value for current temperature calibration (default is 40 °C, must be specified in °C)
160
+ * minimumTargetTemperature - minimum target temperature accepted by the device (default is 16 °C, must be specified in °C, valid values: 16-30)
161
+ * maximumTargetTemperature - maximum target temperature accepted by the device (default is 30 °C, must be specified in °C, valid values: 16-30)
162
+ * xFanEnabled - automatically turn on xFan functionality in supported device modes (xFan actual setting is not modified by the Home App if disabled)
163
+ * temperatureSensor - control additional temperature sensor accessory in Home App (disabled = do not add to Home App / child = add as a child accessory / separate = add as a separate (independent) accessory)
164
+ * overrideDefaultVerticalSwing - by default this plugin does not change the vertical swing position of the AC unit but some devices do not keep the original vertical position set by the remote control if controlled from Homebridge and return back to device default position; this setting allows to override the default position -> if AC unit is set to default vertical swing position Homebridge modifies it to a predefined position (set by defaultVerticalSwing) (Never (0) = turn off override, let device use default / After power on (1) = override default position on each power on / After power on and swing disable (2) = override default position on each power on and each time when swing is switched to disabled)
165
+ * defaultVerticalSwing - specify the vertical swing position to be used instead of device default when overriding is enabled (Device default (0) = use device default, same position as used by device by default without overriding / one of the following 5 positions: fixed Highest (2), fixed Higher (3), fixed Middle (4), fixed Lower (5), fixed Lowest (6))
166
+ * disabled - set to true if you do not want to control this device in the Home App _(can be used also to temporarily remove the device from Home App but not if the device is not responding any more on the network)_
141
167
 
142
168
  ![Homebridge UI](./uiconfig.jpg)
143
169
 
@@ -149,25 +175,19 @@ Open selected device and in the upper right corner select menu symbol:
149
175
 
150
176
  ![AC device](./greedevice.jpg)![MAC Address](./greemac.jpg)
151
177
 
152
- ### Network broadcast address
178
+ ### MAC address alternative detection method
153
179
 
154
- All devices on the local network use the same broadcast address. The broadcast address can be calculated from the IP address and the subnet mask of any device which is connected to the LAN. (E.g. your router or computer) You can find several online calculators which help to determine the broadcast address.
180
+ If you are not familiar with the GREE+ mobile app there is an alternative method to detect the MAC address of your devices:
155
181
 
156
- On Unix-like systems you can query the broadcast address using the following command:
157
- ```bash
158
- ifconfig | grep broadcast
159
- # result
160
- # inet 192.168.1.10 netmask 0xffffff00 broadcast 192.168.1.255
161
- ```
162
- On Windows there is no easy way to read the broadcast address. You can query the IP address and the subnet mask using the following command:
163
- ```cmd
164
- ipconfig
165
- # result
166
- # IPv4 Address. . . . . . . . . . . : 192.168.1.10
167
- # Subnet Mask . . . . . . . . . . . : 255.255.255.0
168
- # Default Gateway . . . . . . . . . : 192.168.1.254
169
- ```
170
- You have to calculate the broadcast address from the IP address and the Subnet mask.
182
+ - Install the plugin
183
+ - Do not configure AC unit devices
184
+ - (Re)start Homebridge
185
+ - GREE Air Conditioner Platform Plugin will auto detect all accessible devices and write an entry to the log
186
+ - The log entry contains the MAC address of the device E.g.: MAC address is 502cc6000000 in the following log entry:
187
+
188
+ > Accessory **502cc6000000** not configured - skipped
189
+
190
+ Unfortunaltely if you have multiple devices you will not know which MAC address belongs to which AC unit. In this case you have to test it. This may require some adding - removal - re-adding cycle before final configuration.
171
191
 
172
192
  ### Device settings
173
193
 
@@ -185,7 +205,7 @@ Home App allows to set the device temperature display units but it is independen
185
205
 
186
206
  ### Temperature measurement
187
207
 
188
- Temperature measurement is not perfect if using the built-in sensor. It is highly affected by current operation and can differ from actual temperature of other places in the room. It is recommended to use a sperarate temperature sensor and place it not too close to the AC unit if you plan to set up automations based on temperature values.
208
+ Temperature measurement is not perfect if using the built-in sensor. It is highly affected by current operation and can differ from actual temperature of other places in the room. It is recommended to use a sperarate HomeKit compatible temperature sensor and place it not too close to the AC unit if you plan to set up automations based on temperature values.
189
209
 
190
210
  ### Invalid room temperature
191
211
 
@@ -201,6 +221,47 @@ Slider description: Zero means off. Minimum value turns on Quiet mode. Next valu
201
221
 
202
222
  ** these values are supported only on 5-speed models
203
223
 
224
+ ### Accessory removal
225
+
226
+ If an AC unit is still working and accessible on the network you can remove the associated accessory by setting the device's "disabled" parameter to true and restarting Homebridge.
227
+
228
+ If you need to remove an old AC unit which is not accessible any more (e.g hardware failure or device was replaced with a new one) you need to use the graphical user interface of Homebridge ([Homebridge Config UI X](https://www.npmjs.com/package/homebridge-config-ui-x)). Follow these steps:
229
+ 1) Open Homebridge GUI
230
+ 1) Go to Settings page
231
+ 1) Go to Accessories section
232
+ 1) Select Remove Single Accessory
233
+ 1) Search for the accessory to be removed in list
234
+ 1) Click on the waste icon of the selected accessory
235
+
236
+ On some platforms the graphical user interface of Homebridge does not support accessory removal. In this case you have to remove and reinstall the plugin to remove a deprecated accessory or you need to manually edit the cache file (it requires advanced Homebridge technical knowledge).
237
+
238
+ ### Troubleshouting
239
+
240
+ Most known errors are fixed by later versions. If so yo can upgrade to the latest version and it will solve the problem. Some errors may require some additional steps.
241
+
242
+ #### "Failed to save cached accessories to disk: Converting circular structure to JSON" error
243
+
244
+ This error is fixed in v2.1.2 and later. First upgrade the plugin to the latest version and restart Homebridge twice. Wait a few minutes between restarts. If it does not solve the problem follow these steps:
245
+
246
+ 1) Uninstall the plugin (and remove the child bridge if a dedicated child bridge was added)
247
+ 1) Go through all cached accessories and delete every instance of accessories created by this plugin:
248
+ - Homebridge GUI > Settings page
249
+ - Accessories section > Remove Single Accessory
250
+ - Click the waste icon of the selected accessory
251
+ 1) Restart Homebridge
252
+ 1) Install the latest version of the plugin
253
+ 1) Configure the plugin
254
+
255
+ Do not try to restore Homebridge configuration from backup because this error means that the cached configuration is corrupt and all the backups contain also the corrupt configuration! Restoring settings from backup will restore the error also.
256
+
257
+ #### Unusual behaviour
258
+
259
+ Check if you are using the correct version of configuration settings. It is always recommended to open and save the actual configuration settings using the graphical user interface of Homebridge. Pressing the Save button on the GUI automatically converts the configuration settings to the actual version. It is useful to re-save the configuration after each upgrade or downgrade even if there are no visible changes in the parameters.
260
+
261
+ #### Device not responding
262
+
263
+ If an AC unit device is not supported it may be added successfully to the Home App as an accessory but never appears the "Device is bound ..." message in the Homebridge log. Unbound devices can't respond to network requests so they are unresponsive in Home App. There is no way to decide if the unresponsive device is only turned off (no AC power) or it has a not supported firmware version. It means that a missing error message does not mean that the device is supported. You can check the Homebrdige log. All supported devices write a "Device is bound ..." message into the Homebridge log after successful configuration upon Homebridge startup.
264
+
204
265
  ## Refs & Credits
205
266
 
206
267
  Special thanks to [tomikaa87](https://github.com/tomikaa87) and [kongkx](https://github.com/kongkx) for GREE network protocol information and code samples. Thank you [mateuszm7](https://github.com/mateuszm7) and [zivanek](https://github.com/zivanek) for helping to implement the version 2 network protocol.
@@ -12,27 +12,14 @@
12
12
  },
13
13
  "port": {
14
14
  "type": "integer",
15
- "required": true,
16
- "default": 7002,
15
+ "required": false,
17
16
  "minimum": 1025
18
17
  },
19
- "scanAddress": {
20
- "type": "string",
21
- "required": true,
22
- "default": "192.168.1.255",
23
- "format": "ipv4"
24
- },
25
- "scanCount": {
26
- "type": "integer",
27
- "required": true,
28
- "default": 10,
29
- "minimum": 3
30
- },
31
- "scanTimeout": {
18
+ "scanInterval": {
32
19
  "type": "integer",
33
- "required": true,
34
- "default": 3,
35
- "minimum": 1
20
+ "required": false,
21
+ "default": 60,
22
+ "minimum": 5
36
23
  },
37
24
  "devices": {
38
25
  "type": "array",
@@ -233,28 +220,17 @@
233
220
  "type": "flex",
234
221
  "flex-flow": "row wrap",
235
222
  "items": [
236
- {
237
- "key": "scanAddress",
238
- "flex": "1 1 50%",
239
- "title": "Scan address:",
240
- "description": "Local network broadcast address"
241
- },
242
223
  {
243
224
  "key": "port",
244
225
  "flex": "1 1 50%",
245
- "title": "Port:"
246
- },
247
- {
248
- "key": "scanCount",
249
- "flex": "1 1 50%",
250
- "title": "Scan count:",
251
- "description": "Initial device discovery retry count"
226
+ "title": "Port:",
227
+ "description": "Requested UDP port (auto if empty)"
252
228
  },
253
229
  {
254
- "key": "scanTimeout",
230
+ "key": "scanInterval",
255
231
  "flex": "1 1 50%",
256
- "title": "Scan timeout:",
257
- "description": "Timeout in seconds between device discovery retries"
232
+ "title": "Scan interval:",
233
+ "description": "Interval in seconds between device discovery retries (60 sec if empty)"
258
234
  }
259
235
  ]
260
236
  },
@@ -281,7 +257,7 @@
281
257
  "key": "devices[].name",
282
258
  "flex": "1 1 50%",
283
259
  "title": "Device name:",
284
- "description": "Custom name of the device"
260
+ "description": "Custom name of the device. Please use only alphanumeric, space, and apostrophe characters. Ensure it starts and ends with an alphabetic or numeric character, and avoid emojis."
285
261
  },
286
262
  {
287
263
  "key": "devices[].disabled",
@@ -1,5 +1,4 @@
1
1
  import { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig, Service, Characteristic } from 'homebridge';
2
- import { GreeAirConditioner } from './platformAccessory';
3
2
  /**
4
3
  * HomebridgePlatform
5
4
  * This class is the main constructor for your plugin, this is where you should
@@ -15,8 +14,7 @@ export declare class GreeACPlatform implements DynamicPlatformPlugin {
15
14
  private initializedDevices;
16
15
  private skippedDevices;
17
16
  private socket;
18
- private timer;
19
- private scanCount;
17
+ private pluginAddresses;
20
18
  constructor(log: Logger, config: PlatformConfig, api: API);
21
19
  /**
22
20
  * This function is invoked when homebridge restores cached accessories from disk at startup.
@@ -27,9 +25,11 @@ export declare class GreeACPlatform implements DynamicPlatformPlugin {
27
25
  * Accessories must only be registered once, previously created accessories
28
26
  * must not be registered again to prevent "duplicate UUID" errors.
29
27
  */
28
+ bindCallback(): void;
30
29
  discoverDevices(): void;
31
30
  handleMessage: (msg: any, rinfo: any) => void;
32
- registerDevice: (deviceInfo: any) => GreeAirConditioner | undefined;
31
+ registerDevice: (deviceInfo: any) => void;
33
32
  broadcastScan(): void;
33
+ getNetworkAddresses(): {};
34
34
  }
35
35
  //# sourceMappingURL=platform.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAGxI,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,qBAAqB;aAaxC,GAAG,EAAE,MAAM;aACX,MAAM,EAAE,cAAc;aACtB,GAAG,EAAE,GAAG;IAd1B,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAwB;IAC/D,SAAgB,cAAc,EAAE,OAAO,cAAc,CAA+B;IAGpF,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAS;gBAGR,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,GAAG;IAqB1B;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAgB/C;;;OAGG;IACH,eAAe;IAyCf,aAAa,iCAqCX;IAEF,cAAc,sDAoGZ;IAEF,aAAa;CASd"}
1
+ {"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAUxI;;;;GAIG;AACH,qBAAa,cAAe,YAAW,qBAAqB;aAYxC,GAAG,EAAE,MAAM;aACX,MAAM,EAAE,cAAc;aACtB,GAAG,EAAE,GAAG;IAb1B,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAwB;IAC/D,SAAgB,cAAc,EAAE,OAAO,cAAc,CAA+B;IAGpF,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAA8B;gBAGnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,GAAG;IAsC1B;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAe/C;;;OAGG;IACH,YAAY;IAQZ,eAAe;IAUf,aAAa,iCA4CX;IAEF,cAAc,4BAyIZ;IAEF,aAAa;IAYb,mBAAmB;CA8BpB"}