Транспорт Modbus RTU
При настройке Modbus переключателя режима интерфейса модуль работает как ведомый Modbus RTU на своих UART-линиях (внешний трансивер адаптирует их к RS-485). Уровень Modbus — это трансляция в тот же регистровый файл, что и I²C: те же величины, те же команды, одна очередь команд; отличается только формат передачи.
Последовательный интерфейс
-
Кадрирование: стандартный RTU
[addr][function][data][CRC16], полином CRC16 0xA001 (отражённый), младший бит первым. Кадр с неверным CRC не получает ответа (стандартное поведение RTU). -
ID устройства: 1..247, по умолчанию 1 (
CFG_MODBUS_ADDR). 0 = широковещательный (только разрешённые записи, см. ниже). ID 248..255 отклоняются при конфигурации. -
Скорость: по умолчанию 9600. Коды в
CFG_MB_BAUD: 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1000000. Модуль принимает коды 0–10; скорость линии по RS-485 задаётся внешним трансивером. Если сохранённый код когда-либо окажется недопустимым, модуль загрузится на 9600. -
Формат кадра:
CFG_MB_FRAME0=8N1 · 1=8E1 · 2=8O1 · 3=8N2. -
Удержание ответа:
CFG_TX_DELAY0..100 ms — для адаптеров RS-485 с автонаправлением, которым нужно время, чтобы освободить линию. -
Настройки последовательного порта проверяются при записи (исключение 03). Запись только помещает значение в ОЗУ — чтобы оно вступило в силу, сохраните его (
COMMAND0x04), затем перезапустите модуль (COMMAND0x02, с гейтом UNLOCK); модуль загружается с сохранёнными значениями. Пошагово: Последовательности D4. -
Задержка ответа: запрошенный диапазон копируется атомарно из опубликованного образа, поэтому даже чтение 125 регистров внутренне согласовано; устройство отвечает за < 20 ms на любой скорости (подходит для опроса инвертора 3–5 Hz).
-
Ответы на команды, вызывающие перезапуск (RESET, ACTIVATE прошивки, смена адреса по UID) могут быть усечены или отсутствовать — устройство может перезапуститься до завершения ответа, а настроенная задержка TX может подавить его полностью. Подтверждайте повторным опросом после перезапуска, а не по ответу.
Коды функций
FC03 чтение holding · FC04 чтение input · FC06 запись одного · FC16 запись нескольких. Любой другой код функции → исключение 01.
Пределы: FC03/FC04 количество 1..125, FC16 1..123 — вне диапазона → исключение 03. FC16 — всё или ничего: весь кадр проверяется сначала; один плохой регистр → ничего не применяется. COMMAND (holding 0x8113) — только запись; чтение → исключение 02.
Пространства регистров
Адреса Modbus — отдельное пространство, независимое от адресов I²C. Структура:
| Пробел | Диапазон | Содержание |
|---|---|---|
| Вход | 0x0000–0x03FF | Профиль float32 (13 живых точек, ниже) |
| Вход | 0x6000–0x6FFF | родной профиль целых с фиксированным масштабом (обнаружение, каналы, энергия, итоги) |
| Holding | 0x8000–0x83FF | родная конфигурация · команды / время · обновление прошивки |
| Holding | 0x8400–0x847F | окно безопасности (сертификат устройства / аттестация; поток байтов) |
| Holding | 0xA000–0xAFFF | зеркало native input только для чтения (= адрес input + 0x4000) для мастеров, поддерживающих только FC03 |
| — | всё остальное | незаданный адрес → исключение 02 |
Нативные и holding-адреса каждого блока перечислены вместе с картой I²C в карте регистров.
Родной профиль (input 0x6000+)
Целые с фиксированным масштабом, те же единицы, что по I²C. Порядок слов ABCD (старшее слово первым) по умолчанию; CFG_WORD_ORDER = 1 переключает на младшее слово первым для всех многорегистровых чисел в родном входном профиле (i64 = все четыре слова в обратном порядке), а маркеры отсутствующих каналов меняются так же. Окна holding (0x81xx/0x83xx) всегда старшим словом первым, независимо от CFG_WORD_ORDER. i32 = 2 регистра, i64 = 4 регистра. Итоги P/Q/S публикуются как i64 по Modbus (с расширением знака из значений устройства).
Профиль float32 (input 0x0000)
Modbus RTU с профилем регистров float32 из 13 значений. Адреса регистров и порядок слов ABCD следуют публично описанной карте регистров SDM. Мы не тестировали модуль ни с каким устройством SDM, ни с ПО SDM сторонних производителей, инвертором, ПЛК или SCADA.
IEEE-754 float32, всегда ABCD, физические единицы (V/A/W/kWh), экспорт как положительная величина. Живые точки (13):
| Адрес входа | Точка |
|---|---|
| 0x0000 / 0x0002 / 0x0004 | напряжение L1 / L2 / L3, V |
| 0x0006 / 0x0008 / 0x000A | ток L1 / L2 / L3, A |
| 0x000C / 0x000E / 0x0010 | активная мощность L1 / L2 / L3, W |
| 0x0034 | суммарная активная мощность, W |
| 0x0046 | частота, Hz |
| 0x0048 / 0x004A | энергия импорта и экспорта, kWh |
Любой другой адрес в 0x0000–0x03FF читается как 0; инвертор или SCADA, которому нужны регистры вне списка выше, не получит их из этого профиля. Фазы, которых нет у модуля, читаются как 0.0 (STD-UI1 публикует свой канал как L1; его адреса L1 несут напряжение, ток, мощность, частоту, энергию импорта и экспорта). Точки S, Q, PF и общей энергии читаются как 0. Однофазные элементы публикуют свой канал как L1. У этого профиля нет алиасов конфигурации — конфигурация выполняется через родные holding-регистры.
Виртуальные unit id
При CFG_VIRTUAL_IDS = 1 (сохранено и перезапуск; вступает при загрузке) модуль с более чем одним токовым каналом также отвечает на unit id base+1 … base+N_CURRENT (ограничено 247): каждый id — представление одного токового канала типа float32 только для чтения: его напряжение, ток, мощность, суммарная мощность (равна мощности этого канала), частота; точки энергии читаются как 0. Любая запись в виртуальный id → исключение 02. Выбирайте базовый unit id так, чтобы производные id не совпадали с другими счётчиками на шине.
(Таблица конфигурации METER_GROUP в карте зарезервирована — состав групп не настраивается.)
Широковещательный (ID устройства 0)
На широковещательный адрес принимаются только эти записи; всё остальное молча отклоняется (ответа с исключением на широковещательные запросы нет, по стандарту Modbus):
-
установка времени — два кадра: FC16 на 0x8100–0x8101 (эпоха, сначала старшее слово), затем FC06
COMMAND0x8113 = 0x0006 — синхронизация часов по всей шине; -
LATCH_BANK/PERIOD_ARM0x8110–11 иCOMMAND0x03 — синхронизированный снимок по модулям (бит возможности 8); -
подготовка адреса по UID 0x8118–0x811E +
COMMAND0x16 — ввод в эксплуатацию на общей шине.
Широковещательный FC16 должен оставаться в пределах регистров белого списка — кадр, затрагивающий что-либо ещё, отклоняется целиком.
UNLOCK (команды с ограничением)
Команды, меняющие состояние устройства, должны предваряться записью ключа разблокировки 0xA5C3 в holding 0x8112:
- Ключ действителен 10 s и расходуется одной командой с ограничением.
- Запись неверного значения сбрасывает активное разблокирование.
- Защищённая команда без действительной разблокировки → исключение 03.
- Чтение 0x8112 возвращает флаг разблокирования (0/1) в последнем установленном значении — считайте его только информативным.
- Разблокирование и команду можно отправить в одном кадре FC16 на 0x8112–0x8113 (сначала ключ, затем код операции).
Набор с ограничением: 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (где реализовано) · 0x10/0x12/0x13/0x14 (обновление прошивки) · 0x15 (сервис). Без ограничения: 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 запись страницы · 0x16 адрес по UID. Для модулей, не реализующих код операции, отказ — исключение 03 ещё до проверки ограничения. Команды накопленной энергии используют другой одноразовый механизм с ключом (LT_KEY), а не UNLOCK — см. Команды.
Правила поведения (контракт семейства)
-
Значения
COMMAND,LATCH_BANK,PERIOD_ARM> 0xFF → исключение 03 (без молчаливого усечения младшего байта). -
Запись в
COMMAND, пока команда ещё выполняется → исключение 06 (устройство занято). -
Окна из пар байтов (безопасность 0x8400+, полезная нагрузка прошивки 0x8380+, запись истории 0x8180+): регистр k несёт байты 2k (старший) и 2k+1 (младший). Записи, затрагивающие байты только для чтения → исключение
-
Окно безопасности — это поток байтов little-endian: числовые поля внутри декодируются как LE из байтов, а не как регистры big-endian.
-
Одна таблица допустимых значений конфигурации обслуживает оба транспорта: недопустимое значение по Modbus → исключение 03; то же значение по I²C отклоняется при SAVE_CONFIG с
ERROR0xFD — в обоих случаях ничего не сохраняется. -
Поля, которых сборка не поддерживает (отсутствующие каналы; величины THD и смещения при бите 2 CAPABILITIES = 0), в родном профиле возвращают маркер-заглушку (
0xFFFF/0x8000…); в профиле float32 — 0.
Исключения
| Код | Значение |
|---|---|
| 01 | недопустимая функция (всё, кроме FC03/04/06/16) |
| 02 | адрес вне карты · запись во входной регистр, holding только для чтения или виртуальный unit id · чтение регистра «только запись» |
| 03 | недопустимое значение (неверный ID устройства / код скорости / значение конфигурации · недопустимый код команды · слишком большое значение COMMAND/LATCH · величина вне диапазона · защищённая команда без разблокировки) |
| 04 | внутренний отказ устройства |
| 06 | устройство занято (выполняется команда или операция прошивки) |
Последнее исключение хранится для диагностики в LAST_EXCEPTION (FC<<24 | code<<16 | address), читается по обоим транспортам: I²C 0x0158, holding Modbus 0x830A–0B.