Перейти к содержанию

Switch

Используется в качестве переключателя, использует значения 1 или 0. Основная задача - управление (включение/выключение) соответствующими параметрами устройств. Поддерживает чтение и запись.

Info

Получать состояние переключателя необязательно, возможно ограничиться только управлением.

HTTP

Пример конфигурации

Пример конфигурации юнита switch_http

Основные свойства

Метод
Тип HTTP запроса для изменения состояния переключателя.
URL для включения
URL, к которому выполняется запрос для включения.
Payload для включения
Payload запроса для включения. Указывается при использовании HTTP методов POST, PUT, PATCH.
URL для выключения
Payload запроса для выключения. Указывается при использовании HTTP методов POST, PUT, PATCH.

Опциональные свойства

Использовать GET-запрос

Включение механизма получения состояния переключателя при помощи GET-запроса.

URL запроса
URL, к которому выполняется GET-запрос.
Способ обработки ответа
Правила, по которым из сообщения извлекается требуемое значение. Подробнее в разделе Обработка ответа.
Значение состояния ON
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние ON.
Значение состояния OFF
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние OFF.
Интервал опроса
Периодичность, с которой будет выполняться GET-запрос.
Использовать Webhook
Включение механизма получения состояния переключателя при помощи webhook'а. Если оборудование умеет отправлять webhook при смене состояния, то можно это использовать. Это позволяет получать информацию в момент изменения значения, что повышает актуальность данных по сравнению с периодическим опросом.

MODBUS

Пример конфигурации

Пример конфигурации юнита switch_modbus

Основные свойства

Шина RS485
Шина RS485, к которой подключено устройство.
Адрес устройства
Адрес устройства на шине RS485.
Тип регистра
Тип регистра, из которого выполняется чтение.
Адрес регистра
Адрес регистра, из которого выполняется чтение.
Чтение конкретного бита
Зачастую производители оборудования используют holding или input регистры для хранения состояний нескольких параметров. Т.е. за состояние параметра может отвечать конкретный бит в числе.
Значение, соостветствующее состоянию ON
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние ON.
Значение, соостветствующее состоянию OFF
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние OFF.

Опциональные свойства

Получать состояние

Включение механизма чтения состояния переключателя из регистра.

Интервал опроса
Периодичность, с которой будет выполняться чтение из регистра.
Запрашивать состояние из отдельного регистра

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

Тип регистра
Тип регистра, из которого выполняется чтение.
Адрес регистра
Адрес регистра, из которого выполняется чтение.
Чтение конкретного бита
Зачастую производители оборудования используют holding или input регистры для хранения состояний нескольких параметров. Т.е. за состояние параметра может отвечать конкретный бит в числе.
Значение, соостветствующее состоянию ON
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние ON.
Значение, соостветствующее состоянию OFF
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние OFF.

MQTT

Пример конфигурации

Пример конфигурации юнита switch_mqtt

Основные свойства

MQTT брокер
MQTT брокер, к которому подключено устройство.
Топик для управления
Топик, в который нужно отправлять сообщения с командами управления.
Сообщение для включения
Сообщение с командой включения.
Сообщение для выключения
Сообщение с командой выключения.

Опциональные свойства

Получать состояние

Включение механизма получения состояния из топика.

Топик для получения состояния
Топик, на который нужно подписаться. Устройство публикует свое состояние в этот топик.
Способ обработки сообщения
Правила, по которым из сообщения извлекается требуемое значение. Подробнее в разделе Обработка ответа.
Значение состояния ON
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние ON.
Значение состояния OFF
Референсное значение, с которым сравнивается полученный ответ. При совпадении юнит переходит в состояние OFF.
LWT
Механизм, позволяющий отслеживать потерю соединения с устройством. Подробнее в разделе LWT.