03 · Выбор токового датчика
rbAmp измеряет ток через внешние токовые клещи (трансформатор тока) и напряжение через встроенный трансформатор напряжения (в артикулах UI*). Эта глава — о том, как выбрать клещи под вашу нагрузку и как сообщить модулю через YAML, какая модель установлена.
Семейство датчиков (sensor_class:)
Аппаратная ревизия модуля определяет, какое семейство токовых датчиков поддерживается. На текущих артикулах доступно только одно:
| Класс | Значение в YAML | Состояние |
|---|---|---|
| SCT-013 (разъёмная клипса CT) | SCT_013 |
Доступно сейчас, по умолчанию |
| WIRED_CT (модуль со своей установленной проводной клипсой) | WIRED_CT |
Поставляется в паре: откалиброван вместе со своим датчиком |
| BUILTIN_CT (модуль со встроенным датчиком) | BUILTIN_CT |
Поставляется в паре: откалиброван вместе со своим датчиком |
Класс задаётся один раз и сохраняется во флеш модуля:
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 |
SCT_013_060 (60 A) и SCT_013_100 (100 A) принимаются; выберите клипсу, номинал которой соответствует максимальному току.
Шунтирующий резистор уже установлен на плате модуля — между выводами клещей добавлять внешние резисторы не нужно.
Дерево выбора
Общее правило: выбирайте клипсу с наименьшим номиналом, максимально измеримое значение которой покрывает пиковую нагрузку с запасом ~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_ |
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 с одинаковыми клипсами на всех трёх каналах — одна строка:
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 в квадратных скобках:
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); лишние записи игнорируются с предупреждением.
Модели по каналам сохраняют только модули, которые помнят их при отключении питания. Если подключённый модуль не помнит, компонент громко отказывает (предупреждение, ключи игнорируются), а не записывает значение, которое тихо откатится, — используйте там одиночный 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: достаточно объявить:
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)