04 · Проводка
В этой главе описано физическое подключение модуля rbAmp к платам семейства ESP32: распиновка стороны низкого напряжения, требования к питанию, совместимость уровней напряжения I²C, длина шины и стандартные выводы по умолчанию для 7 поддерживаемых чипов ESP32 (esp32, esp32s2, esp32s3, esp32c2, esp32c3, esp32c6, esp32h2).
Сам модуль целиком низковольтный; на вариантах UI* единственный опорный сигнал сети — отвод L–N за гальванически изолированным делителем. Низковольтная сторона (питание + I²C + необязательный DRDY) описана первой; подключение сети и CT — в разделе Подключение сети и CT ниже.
Распиновка низковольтной стороны
| Вывод | Сигнал | Цель |
|---|---|---|
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) — никогда весь кабель. Защитите отвод 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).
-
Отрежьте перемычки на остальных модулях.
Практическое правило
Внешние значения — рекомендуемые (рассчитаны по спецификации 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(автоинкремент). При записи автоинкремента нет: пакетная записьпопадает только в первый байт, остальные отбрасываются. Многобайтовые регистры записываются побайтно — отдельная однобайтовая транзакция на каждый адрес. Подробности — в 09 · Справочник API, раздел «Многобайтовые записи».+ N байт
Длина шины
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 через дескриптор парка. Все правила и оптимизации ниже рассчитаны именно на эту топологию; один модуль — частный случай (тот же дескриптор, но вызовы парка вырождаются в тривиальные).
Типичные развёртывания
| Сценарий | Конфигурация | Число модулей |
|---|---|---|
| Канонические 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) должен быть на шине в момент вызова rbamp_provision(). Если два модуля по одному адресу отвечают на I²C одновременно — коллизия в фазе данных, поведение не определено, и различить их невозможно (open-drain с монтажным AND). Путь восстановления: выключить питание, физически перейти к запуску одного модуля, провизионировать их по одному, затем подключить остальные. См. 10 · Устранение неполадок, раздел «Провизионинг: сбой / конфликт адресов».
Если у вас нет дескриптора флота и вы переадресуете вручную через rbamp_prepare_address_change() + rbamp_commit_address_change() (низкоуровневая форма), дисциплина та же: один чистый модуль за раз.
Двухфазная фиксация при смене адреса
Прошивка поддерживает смену адреса в производственном режиме через двухфазную последовательность:
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для асинхронной работы — не опрашивайте модули, которые ещё не готовы.
Синхронизация периодов — для жёсткой синхронизации
Для тарифного учёта все модули должны снимать снимок за один и тот же интервал времени. Две стратегии:
Стратегия 1 — последовательный снимок + общая выдержка (работает на любой прошивке):
/* 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:
addr=0x00 | A5 27 (5 bytes)
Перекос = 0 (атомарно). Предварительная конфигурация:
- На каждом модуле включите
REG_FLEET_CONFIG.bit0 = 1черезCMD_SAVE_USER_CONFIG. CMD_RESET— приём GC активируется при загрузке.- После сброса мастер отправляет 5-байтовый кадр.
- Контроль: для каждого ожидаемого модуля читайте
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:
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)
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:
.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-выводы):
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, а не ведомого). Компонент закрывает это двумя уровнями:
-
Скорость шины по умолчанию 50 кГц через Kconfig
CONFIG_RBAMP_DEFAULT_I2C_FREQ_HZ=50000. Компонент запрашивает эту частоту при добавлении своего дескриптора устройства на созданную вами шину. -
Повтор на уровне байта —
CONFIG_RBAMP_NACK_RETRY_ATTEMPTS=3× пауза 5 мс. При 50 кГц остаточная частота ошибок составляет < 0.8%.
При необходимости переопределите через idf.py menuconfig:
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.
#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.
Ссылки
- 05 · Быстрый старт — ваш первый рабочий проект
-
06 · Примеры — рабочие сценарии (включая шину с несколькими модулями)
-
09 · Справочник API — раздел «Символы Kconfig» с подробной конфигурацией параметров I²C
-
10 · Устранение неполадок — отладка на уровне шины, шаблон NACK, дисциплина повторов и проверки здравого смысла
Исходный код и вопросы: rb-amp/rbamp-esp-idf · эта страница в репозитории: docs/04_hardware.md (v1.7.3)