diff --git a/10-systems/automations/smart-home-overview.md b/10-systems/automations/smart-home-overview.md index 2044f81..d177d90 100644 --- a/10-systems/automations/smart-home-overview.md +++ b/10-systems/automations/smart-home-overview.md @@ -1,33 +1,60 @@ --- owner: gmikcon status: active -last_reviewed: 2026-05-10 +last_reviewed: 2026-09-04 review_interval: 90d confidence: high -source_of_truth: owner-described-and-ssh-host +source_of_truth: ssh-host-verified --- # Smart Home Overview ... (existing content) ... -## Automation Actions (Quick Reference) +## Automation Actions (verified 2026-09-04) -The following actions are available via the API to control lights in specific zones. These are implemented in `ControlScripts/Scopes/LightHubScope.php`. +Actions are implemented as PHP Scope classes in `/home/shome/smart-home-server/automation/Scopes/` (Bathroom, Hall, Kitchen, MasterBedroom, Office, Outdoor, PlantsRoom, ServerRoom). Each class extends `ControlScripts` and registers actions in `register_actions_scripts()` via helpers from the `Common` trait: -### Light Control via API +- `add_toggle_action(alias, name, relay_alias, channel, attrs)` — single relay toggle +- `add_group_toggle_action(alias, name, ["device:channel", ...], attrs)` — multi-relay toggle +- `add_action_script(attrs, callable)` — custom action (attrs: `alias`, `name`, `description`, `icon`, `author`, `danger_level` safe/cautious/dangerous, `state_callback`, `params_schema`) +- `add_off_action(...)`, `add_hatch_action(...)` — specialized helpers -To toggle lights, use the `POST /api/v1/scripts/actions/run` endpoint with the corresponding alias. +Registration auto-syncs rows into the `scripts` DB table; `run_action_script` resolves aliases from the runtime registry and checks the DB state flag. Aliases removed from code are dead even if still `enabled` in the DB. Code changes are picked up without restart (`opcache.validate_timestamps=1`). -| Action Alias | Description | Target Device (Relay) | Channel | -| --- | --- | --- | --- | -| `master_room_lamp_switch` | Включить/выключить основной свет в спальне | `light_hub_1` | 1 | -| `hallway2_lamp_switch` | Включить/выключить основной свет в холе, эт2 | `light_hub_1` | 2 | -| `bathroom2_lamp_switch` | Включить/выключить основной свет в ванной 2 | `light_hub_1` | 3 | +### Trigger via API -**Example Request:** -```bash -curl -X POST http://192.168.1.101/api/v1/scripts/actions/run \ - -H "Content-Type: application/json" \ - -d '{"alias": "master_room_lamp_switch", "params": {}}' -``` +`POST http://192.168.1.101/api/v1/scripts/actions/run` with `{"alias": "...", "params": {}}`. + +### Current live actions (16) + +| Alias | Description | Target | +| --- | --- | --- | +| `master_toggle` | Вкл/Выкл. свет в спальне | `light_hub_1:1` | +| `hall2_toggle` | Вкл/Выкл. свет в холле 2 эт | `light_hub_1:2` | +| `bathroom_light_switch` | Вкл/Выкл. свет в ванной (2 сан узел) | `bathroom_2_light:0` | +| `kitchen1_toggle` | Вкл/Выкл. свет на кухне 1 | `fisrt_floor_big_relay:0` | +| `kitchen2_toggle` | Вкл/Выкл. свет на кухне 2 | `fisrt_floor_big_relay:1` | +| `computer_table_lamp_switch` | Вкл/Выкл. настольную компьютерную лампу | `computer_table_lamp:0` | +| `craft_table_lamp_switch` | Вкл/Выкл. лампу в мастерской | `craft_table_lamp:0` | +| `plants_room_light_switch` | Вкл/Выкл. свет в комнате растений | `plants_room_light:0` | +| `italy_lamp_switch` | Вкл/Выкл. Italy лампу | `italy_lamp_relay:0` | +| `floor_lamp_switch` | Вкл/Выкл. торшер | `floor_lamp_relay:0` | +| `server_room_light_switch` | Вкл/Выкл. свет в серверной | `server_room_light:0` | +| `all_spotlights_off` | Выключить все прожекторы (3) | group off | +| `back_spotlights_off` | Выключить задние прожекторы (2) | group off | +| `front_spotlight_off` | Выключить передний прожектор | `spotlight_main_front_1` off | +| `hatch_open` | Открыть люк в подвал | `kitchen_hatch` (dangerous) | +| `hatch_close` | Закрыть люк в подвал | `kitchen_hatch` (dangerous) | + +### Dead aliases (do not use) + +Legacy rows remain in the `scripts` DB table but are NOT registered by code and return null: `master_room_lamp_switcher`, `hallway2_lamp_switcher`, `bathroom2_lamp_switcher`, `main_lamps_switcher`, `hall1_light_switcher`, `kitchen_light_switcher`, `hall1_toggle`, `all_hub_toggle`, `spotlights_on/off`, `computer/craft_table_lamp_on/off`, `front_spotlight_on`, `stand_relay_toggle`, `spotlights_by_time`. Docs referencing `master_room_lamp_switch`/`_switcher` are outdated — the bedroom action is `master_toggle`. + +### Known coverage gaps (as of 2026-09-04) + +- `light_hub_1:3` (нижний хол) — no action; `hall1_toggle` was removed in commit `ec9e69b`. Channel is currently ON and unreachable via API. +- `light_hub_1:0` — no action; sync map binds it to `buttons_office_room:3` (zone to confirm). +- Spotlights are off-only (no on/toggle actions). +- No global "all lights off" action. +- No relay hardware for: гостинная, гостевая спальня, vika_room, главный сан узел, подвал, чердак, хоз домик.