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

03 · Выбор токового датчика

Установка токовых клещей: охватите только провод L, стрелка к нагрузке

rbAmp измеряет ток через внешние токовые клещи (трансформатор тока) и напряжение через встроенный трансформатор напряжения (в артикулах UI*). Эта глава — о том, как выбрать клещи под вашу нагрузку и как сообщить модулю через YAML, какая модель установлена.

Семейство датчиков (sensor_class:)

Аппаратная ревизия модуля определяет, какое семейство токовых датчиков поддерживается. На текущих артикулах доступно только одно:

Класс Значение в YAML Состояние
SCT-013 (разъёмная клипса CT) SCT_013 Доступно сейчас, по умолчанию
WIRED_CT (модуль со своей установленной проводной клипсой) WIRED_CT Поставляется в паре: откалиброван вместе со своим датчиком
BUILTIN_CT (модуль со встроенным датчиком) BUILTIN_CT Поставляется в паре: откалиброван вместе со своим датчиком

Класс задаётся один раз и сохраняется во флеш модуля:

YAML
rbamp:
  id: meter1
  sensor_class: SCT_013   # defaults to SCT_013, can be omitted

На прошивке v1.2+ это значение становится предусловием для записи модели CT: модуль откажет, если класс не задан. Компонент никогда не записывает класс, который модуль уже имеет.

Защиты записи: чтение-сравнение-запись (v1.3+) и заводская защита (v1.8.1+)

При загрузке компонент читает текущий класс датчика модуля и сравнивает его с запрошенным в YAML значением. Если они совпадают, запись во флеш не происходит (запись класса на модуле также сбрасывает модели каналов, поэтому неизменённое значение никогда не перезаписывается). Это означает:

  • Блок YAML может навсегда сохранить sensor_class: SCT_013 — повторная загрузка не вызывает стирание флеша (~0 мс вместо ~700 мс).

  • Старый совет «удалить sensor_class: из YAML после первой загрузки» устарел — конфигурация идемпотентна.

То же поведение относится к ct_model: / ct_models: (см. ниже).

Примечание

Модули, поставляемые в паре (WIRED_CT / BUILTIN_CT). Модуль, поставляемый вместе со своим установленным датчиком, калибруется как пара с этим датчиком. Компонент защищает эту калибровку: изменение sensor_class: или ct_model: из YAML на таком модуле отклоняется с явной записью в лог (запись заменила бы индивидуальную калибровку общей настройкой). Для таких модулей оставьте оба ключа вне YAML. Для клипс SCT-013 (SCT_013, по умолчанию) ключи работают так, как описано ниже.

Выбор модели SCT-013

Модуль принимает любую из семи моделей серии SCT-013. Их электрический выход различается, поэтому модулю нужно знать, какая установлена — заводские коэффициенты загружаются для конкретной модели.

Какая у меня модель? Прочитайте номинал с этикетки на корпусе клипсы: SCT-013-030 означает 30 A, поэтому пишите ct_model: SCT_013_030. Используйте модель, номинал которой совпадает с этикеткой, а не ту, что «выглядит ближе» к вашей нагрузке.

Код Имя в YAML Номинальный ток Типичная нагрузка Максимум при 230 В Статус v1.3
1 SCT_013_005 5 A LED-освещение, отдельные приборы, ноутбуки ~1.15 кВт production
2 SCT_013_010 10 A Настольные ПК, небольшой кондиционер, одна цепь ~2.3 кВт production
6 SCT_013_020 20 A Водонагреватели, средние ответвления, ~3–5 kW ~4.6 kW production
3 SCT_013_030 30 A Учёт всего дома при типичном потреблении ~6.9 кВт production (артикул по умолчанию)
4 SCT_013_050 50 A Зарядка электромобиля, мощный кондиционер, индукционная плита ~11.5 кВт production
7 SCT_013_060 60 A Промышленный субсчётчик, крупные ответвления ~13.8 кВт production
5 SCT_013_100 100 A Главный ввод в здание, мощные фидеры ~23 кВт production
Установки свыше 50 A.

