Custom-wiren-board-device-templates - История изменений

Admin: Английские адреса Wiki: обновление ссылок с сохранением русских подписей

2026-10-02T22:19:06Z

Английские адреса Wiki: обновление ссылок с сохранением русских подписей

← Предыдущая версия		Версия от 22:19, 2 октября 2026
Строка 1:		Строка 1:
	{{DISPLAYTITLE:Пользовательские шаблоны устройств Wiren Board}}		{{DISPLAYTITLE:Пользовательские шаблоны устройств Wiren Board}}
	Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board <code>wb-mqtt-serial</code>. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи [[Настройка драйверов]].		Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board <code>wb-mqtt-serial</code>. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи [[Driver-setup\|Настройка драйверов]].

	Готовый файл шаблона с расширением <code>.json</code> скопируйте на контроллер в каталог:		Готовый файл шаблона с расширением <code>.json</code> скопируйте на контроллер в каталог:
Строка 110:		Строка 110:
	== Следующий шаг и связанные статьи ==		== Следующий шаг и связанные статьи ==

	* [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]] — пример готового пользовательского шаблона.		* [[Ensystec-leak-protect-wiren-board-template\|Шаблон Wiren Board Ensystec Leak Protect для XIOT]] — пример готового пользовательского шаблона.
	* [[Подключение Ensystec в XIOT через Wirenboard]] — пример его использования в XIOT.		* [[Ensystec-wiren-board-integration\|Подключение Ensystec в XIOT через Wirenboard]] — пример его использования в XIOT.

	== Источники ==		== Источники ==
Строка 121:		Строка 121:

	[[Категория:Документация XIOT]]		[[Категория:Документация XIOT]]
			{{DEFAULTSORT:Пользовательские шаблоны устройств Wiren Board}}

Admin: Admin переименовал страницу Пользовательские шаблоны устройств Wiren Board в Custom-wiren-board-device-templates: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T21:28:31Z

Admin переименовал страницу Пользовательские шаблоны устройств Wiren Board в Пользовательские шаблоны устройств Wiren Board: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия	Версия от 21:28, 2 октября 2026
(нет различий)

Admin: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T21:28:29Z

Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия		Версия от 21:28, 2 октября 2026
Строка 1:		Строка 1:
			{{DISPLAYTITLE:Пользовательские шаблоны устройств Wiren Board}}
	Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board <code>wb-mqtt-serial</code>. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи [[Настройка драйверов]].		Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board <code>wb-mqtt-serial</code>. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи [[Настройка драйверов]].

Admin: COR-06: отделить wb-mqtt-serial от драйвера XIOT и добавить предупреждение для SSH/SFTP

2026-08-29T05:50:49Z

COR-06: отделить wb-mqtt-serial от драйвера XIOT и добавить предупреждение для SSH/SFTP

← Предыдущая версия		Версия от 05:50, 29 августа 2026
Строка 1:		Строка 1:
			Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board <code>wb-mqtt-serial</code>. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи [[Настройка драйверов]].

	Готовый файл шаблона с расширением <code>.json</code> скопируйте на контроллер в каталог:		Готовый файл шаблона с расширением <code>.json</code> скопируйте на контроллер в каталог:

Строка 17:		Строка 19:

	Для подключения к файлам контроллера используется SFTP, порт <code>22</code>.		Для подключения к файлам контроллера используется SFTP, порт <code>22</code>.

			Подключайтесь по SFTP или SSH только из локальной либо другой доверенной сети. Не публикуйте порт <code>22</code> контроллера в интернет и не передавайте пароль <code>root</code> посторонним.

	== Шаг 1. Скопируйте файл через SFTP ==		== Шаг 1. Скопируйте файл через SFTP ==
