Range¶

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

Общие свойства¶

Общие свойства

Общие свойства юнита range

Основные¶

Параметр: Изменяемый параметр. Есть список предустановленных параметров. При остутствии нужного параметра можно выбрать Кастомный параметр и указать его название.
Единицы измерения: Единицы измерения для указанного параметра. Единицы измерения можно выбрать из списка или, при отсутствии подходящих, указать собственные.
Количество знаков после запятой: Точность значения.
Чувствительность значения: Если изменение параметра больше или равно указанной чувствительности, юнит обновит свое значение. Иначе считается, что параметр не менялся.
Используемый диапазон значений: Диапазон доступный для пользователя. Значение можно изменять только в этих пределах. Если активирован Конвертировать в проценты, то ограничить можно диапазон 0-100%.
Шаг значения: Шаг изменения значения.

Опциональные¶

Конвертировать в проценты: При активации, необходимо указать полный диапазон значений параметра. Он будет приведен к диапазону 0-100%. Единицы измерения устанавливаются %, без возможности изменения.
Полный диапазон значения: Диапазон в котором меняется значение параметра на устойстве.

Note

В примере рассмотрено устройство, позволяющее управлять яркостью свечения лампы с помощью ШИМ.

Значение ШИМ задается в диапазоне от 0 до 255 инженерных единиц. Для удобства диапазон 0-255 приведен к 0-100%. 0 - лампа отключена, 255 - 100% яркости.

Также рабочий дипазон ограничен минимальным значением 10%, т.к. значения ниже не приводят к изменению яркости; и максимальным - 70%, т.к. значения выше просто не требуются.

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

HTTP¶

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

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

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

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

Note

В URL или Payload нужно указать позицию куда поместить устанавливаемое значение. Для этого нужно использовать конструкцию-плейсхолдер {{.}}.

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

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

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

URL запроса: URL, к которому выполняется GET-запрос.
Способ обработки ответа: Правила, по которым из сообщения извлекается требуемое значение. Подробнее в разделе Обработка ответа.
Интервал опроса: Периодичность, с которой будет выполняться GET-запрос.

Использовать Webhook

Включение механизма получения состояния переключателя при помощи webhook'а. Если оборудование умеет отправлять webhook при смене состояния, то можно это использовать. Это позволяет получать информацию в момент изменения значения, что повышает актуальность данных по сравнению с периодическим опросом.

MODBUS¶

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

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

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

Шина RS-485: Выбрать шину RS-485, к которой подключено устройство.
Адрес устройства: Указать адрес устройства на шине RS-485.
Порядок байт: Указать порядок байт в регистре. Обычно и по умолчанию BIG ENDIAN.
Порядок слов: Указать порядок регистров. Важно при работе со значениями, занимающими несколько регистров. Обычно и по умолчанию HIGH WORD FIRST.
Адрес регистра: Указать адрес начального регистра для записи. Тип регистра по умолчанию Holding.
Количество регистров: Указать количество считываемых регистров. Будет выполнено чтение указанного количества, начиная с адреса начального регистра.
Тип данных: Указать тип хранимых в регистре(ах) данных.
Множитель: Полученное значение будет умножено на это число.
Смещение: К полученному значению будет прибавлено это число.

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

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

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

Интервал опроса

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

Запрашивать состояние из отдельного регистра

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

Тип регистра: Тип регистра, из которого выполняется чтение.
Адрес регистра: Адрес регистра, из которого выполняется чтение.
Количество регистров: Указать количество считываемых регистров. Будет выполнено чтение указанного количества, начиная с адреса начального регистра.
Тип данных: Указать тип хранимых в регистре(ах) данных.
Множитель: Полученное значение будет умножено на это число.
Смещение: К полученному значению будет прибавлено это число.

MQTT¶

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

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

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

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

Note

В сообщении нужно указать позицию куда поместить устанавливаемое значение. Для этого нужно использовать конструкцию-плейсхолдер {{.}}.

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

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

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

Топик для получения состояния: Топик, на который нужно подписаться. Устройство публикует свое состояние в этот топик.
Способ обработки сообщения: Правила, по которым из сообщения извлекается требуемое значение. Подробнее в разделе Обработка ответа.

LWT

Механизм, позволяющий отслеживать потерю соединения с устройством. Подробнее в разделе LWT.