SCT_013_060 (60 A) и SCT_013_100 (100 A) принимаются; выберите клипсу, номинал которой соответствует максимальному току.

Шунтирующий резистор уже установлен на плате модуля — между выводами клещей добавлять внешние резисторы не нужно.

Дерево выбора

Выбор клещей SCT-013: возьмите наибольший ожидаемый ток плюс 30 процентов, выберите клещи наименьшего номинала выше этого значения и используйте их код модели.

Общее правило: выбирайте клипсу с наименьшим номиналом, максимально измеримое значение которой покрывает пиковую нагрузку с запасом ~30%. Слишком большой номинал на малой нагрузке снижает амплитуду сигнала относительно шума — точность падает. Клипса с номиналом ниже пика насытит магнитный сердечник и даст грубо неверные показания.

Проверка клещей по классам (новое в v1.3)

Валидатор схемы _validate_ct_model_per_class отклоняет недопустимые комбинации sensor_class: × ct_model: на этапе esphome config, до прошивки и загрузки. Допустимые наборы не непрерывны — это явный канон, а не ошибка:

sensor_class Допустимые коды Имена в YAML Поведение при несовпадении
SCT_013 {1, 2, 3, 4, 5, 6, 7} SCT_013_005/010/030/050/100/020/060 cv.Invalid с подсказкой
WIRED_CT {1–10, 12} WIRED_CT_ (например, WIRED_CT_6) cv.Invalid
BUILTIN_CT {} (нет) — cv.Invalid (любой ct_model отклоняется)
UNSET {} — cv.Invalid (класс не задан)

Specifically:

  • SCT_013 несмежный: допустимые коды — {1, 2, 3, 4, 5, 6, 7} (SCT_013_005, _010, _030, _050, _100, _020, _060); порядок кодов не совпадает с порядком номиналов.

  • WIRED_CT — класс модулей, поставляемых со своей установленной проводной клипсой CT; схема для него принимает коды 1/2/3. Модуль откалиброван на заводе с этим датчиком, поэтому компонент отказывается менять класс или модель (см. примечание о парной поставке выше).

  • BUILTIN_CT — класс модулей со встроенным датчиком; ct_model: не нужен и не принимается схемой. Объявление BUILTIN_CT без соответствующего железа бессмысленно.

Если YAML проскакивает валидатор (старая схема + новая прошивка, ручная перезапись), прошивка возвращает REG_ERROR = 0xFE DEV_ERR_PARAM — модуль не запишет неподдерживаемый код: он вернёт DEV_ERR_PARAM, а зеркала останутся на прежнем значении.

Как определить модуль

В YAML есть два ключа — выбирайте один из них в зависимости от того, одна ли клипса на всех каналах или разные. Синтаксический переход — от скалярного значения к списку YAML (массиву):

Шаг 1 — один клещевой датчик на все каналы (ct_model:, скаляр)

Если у вас UI1 (один канал тока) или UI3 с одинаковыми клипсами на всех трёх каналах — одна строка:

YAML
rbamp:
  id: meter1
  ct_model: SCT_013_030      # ← scalar value, one model for all channels

Это самый частый случай. Большинство установок начинают с одной модели клипсы и никогда не выходят за пределы этой линейки.

Шаг 2 — разные клещи на разных каналах (ct_models:, список)

Если у вас UI2 / UI3 и вы хотите разные клещи на каналах (например, небольшие на линии режима ожидания, большие на вводе сети) — замените ct_model: на ct_models: (с суффиксом s) и используйте список YAML в квадратных скобках:

YAML
rbamp:
  id: meter_ui3
  ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]
  #         ↑                            ↑                           ↑
  #     channel 0                     channel 1                channel 2
  #
  # This is a standard YAML list (1..16 elements; only as many as the module has channels are applied).
  # Order matters: the position in the list = the channel index.
  # Mixed codes such as [1, 3, 6] are each kept on their own channel.

