Аксессуары, сервисы и характеристики

Материал из Sprut.hub Wiki

В Sprut.hub применяется классификация и архитектура устройств, аналогичная Apple HomeKit. Мы не просто так взяли эту архитектуру за основу, так как она является наиболее полной среди всех концепций организации устройств умного дома.

Основными элементами, являются Аксессуары, Сервисы и Характеристики.

Разберем на примере датчика температуры Aqara

В разрезе данного датчика, у него есть Аксессуар - то есть устройство целиком, у которого есть четыре сервиса:

  • Датчик температуры
  • Датчик влажности
  • Датчик атмосферного давления
  • Батарея

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

Список сервисов и параметров аксессуара

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

Дополнительная информация характеристики и связи

При этом уже у характеристики, есть дополнительная информация и настройки, а так же связи с физическим устройством, или с логическими устройствами, о чем написано в разделе Связи между виртуальными и реальными устройствами

Раздел дополнительной информации и настроек, содержит в себе список идентификаторов Аксессуара, Сервиса и Характеристики, для использования их в различных сценариях

Идентификаторы аксессуара, сервиса и характеристики

Также у аксессуара, в этом разделе есть различные настройки, присущие данному конкретному типу аксессуара. Например у датчика температуры, есть настройка смещения, где можно указать поправку температуры, относительно измеренной датчиком

Смещение температуры

Настройка производится в разделе дополнительной информации у характеристики Температура (значок i у характеристики)

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

SwitchOffTime и задержка отключения

Данная настройка находится в разделе дополнительной информации у характеристики "Обнаружено движение" у датчика (значок i у характеристики)

Выключение по таймеру, или SwitchOffTime, используется для тех датчиков движения, которые не отправляют статус "нет движения" после обнаружения движения. Это за них делает Sprut.hub. Соответственно у некоторых датчиков (например Aqara) там установлена задержка по умолчанию, которая равна 180 секунд или 3 минуты. Указывается в секундах.


Задержка выключения - увеличивает время задержки на указанное время в секундах.

Настраиваемые параметры устройства

Некоторые устройства имеют настраиваемые параметры. Его можно открыть как через меню, так и нажав шестеренку в правом верхнем углу карточки устройства.

На примере комбинированного датчика Wirenboard WB-MSW-ZIGBEE v.3 мы видим большое количество настраиваемых параметров

а также настройку уведомлений

Не все устройства имеют дополнительные параметры, но вам стоит проверить их наличие

Например у различных штор и моторов - есть верхние, нижние и крайние положения. Которые настраиваются в этом разделе.

Изменение предельных значений у виртуальных устройств

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

В данном случае, если мы хотим изменить предельные значения у характеристики "Целевая температура", то мы должны нажать на значок (i) у этой характеристики

Далее перейти в раздел "Ограничения" и настроить предельные значения характеристики, а также шаг изменения

Изменение вариантов целевых режимов виртуальных устройств

У виртуального термостата - обширный выбор целевых режимов, которые не всегда нужны. Их список можно сократить до необходимого количества, изменив дополнительный параметр "Допустимые значения" уже у характеристики "Целевой режим"

Для этого необходимо открыть дополнительные параметры характеристики

И отключить ненужные вам режимы