Система именования и маркировки

Урок 1 · Монтаж и пусконаладка контроллера · 15 мин · theory

Введение в системы именования: Физическая и логическая маркировка

Приступая к монтажу любой системы автоматизации, инженер сталкивается с сотнями, а иногда и тысячами точек подключения: кабелей, клемм, датчиков и исполнительных устройств. Без строгой и понятной системы идентификации этих элементов объект быстро превращается в хаотичное переплетение проводов и неструктурированных данных. Стандартизированная система именования — это не бюрократия, а критически важный инструмент, обеспечивающий эффективность на всех этапах жизненного цикла проекта: от монтажа и пусконаладки до последующей эксплуатации, диагностики и модернизации.

В основе профессионального подхода лежит разделение двух ключевых понятий:

Физическая маркировка — это уникальный идентификатор, нанесенный непосредственно на физические компоненты системы. Это то, что инженер видит своими глазами в распределительном щите или на объекте: бирка на кабеле, наклейка на клемме, гравировка на DIN-рейке. Эта маркировка отвечает на вопрос: «Что это за провод у меня в руках?».

Логическое именование — это стандартизированное имя того же компонента в программной среде. Это то, как устройство представлено в логике контроллера, в протоколе обмена данными (например, MQTT) или в пользовательском интерфейсе. Логическое имя отвечает на вопрос: «Как мне обратиться к этому датчику в коде?».

Главная цель, которую мы преследуем, — создать неразрывную, однозначную и легко прослеживаемую связь между физическим миром и его программным (логическим) представлением. Инженер, обнаружив в щите кабель с маркировкой `F2-L-201`, должен за несколько секунд найти соответствующий ему MQTT-топик и узел в Node-RED, и наоборот.

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

Путаница при монтаже: Монтажники тратят часы, "прозванивая" кабели, потому что их маркировка отсутствует или непонятна.
Затягивание пусконаладки: Программист не может связать логику с реальным оборудованием, так как неизвестно, какой датчик подключен к какому входу контроллера.
Сложность диагностики: При отказе датчика поиск неисправности превращается в детективное расследование. Вместо того чтобы за 5 минут найти нужный кабель по карте и проверить сигнал, приходится тратить часы на выявление всей цепочки от интерфейса до поля.
Невозможность модернизации: Добавление новой функции или замена устройства становится рискованной операцией, способной нарушить работу всей системы.

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

---

Стандарты физической маркировки кабелей и оборудования

Физическая маркировка — это ваш «паспорт» для каждого элемента системы. Она должна быть долговечной, легко читаемой и понятной для любого инженера, который будет работать на объекте, даже спустя годы после монтажа.

Материалы и правила нанесения

Качество маркировки определяется не только ее содержанием, но и физическим исполнением.

> 💡 Подсказка: Используйте термоусадочные трубки с печатью для маркировки кабелей. Это дороже, чем бумажные наклейки, но обеспечивает долговечность и читаемость на весь срок службы объекта. Термоусадка устойчива к влаге, пыли, растворителям и механическому истиранию, в отличие от бумажных маркеров, которые отклеиваются и выцветают.

Правила нанесения маркировки:

На обоих концах: Маркировка обязательно наносится на оба конца кабеля — у клеммника контроллера в щите и у оконечного устройства (датчика, светильника, розетки). Это позволяет однозначно идентифицировать кабель с любой стороны без необходимости "прозвонки".

На оборудовании: Аналогичная маркировка должна присутствовать на корпусе самого устройства (например, наклейка на датчике движения `PNL1-S-204`).

В щите: Под клеммной колодкой или DIN-модулем, к которому подключается кабель, размещается наклейка с тем же идентификатором. Это создает тройное подтверждение и исключает ошибки при коммутации.

Читаемость: Располагайте маркировку так, чтобы ее было легко прочитать, не изгибая и не вытягивая кабель из жгута.

Для создания качественных и долговечных маркировок используйте промышленные принтеры этикеток (например, Brady, Dymo, Brother) со специальными самоламинирующимися наклейками или термоусадочными трубками. Это профессиональный стандарт, который отличает качественный монтаж.

---

Логическое именование: Структура топиков MQTT

Если физическая маркировка — это «тело» элемента, то логическое именование — это его «душа» в цифровом мире. На платформе HI основной шиной для обмена сообщениями служит протокол MQTT. Правильно спроектированная структура MQTT-топиков является ключом к созданию гибкой, масштабируемой и легко отлаживаемой системы.