Здесь чаще всего ошибаются при изменении многоканальных систем. Помните: ct_model: (без s) — скалярное значение для одной модели; ct_models: (с s) — список значений в квадратных скобках, по одному на канал. Применяется только столько записей, сколько каналов у модуля (1 для UI1, 2 для UI2, 3 для UI3); лишние записи игнорируются с предупреждением.

модули STANDARD (STD).

Модели по каналам сохраняют только модули, которые помнят их при отключении питания. Если подключённый модуль не помнит, компонент громко отказывает (предупреждение, ключи игнорируются), а не записывает значение, которое тихо откатится, — используйте там одиночный ct_model:.

⚠ Взаимно исключают друг друга. Объявление одновременно ct_model: И ct_models: — ошибка проверки схемы (cv.Invalid). Используйте только один из двух.

Установка UI3 с клипсами разного размера

Канонический сценарий для дома с собственной генерацией или со смешанными типами нагрузок:

  • Канал 0 — маломощные потребители (LED-освещение, режим ожидания, электроника). Клещи SCT_013_005 (5 А) дают максимальное разрешение на малом токе.
  • Канал 1 — основные нагрузки (плита, водонагреватель). Клещи SCT_013_030 (30 А) покрывают типичный бытовой пик.
  • Канал 2 — ответвление средней мощности (водонагреватель, ~3–5 kW). Клипса SCT_013_020 (20 A) — оптимальный компромисс между точностью и запасом для типичного субсчётчика.

В одном YAML-блоке rbamp: достаточно объявить:

YAML
rbamp:
  id: home_meter
  ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]

sensor:
  - platform: rbamp
    rbamp_id: home_meter
    voltage:
      name: "Mains Voltage"
    current:
      name: "Lighting Current"     # SCT_013_005, channel 0
    current_1:
      name: "Appliances Current"   # SCT_013_030, channel 1
    current_2:
      name: "Boiler Current"       # SCT_013_020, channel 2
    # ...power_0/_1/_2, energy_0/_1/_2 likewise

Сам компонент назначает точную модель каждому каналу при загрузке.

Что ключ делает внутри

На прошивке v1.2+ атомарная запись ct_model: / ct_models: загружает заводские коэффициенты (шум и усиление) для выбранной модели в ОЗУ модуля и сохраняет их во флеш. Дополнительных шагов калибровки со стороны пользователя не требуется — модуль поставляется с завода со всеми необходимыми таблицами коэффициентов.

На более ранней прошивке значение хранится как маркер модели.

Чтение-сравнение-запись (v1.3+) — почему загрузка теперь «мгновенная»

При загрузке компонент v1.3 читает текущие REG_CT_MODEL_CH0/1/2 (зеркала 0x51–0x53) и сравнивает их со значениями из YAML. Если они совпадают, запись во флеш пропускается полностью.

Сценарий загрузки v0.4.0 (всегда записывать) v1.3 (чтение-сравнение-запись)
Конфигурация уже применена (зеркала совпадают) ~700 мс × N каналов стирание флеша 0 мс (только чтение обратно по I²C)
Конфигурация изменена (одна модель) ~700 мс ~700 мс (только дельта)
UI3 с тремя разными моделями (холодная установка) ~2.8 с провала питания ~2.1 с (3 × 700 мс + проверка)
UI3 с теми же моделями (тёплая загрузка) ~2.8 с провала при каждом запуске ~0 мс

На практике: держите ct_model: / ct_models: в YAML постоянно — конфигурация идемпотентна и не изнашивает флеш при повторных загрузках.

Смена номинала SCT сохраняет точность

На модуле STD ct_model — только метка и не задаёт усиление. Остальная часть раздела описывает модули BASIC.

