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

04 · Проводка

В этой главе описано физическое подключение модуля rbAmp к платам семейства ESP32: распиновка стороны низкого напряжения, требования к питанию, совместимость уровней напряжения I²C, длина шины и стандартные выводы по умолчанию для 7 поддерживаемых чипов ESP32 (esp32, esp32s2, esp32s3, esp32c2, esp32c3, esp32c6, esp32h2).

Сам модуль целиком низковольтный; на вариантах UI* единственный опорный сигнал сети — отвод L–N за гальванически изолированным делителем. Низковольтная сторона (питание + I²C + необязательный DRDY) описана первой; подключение сети и CT — в разделе Подключение сети и CT ниже.

Распиновка низковольтной стороны

Низковольтные выводы модуля: VCC, GND, SDA, SCL и необязательная линия готовности данных.
Модуль работает с логикой I²C на 3.3 В иТерпимость к 5 Вна сигнальных линиях. Все выводы низкого напряжения полностью гальванически изолированы от сети.

Вывод Сигнал Цель
VCC +5 V (4.5..5.5 V) Питание модуля; минимум 4.5 В для корректной работы
GND Земля Общий с мастером — обязательно
SDA SDA I²C Данные I²C
SCL I²C SCL (линия тактирования) Тактовая частота I²C
DRDY Data-ready (опционально) Открытый сток, низкий импульс ~10 мкс каждые ~100 мс

Мощность

Параметры VCC

  • Номинальное напряжение: 5 В DC
  • Допустимый диапазон: 4.5..5.5 В
  • Потребление тока: ~15 мА типично, ~25 мА в пике при записи во флеш
  • Пульсации: < 50 мВ от пика до пика (для точности измерения)

На модуле есть встроенный стабилизатор, RC-фильтр, керамические конденсаторы и ферритовая бусина — дополнительной фильтрации от пользователя не требуется. Модуль можно питать от шины +5V или +5V0 любой платы DevKitC (питание от USB-5V).

Совместимость уровней напряжения I²C

  • SDA / SCL работают на логике 3.3 В (встроенные подтяжки тянут линии к 3.3 В).

  • Линии устойчивы к 5 В, но семейство ESP32 и так работает на 3.3 В — преобразователи уровня не нужны.

  • Драйвер i2c_master из ESP-IDF использует выходы с открытым стоком на GPIO — совместимо со встроенными подтяжками модуля.

Поведение при включении питания

  • Холодный старт: ~250 мс до первого корректного результата.
  • После сброса (программного или по провалу питания): около 250 мс на восстановление.
  • До первого валидного результата регистры читаются как 0, при флаге DATA_VALID = 0.

Компонент сам ждёт готовности модуля внутри rbamp_begin(dev) — пользовательский код просто вызывает rbamp_begin() и продолжает работу.

Изоляция

Сам модуль полностью низковольтный — высоковольтной измерительной цепи на нём нет. Ток измеряется клещами CT, которые связываются магнитно снаружи изолированного проводника, без электрического контакта с сетевым проводом. На вариантах с измерением напряжения (UI) единственный опорный сигнал сети — клемма L–N, которая питает гальванически изолированный* измерительный делитель; варианты только с амперметром вообще не имеют подключения к сети.

Consequences:

  • GND модуля не подключён к сетевой фазе или нулю.
  • Выводы низкого напряжения подключаются к ESP32 без привязки к сети: клипса связывается магнитно, а отвод напряжения UI находится за гальванически изолированным делителем. Это не отменяет меры предосторожности при подключении к сети из следующего раздела.
Безопасность

⚠ Не вскрывайте корпус модуля — это аннулирует заводскую калибровку.

Подключение сети и CT

Проводка на стороне сети: отвод L и N для напряжения и клещи на фазном проводнике.

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

