Newer
Older
gnexus-book / 10-systems / automations / light_control_procedures.md

owner: gmikcon status: active last_reviewed: 2026-09-04 review_interval: 90d confidence: high

source_of_truth: owner-described-and-ssh-host

Процедура управления освещением: Спальня (2 этаж)

Данный документ описывает алгоритм безопасного управления основным освещением в главной спальне на втором этаже через API платформы умного дома.

Описание задачи

При необходимости выключить свет в спальне, не нарушая работу других каналов реле и не используя физические выключатели (во избежание случайного переключения других зон).

Используемые компоненты

  • Устройство: light_hub_1 (ID: 13) — Хаб 1 управления светом.
  • Канал: 1 (Основной свет спальни).
  • Действие (Action): master_toggle (живой алиас; прежний master_room_lamp_switcher мёртв — не зарегистрирован в коде, см. smart-home-overview.md).
  • Сервер управления: 192.168.1.101.

Алгоритм выполнения

1. Проверка текущего состояния

Перед выполнением переключателя (toggle) необходимо убедиться, что свет включен. Если свет уже выключен, выполнение команды переключит его в состояние ON.

Запрос: GET http://192.168.1.101/api/v1/devices/id/13/status

Что искать в ответе: В массиве channels для id: 1 значение state должно быть "on".

2. Выполнение переключения

Если состояние "on", отправьте POST-запрос для запуска action-скрипта.

Запрос: POST http://192.168.1.101/api/v1/scripts/actions/run

Тело запроса (JSON):

{
  "alias": "master_toggle",
  "params": {}
}

3. Верификация

После выполнения запроса повторно проверьте статус устройства тем же методом, что и в шаге 1. Значение state для канала 1 должно стать "off".

Меры предосторожности

  • Не использовать прямой вызов POST /api/v1/devices/action для этого реле, так как это может привести к непредсказуемому состоянию других каналов, если не переданы точные параметры.
  • Использовать только master_toggle, так как он инкапсулирует безопасную логику переключения.
  • Не использовать legacy-алиасы (master_room_lamp_switcher и др.) — они есть в таблице scripts БД, но не зарегистрированы в коде и возвращают null.