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