Строка 113:		Строка 117:
	* [https://wirenboard.com/wiki/View_controller_files_from_your_computer Просмотр и копирование файлов контроллера с компьютера — Wiren Board]		* [https://wirenboard.com/wiki/View_controller_files_from_your_computer Просмотр и копирование файлов контроллера с компьютера — Wiren Board]
	* [https://wirenboard.com/wiki/RS-485:Configuration_via_Web_Interface Настройка устройств RS-485 через веб-интерфейс — Wiren Board]		* [https://wirenboard.com/wiki/RS-485:Configuration_via_Web_Interface Настройка устройств RS-485 через веб-интерфейс — Wiren Board]
			* [https://github.com/wirenboard/wb-mqtt-serial Описание и пользовательские шаблоны wb-mqtt-serial — GitHub Wiren Board]

	[[Категория:Документация XIOT]]		[[Категория:Документация XIOT]]

Admin: Убраны служебные вводные комментарии

2026-08-27T07:45:15Z

Убраны служебные вводные комментарии

← Предыдущая версия		Версия от 07:45, 27 августа 2026
Строка 1:		Строка 1:
	~~'''Для кого:''' интеграторы, которым нужно установить готовый шаблон устройства на контроллер Wiren Board.~~		Готовый файл шаблона с расширением <code>.json</code> скопируйте на контроллер в каталог:

	~~'''Результат:'''~~ файл шаблона скопирован на контроллер, устройство добавлено через веб-интерфейс и его каналы появились в разделе «Устройства».

	~~'''Проверено:''' 27 августа 2026 года по актуальной документации Wiren Board и HomeUI <code>2.249.0</code>.~~

	~~'''Главное:''' готовый файл~~ <code>.json</code> ~~нужно скопировать~~ на контроллер в каталог:

	<pre>		<pre>

Admin: Переработана в практическую инструкцию для интегратора: SFTP, каталог шаблонов и настройка устройства

2026-08-27T07:42:04Z

Переработана в практическую инструкцию для интегратора: SFTP, каталог шаблонов и настройка устройства

Внесённые изменения

Admin: Актуализирована установка пользовательских шаблонов по wb-mqtt-serial 2.269.0 и WB-STD-003 v1.2

2026-08-27T07:21:21Z

Актуализирована установка пользовательских шаблонов по wb-mqtt-serial 2.269.0 и WB-STD-003 v1.2

Внесённые изменения

Admin: COR-06: единый словарь действий и адресов управления/состояния

2026-08-23T16:11:19Z

COR-06: единый словарь действий и адресов управления/состояния

← Предыдущая версия		Версия от 16:11, 23 августа 2026
Строка 1:		Строка 1:
	~~__NOTOC__~~		Статья описывает, куда размещать свои JSON-шаблоны устройств для системной службы Wiren Board <code>wb-mqtt-serial</code> и как безопасно обновлять шаблон без правки штатных файлов пакета. Эта служба производителя не является драйвером XIOT: драйвер XIOT — интеграционный модуль XIOT-PLC, через который проект получает физические адреса.
	~~= Пользовательские шаблоны устройств Wiren Board =~~

	Статья описывает, куда размещать свои JSON-шаблоны устройств для ~~драйвера~~ <code>wb-mqtt-serial</code> и как безопасно обновлять шаблон без правки штатных файлов пакета.

	== Когда нужен пользовательский шаблон ==		== Когда нужен пользовательский шаблон ==

	Пользовательский шаблон нужен, если устройство работает по поддерживаемому протоколу, но штатного шаблона нет, либо штатный шаблон нужно расширить под конкретную интеграцию. Например, для Ensystec Leak Protect в XIOT нужны отдельные ~~теги~~ состояния и управления, поэтому используется отдельный шаблон: [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]].		Пользовательский шаблон нужен, если устройство работает по поддерживаемому протоколу, но штатного шаблона нет, либо штатный шаблон нужно расширить под конкретную интеграцию. Например, для Ensystec Leak Protect в XIOT нужны отдельные адреса состояния и управления, поэтому используется отдельный шаблон: [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]].

	== Куда класть шаблон ==		== Куда класть шаблон ==
Строка 43:		Строка 40:
	</pre>		</pre>

	Если устройство уже добавлено и используется ~~драйвером~~ <code>wb-mqtt-serial</code>, после замены шаблона перезапустите ~~драйвер~~:		Если устройство уже добавлено и используется службой <code>wb-mqtt-serial</code>, после замены шаблона перезапустите службу:

	<pre>		<pre>
Строка 65:		Строка 62:
	== Источники ==		== Источники ==

	* [https://wiki.wirenboard.com/wiki/Wb-mqtt-serial_driver ~~Драйвер~~ wb-mqtt-serial — Wiren Board]		* [https://wiki.wirenboard.com/wiki/Wb-mqtt-serial_driver Служба wb-mqtt-serial — Wiren Board]
	* [https://github.com/wirenboard/wb-mqtt-serial Описание wb-mqtt-serial на GitHub]		* [https://github.com/wirenboard/wb-mqtt-serial Описание wb-mqtt-serial на GitHub]
	* [https://wiki.wirenboard.com/wiki/index.php?title=Wb-mqtt-serial_templates/en WB-mqtt-serial driver: examples of writing templates]		* [https://wiki.wirenboard.com/wiki/index.php?title=Wb-mqtt-serial_templates/en WB-mqtt-serial driver: examples of writing templates]

Admin: Добавлен шаблон Ensystec для XIOT и инструкция по пользовательским шаблонам Wiren Board

2026-06-09T16:15:10Z

Добавлен шаблон Ensystec для XIOT и инструкция по пользовательским шаблонам Wiren Board

Новая страница

__NOTOC__
= Пользовательские шаблоны устройств Wiren Board =

Статья описывает, куда размещать свои JSON-шаблоны устройств для драйвера <code>wb-mqtt-serial</code> и как безопасно обновлять шаблон без правки штатных файлов пакета.

== Когда нужен пользовательский шаблон ==

Пользовательский шаблон нужен, если устройство работает по поддерживаемому протоколу, но штатного шаблона нет, либо штатный шаблон нужно расширить под конкретную интеграцию. Например, для Ensystec Leak Protect в XIOT нужны отдельные теги состояния и управления, поэтому используется отдельный шаблон: [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]].

== Куда класть шаблон ==

На Wiren Board используются две основные директории шаблонов <code>wb-mqtt-serial</code>:

{| class="wikitable"
! Путь !! Назначение
|-
| <code>/usr/share/wb-mqtt-serial/templates</code> || Предустановленные шаблоны из пакета <code>wb-mqtt-serial</code>. Эти файлы не стоит редактировать вручную: обновление пакета может заменить изменения.
|-
| <code>/etc/wb-mqtt-serial.conf.d/templates</code> || Пользовательские шаблоны. Эта директория имеет приоритет над предустановленными шаблонами и подходит для кастомных правок.
|}

Если нужно переопределить штатный тип устройства, сохраните шаблон в пользовательскую директорию и оставьте тот же <code>device_type</code>, который используется в настройках устройства. Если создаётся новый тип устройства, задайте новый уникальный <code>device_type</code>.

== Установка шаблона ==

Пример для файла <code>config-ensystec.json</code>:

<pre>
mkdir -p /etc/wb-mqtt-serial.conf.d/templates
cp config-ensystec.json /etc/wb-mqtt-serial.conf.d/templates/config-ensystec.json
</pre>

Если шаблон является обычным строгим JSON без комментариев, можно проверить синтаксис командой:

<pre>
python3 -m json.tool /etc/wb-mqtt-serial.conf.d/templates/config-ensystec.json >/dev/null
</pre>

После добавления или изменения шаблона подождите около 20 секунд и обновите страницу конфигуратора Wiren Board через <code>Ctrl</code>+<code>F5</code>. Если шаблон не появился в веб-интерфейсе, перезапустите конфигуратор:

<pre>
systemctl restart wb-mqtt-confed
</pre>

Если устройство уже добавлено и используется драйвером <code>wb-mqtt-serial</code>, после замены шаблона перезапустите драйвер:

<pre>
systemctl restart wb-mqtt-serial
systemctl status wb-mqtt-serial
</pre>

Ошибки загрузки шаблона и конфигурации смотрите в журнале:

<pre>
journalctl -u wb-mqtt-serial -n 100 --no-pager
</pre>

== Важные нюансы ==

* Не правьте <code>/etc/wb-mqtt-serial.conf</code> вручную без необходимости: основной путь настройки устройств — веб-интерфейс Wiren Board.
* Параметры каналов, заданные прямо в конфигурации устройства, имеют приоритет над параметрами из шаблона. Поэтому если канал в шаблоне добавлен, но в интерфейсе не появился, проверьте, нет ли для него переопределения <code>enabled: false</code> в конфигурации устройства.
* Перед заменой рабочего шаблона сделайте копию текущего файла и запишите, какая версия установлена на объекте.
* Для шаблонов с комментариями проверка через <code>python3 -m json.tool</code> не подходит, потому что это уже не строгий JSON. В этом случае ориентируйтесь на проверку через сервисы Wiren Board и журнал <code>wb-mqtt-serial</code>.

== Источники ==

* [https://wiki.wirenboard.com/wiki/Wb-mqtt-serial_driver Драйвер wb-mqtt-serial — Wiren Board]
* [https://github.com/wirenboard/wb-mqtt-serial Описание wb-mqtt-serial на GitHub]
* [https://wiki.wirenboard.com/wiki/index.php?title=Wb-mqtt-serial_templates/en WB-mqtt-serial driver: examples of writing templates]