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

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

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

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

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

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

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

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

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

Аксессуары 001 список аксессуаров датчика.png

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

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

Аксессуары 002 характеристика температура.png

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

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

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

Аксессуары 003 идентификаторы.png

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

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

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

Аксессуары 008 дополнительные Смещение.png

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

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

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

Аксессуары 007 дополнительные SwitchOffTime.png

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


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

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

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

Аксессуары 004 параметры.png

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

Аксессуары 005 настройка параметров.png

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

Аксессуары 006 настройка уведомлений.png

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

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

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

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

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

Виртуальный термостат 011 настройка характеристики.png

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

Виртуальный термостат 012 изменение предельных значений.png

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

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

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

Виртуальный термостат 014 изменение вариантов целевого режима.png

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

Виртуальный термостат 013 изменение вариантов работы.png