04 · Проводка
Эта глава описывает физическое подключение rbAmp к ESP32: выбор GPIO, правила подтяжки, шину с несколькими модулями, питание, необязательную линию DRDY и провизионирование адреса.
Каноническое развёртывание — парк из нескольких модулей на одной шине. 80% полевых установок состоят из 1× UI1 (сеть) + N× I2/I3 (субсчётчики) на одной шине I²C ESP32, с подтяжками по таблице ниже. См. 01_overview.md для общей картины парка. Один модуль — минимальный случай, а не канон. Эта глава охватывает обе топологии, но многомодульная отмечена как «основная топология» в соответствующих разделах.
Модули STANDARD (STD). Подключение, правила подтяжки, питание и необязательная линия DRDY одинаковы для модулей BASIC и STANDARD, и один и тот же YAML работает для обоих — компонент определяет подключённый модуль при загрузке. new_address: работает на обеих линейках. Синхронизация парка общим вызовом (fleet_gc_enable: / group_id:) относится только к модулям BASIC; на модуле STANDARD эти ключи игнорируются с записью в лог.
ОПАСНО: клеммы L/N несут сетевое напряжение. Обесточьте и заблокируйте цепь перед подключением, пусть подключением сетевой проводки и любыми работами внутри щитка занимается квалифицированный специалист, зажимайте клещами ТОЛЬКО ОДИН проводник (L) и никогда не оставляйте токовые клещи на проводнике с отключённым разъёмом CT.
Провод и предохранитель. Толстый провод для подключения напряжения не требуется: достаточно AWG26–22, так как датчик напряжения потребляет очень малый ток. Предохранитель в линии L обязателен, номиналом до 0.1 А.
Сторона сети в двух словах. Сеть L и N подключаются к двум клеммам модуля (они дают показания напряжения); клипса CT вставляется в разъём CT и охватывает только проводник L, стрелка к нагрузке. Всё остальное в этой главе относится к низковольтной стороне.
Распиновка низковольтной стороны
Низковольтная сторона модуля выводит пять сигналов. Все они гальванически изолированы от сети — контакт GND — это GND ESP32, а не нейтраль сети.
| Вывод | Сигнал | Описание |
|---|---|---|
VCC |
+4.5..+5.5 V постоянного тока | Питание модуля. Номинально 5 В; ниже 4.5 В показания могут стать недостоверными. |
GND |
Общее | Общий с мастером. Обязательно. |
SDA |
Данные I²C | Логика 3.3 V; допускает 5 V. |
SCL |
Тактовая частота I²C | Логика 3.3 V; допускает 5 V. |
DRDY |
Готовность данных (необязательно) | Выход с открытым стоком. Импульс LOW ~10 мкс каждые ~100 мс после обновления мгновенных регистров. |
Выбор GPIO на ESP32
Работает любая пара GPIO, поддерживающая I²C. Периферийная матрица ESP32 позволяет вывести I²C почти на любой контакт. Практические ограничения:
- GPIO0 и GPIO2 — контакты загрузки. Низкий уровень на них при включении блокирует загрузку. Не используйте.
- GPIO 6..11 подключены к встроенной флеш-памяти или PSRAM на большинстве модулей ESP32-WROOM. Недоступны.
- GPIO 34..39 — только входы. Не подходят для I²C (которому нужен двунаправленный драйв).
- Не подключайте GPIO ESP32 к линии сброса модуля — модуль сбрасывается командой I²C, и на стороне мастера аппаратные контакты сброса не нужны.
Рекомендуемые назначения по умолчанию, которые работают на большинстве плат ESP32-DevKitC:
| Сигнал | GPIO | Примечание |
|---|---|---|
| SDA | GPIO21 | По умолчанию во всех примерах YAML |
| SCL | GPIO22 | По умолчанию во всех примерах YAML |
| DRDY | GPIO15 | Необязательно; подойдёт любой пин, поддерживающий вход |
Если GPIO21/22 заняты, выберите любую другую допустимую пару и обновите блок i2c: в YAML.
Подключение одного модуля
Полная проводка ESP32 показана на справочной схеме ниже.
Внешние подтягивающие резисторы для одного модуля не нужны — на плате rbAmp уже есть встроенные подтяжки 4.7 kΩ на SDA и SCL к 3.3 V.
Шина с несколькими модулями (основная топология)
Большинство развёртываний rbAmp — парк из нескольких модулей на одной шине I²C ESP32: один UI1 на вводе и несколько I2/I3 на ответвлениях. Это основная топология, для которой спроектирован компонент, и конфигурация подтяжек ниже оптимизирована именно под неё.
Когда два и более модулей (или других устройств I²C с собственными подтяжками) делят одну шину, их подтяжки складываются параллельно. Совокупное сопротивление падает ниже эффективного минимума — что приводит к:
- Чрезмерное потребление шины.
- Возможна перегрузка выходов ESP32 с открытым стоком (обычно ≤ 3 мА при 3.3 V).
- Повышенная ёмкостная нагрузка на длинной шине.
На нижней стороне каждой платы rbAmp есть паяные перемычки с подписью Pull-Up. Перерез дорожки острым лезвием отключает встроенную пару 4.7 kΩ этого модуля.
| Модули на шине | Конфигурация подтяжки (pull-up) | Эффективное R |
|---|---|---|
| 1 | Оставьте встроенную пару. Внешняя не нужна. | ~4.7 kΩ |
| 2 | Оставьте только на первом; второй отрежьте. | ~4.7 kΩ |
| 3 | Разрезать все. Одна внешняя пара 2.7..3.3 кОм на ESP32. | 2.7..3.3 kΩ |
| 4..6 | Разрезать все. Одна внешняя пара 2.2..2.7 кОм на ESP32. | 2.2..2.7 kΩ |
| 7..16 | Вырезать на всех. Одна внешняя пара 1.5..2.2 kΩ на ESP32 + проверка ёмкости шины (см. ниже). | 1.5..2.2 kΩ |
| ESP32 уже обеспечивает подтяжки | Вырежьте на всех модулях. Внутренние подтяжки ESP32 (≥50 kΩ) слабые — длинной шине всё равно нужны внешние 2.2..4.7 kΩ. | как выше |
Внешние значения — рекомендуемые (рассчитаны по спецификации I²C: ток стока ≤ 3 мА при 3.3 В, ёмкость шины ≤ 400 пФ). Подключайте внешние подтяжки к 3.3 В (логический уровень шины), а не к питанию VCC 5 В.
Логика выбора: эффективный R_pullup — параллельное сочетание всех активных подтяжек. Целевой диапазон 1.5..4.7 кОм (минимум ограничен током стока ESP32 ≤ 3 мА при 3.3 В; максимум — постоянной времени RC шины). Формула: 1/R_eff = N/R_unit. Для встроенной пары 4.7 кОм: 2 модуля = 2.35 кОм, 3 = 1.57 кОм, 4 = 1.18 кОм — при 3 модулях параллельное значение 1.57 кОм всё ещё в диапазоне, и шина из 3 модулей до 15 см измерена как надёжная (выводы 15 см, 50 кГц), поэтому таблица оставляет встроенные перемычки при 2 и 3 модулях. Начиная с 4 модулей или раньше на более длинной шине их разрезают и переходят на одну внешнюю пару.
Диагностическая проверка: измерьте сопротивление между SDA и VCC при выключенном питании. Результат должен быть в диапазоне 1.5..4.7 kΩ. Ниже 1.0 kΩ означает слишком много активных подтяжек, включённых параллельно; выше 10 kΩ — активной подтяжки нет (проверьте перемычки).
Ёмкость шины (для ≥7 модулей или общей длины проводки > 50 см): спецификация I²C ограничивает общую ёмкость C_b до ≤ 400 пФ. Короткая шина с 2–3 модулями обычно 50..100 пФ; шина 1 м с 10 модулями может достигать 300..400 пФ. Вблизи предела перейдите на frequency: 50kHz (если работали на 100 кГц) или используйте микросхему с активной подтяжкой (например, PCA9517).
Скорость шины
Задайте frequency: 50kHz в блоке i2c: ESPHome. На текущей прошивке это обязательно для надёжной работы с ESP-IDF v5:
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz # recommended on ESP32 — ESP-IDF i2c_master driver interaction, see below
Модуль периодически отвечает NACK на чтения от ESP32 при 100 kHz (заметная доля транзакций) из-за взаимодействия таймингов драйвера ESP-IDF v5 i2c_master и окна восстановления после STOP периферии I²C модуля. На 50 kHz NACK гораздо реже, а повтор внутри компонента по байтам восстанавливает > 99% корректных чтений.
Прошивка усилила окно восстановления I²C модуля (выпущено в v1.1 и v1.3), что уменьшило вклад модуля, но 50 kHz остаётся рекомендуемой настройкой на мастерах на базе ESP-IDF, поскольку взаимодействие таймингов драйвера сохраняется на 100 kHz. Считайте это постоянной рекомендацией для ESP32, а не временным обходным путём до исправления.
Другие мастера I²C работают с модулем на 100 кГц без проблем: STM32 HAL, RP2040 SDK, Raspberry Pi smbus2 (I²C ядра Linux) и не-ESP32 Arduino (AVR / STM32duino). Обратите внимание, что ось — это драйвер, а не плата: Arduino на ESP32 использует тот же драйвер ESP-IDF i2c_master, поэтому ему тоже нужны 50 кГц — 100 кГц работает только на не-ESP32 Arduino.
Справочная схема — один ESP32 + один rbAmp
Notes:
- Резистор 10 кОм на DRDY стоит на стороне мастера (рядом с GPIO), а не на стороне модуля. DRDY — с открытым стоком, без внутреннего подтягивания.
- Разъём CT должен быть вставлен полностью; клипса полностью охватывает один проводник, стрелка направлена к нагрузке.
- Полярность L/N на клеммах влияет на знак P (см. 03_sensor_selection.md).
Мощность
Питание модуля (VCC)
Модулю нужно +4.5..+5.5 В постоянного тока. Потребление тока:
| Режим | Типичная |
|---|---|
| Измерение в установившемся режиме | ~15 мА |
Запись во флеш (при ct_model: / провизионировании адреса) |
~25 mA пик, ~700 мс |
| Прогрев при загрузке (~250 мс) | ~15 мА |
Пин 5V на ESP32-DevKitC (обычно подключён к USB VBUS) может питать модуль напрямую — USB-хост должен обеспечить суммарный ток ESP32 (~200 мА) + rbAmp (~15 мА пик) = ~215 мА. Для установок, где ESP32 питается от внешнего источника 5 В, подключите VCC к той же шине 5 В.
Просадка ESP32 (brownout)
Детектор просадки ESP32 срабатывает при ~2.43 V на VDD. Когда он срабатывает, шина I²C простаивает, а модуль продолжает измерять автономно (у него собственное питание 5 V). Когда ESP32 восстанавливается, setup() восстанавливает накопленную энергию из NVS до первого update(). HA не видит ни разрыва, ни сброса на графике энергии.
Необязательный DRDY
Вывод DRDY модуля — с открытым стоком. Он импульсно переходит в LOW на ~10 мкс каждые ~100 мс сразу после обновления блока мгновенных регистров. На снимке периода он не срабатывает.
При update_interval: 60s DRDY можно не подключать — компонент проверяет регистр состояния в начале каждого update() и пропускает чтение, если модуль не готов. Компонент логирует пин DRDY; чтение управляется таймером (update_interval).
Монтаж DRDY
DRDY — с открытым стоком: он тянет в LOW, но не может выдать HIGH. Ему нужна внешняя подтяжка:
rbAmp DRDY ──────────────────┬── ESP32 GPIO (input)
|
[10K]
|
3.3V
10 kΩ на 3.3 V. Не подключайте DRDY к 5 V, хотя SDA/SCL и допускают 5 V — DRDY является отдельным сигналом, а абсолютный максимум на входном GPIO ESP32 — 3.6 V.
Объявите пин в YAML:
rbamp:
id: meter1
drdy_pin: GPIO15
DRDY нескольких модулей
Сигналы DRDY нескольких модулей можно объединить по схеме wire-OR на один GPIO ESP32 (выходы с открытым стоком естественно складываются). Общий сигнал уходит в LOW, когда любой модуль обновил свои мгновенные регистры. Компонент только логирует пин; он не сообщает, какой модуль сработал.
Если нужны раздельные сигналы, выведите DRDY каждого модуля на свой GPIO и объявите drdy_pin: в каждом блоке rbamp: отдельно.
Назначение адресов на шине из нескольких модулей
Все модули rbAmp поставляются с завода с адресом 0x50. Прежде чем подключать несколько модулей к одной шине, каждому нужен уникальный адрес. На прошивке v1.3 это можно сделать в производстве без режима заводского провизионирования — благодаря протоколу двухфазной фиксации.
Двухфазная фиксация адреса (v1.3+, production-OK)
С new_address: компонент выполняет следующую последовательность:
-
Проверяет, поддерживает ли прошивка двухфазную фиксацию. Если да, выбирается производственный путь. Если нет, используется устаревший однофазный путь с закрытием заводским провизионированием (прошивка v1.0–v1.2).
-
Записывает новый адрес в
REG_I2C_ADDRESS(промежуточно, ещё не активен). -
Записывает «магическое слово»
0xA5вREG_ADDR_COMMIT_MAGIC— явное подтверждение намерения, защищающее от случайной записи вREG_I2C_ADDRESS. -
Отправляет опкод
CMD_COMMIT_ADDR— модуль атомарно применяет подготовленный адрес, сохраняет его во флеш и выполняет мягкий сброс. -
Через ~700 мс компонент перепривязывает свой дескриптор i2c_address к новому адресу и проверяет повторное перечисление probe-чтением.
Если любой шаг не удался, модуль откатывается на предыдущий адрес без состояния «наполовину применено». Цикл 0x50 → 0x60 → 0x50 переобнаруживается менее чем за секунду.
Последовательное провизионирование (рекомендуемый порядок)
Несколько модулей вместе на шине до назначения адресов — это конфликт адресов (все на 0x50). Поэтому назначение идёт последовательно, по одному модулю:
- Подключите к ESP32 только модуль 1 (один на шине).
-
Прошейте конфигурацию из
example/address_change.yamlсaddress: 0x50иnew_address: 0x51. При загрузке компонент обнаруживает расхождение → выполняет двухфазную фиксацию (см. выше). -
Подтвердите успех в логах ESPHome (повторное перечисление на новом адресе). Обновите YAML:
address: 0x51, удалитеnew_address:. -
Отключите модуль 1. Подключите модуль 2 (по-прежнему на заводском
0x50). -
Повторите для
0x52,0x53и так далее. ОБЯЗАТЕЛЬНО: на шине одновременно только один новый модуль — иначе оба ответят на 0x50, что вызовет конфликт на шине. -
Когда у всех модулей уникальные адреса, подключите все к шине и задайте подтяжки по таблице в Шина из нескольких модулей (2 модуля: оставьте одну пару; 3 и более: разрежьте все и добавьте одну внешнюю пару).
Опасность параллельного провизионирования: если два девственных модуля оба на 0x50, оба подтверждают байт адреса и тянут SDA друг против друга в фазе данных → конфликт на шине + неопределённые данные. Всегда по одному девственному модулю.
Пример YAML для нескольких модулей
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz
scan: true
rbamp:
- id: meter_house
address: 0x50
update_interval: 60s
- id: meter_solar
address: 0x51
update_interval: 60s
bidirectional: true
- id: meter_evcharger
address: 0x52
update_interval: 60s
sensor:
- platform: rbamp
rbamp_id: meter_house
voltage: { name: "House Voltage" }
current: { name: "House Current" }
power: { name: "House Power" }
energy: { name: "House Energy" }
- platform: rbamp
rbamp_id: meter_solar
voltage: { name: "Solar Voltage", internal: true }
current: { name: "Solar Current" }
power: { name: "Solar Power" }
energy: { name: "Solar Energy" }
energy_exported: { name: "Solar Energy Exported" }
- platform: rbamp
rbamp_id: meter_evcharger
voltage: { name: "EV Charger Voltage", internal: true }
current: { name: "EV Charger Current" }
power: { name: "EV Charger Power" }
energy: { name: "EV Charger Energy" }
Полная версия с примечаниями — в example/multi_module.yaml.
Длина шины
I²C — протокол короткой дистанции (по умолчанию ~15 см). Многие подключают модули проводами низкого качества, которые собирают много помех и теряют много передач, поэтому предел короткий. Рекомендуемые длины для rbAmp:
| Тип кабеля | Максимальная длина | Скорость |
|---|---|---|
| Стандартный JST / 4-проводной плоский | 0.15 m | 50 kHz |
| Витая пара (SDA+GND и SCL+GND — в отдельных парах) | 1 m | 50 kHz |
| Витая пара + буфер I²C (PCA9515 / TCA9617) | 3 m | 50 kHz |
| Дифференциальная шина (PCA9615 / LTC4332) | 100 m | 50 kHz |
При длине более 0.15 м используйте витую пару, и SDA и SCL должны лежать в разных парах (например, синий + бело-синий для SDA, зелёный + бело-зелёный для SCL). Если SDA и SCL в одной паре, перекрёстные наводки искажают фронты даже на 50 кГц.
⚠ Внутри электрошкафа экранируйте кабель I2C. Сильные магнитные поля рядом с силовыми проводниками, контакторами и трансформаторами наводят помехи в неэкранированном кабеле. Держите кабель как можно короче и вдали от силовой проводки.
Режим заводского провизионирования (устаревшая прошивка v1.0–v1.2)
На прошивке v1.3 смена адреса не требует режима заводского провизионирования — она выполняется в производстве через двухфазную фиксацию (см. выше). Этот раздел относится только к устаревшей прошивке (v1.0–v1.2), где однофазная смена адреса требовала специального режима.
На устаревшей прошивке некоторые операции с модулем (смена I²C-адреса, сброс к заводским) требовали перевода модуля в режим заводской настройки — особый режим для разовых действий настройки. Серийные модули поставлялись с отключённым режимом provisioning: попытка сменить адрес на них возвращала ошибку, видимую в журнале ESPHome как WARNING при загрузке.
Поведение совместимости компонента v1.3:
-
С
new_address:компонент сначала проверяет, поддерживает ли прошивка двухфазную фиксацию. Да → производственный путь (двухфазный, без ограничения заводской настройкой). -
Если нет (устаревшая прошивка v1.0–v1.2) → откат к однофазной записи, которая действует только в режиме заводской настройки. Компонент записывает это в журнал загрузки как
WARN_FACTORY_MODE_REQUIRED.
Если у вас модуль на устаревшей прошивке (DUT обновляется на заводском стенде, а не полевой OTA), обратитесь к поставщику за процедурой временного включения режима provisioning. На прошивке v1.3 этой проблемы нет.
Конфигурация токовых датчиков (ct_model: / ct_models:) никогда не требовала режима заводской настройки — модуль на любой прошивке принимает запись модели ТТ напрямую (см. 03_sensor_selection.md).
Что дальше
- 05_quickstart.md — первый запуск
- 06_examples.md — полные сценарии: UI1 / UI3 / несколько модулей / провизионирование адресов
- 10_troubleshooting.md — диагностика по симптомам
Исходники и задачи: rb-amp/rbamp-esphome · эта страница в репозитории: docs/04_hardware.md (v1.9.1)