Sprut.hub Wiki - Вклад [ru]

Что такое шаблоны?

2026-05-12T08:02:58Z

Coldsun: Убрал информацию про внешнее хранилище, как неактуальную

Шаблоны в Sprut.hub, используются для перевода различных событий, приходящих от устройств в понятную структуру [[Аксессуары, сервисы и характеристики|Аксессуаров, Сервисов и Характеристик]], которая используется в хабе.

{{QuoteBlue|Именно шаблоны, отвечают за появление устройства в интерфейсе хаба после его спаривания}}

Если [[Моё устройство не поддерживается. Нет шаблона. Что делать?|нет шаблона]], то устройством невозможно управлять. Тогда придется [[Моё устройство не поддерживается. Нет шаблона. Что делать?|отправить информацию]] об этом устройстве разработчикам, чтобы они выяснили как оно работает и добавили для него шаблон.

Шаблоны бывают встроенные и пользовательские, которые еще называют кастомные.

При этом пользователь может самостоятельно разрабатывать шаблоны и загружать их в хаб в [[Добавление кастомных шаблонов для любых устройств|соответствии с инструкцией]].

Шаблоны, подразделяются на несколько типов, при этом их приоритет для хаба, определяется по очередности (чем выше тем приоритетнее):

* Внутреннее хранилище
* Премиум
* Ранний доступ
* Основные
* Встроенные в систему

'''Внутреннее хранилище''' - шаблоны, которые были загружены в хаб через раздел "Каталог" в [[Добавление кастомных шаблонов для любых устройств|соответствии с инструкцией]].