⚠ Напряжение сети опасно для жизни. Отключите и заблокируйте цепь перед подключением клемм L/N или установкой клипсы; подключение к сети и любые работы внутри щитка поручайте квалифицированному специалисту. Клипсой охватывайте ТОЛЬКО один проводник (L) — никогда весь кабель. Защитите отвод L предохранителем по местным правилам (обязательно, до 0.1 А; достаточно провода AWG26–22 — датчик напряжения потребляет очень мало тока).

  • Напряжение (только варианты UI): модуль измеряет напряжение по соединению L/N на своей стороне сети: плата выводит клеммы L (фаза) и N (нейтраль), и полярность важна для знака мощности. Варианты I (I1/I2/I3) не имеют входа напряжения.

  • Ток: клещи SCT-013 вставляются в 3.5-мм разъём CT модуля (с ключом для правильной полярности; каждый разъём на плате подписан каналом, I0, I1, …) и охватывают линейный проводник (L). Стрелка на корпусе клещей указывает направление тока к нагрузке. Перевёрнутые клещи дают отрицательную P на потребляющей нагрузке.

  • Охватывайте фазный проводник, а не нейтраль и не оба проводника сразу.

  • Не вскрывайте корпус модуля — это аннулирует заводскую калибровку. Перемычки подтяжки, упомянутые ниже, находятся на нижней стороне платы; для доступа к ним следуйте инструкциям модуля.

Встроенные подтягивающие резисторы — на плате

Важно: каждый модуль rbAmp имеет встроенные подтягивающие резисторы 4.7 кОм на SDA и SCL к 3.3 В. Для одного модуля на шине внешние подтяжки не нужны — подключайте ESP32 напрямую.

Конфигурация i2c_master_bus_config_t в ESP-IDF также позволяет включить внутренние подтяжки GPIO через flags.enable_internal_pullup = true. Они слабые (~50 кОм на ESP32) и работают параллельно с внешними 4.7 кОм модуля — итоговые ~4.4 кОм, что приемлемо. Для промышленных развёртываний предпочтительно полагаться на внешние 4.7 кОм модуля; внутренние подтяжки GPIO необязательны при собственных подтяжках модуля и нужны в основном для стендовых тестов без модуля под рукой (например, когда вы просто проверяете сканирование шины).

Когда отключать встроенные подтяжки

Если на шине несколько модулей rbAmp (или другие устройства I²C со своими подтяжками), их параллельное подключение даёт слишком низкое эквивалентное сопротивление, что:

  • Увеличивает потребление тока шиной
  • Может превышать максимальный ток стока выходного каскада мастера I²C
  • Добавляет ёмкостную нагрузку на длинной шине и мало помогает помехоустойчивости

Решение: на нижней стороне платы каждого модуля, рядом с подтягивающими резисторами, есть перемычки (шелкография Pull-Up). Перережьте их острым лезвием:

  • Оставьте подтяжки включёнными только на одном модуле (или переместите их в одну точку рядом с ESP32).

  • Отрежьте перемычки на остальных модулях.

Практическое правило

Правила подтяжек для одного–трёх модулей на короткой шине и для четырёх и более.
| Модули rbAmp на шине | Подтяжки | |:---:|---| | 1 | Оставить как есть (встроенные 4.7 кОм работают) | | 2 | Оставить на одном, отключить на другом | | 3 | Отключить на всех модулях, установить одну внешнюю пару 2.7…3.3 кОм рядом с ESP32 | | 4…6 | Отключить на всех модулях, одна внешняя пара 2.2…2.7 кОм рядом с ESP32 | | 7…16 | Отключить на всех модулях, одна внешняя пара 1.5…2.2 кОм рядом с ESP32; проверьте ёмкость шины (≤ 400 пФ), при необходимости снизьте скорость шины |

Внешние значения — рекомендуемые (рассчитаны по спецификации I²C: ток стока ≤ 3 мА при 3.3 В, ёмкость шины ≤ 400 пФ). Подключайте внешние подтяжки к 3.3 В (логический уровень шины), а не к питанию VCC 5 В.

Если сомневаетесь

: измерьте сопротивление между SDA и линией 3V3 при полностью обесточенных устройствах. Оно должно быть в диапазоне 1.5..4.7 кОм. Меньше — слишком много активных подтяжек параллельно.

