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

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, стрелка к нагрузке. Всё остальное в этой главе относится к низковольтной стороне.

Монтаж на щитке: клипса CT на проводнике L после входного автомата, отвод опорного напряжения L и N к модулю.

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

Низковольтная сторона модуля выводит пять сигналов. Все они гальванически изолированы от сети — контакт 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 мс после обновления мгновенных регистров.

Пять низковольтных контактов модуля rbAmp и требования каждого из них.

Выбор 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 на ответвлениях. Это основная топология, для которой спроектирован компонент, и конфигурация подтяжек ниже оптимизирована именно под неё.

Несколько модулей rbAmp на одной шине I²C со встроенными подтяжками, разрезанными, и одна внешняя пара у мастера, плюс варианты DRDY.

Когда два и более модулей (или других устройств 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 В.

Правила подтягивания I²C для одного–трёх модулей на короткой шине и для четырёх и более, с паяной перемычкой на модуле и скоростью шины для каждого хоста.

Логика выбора: эффективный 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:

YAML
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

Справочная проводка между платой ESP32 и модулем rbAmp, с клипсой CT на проводнике L и необязательной линией DRDY.

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 мс сразу после обновления блока мгновенных регистров. На снимке периода он не срабатывает.

Непрерывные окна измерения по 100 мс, один импульс DRDY на окно и пакетное чтение мастером атомарного блока результатов.

При update_interval: 60s DRDY можно не подключать — компонент проверяет регистр состояния в начале каждого update() и пропускает чтение, если модуль не готов. Компонент логирует пин DRDY; чтение управляется таймером (update_interval).

Монтаж DRDY

DRDY — с открытым стоком: он тянет в LOW, но не может выдать HIGH. Ему нужна внешняя подтяжка:

Text
  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:

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: компонент выполняет следующую последовательность:

  1. Проверяет, поддерживает ли прошивка двухфазную фиксацию. Если да, выбирается производственный путь. Если нет, используется устаревший однофазный путь с закрытием заводским провизионированием (прошивка v1.0–v1.2).

  2. Записывает новый адрес в REG_I2C_ADDRESS (промежуточно, ещё не активен).

  3. Записывает «магическое слово» 0xA5 в REG_ADDR_COMMIT_MAGIC — явное подтверждение намерения, защищающее от случайной записи в REG_I2C_ADDRESS.

  4. Отправляет опкод CMD_COMMIT_ADDR — модуль атомарно применяет подготовленный адрес, сохраняет его во флеш и выполняет мягкий сброс.

  5. Через ~700 мс компонент перепривязывает свой дескриптор i2c_address к новому адресу и проверяет повторное перечисление probe-чтением.

Двухфазная смена адреса: подготовка, взведение, фиксация, ожидание, сброс, ожидание и проверка по новому адресу.

Если любой шаг не удался, модуль откатывается на предыдущий адрес без состояния «наполовину применено». Цикл 0x50 → 0x60 → 0x50 переобнаруживается менее чем за секунду.

Провизионирование адресует по одному девственному модулю на шине, затем повторяется для следующего.

Несколько модулей вместе на шине до назначения адресов — это конфликт адресов (все на 0x50). Поэтому назначение идёт последовательно, по одному модулю:

  1. Подключите к ESP32 только модуль 1 (один на шине).
  2. Прошейте конфигурацию из example/address_change.yaml с address: 0x50 и new_address: 0x51. При загрузке компонент обнаруживает расхождение → выполняет двухфазную фиксацию (см. выше).

  3. Подтвердите успех в логах ESPHome (повторное перечисление на новом адресе). Обновите YAML: address: 0x51, удалите new_address:.

  4. Отключите модуль 1. Подключите модуль 2 (по-прежнему на заводском 0x50).

  5. Повторите для 0x52, 0x53 и так далее. ОБЯЗАТЕЛЬНО: на шине одновременно только один новый модуль — иначе оба ответят на 0x50, что вызовет конфликт на шине.

  6. Когда у всех модулей уникальные адреса, подключите все к шине и задайте подтяжки по таблице в Шина из нескольких модулей (2 модуля: оставьте одну пару; 3 и более: разрежьте все и добавьте одну внешнюю пару).

Примечание

Опасность параллельного провизионирования: если два девственных модуля оба на 0x50, оба подтверждают байт адреса и тянут SDA друг против друга в фазе данных → конфликт на шине + неопределённые данные. Всегда по одному девственному модулю.

Пример YAML для нескольких модулей

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)