Каждый модуль SCT откалиброван на заводе на SCT-013-030. Когда вы выбираете другой номинал (например, ct_model: SCT_013_010), ток, мощность и энергия остаются точными — заводская калибровка каждого экземпляра сохраняется:

  • На прошивке модуля до 1.4.19 компонент завершает запись модели перезапуском модуля, который требует процедура (сохранение, сброс, повторное определение), и масштабирует ток, активную/реактивную мощность и энергию к выбранному датчику по коэффициенту, который модуль реально применяет. Перезапуск отображается в журнале и нормален; датчики могут пропустить один цикл. Последующий перезапуск модуля (ваш или внешний) обнаруживается, и масштабирование пересчитывается автоматически.

  • На более новой прошивке (1.4.20+) модуль выполняет переключение сам; компонент это определяет и не меняет показания (обычная запись модели, без перезапуска).

  • Напряжение и коэффициент мощности не затрагиваются.

  • Если коэффициент, который применяет модуль, отличается от ожидаемого более чем на ±5 %, компонент пишет предупреждение и не масштабирует.

Для всего этого изменения YAML не требуются.

Привязка по нескольким каналам

Компонент привязывает каналы по одному; порядок не важен. Смешанные модели на одном модуле (например, коды [1, 3, 6] на трёхканальном модуле) сохраняются каждая на своём канале.

Компонент сам кормит сторожевой таймер (App.feed_wdt()) во время каждого окна записи во флеш — типичный бюджет setup() ESPHome в 15 с не превышается даже при первой установке UI3 с холодного старта.

Проверка установки

После первой загрузки проверьте показания на чисто резистивной нагрузке — лампе накаливания, чайнике, нагревательном элементе. Резистивная нагрузка даёт известную форму сигнала:

  • Коэффициент мощности (power_factor) должен быть близок к 1.00 (устойчиво > 0.95).
  • Активная мощность (power) должна быть положительной и стабильной.
  • Действующий ток (current) должен разумно совпадать с P / U.

Если показания не сходятся:

  • current стабильно ~0 при работающей нагрузке → проверьте полярность и что клещи охватывают один проводник (см. ниже)
  • power стабильно отрицательна → переверните клипсу на проводнике (стрелку направьте в другую сторону)
  • power_factor ~0.5..0.7 на лампе накаливания → рядом может быть реактивная нагрузка или клещи установлены неверно

Подробная диагностика по симптомам — в 10_troubleshooting.md.

Полярность токовых клещей

На корпусе клещей есть стрелка, показывающая направление «нормального» потока энергии (потребление, к нагрузке). При правильной установке (стрелка указывает в направлении тока в нагрузку):

  • P_real > 0 — потребление.
  • P_real < 0 — выдача (только STANDARD (STD)).

Если активная мощность отрицательна при работающем потребителе — физически переверните клещи на проводнике. Не исправляйте полярность программно: это маскирует ошибки направления в последующих автоматизациях.

Клещи должны полностью охватывать один проводник. Не пропускайте L и N через одни клещи — их магнитные поля компенсируются, и датчик покажет около нуля.

Канал напряжения

Артикулы UI* содержат встроенный трансформатор напряжения. Первичная обмотка подключается к L и N сети через клеммные колодки модуля, и модуль измеряет её внутри.

Заводская конфигурация трансформатора фиксирована аппаратной ревизией платы — пользователю ничего настраивать не нужно. Датчик voltage готов к работе сразу.

Артикулы только с I (I1 / I2 / I3) не имеют канала напряжения. Слот voltage на них возвращает 0 и не должен объявляться вместе с power: или energy: (валидатор схемы проверяет эту зависимость).

Модули с несколькими каналами

На UI2 / UI3 каждый канал — отдельная независимая цепь измерения, а не общий магнитный сердечник. Это позволяет:

  • Задайте одну модель CT на все каналы (ct_model:) — типичная конфигурация для равномерных нагрузок.
  • Разместите разные модели на разных каналах (ct_models:) — чтобы оптимизировать точность на смешанных установках (см. выше).
  • Выделите один канал под потребление, другой — под выдачу солнечной энергии в сеть: полярность каждого канала задаётся независимо физическим направлением клещей.

Что дальше

  • 04_hardware.md — физическая проводка, выбор GPIO, шина из нескольких модулей
  • 05_quickstart.md — первый запуск за 5 минут с уже настроенной клипсой
  • 10_troubleshooting.md — диагностика установки по симптомам

Исходники и задачи: rb-amp/rbamp-esphome · эта страница в репозитории: docs/03_sensor_selection.md (v1.9.1)