Топик в MQTT — это иерархический путь, похожий на структуру папок в файловой системе. Мы будем использовать многоуровневую структуру, которая позволяет точно адресовать любое устройство и его параметры.

Рекомендуемая структура топика:

`project/location/device_class/device_id/parameter`

Разберем эту структуру на реальном примере:

`h-mansion/f1/living-room/light/ceiling-main/state`

`project` (h-mansion): Уникальное имя проекта или объекта. Это корневой уровень, который позволяет отличать сообщения от разных инсталляций, если они используют один MQTT-брокер. (Например, `h-cottage-sochi`, `office-moscow`).
`location` (f1/living-room): Физическое расположение устройства. Этот уровень может быть составным, чтобы обеспечить нужную гранулярность. Например, `f1/living-room` (этаж 1, гостиная), `outdoor/terrace` (улица, терраса). Использование стандартизированных и понятных имен (на английском языке, в нижнем регистре) является обязательным.
`device_class` (light): Класс устройства. Соответствует физическому типу, например: `light`, `temperature-sensor`, `motion-sensor`, `curtain`, `socket`.
`device_id` (ceiling-main): Уникальный идентификатор конкретного устройства в пределах его класса и расположения. Здесь нужно использовать описательные имена: `ceiling-main`, `spot-line-1`, `wall-switch-left`. Избегайте безликих `light1`, `light2`.
`parameter` (state): Конкретный параметр устройства, который мы хотим прочитать или изменить.

📋 Ключевые понятия: Параметры `state` и `set`

Для управляемых устройств (реле, диммеры, термостаты) принято разделять топики на два типа:

`/set` (командный топик): используется для отправки команд устройству. Например, чтобы включить свет, мы публикуем сообщение `ON` в топик `.../light/ceiling-main/set`.
`/state` (топик состояния): используется устройством для публикации своего текущего состояния. После успешного включения реле отправит сообщение `ON` в топик `.../light/ceiling-main/state`. Это обеспечивает обратную связь и позволяет интерфейсам всегда отображать актуальный статус.

Примеры MQTT-топиков:

// Управление светом в кухне
h-mansion/f1/kitchen/light/spot-line-1/set      // Отправить команду (ON/OFF)
h-mansion/f1/kitchen/light/spot-line-1/state    // Получить текущее состояние

// Управление яркостью диммируемого света
h-mansion/f1/kitchen/light/pendant/brightness/set   // Установить яркость (0-100)
h-mansion/f1/kitchen/light/pendant/brightness/state // Получить текущую яркость

// Чтение данных с датчика температуры
h-mansion/f2/bedroom-master/temperature-sensor/air/value  // Получить значение температуры (e.g., 23.5)
h-mansion/f2/bedroom-master/humidity-sensor/air/value   // Получить значение влажности (e.g., 45.2)

// Состояние датчика движения
h-mansion/f1/corridor/motion-sensor/main/state  // Получить состояние (true/false)

Преимущества для Node-RED

Такая иерархическая структура дает огромную гибкость при работе в Node-RED благодаря использованию символов подстановки (wildcards) в узле `mqtt in`:

`+` (одноуровневый wildcard): Заменяет один уровень иерархии.

* Подписка на `h-mansion/f1/+/temperature-sensor/air/value` позволит одним узлом получать данные со всех датчиков температуры на первом этаже.

`#` (многоуровневый wildcard): Заменяет все последующие уровни иерархии.

* Подписка на `h-mansion/f1/living-room/#` позволит отлавливать абсолютно все события, происходящие в гостиной на первом этаже, что незаменимо при отладке.

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

---

Пример: Связывание физического и логического в Карте I/O

Теперь, когда мы определили стандарты для физических и логических имен, нам нужен инструмент, который свяжет их воедино. Этим инструментом является Карта входов-выходов (I/O Map).

> 🔗 Связанный материал: Основные принципы и назначение этого документа были подробно рассмотрены в предыдущем уроке "Что такое карта входов-выходов (I/O Map)". Здесь мы сосредоточимся на практическом ее заполнении.

Карта I/O — это главный документ проекта, ваша "карта сокровищ". Она должна вестись в формате электронной таблицы (Google Sheets, Excel) и быть доступной всем участникам проекта.

> ⚠️ Внимание: Карта I/O — это «живой» документ. Любые изменения на объекте (перекоммутация, добавление устройства) должны немедленно отражаться в карте. Неактуальная документация — главная причина задержек при пусконаладке и обслуживании.

