rbAmp
RU
Магазин
Документация
Обновлено

Транспорт 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_FRAME 0=8N1 · 1=8E1 · 2=8O1 · 3=8N2.

  • Удержание ответа: CFG_TX_DELAY 0..100 ms — для адаптеров RS-485 с автонаправлением, которым нужно время, чтобы освободить линию.

  • Настройки последовательного порта проверяются при записи (исключение 03). Запись только помещает значение в ОЗУ — чтобы оно вступило в силу, сохраните его (COMMAND 0x04), затем перезапустите модуль (COMMAND 0x02, с гейтом 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 COMMAND 0x8113 = 0x0006 — синхронизация часов по всей шине;

  • LATCH_BANK / PERIOD_ARM 0x8110–11 и COMMAND 0x03 — синхронизированный снимок по модулям (бит возможности 8);

  • подготовка адреса по UID 0x8118–0x811E + COMMAND 0x16 — ввод в эксплуатацию на общей шине.

Широковещательный 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 с ERROR 0xFD — в обоих случаях ничего не сохраняется.

  • Поля, которых сборка не поддерживает (отсутствующие каналы; величины 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.