WB-STD-001, 002 и 003: новые стандарты Wiren Board для MQTT и шаблонов устройств

Что регулируют три стандарта

Почему это важно на реальном объекте

До появления формализованных правил собственный шаблон Modbus-устройства можно было сделать технически рабочим, но назвать каналы и параметры так, что через год конфигурацию будет сложно сопровождать. Особенно это заметно на больших объектах, где MQTT используется одновременно в Wiren Board, сценариях, Home Assistant и других системах.

Теперь разработчик стороннего драйвера или интегратор может использовать тот же набор правил, что и сам производитель. Это делает топики предсказуемыми, интерфейс единообразным, а шаблон проще переносить между контроллерами и передавать другому специалисту.

Как теперь добавить стороннее Modbus-устройство

1. Найти таблицу регистров. Нужны адреса регистров и параметры связи: скорость, чётность, стоп-биты и Slave ID для Modbus RTU либо адрес и порт для Modbus TCP.
2. Проверить обмен. До создания большого шаблона полезно убедиться, что известный регистр действительно читается.
3. Создать шаблон wb-mqtt-serial. Регистры описываются как каналы и параметры устройства.
4. Применить WB-STD. Идентификаторы, группы, переводы и структура приводятся к опубликованным правилам.
5. Проверить шаблон на контроллере. После загрузки нужно проверить журнал wb-mqtt-serial и фактические значения каналов.

Что особенно важно в WB-STD-001

• машинные идентификаторы используют строчную латиницу, цифры и подчёркивание;
• для типовых служебных каналов предусмотрены канонические имена;
• каналы, связанные с физическими клеммами, именуются с учётом маркировки устройства;
• единицы измерения не следует зашивать в имя канала;
• после публикации шаблона менять имя канала нежелательно, поскольку оно уже становится частью MQTT-конфигурации пользователя.

WB-STD-002: человек должен видеть нормальный интерфейс

Машинное имя MQTT и отображаемое название теперь явно разделяются. Пользователю не нужно видеть технические идентификаторы вроде v_vin. Для интерфейса используются переводы и понятные подписи, например «Напряжение питания».

Стандарт отдельно задаёт правила для русского и английского текста, аббревиатур, единиц измерения и описаний. Это особенно полезно для собственных шаблонов, которые потом используются на нескольких объектах.

WB-STD-003: шаблон становится переносимым

Стандарт описывает устройство целиком: device.id, группы, каналы, параметры и переводы. Отображаемые тексты выносятся в translations, а машинные идентификаторы остаются стабильными.

А при чём здесь AI

Wiren Board отдельно предусмотрел использование стандартов AI-агентами. В документации указано, какие документы следует передавать в контекст для типовых задач: генерации шаблона wb-mqtt-serial, проверки MQTT-идентификатора или текста интерфейса.

Это не отменяет проверку инженером. Сгенерированный шаблон всё равно необходимо сверять с документацией конкретного Modbus-устройства и тестировать на реальном оборудовании.

Что это меняет для Home Assistant и Node-RED

Стандарты не являются новым протоколом и сами по себе не меняют MQTT. Их польза в предсказуемой структуре данных. Чем стабильнее идентификаторы устройств и каналов, тем проще строить поверх них автоматизации, правила, MQTT-интеграции и обслуживать систему после изменений.

Стоит ли переделывать старые шаблоны

Рабочий объект не стоит массово переделывать только ради новых правил. Изменение уже используемых MQTT-идентификаторов может нарушить сценарии и внешние интеграции. Новые стандарты прежде всего полезны при создании новых шаблонов и при подготовке устройств к повторному использованию на разных объектах.