Параметры шины I²C

  • Адрес по умолчанию: 0x50 (7-битный)
  • Диапазон адресов: 0x08..0x77 (переназначаемый на заводе)
  • Рекомендуемая скорость на ESP32: 50 кГц (см. раздел о дисциплине повторов и проверки здравого смысла ниже)

  • Автоинкремент указателя: только при чтении. Пакетное чтение + N байт возвращает N последовательных байтов, начиная с addr (автоинкремент). При записи автоинкремента нет: пакетная запись + N байт попадает только в первый байт, остальные отбрасываются. Многобайтовые регистры записываются побайтно — отдельная однобайтовая транзакция на каждый адрес. Подробности — в 09 · Справочник API, раздел «Многобайтовые записи».

Длина шины

I²C — короткая шина (около 15 см по умолчанию). Многие подключают модули проводами низкого качества, которые собирают много помех и теряют много передач, отсюда короткое ограничение. Рекомендуемые топологии для rbAmp:

Кабель Макс. длина Скорость
Стандартный JST / плоский 4-жильный до 0.15 м 100 кГц
Витая пара UTP (cat-5/5e/6) — SDA+GND и SCL+GND в разных парах до 1 м 100 кГц
Витая пара + буфер I²C (PCA9515 / TCA9617) до 3 м 100 кГц
Дифференциальная шина (PCA9615 / LTC4332) до 100 м 100 кГц
Безопасность

Длины выше проверены на 100 кГц. Скорость шины компонента по умолчанию — 50 кГц (см. «базовый шаблон NACK ESP32» ниже), она более терпима к длинным кабелям; оставайтесь на 50 кГц и не превышайте эти длины.

Для длин более 0.15 м обязательна витая пара: SDA и SCL должны быть в разных парах, каждая со своей землёй. SDA и SCL в одной паре создают перекрёстную ёмкостную связь, которая искажает фронты.

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

Многомодульная шина — основная топология

Канонический случай использования библиотеки — несколько модулей rbAmp на одной шине I²C, которыми управляет один ESP32 через дескриптор парка. Все правила и оптимизации ниже рассчитаны именно на эту топологию; один модуль — частный случай (тот же дескриптор, но вызовы парка вырождаются в тривиальные).

Несколько модулей rbAmp на одной шине I2C с подтяжками, организованными по правилам.

Типичные развёртывания

Сценарий Конфигурация Число модулей
Канонические 80%: главный ввод дома + субсчётчики 1× UI1 (основной, энергия сети) + 3–6× UI1 (нагрузки; мощность и Wh требуют варианта UI) 4-7
Субпанель с разбивкой по току 1× UI1 (основной) + 1–2× I2/I3 (ток по цепям) 3-5
Промышленный субучёт 1× UI1 (основной) + N× I2/I3 (на каждую машину, разбивка по токам) до ~16

Электрические ограничения

  • Количество модулей: до ~16 (суммарная ёмкость шины ≤ 400 пФ при 100 кГц).
  • Адреса: у каждого модуля свой 7-битный адрес (диапазон 0x08..0x77). Все модули поставляются с завода на 0x50 — переадресуйте их по одному, прежде чем подключать параллельно (см. ниже о двухфазной фиксации и подготовке через rbamp_provision()).
  • Подтяжки (важно для шины флота): внутренние подтяжки ESP32 (~45 кОм) слишком слабы для шины из нескольких модулей с длинными дорожками и помехами. Для надёжной работы нужны внешние подтяжки (2.7…3.3 кОм для 3 модулей, меньше для больших шин — см. таблицу выше) к 3.3 В на SCL/SDA в одной точке шины + начиная с 4 модулей (или раньше на шине длиннее 15 см) встроенные подтяжки отключаются на всех модулях, кроме одного — при 2–3 модулях на шине до 15 см их не трогайте, этот случай измерен (или отключите на всех и оставьте только внешние). Это часть трёхуровневой защиты от зависания на слабой шине — см. 10 · Устранение неполадок.

Адресация — провизионинг и замена модуля на месте

Заводской адрес по умолчанию — 0x50. Каждый новый или заменяющий модуль проходит провизионинг (один раз): переадресация с 0x50 на рабочий адрес + необязательное сохранение конфигурации (модель CT, group_id, метка) во flash.