'''Премиум''' - шаблоны для тех пользователей, кто подписан на [https://boosty.to/sprut666666 boosty]. Они становятся доступными для всех через месяц после появления в премиум подписке.

'''Основные шаблоны''' - это те, которые используются у всех пользователей и являются проверенными и адекватно работающими. Перечень устройств, официально перечислен в каталоге как [https://sprut.ai/catalog?tags=Sprut.hub поддерживаемый в Sprut.hub]

'''Встроенные в систему''' - шаблоны, которые уже встроены в ядро и не являются изменяемыми при обновлении шаблонов из интерфейса.

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

2026-04-09T18:29:03Z

Coldsun: Switchofftime

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

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

Разберем на примере [https://sprut.ai/catalog/item/aqara-temperature-and-humidity-sensor датчика температуры Aqara]

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

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

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

== Список сервисов и параметров аксессуара ==
[[Файл:Аксессуары 001 список аксессуаров датчика.png|центр|обрамить]]Каждый из перечисленных сервисов, имеет отдельную плитку в интерфейсе. Зайдя в ее настройки (долгое нажатие на плитку), или выбрав сервис из списка выше, мы увидим уже характеристику '''Температура''', у сервиса '''Датчик температуры''', или в данном примере у сервиса '''"Температура ванная"'''
===Дополнительная информация характеристики и связи===
[[Файл:Аксессуары 002 характеристика температура.png|центр|обрамить]]При этом уже у характеристики, есть дополнительная информация и настройки, а так же связи с физическим устройством, или с логическими устройствами, о чем написано в разделе [[Связи между виртуальными и реальными устройствами (Линки)|Связи между виртуальными и реальными устройствами]]

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

== Идентификаторы аксессуара, сервиса и характеристики ==
[[Файл:Аксессуары 003 идентификаторы.png|центр|обрамить]]Также у аксессуара, в этом разделе есть различные настройки, присущие данному конкретному типу аксессуара. Например у датчика температуры, есть настройка смещения, где можно указать поправку температуры, относительно измеренной датчиком

== Смещение температуры ==
Настройка производится в разделе [[Аксессуары,_сервисы_и_характеристики#Дополнительная_информация_характеристики_и_связи|дополнительной информации у характеристики]] Температура (значок i у характеристики)
[[Файл:Аксессуары 008 дополнительные Смещение.png|центр|обрамить]]У датчика движения, например есть возможность настроить выключение по таймеру и задержку выключения.

== SwitchOffTime и задержка отключения ==
Данная настройка находится в разделе настроек характеристик "Обнаружено движение" у датчика.
[[Файл:Аксессуары 007 дополнительные SwitchOffTime.png|центр|обрамить]]Выключение по таймеру, или SwitchOffTime, используется для тех датчиков движения, которые не отправляют статус "нет движения" после обнаружения движения. Это за них делает Sprut.hub. Соответственно у некоторых датчиков (например Aqara) там установлена задержка по умолчанию, которая равна 180 секунд или 3 минуты. {{color|red|Указывается в секундах.}}

Задержка выключения - увеличивает время задержки на указанное время в секундах.
{{QuoteBlue|SwitchOffTime можно использовать для выключения реле через указанный промежуток времени без использования сценариев. Например при использовании сухого реле в качестве команды для ворот и т.д.}}

== Настраиваемые параметры устройства ==
Некоторые устройства имеют настраиваемые параметры. Его можно открыть как через меню, так и нажав шестеренку в правом верхнем углу карточки устройства.
[[Файл:Аксессуары 004 параметры.png|центр|обрамить]]На примере [https://sprut.ai/catalog/item/wirenboard-nastennyj-kombinirovannyj-datcik-sprut-zigbee комбинированного датчика Wirenboard WB-MSW-ZIGBEE v.3] мы видим большое количество настраиваемых параметров
[[Файл:Аксессуары 005 настройка параметров.png|центр|обрамить]]а также настройку уведомлений
[[Файл:Аксессуары 006 настройка уведомлений.png|центр|обрамить]]{{QuoteBlue|Не все устройства имеют дополнительные параметры, но вам стоит проверить их наличие}}Например у различных штор и моторов - есть верхние, нижние и крайние положения. Которые настраиваются в этом разделе.

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

В данном случае, если мы хотим изменить предельные значения у характеристики "Целевая температура", то мы должны нажать на значок (i) у этой характеристики
[[Файл:Виртуальный термостат 011 настройка характеристики.png|центр|обрамить]]Далее перейти в раздел "Ограничения" и настроить предельные значения характеристики, а также шаг изменения
[[Файл:Виртуальный термостат 012 изменение предельных значений.png|центр|обрамить]]

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

Для этого необходимо открыть дополнительные параметры характеристики
[[Файл:Виртуальный термостат 014 изменение вариантов целевого режима.png|центр|обрамить]]
И отключить ненужные вам режимы
[[Файл:Виртуальный термостат 013 изменение вариантов работы.png|центр|обрамить]]

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

2026-04-09T18:28:39Z

Coldsun: Coldsun загрузил новую версию Файл:Аксессуары 007 дополнительные SwitchOffTime.png

=={{int:filedesc}}==
{{Information
|description={{en|1=Аксессуары 007 дополнительные SwitchOffTime}}
|date=2022-11-20
|source={{own}}
|author=[[User:Bigmanekb|Bigmanekb]]
|permission=
|other versions=
}}

=={{int:license-header}}==
{{self|cc-by-sa-4.0}}

[[Категория:Аксессуары]]
[[Категория:Интерфейс]]
[[Категория:Параметры устройств]]
[[Категория:SwitchOffTime]]

Создание контроллера ZigBee

2025-09-24T08:00:37Z

Coldsun:

{{QuoteBlue |Для Sprut.hub CE, Sprut.hub 2 и Sprut.hub 2 Din для встроенного Zigbee создание контроллера не требуется. Он уже существует "из коробки", и после удаления автоматически создаётся при перезагрузке хаба.}}

Данная инструкция для владельцев [https://spruthub.ru/device/defaro-sprut-stick-2-pro.html USB Sprut.stick].

Для пользователей WirenBoard, кто приобрел Sprut.stick ZigBee 2 WB Pro - [[Установка и настройка Sprut.stick в WirenBoard|есть отдельная инструкция]].

== Создание контроллера ZigBee ==
[[Файл:Добавить контроллер.png|центр|обрамить]]
Выбрать из списка тип контроллера ZigBee
[[Файл:Выбрать ZigBee.png|центр|мини|942x942пкс]]
Перейти в новый контроллер и нажать кнопку настройки
[[Файл:Перейти в ZigBee контроллер.png|центр|обрамить]]

Выбрать тип USB стика
[[Файл:Тип стика.png|центр|мини|865x865пкс]]
Выбрать порт в который подключен USB стик
[[Файл:Выбрать порт ZigBee стика.png|центр|мини|792x792пкс]]

Для применения настроек контроллера необходимо нажать вне карточки настрое
[[Файл:Сохранить.png|центр|мини|1490x1490пкс]]
Запустить новый контроллер нажав кнопку Play в правой части контроллера
[[Файл:Запустить ZigBee контроллер.png|центр|обрамить]]
== Подключить новое устройство ZigBee ==
{{QuoteRed|Все устройства должны спариваться находясь на том месте где они будут работать. Не рядом с хабом, а именно там, где они будут потом работать}}
{{QuoteYellow|Если вы хотите, чтобы новое устройство появилось в нужной вам комнате, то лучше воспользоваться функцией [[Как_подключить_мое_устройство_к_Sprut.hub#Поиск_новых_устройств_с_автоматическим_добавлением_в_комнату|глобального поиска новых устройств]]}}{{QuoteBlue|Для подключения устройства, необходимо чтобы контроллер был запущен, режим поиска был запущен и после запуска режима поиска в Sprut.hub, устройство было переведено в [[Какие устройства поддерживаются? (про каталог)#Как_перевести_устройства_в_режим_спаривания_с_хабом?|режим спаривания]] в соответствии с инструкцией к устройству}}Если у вас в доме уже установлено множество ZigBee устройств и вы их начинаете подключать к Sprut.hub, то делать это нужно начиная от устройств ближе всего расположенных к Sprut.hub и постепенно удаляясь от него. То есть вы сначала спариваете самые ближние устройства, потом те которые чуть дальше и так далее. Это связано со спецификой работы ZigBee сети, которая является MESH сетью и часть устройств, работающих от 220В (с нулевым проводом) - выступают в качестве ретрансляторов сети. Это позволяет "растянуть" сеть ZigBee на достаточно большую площадь.[[Файл:Добавление устройств ZigBee.png|центр|обрамить]]

== Подключить новое устройство ZigBee через конкретный роутер ==
Устройства ZigBee, работающие от сети 220 и подключенные с нулевым проводником (выключатели с нулем, умные лампочки, розетки и т.п.) - выступают в качестве роутера ZigBee сети.

Какие устройства работают в качестве роутера, можно узнать [https://sprut.ai/catalog?tags=Sprut.hub,Zigbee,%D0%A0%D0%BE%D1%83%D1%82%D0%B5%D1%80 в каталоге на Sprut.ai]

Соответственно если ваше устройство находится довольно далеко от хаба и оно не проходит какие-то этапы при спаривании, есть вероятность, что сеть ZigBee работает не очень корректно, например из-за "кривых" роутеров или других причин.

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

Для этого, необходимо найти этот роутер в списке устройств ZigBee контроллера и запустить поиск новых устройств через него
[[Файл:ZigBee 001 Подключение через конкретный роутер.png|центр|обрамить]]{{QuoteYellow|Если вы переспариваете через другой роутер ранее подключенное устройство, то перед спариванием - нужно его удалить из контроллера ZigBee. }}

Аксессуары (плитки управления) в разделе "Устройства" трогать не нужно. Связь между аксессуарами и устройством заново создастся при переспаривании, так что вам не придется заменять аксессуары в сценариях и т.п.

== Подключение устройства напрямую к Zigbee координатору Sprut.hub ==
Так же как описано выше, можно подключить устройство напрямую к ZigBee координатору, который встроен в Sprut.hub CE или 2 (он же выполнен в виде стика для Raspberry Pi и WirenBoard)

Для этого нужно:

# Перейти в раздел контроллеры
# Выбрать контроллер ZigBee
# Найти в списке Sprut zigbee
# Выбрать три точки на Sprut zigbee справа
# Запустить поиск устройств

[[Файл:ZigBee 007 Поиск через координатор.png|центр|обрамить]]
__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__
[[Категория:Подключить через конкретный роутер]]
[[Категория:Роутер zigbee]]
[[Категория:Роутер]]