v0.8.17

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.8.16**.
+HTTP and WebSocket API for GREE Controller **0.8.17**.
 
 [← Main documentation](../README.md)
 
@@ -212,7 +212,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.8.16",
+  "version": "0.8.17",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -236,7 +236,7 @@ Returns the initial Web UI snapshot:
   "settings": {},
   "outdoor_temperature": null,
   "system": {
-    "version": "0.8.16",
+    "version": "0.8.17",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -438,6 +438,9 @@ The backend sends only properties that differ from the last known device state.
   "heat_sleep_setpoint": 19.0,
   "heat_away_setpoint": 17.0,
   "hysteresis": 0.6,
+  "separate_hysteresis": false,
+  "cool_hysteresis": 0.6,
+  "heat_hysteresis": 0.6,
   "min_on_seconds": 180,
   "min_off_seconds": 180,
   "min_adjust_seconds": 120,
@@ -458,7 +461,8 @@ Important rules:
 - `device_id` must reference an existing device and thermostat ownership must remain valid/safe.
 - `mode`: `cool` or `heat` when not inheriting house mode.
 - temperature/profile values are constrained to the supported thermostat range.
-- `hysteresis`: controller-valid range is approximately `0.1..5.0` °C.
+- `hysteresis`: shared controller hysteresis, valid range `0.1..5.0` °C.
+- `separate_hysteresis`: when `true`, cooling uses `cool_hysteresis` and heating uses `heat_hysteresis`; both use the same `0.1..5.0` °C range.
 - `standby_offset_c`: bounded thermostat offset.
 - `sensor_source`: `device`, `home_assistant` or `combined`.
 - `external_sensor_weight`: `0..1`.
@@ -488,6 +492,8 @@ Safely powers the owned device off before detaching thermostat ownership. Return
 
 ### `POST /api/zones/{id}/control`
 
+Manual `setpoint` values are retained with 0.1 °C precision. The physical GREE unit setpoint is still rounded to the whole-degree resolution supported by the protocol.
+
 Quick thermostat endpoint. Body fields are optional and can be combined:
 
 ```json