В коде это один вызов — rbamp_provision(bus, desired_addr, save_config, &dev). Он проверяет, что на шине действительно только один новый модуль на 0x50, переадресует его через двухфазную фиксацию (см. ниже), по желанию сохраняет пользовательскую конфигурацию и возвращает готовый дескриптор.

Процесс ввода в эксплуатацию: подключите один новый модуль на адрес 0x50, задайте ему адрес, затем следующий.

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

⚠ Дисциплина провизионинга (ОБЯЗАТЕЛЬНО): ровно один чистый модуль (на 0x50) должен быть на шине в момент вызова rbamp_provision(). Если два модуля по одному адресу отвечают на I²C одновременно — коллизия в фазе данных, поведение не определено, и различить их невозможно (open-drain с монтажным AND). Путь восстановления: выключить питание, физически перейти к запуску одного модуля, провизионировать их по одному, затем подключить остальные. См. 10 · Устранение неполадок, раздел «Провизионинг: сбой / конфликт адресов».

Если у вас нет дескриптора флота и вы переадресуете вручную через rbamp_prepare_address_change() + rbamp_commit_address_change() (низкоуровневая форма), дисциплина та же: один чистый модуль за раз.

Двухфазная фиксация при смене адреса

Прошивка поддерживает смену адреса в производственном режиме через двухфазную последовательность:

Шаги двухфазной смены адреса — от подготовки нового адреса до проверки.

Text
1. write candidate_addr → REG_I2C_ADDRESS (0x30, in RAM)
2. write 0xA5 → REG_ADDR_COMMIT_MAGIC (0x31, armed)
3. issue CMD_COMMIT_ADDR (opcode 0x30 in REG_COMMAND)
4. issue CMD_RESET (0x01)
5. wait ~300 ms; the new address is active

Компонент оборачивает это в rbamp_prepare_address_change() / rbamp_commit_address_change() — см. 09 · Справочник API. Сохранность подтверждается только после сброса (см. врезку «Производственный и заводской режим» в 03_sensor_selection.md).

Бюджет энергии шины — сколько модулей может обслужить ваша частота опроса

На шине 50 кГц одна транзакция чтения регистра ≈ 200–400 мкс (зависит от драйвера MCU). Полный RT-блок одного канала (U + I + P + PF) = 4 float = 16 байт + 4 фазы адреса ≈ 5–8 мс на канал.

Конфигурация Шина за цикл При 50 кГц Макс. частота опроса
1× UI1, блок RT ~5 мс < 5 мс 100+ Гц (но модуль обновляется с 10 Гц)
1× I3, RT-блок + период ~25 мс ~25 мс до 10 Гц
5× UI1, блок RT ~25 мс ~25 мс до 10 Гц
16× I3, RT + период ~400 мс 400 мс > 100 мс не успевает за модулем (10 Гц); в лучшем случае ~2 Гц
Примечание

Приведённые выше числа — оценки; они зависят от МК хоста и драйвера.

Правило: при 50 кГц комфортные пределы — 8–10× I3 или 15–16× UI1 при опросе 5 Гц (каждое второе окно модуля), и примерно половина этого при полных 10 Гц. Сверх этого:

  • Снизьте частоту опроса (1 Гц = 10-кратный запас).
  • Перейдите на 100 кГц с повтором (ожидайте частых NACK и полагайтесь на повтор).
  • Используйте вывод DRDY для асинхронной работы — не опрашивайте модули, которые ещё не готовы.

Синхронизация периодов — для жёсткой синхронизации

Для тарифного учёта все модули должны снимать снимок за один и тот же интервал времени. Две стратегии:

Последовательная фиксация каждого модуля в сравнении с одним кадром General-Call, фиксирующим все модули разом.

Стратегия 1 — последовательный снимок + общая выдержка (работает на любой прошивке):

C
/* Phase 1: sequential snapshot */
for (int i = 0; i < n; i++) {
    rbamp_latch_period(devs[i]);
}

/* Phase 2: shared settle (≥ 50 ms for the snapshot + ~1 commit cycle for witness) */
vTaskDelay(pdMS_TO_TICKS(50));

