Пользователь может самостоятельно разработать шаблон для своего устройства и загрузить его в Sprut.hub.
Это позволяет не дожидаться, пока разработчики добавят поддержку устройства и пользоваться им до появления официальной поддержки.
Добавить кастомный шаблон очень просто. Достаточно его записать в соответствующую протоколу папку на отдельную внешнюю флешку (или microSD карту памяти для владельцев Sprut.hub CE), которая используется для резервного копирования.
Причем структура папок создается автоматически при настроенной резервной копии.
Шаблоны расположены в папке /Sprut.hub/Templates/ на флешке, которая используется для резервного копирования в хабе.
- Bluetooth
- ZigBee
- MQTT
- ZWave
- Test
- Xiaomi
- ModBus
- Wirenboard
Шаблоны для каждого протокола располагаются в соответствующей протоколу папке. То есть ZigBee шаблоны, обитают в папке /Sprut.hub/Templates/ ZigBee
Если папок на флешке нет, их можно создать в соответствии с путем и перечнем протоколов, или настроить резервное копирование и создать первую резервную копию, которая автоматически создается при перезагрузке хаба. После перезагрузки, папки для шаблонов на флешке создадутся автоматически
Владельцам Raspberry Pi и WirenBoard
Для владельцев Raspberry Pi можно залить кастомный шаблон через SSH (SFTP) в папку /home/makesimple/.SprutHub/data/Templates
Для владельцев WirenBoard можно залить кастомный шаблон через SSH (SFTP) в папку /mnt/data/makesimple/.SprutHub/data/Templates
В качестве SFTP клиента можно использовать, например Filezilla где необходимо добавить новый хост с IP адресом вашей Raspberry Pi или WirenBoard, на которой установлен Sprut.hub, выбрать протокол SFTP и ввести логин и пароль, который вы используете при подключение к "малине" или "вайрену" по SSH. Для Raspberry Pi - стандартный логин/пароль SSH: pi/raspberry
Загрузка кастомного шаблона
Ваш кастомный шаблон необходимо скопировать в соответствующую протоколу папку, подключить флешку к хабу и в разделе Настройки - Расширенные - Перезагрузить шаблоны
Если шаблон некорректный - в логе вы увидите ошибку. Что именно в нем не так - вам придется выяснять самостоятельно.
Если вы создаете собственный шаблон и производите постоянное изменение настроек в нем, то каждая версия шаблона должна иметь отличное от предыдущей версии название файла. Иначе он не загрузится. Аксессуар, созданный предыдущей версией шаблона, перед обновлением шаблонов необходимо удалить.
Обновление шаблонов
Обновление шаблонов происходит так же как и при обновлении системы. Появится уведомление о наличии обновлений.
Если у вас есть кастомные шаблоны и вы обновляете версию шаблонов, стоит внимательно отслеживать события в логе, так как может возникнуть их конфликт. Для всех шаблонов кроме MQTT - приоритетными являются кастомные