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

Транспорт I²C

Модуль — ведомый I²C с полной картой регистров. Адрес по умолчанию 7-битный 0x50 (настраивается, см. ниже). Рекомендуемая скорость шины — 50 kHz для хостов ESP32 и ESP8266 и 100 kHz для других хостов (не 400 kHz); ведомый поддерживает растяжение тактов, и мастер должен это терпеть (см. ограничения ниже).

Активный транспорт (I²C или Modbus RTU) выбирается один раз при загрузке переключателем режима интерфейса — см. Аппаратный интерфейс. При настройке I²C пространство регистров Modbus не обслуживается и наоборот; команды и данные одинаковы для обоих.

Указатель регистра

  • 16-битный указатель регистра, big-endian в линии (сначала старший байт), с автоинкрементом.
  • Запись: мастер отправляет 2 байта указателя (старший, младший), затем поток данных; каждый байт данных попадает по указателю, который затем увеличивается.

  • Чтение: мастер записывает 2 байта указателя, затем выдаёт повторный старт и читает; байты выдаются от указателя с автоинкрементом.

  • Многобайтовые поля — little-endian и адресуются по байтам — требования выравнивания на шине нет; мастер может читать любое поле как N байт little-endian с его адреса, одной транзакцией или несколькими.

  • Незамапленные адреса: чтение возвращает 0xFF, запись игнорируется. Адреса блоков каналов с индексом ≥ N_CURRENT / N_VOLTAGE не определены — проверяйте по счётчикам, не интерпретируйте их.

Проверки на шине для 8- против 16-битной адресации нет (8-битное устройство неверно прочитало бы второй байт указателя как данные). Мастер знает соглашение по линейке изделий; сигнатура STD после 16-битного чтения 0x0000 — это 'S','T' + VERSION ≥ 0x30 + бит 9 CAPABILITIES.

Тайминги и устойчивость

  • Готовность после сброса: интерфейс регистров поднимается в течение миллисекунд после сброса, раньше тракта измерения — модуль отвечает на шине даже пока тракт датчика ещё запускается. После перезагрузки при активации прошивки подождите ~4 s, прежде чем устройство снова появится.

  • Растяжение тактового сигнала: обычно незначимо; во время операций записи прошивки во флеш ведомый может удерживать SCL до ≈9 ms. Установите таймаут SCL на мастере ≥10 ms, иначе повторы будут фиксироваться во время OTA (данные не портятся — транзакция просто ждёт).

  • Во время записи во флеш, запускаемой командами (сохранение конфигурации или калибровки, запись страниц OTA), ведомый может также кратковременно не подтверждать приём. Повторяйте, пока не истечёт время установления команды, а не прерывайтесь на первом NACK (времена установления см. в Командах).

  • Согласованность: каждая транзакция чтения обслуживается из согласованного 128-байтного снимка, снятого при установке адреса регистра — поля, прочитанные одной транзакцией до 128 байт, взяты из одной публикации и не могут разойтись (так читают i64-поля энергии и целые блоки). Поля, прочитанные разными транзакциями, могут происходить из разных окон. Чтобы обнаружить перезапуск модуля между чтениями, проверяйте монотонность FRAME_CNT (0x0020) и BOOT_COUNT (0x00CE).

Изменение I²C-адреса

Два пути:

Прямой (адрес известен):

  1. Запишите новый 7-битный адрес (0x08..0x77) в CFG_I2C_ADDR (0x0073).
  2. COMMAND = 0x04 (SAVE_CONFIG) — проверяется; недопустимый адрес отклоняется с ERROR 0xFD, и ничего не сохраняется. Сохранения ограничены по частоте: повтор в течение ~5 s получает ответ 0xF9 — повторите позже. Дождитесь BUSY = 0 и ERROR = 0 до следующего шага.

  3. COMMAND = 0x02 (RESET). Адрес применяется при перезагрузке; устройство заново перечисляется по новому адресу примерно через 1 s.

Безопасность

⚠ После сброса каждый мастер на шине должен переключиться на новый адрес; планируйте это как монтажную операцию, а не рутинную.

По UID (несколько модулей на одном адресе по умолчанию): запишите 12-байтовый UID целевого модуля в ADDR_UID (0x00E0), новый адрес I²C в ADDR_UID_I2C (0x00EC, 0 = оставить) и/или новый Modbus unit id в ADDR_UID_UNIT (0x00ED, 0 = оставить), затем COMMAND = 0x16 (ADDR_BY_UID). Только модуль, чей UID совпадает, сохраняет изменение — вместе с любыми другими подготовленными значениями CFG_, как при SAVE_CONFIG — и перезапускается; все остальные модули игнорируют команду (там ERROR 0xFC). Принимается также при широковещании Modbus — см. транспорт Modbus. Оба новых поля адреса нулевые → 0xFD; недопустимый адрес → 0xFD; ограничение сохранения → 0xF9. Пошагово: Последовательности D4.