/* Phase 3: read snapshots with skip_latch=true */
rbamp_period_snapshot_t snaps[n];
for (int i = 0; i < n; i++) {
    rbamp_read_period_snapshot(devs[i], &snaps[i], 0, /*skip_latch=*/true);
}

Расхождение между модулями: 16 модулей × ~1 мс/снимок = ~16 мс относительно 60-секундного периода → 0.027%. Пренебрежимо мало.

Стратегия 2 — широковещательный снимок General-Call (требует включения):

Все модули получают снимок одним кадром I²C на адрес 0x00:

Структура 5-байтового кадра снимка General-Call, отправляемого на адрес 0x00.

Text
addr=0x00 | A5 27      (5 bytes)

Перекос = 0 (атомарно). Предварительная конфигурация:

  1. На каждом модуле включите REG_FLEET_CONFIG.bit0 = 1 через CMD_SAVE_USER_CONFIG.
  2. CMD_RESET — приём GC активируется при загрузке.
  3. После сброса мастер отправляет 5-байтовый кадр.
  4. Контроль: для каждого ожидаемого модуля читайте REG_V03_PERIOD_VALID (0x07). !=1 → переход к стратегии 1.

Когда что использовать:

  • < 8 модулей: стратегия 1 (проще, включение не требуется).
  • ≥ 8 модулей или жёсткая синхронизация: стратегия 2.

Фильтрация по группе GC — шина с несколькими арендаторами

REG_GROUP_ID (0x28) позволяет иметь несколько доменов GC на одной шине:

  • group = 0x00 → all-call (все модули с включённым GC делают снимок).
  • group = N → снимок берут только модули с REG_GROUP_ID = N.

Пример: шина с 10 модулями, где нужно независимо снимать 5 для тарифа A и 5 для тарифа B:

Text
write REG_GROUP_ID = 1 on the 5 tariff-A modules
write REG_GROUP_ID = 2 on the 5 tariff-B modules

GC frame [A5 27 01 tl th] → only tariff A takes a snapshot
GC frame [A5 27 02 tl th] → only tariff B takes a snapshot
GC frame [A5 27 00 tl th] → all 10 take a snapshot (all-call)

Режимы отказа на шине с несколькими модулями

Симптом Причина Что делать
i2c bus scan показывает несколько модулей по одному адресу после добавления в установку Новый модуль на 0x50 конфликтует с уже адресованным Сначала отдельно перепрошейте адрес нового модуля, и только потом добавляйте его на шину
Один модуль начинает чаще давать NACK, чем остальные Неисправность кабеля / просадка VCC на этом модуле Проверьте VCC под нагрузкой и уровни логики
Wh одного модуля постоянно расходится Собственный таймер модуля отличается от часов мастера Интегрируйте энергию по мастер-часам (master_dt_ms)
После кадра GC один модуль не делает снимок FLEET_CONFIG.bit0 = 0 или несовпадение группы Проверьте REG_FLEET_CONFIG и REG_GROUP_ID

Заметки по проектированию шины

  • Растяжение тактов (clock stretching): текущая прошивка минимизирует растяжение (окно __disable_irq в LatchPeriod короткое, ~мкс). Сам снимок существенно не тянет SCL. Для Raspberry Pi BCM283x (известная аппаратная ошибка растяжения тактов) — стандартная осторожность: уже рекомендованы 50 кГц + повтор.
  • Длина шины при >4 модулях: даже на витой паре эффективная ёмкость растёт линейно с числом модулей. Рассмотрите буфер I²C (PCA9515) при ≥ 8 модулях и длине > 1 м.

Подробные многомодульные сценарии — в 06 · Примеры, сценарии «Субучёт на общей шине» и «Широковещательный снимок GC».

Распиновка семейства ESP32

7 чипов, перечисленных в начале этой главы, поддерживаются (согласно idf_component.yml). Ниже приведены рекомендуемые выводы по умолчанию для I²C; для производственных установок выбирайте GPIO с учётом разводки вашей платы.

ESP32 (оригинальный / DevKitC / WROOM)

Справочная схема подключения ESP32 к модулю rbAmp с клипсой в гнезде I0.

