v0.3.5

docs/API.md

@@ -33,9 +33,11 @@ These two endpoints always require `Authorization: Bearer <generated-token>` (or
 
 ```bash
 curl -X POST "$BASE/api/discovery" -H "$AUTH" -H 'Content-Type: application/json' \
-  -d '{"timeout_ms":3000,"broadcast":"255.255.255.255:7000"}'
+  -d '{"timeout_ms":6000,"broadcast":"255.255.255.255:7000","protocol_version":0,"passes":3}'
 ```
 
+`protocol_version` is `0` for auto/both, `1` for AES-ECB only, and `2` for AES-GCM only. `passes` is `1..10`. Auto is recommended when different GREE Wi-Fi module generations share the network.
+
 ## Device command
 
 ```json
@@ -51,7 +53,7 @@ curl -X POST "$BASE/api/discovery" -H "$AUTH" -H 'Content-Type: application/json
 }
 ```
 
-Supported modes: `auto`, `cool`, `dry`, `fan`, `heat`. Fan speed: `0..5`.
+Supported modes: `auto`, `cool`, `dry`, `fan`, `heat`. Fan speed: `0..5`. Physical GREE Celsius setpoints are normalized to whole degrees in the `8..30°C` range.
 
 ## Zone
 
@@ -80,6 +82,15 @@ Supported modes: `auto`, `cool`, `dry`, `fan`, `heat`. Fan speed: `0..5`.
 
 For `combined` and `home_assistant`, set a per-zone `ha_entity_id`. `external_sensor_weight` is `0.0..1.0`. If a combined sensor pair differs by more than `max_sensor_difference`, the controller falls back to GREE. The returned zone object includes `device_temperature`, `external_temperature`, `current_temperature`, and `control_temperature_source`.
 
+### Quick zone control
+
+```bash
+curl -X POST "$BASE/api/zones/ZONE_ID/control" -H "$AUTH" -H 'Content-Type: application/json' \
+  -d '{"setpoint":21.5,"mode":"heat"}'
+```
+
+Fields are optional: `setpoint`, `mode` (`heat`/`cool`) and `enabled`. The zone setpoint may use 0.5°C precision for controller hysteresis; when the quick control changes setpoint/mode, the paired GREE unit is updated immediately while its current power state is preserved.
+
 ## Schedule
 
 Weekdays use ISO numbers: Monday `1`, Sunday `7`.