gru/gree-controller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.15.15

Browse Source
This commit is contained in:
Mateusz Gruszczyński
2026-09-21 22:58:30 +02:00
parent 3b969c8754
commit d80005de33
33 changed files with 722 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/API.md
+23 -3
View File
@@ -1,6 +1,6 @@
# GREE Controller API reference
HTTP and WebSocket API for GREE Controller **0.15.14**.
HTTP and WebSocket API for GREE Controller **0.15.15**.
[← Main documentation](../README.md)
@@ -163,6 +163,7 @@ Common statuses:
| POST | `/api/groups/{id}/control` | Group control enable/mode/preset/custom-temperature control. |
| POST | `/api/house/control` | Set global thermostat mode. |
| POST | `/api/house/power` | Bulk ON/OFF for all thermostats and enabled units; no persistent global gate. |
| POST | `/api/house/emergency-stop` | Persistently pause/resume automation; activation sends one-shot OFF to enabled units. |
| POST | `/api/house/preset` | Set/clear whole-house preset override. |
### Schedules and automations
@@ -225,6 +226,7 @@ Common statuses:
| POST | `/api/integrations/home-assistant/house/control` | Restricted house mode. |
| POST | `/api/integrations/home-assistant/house/preset` | Restricted house preset. |
| POST | `/api/integrations/home-assistant/house/power` | Restricted bulk all-thermostat/all-unit power action. |
| POST | `/api/integrations/home-assistant/house/emergency-stop` | Restricted persistent emergency automation pause/resume. |
| POST | `/api/integrations/home-assistant/zones/{id}/control` | Restricted thermostat-zone control. |
---
@@ -241,7 +243,7 @@ Response:
{
"status": "ok",
"name": "gree-controller",
"version": "0.15.14",
"version": "0.15.15",
"uptime_seconds": 1234,
"control_ready": true,
"time": "2026-08-30T06:54:00Z"
@@ -304,7 +306,7 @@ Returns the initial Web UI snapshot:
"control_plan": {"generated_at": "2026-09-04T08:00:00Z", "zones": [], "rules": []},
"control_plan_revision": 42,
"system": {
"version": "0.15.14",
"version": "0.15.15",
"uptime_seconds": 1234,
"auth_required": false,
"control_ready": true,
@@ -845,6 +847,20 @@ Response includes:
}
```
### `POST /api/house/emergency-stop`
```json
{
"active": true
}
```
`true` persistently pauses thermostat/schedule/automation execution, clears stale compressor-protection tasks, and makes a one-shot best-effort OFF request to every enabled unit. The pause survives controller restarts, but startup does **not** replay OFF commands. Manual/direct device control remains available while automation is paused.
`false` releases only the automation safety gate. It does not force devices ON; the controller immediately evaluates current schedules, temperatures and ownership again.
Response includes `active`, `since`, `changed`, `failed`, and `cleared_queues`.
### `POST /api/house/preset`
```json
@@ -1489,6 +1505,10 @@ Same `{ "preset": "auto|comfort|sleep|away" }` semantics.
Same `{ "power": true|false }` semantics.
### `POST /api/integrations/home-assistant/house/emergency-stop`
Same `{ "active": true|false }` emergency-stop semantics as the administrator endpoint.
### `POST /api/integrations/home-assistant/zones/{id}/control`
Same `ZoneControlPatch` thermostat semantics as the normal zone control endpoint. The internal source is recorded as Home Assistant thermostat control.