C
const i2c_master_bus_config_t bus_cfg = {
    .i2c_port  = I2C_NUM_0,
    .sda_io_num = GPIO_NUM_21,
    .scl_io_num = GPIO_NUM_22,
    .clk_source = I2C_CLK_SRC_DEFAULT,
    .glitch_ignore_cnt = 7,
    .flags.enable_internal_pullup = true,
};
Вывод GPIO
SDA GPIO21
SCL GPIO22
DRDY любой свободный GPIO, не являющийся стробирующим (на классическом ESP32 избегайте GPIO0/2/12/15)

ESP32-S2

Тот же GPIO21/22 по умолчанию, что у исходного ESP32. У S2 нет Bluetooth — дополнительно доступно ~30 кБ кучи для сценариев TLS.

ESP32-S3

У S3 нет аппаратно закреплённых I²C-выводов — любой GPIO через матрицу. На большинстве плат WROOM-S3 удобный выбор — GPIO8/GPIO9 (проверьте схему вашей платы: на N16R8 эти выводы могут быть заняты QSPI flash; USB-JTAG занимает GPIO19/20). Измените поля sda_io_num / scl_io_num в i2c_master_bus_config_t:

C
.sda_io_num = GPIO_NUM_8,
.scl_io_num = GPIO_NUM_9,

У S3 есть USB-OTG — его можно использовать для отладки без внешнего чипа USB-UART.

ESP32-C2 / C3 / C6 / H2

Одноядерные чипы RISC-V (C3 и C6 — одноядерные; H2 — одноядерный с BLE+802.15.4; C2 — одноядерный с ограниченной RAM). Выводы I²C не закреплены аппаратно — ниже пример для ESP32-C3 (на C3-SuperMini GPIO5/GPIO6 удобны; на C3-DevKitM-1 USB-JTAG занимает GPIO18/19, а GPIO8/9 — strapping-выводы):

C
const i2c_master_bus_config_t bus_cfg = {
    .i2c_port  = I2C_NUM_0,
    .sda_io_num = GPIO_NUM_5,
    .scl_io_num = GPIO_NUM_6,
    .clk_source = I2C_CLK_SRC_DEFAULT,
    .glitch_ignore_cnt = 7,
    .flags.enable_internal_pullup = true,
};

Для других чипов — смотрите документацию ESP-IDF для конкретного чипа (docs.espressif.com → ESP-IDF v5.2+ → ваш чип → API reference → peripherals → I2C).

ESP32-P4 — не поддерживаемая цель

ESP32-P4 нет в списке поддерживаемых целей: поддержка P4 требует ESP-IDF v5.3+, а минимум компонента — v5.2 (сборка v5.2 для esp32p4 завершилась бы ошибкой «target esp32p4 not in idf»).

Базовый шаблон NACK ESP32 — скорость шины 50 кГц

С драйвером i2c_master ESP-IDF v5 rbAmp показывает частые NACK на 100 кГц, гораздо реже на 50 кГц (особенность драйвера на стороне ESP32, а не ведомого). Компонент закрывает это двумя уровнями:

  1. Скорость шины по умолчанию 50 кГц через Kconfig CONFIG_RBAMP_DEFAULT_I2C_FREQ_HZ=50000. Компонент запрашивает эту частоту при добавлении своего дескриптора устройства на созданную вами шину.

  2. Повтор на уровне байта — CONFIG_RBAMP_NACK_RETRY_ATTEMPTS=3 × пауза 5 мс. При 50 кГц остаточная частота ошибок составляет < 0.8%.

При необходимости переопределите через idf.py menuconfig:

Text
CONFIG_RBAMP_DEFAULT_I2C_FREQ_HZ=50000
CONFIG_RBAMP_NACK_RETRY_ATTEMPTS=5     # for dense workloads
CONFIG_RBAMP_NACK_RETRY_GAP_MS=5
CONFIG_RBAMP_I2C_TIMEOUT_MS=200

Подробнее о диагностике проблем на уровне шины — см. 10 · Устранение неполадок.

DATA_READY (DRDY)

Необязательный вывод для оптимизации опроса. Если приложение опрашивает модуль не чаще одного раза в 100 мс — DRDY можно не подключать.