Структура Карты входов-выходов

Таблица должна содержать следующие столбцы:

|:---|:---|:---|:---|:---|:---|:---|

| `...` | `...` | `...` | `...`| `...` | `...` | `...` |

Разберем столбцы:

Физическая маркировка: Уникальный идентификатор кабеля в формате `ГРУППА-ТИП-ID`, который мы определили ранее.

ID Контроллера: Идентификатор контроллера HI, к которому выполнено подключение (например, `HI-Core-01`).

Порт контроллера: Конкретный физический порт, к которому подключен кабель (например, `UI-05`, `RL-11`, `RS485-1`).

Тип сигнала: Тип электрического сигнала («сухой контакт», 0-10В, 1-Wire, реле 230V).

Назначение: Человекочитаемое описание того, что делает этот канал (например, "Основной свет, Гостиная", "Датчик движения, Коридор 1 эт.").

Имя узла в Node-RED: Имя соответствующего узла в потоке Node-RED (например, `[MQTT IN] Living Room Light State`, `[GPIO OUT] Kitchen Spots`).

Топик MQTT: Полный MQTT-топик, связанный с этим каналом.

Практический пример заполнения

Представим, что мы монтируем систему в двухэтажном коттедже. Проследим всю цепочку для одной линии освещения на кухне.

Монтаж: Электрик прокладывает кабель от щита до группы потолочных спотов на кухне. Он маркирует оба конца кабеля как `F1-L-105`.

Коммутация в щите: Кабель подключается к 11-му реле контроллера `HI-Core-01`.

Запись в Карту I/O: Инженер по наладке открывает Карту I/O и заполняет новую строку:

|:---|:---|:---|:---|:---|:---|:---|

Теперь у нас есть полная, прозрачная связь:

Видя кабель `F1-L-105`, мы знаем, что он идет на 11-е реле и отвечает за вторую линию спотов на кухне.
Тестируя выход `RL-11` на контроллере, мы знаем, какая именно нагрузка должна включиться.
Отправляя команду в топик `.../spot-line-2/set`, мы понимаем, какое реле и какой светильник мы активируем.
Отлаживая узел `[GPIO OUT] Kitchen Spots L2` в Node-RED, мы точно знаем, с каким физическим выходом он связан.

Эта таблица становится единым источником правды для всей команды проекта.

---

Итоги и лучшие практики

В этом уроке мы заложили основу для системного подхода к монтажу и программированию. Правильная система именования — это инвестиция в будущее проекта, которая многократно окупается за счет снижения трудозатрат на всех последующих этапах.

Кратко закрепим основные принципы:

Физическая маркировка (формат `ГРУППА-ТИП-ID`) — это язык для инженеров и монтажников, работающих "в поле" и в щите. Она должна быть долговечной и однозначной.
Логическое именование (структура MQTT-топиков `project/location/...`) — это язык для программистов и наладчиков, работающих с программным обеспечением. Она должна быть иерархической и гибкой.
Карта входов-выходов (I/O Map) — это мост, связующее звено между физическим и логическим мирами. Это самый важный документ проекта.

Лучшие практики, которые нужно внедрить в работу:

Принцип консистентности: Выбрав систему именования, строго соблюдайте ее на протяжении всего проекта. Никаких исключений "на один раз". Это касается всех участников команды: от проектировщика до монтажника и программиста.

Документация как инструмент: Перестаньте воспринимать документацию (особенно Карту I/O) как бюрократическую повинность, которую делают "потом". Ведите ее в процессе работы. Она сэкономит вам часы, а не отнимет их.

Используйте описательные имена: И в физической маркировке, и в MQTT-топиках `living-room-main-light` всегда лучше, чем `light1`. Через полгода вы забудете, что такое `light1`, а описательное имя будет понятно всегда.

Стандартизируйте лексику: Используйте английские термины в нижнем регистре `kebab-case` (слова через дефис) для MQTT-топиков. `living-room`, а не `LivingRoom` или `living_room`. Это упрощает парсинг и подписки.

Начинайте с документации: Перед тем как проложить первый кабель, создайте черновик Карты I/O. Распределите входы и выходы, присвойте имена. Это позволит избежать хаоса с самого начала.

В следующем уроке мы перейдем к практической настройке универсальных входов (UI) контроллера и научимся работать с их различными режимами, используя созданную нами систему именования для привязки реальных датчиков к логике Node-RED.