Электрические параметры

  • Тип выхода: открытый сток (без активной подтяжки к VCC)
  • Уровень покоя: HIGH (нужна подтяжка на стороне мастера — внутренний gpio_pullup_en() или внешний резистор; рекомендуется 10 кОм на 3.3 В)

  • Импульс готовности: LOW примерно на 10 мкс после обновления регистров RT свежими данными

  • Частота импульсов: ~10 Гц (один импульс на окно RT ~100 мс)

Семантика

Спад сигнала на DRDY гарантирует, что все RT-регистры синхронизированы и опубликованы (прошивка обновляет их атомарно в ISR до опускания линии). После спада мастер может читать RT-блок без риска получить разорванную выборку.

Шаблон прерывания — семафор FreeRTOS

ESP-IDF предлагает чистую модель: ISR в IRAM поднимает бинарный семафор, отдельная задача FreeRTOS ждёт семафор и читает RT.

C
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/semphr.h"
#include "driver/gpio.h"

#define DRDY_GPIO GPIO_NUM_4   /* a free GPIO; do not use
                                 * GPIO0/2/12/15 — strapping pins
                                 * (ESP32 classic), they can disrupt boot
                                 * if the open-drain DRDY goes LOW
                                 * during reset */
static SemaphoreHandle_t drdy_sem;

static void IRAM_ATTR drdy_isr_handler(void *arg) {
    BaseType_t hi_task_woken = pdFALSE;
    xSemaphoreGiveFromISR(drdy_sem, &hi_task_woken);
    if (hi_task_woken) portYIELD_FROM_ISR();
}

void bidir_task(void *arg) {
    rbamp_handle_t dev = arg;
    while (1) {
        if (xSemaphoreTake(drdy_sem, portMAX_DELAY) == pdTRUE) {
            float p;
            if (rbamp_read_power(dev, 0, &p) == ESP_OK) {
                /* integrate + publish */
            }
        }
    }
}

void app_main(void) {
    /* ...rbamp_new + rbamp_begin... */

    drdy_sem = xSemaphoreCreateBinary();

    /* The ISR service is installed ONCE for the whole project — if another
     * component (LCD, encoder, anything) has already installed it,
     * gpio_install_isr_service() returns ESP_ERR_INVALID_STATE.
     * This is normal, do not fail on it. ESP_INTR_FLAG_IRAM keeps the
     * ISR dispatcher in IRAM — important for the single-core C3/C6/H2/S2,
     * where non-IRAM code is unavailable while the flash cache is disabled. */
    esp_err_t err = gpio_install_isr_service(ESP_INTR_FLAG_IRAM);
    if (err != ESP_OK && err != ESP_ERR_INVALID_STATE) {
        ESP_ERROR_CHECK(err);
    }

    gpio_config_t io_cfg = {
        .pin_bit_mask = 1ULL << DRDY_GPIO,
        .mode         = GPIO_MODE_INPUT,
        .pull_up_en   = GPIO_PULLUP_ENABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type    = GPIO_INTR_NEGEDGE,
    };
    gpio_config(&io_cfg);
    gpio_isr_handler_add(DRDY_GPIO, drdy_isr_handler, NULL);

    /* Priority 6 — above idle (0), below WiFi (23) and the standard
     * MQTT (5+). 4096 bytes of stack are enough for rbamp_read_* +
     * ESP_LOG; if you add an MQTT publish right in this task —
     * raise it to 6144. On dual-core ESP32/S3, for a clean
     * separation from the WiFi task (usually core 0), you can pin
     * this task to core 1: xTaskCreatePinnedToCore(..., 1).
     * On the single-core C3/C6/H2/S2 — keep xTaskCreate. */
    xTaskCreate(bidir_task, "bidir", 4096, dev, 6, NULL);
}

DRDY — необязательный: опрос с любой частотой ≤ 10 Гц работает и без него. Компонент ни в одном из своих путей не зависит от DRDY.


Исходный код и вопросы: rb-amp/rbamp-esp-idf · эта страница в репозитории: docs/04_hardware.md (v1.7.3)