03 · Выбор токового датчика
Эта глава отвечает на два вопроса:
- Какой токовый датчик выбрать для заданной нагрузки.
- Как сообщить модулю rbAmp ваш выбор, чтобы заводская калибровка для этой комбинации загрузилась автоматически.
Физическое подключение датчика (ориентация клипсы, проверка полярности L/N) описано в 04_hardware.md. Эта глава — о выборе модели и вызовах API.
Класс датчика
Модули rbAmp работают с клипсами CT семейства SCT-013. Класс датчика нужно один раз указать модулю через rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013), перед тем как выбирать конкретную модель клипсы CT через rbamp_set_ct_model().
Выбор модели SCT-013
Семейство SCT-013 насчитывает семь моделей, различающихся по максимальному току первичной цепи. Поддерживаются все семь кодов {1, 2, 3, 4, 5, 6, 7}.
code |
Модель | Диапазон тока | Статус | Типичное применение |
|---|---|---|---|---|
| 1 | SCT-013-005 | 0…5 A | ✅ охарактеризовано | Малые нагрузки — лампы, маломощная электроника, один выключатель |
| 2 | SCT-013-010 | 0…10 A | ✅ охарактеризовано | Один прибор средней мощности — холодильник, стиральная машина, кондиционер до 2 кВт |
| 3 | SCT-013-030 | 0…30 A | ✅ охарактеризовано | Ввод средней по размеру бытовой установки — до ~7 кВт |
| 4 | SCT-013-050 | 0…50 A | ✅ охарактеризовано | Большой ввод — электрическое отопление, зарядка электромобиля, дом с пиковыми нагрузками |
| 5 | SCT-013-100 | 0…100 A | ✅ охарактеризовано | Главный вводной щит дома или малого офиса |
| 6 | SCT-013-020 | 0…20 A | ✅ охарактеризовано | Средний ввод — приборы 3–4 кВт, тяжёлое бытовое оборудование |
| 7 | SCT-013-060 | 0…60 A | ✅ охарактеризовано | Промышленный субсчётчик |
Допустимые коды — {1, 2, 3, 4, 5, 6, 7}. Код вне этого набора (например, 0 или 8), переданный в rbamp_set_ct_model_ch, возвращает ESP_ERR_INVALID_ARG + REG_ERROR = 0xFE (ERR_PARAM). Подробнее о том, как именно компонент возвращает эту ошибку, см. 09 · Справочник API, раздел «Модель ошибок v1.3».
Как выбрать нужную модель
Базовое правило:
-
Определите максимальный ток, который может протекать в цепи (по самой большой нагрузке + запас 30 %).
-
Выберите наименьшие из номинальных клещей выше этого значения.
- Не берите завышенный номинал более чем в 5 раз. Клипса SCT-013-100 на цепи с максимумом 5 А будет работать, но даст низкое разрешение и большую погрешность при типичных значениях.
Запас
Клещи SCT-013 работают без насыщения в пределах своего номинала. Кратковременные пики (пуск компрессора, индуктивная нагрузка) могут превышать номинал в 5–7 раз — это нормально, клещи физически это выдерживают, но выше номинала измерение становится нелинейным.
Если пиковый ток нагрузки выше номинала клипсы, возьмите следующий размер. Например, для стиральной машины с пусковым током 12 А (при рабочем номинале 2–3 А): 12 А × 1.3 = 15.6 А, значит наименьшая клипса с номиналом выше этого — SCT-013-020 (код 6), а не SCT-013-005.
Как сообщить модулю ваш выбор
Два вызова обязательны, в правильном порядке — сначала rbamp_set_sensor_class(), затем rbamp_set_ct_model(). Если вызвать rbamp_set_ct_model() раньше rbamp_set_sensor_class(), компонент вернёт ESP_ERR_INVALID_STATE, и пресет НЕ загрузится.
Модель CT — это функциональный пресет, а не метка. Запись модели CT сразу применяет базовый уровень шума NF, коэффициент усиления и коэффициент формы к конвейеру измерений модуля; показания тока меняются. Изменение sensor_class сбрасывает модель CT в значение по умолчанию (0) и требует задать её снова.
#include "driver/i2c_master.h"
#include "rbamp.h"
void setup_sensor(rbamp_handle_t dev) {
/* Step 1: select the sensor family.
* MANDATORY before rbamp_set_ct_model(). */
esp_err_t err = rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
if (err != ESP_OK) {
ESP_LOGE("app", "set_sensor_class: %s", rbamp_err_to_str(err));
return;
}
/* Step 2: select the model within the family.
* 1 = SCT-013-005, 2 = SCT-013-010, 3 = SCT-013-030,
* 4 = SCT-013-050, 5 = SCT-013-100, 6 = SCT-013-020, 7 = SCT-013-060. */
err = rbamp_set_ct_model(dev, 3); /* e.g. SCT-013-030 */
if (err != ESP_OK) {
/* Possible causes:
* ESP_ERR_INVALID_STATE — rbamp_set_sensor_class() was not called
* before rbamp_set_ct_model()
* ESP_ERR_INVALID_ARG — code not in {1,2,3,4,5,6,7}
* ESP_FAIL — communication error (NACK after retry)
*/
ESP_LOGE("app", "set_ct_model: %s", rbamp_err_to_str(err));
return;
}
}
Компонент намеренно НЕ вызывает rbamp_set_sensor_class() за вас. Если этот шаг пропущен, rbamp_set_ct_model() возвращает ESP_ERR_INVALID_STATE, не записывая во флеш. Так сделано, чтобы поведение оставалось предсказуемым и явным — никакой «магии» в публичном API.
После этих двух вызовов:
-
Модуль хранит оба значения во флеше — настройка переживает сброс, отключение питания и перепрошивку.
-
Коэффициенты калибровки для этой конкретной комбинации (класс датчика + модель) загружаются из таблицы заводских пресетов. Трогать ручные регистры калибровки не нужно.
-
Следующий вызов
rbamp_read_current(dev, 0, &i)уже возвращает значение в амперах с правильным масштабом.
Общее время обоих вызовов — около 1.4 секунды (две операции записи во flash × ~700 мс каждая, ограничено временем стирания страницы flash). Выполняется один раз при первой установке; настройка хранится во flash и больше не повторяется.
Если вы уже выбрали датчик при первом запуске и просто перезагружаете ESP32, повторять вызовы rbamp_set_sensor_class() и rbamp_set_ct_model() не нужно — модуль помнит предыдущий выбор. Но и вреда от повтора нет: повторный вызов с тем же значением просто перезаписывает тот же байт.
Проверка настройки
Простая проверка здравого смысла после rbamp_set_ct_model():
#include
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
static const char *TAG = "rbamp_check";
void sanity_check(rbamp_handle_t dev) {
ESP_LOGI(TAG, "Ready. Connect a purely resistive load "
"(e.g. an incandescent lamp).");
ESP_LOGI(TAG, "Expect a stable PF ~= 1.0 and positive P.");
while (1) {
float u = NAN, i = NAN, p = NAN, pf = NAN;
rbamp_read_voltage(dev, 0, &u);
rbamp_read_current(dev, 0, &i);
rbamp_read_power(dev, 0, &p);
rbamp_read_power_factor(dev, 0, &pf);
ESP_LOGI(TAG, "U=%.1f V I=%.2f A P=%.1f W PF=%.2f",
(double)u, (double)i, (double)p, (double)pf);
vTaskDelay(pdMS_TO_TICKS(2000));
}
}
На чисто активной нагрузке (лампа накаливания, электрочайник, нагревательный элемент) ожидайте:
U≈ 220–240 В (для сети 230 В)I≈ соответствует мощности нагрузки (P / U)P> 0 и стабильноPF≈ 1.0 (явно положительный)
Если что-то не сходится, см. 10_troubleshooting.md.
Модули с несколькими токовыми каналами
Линейка SKU — что подходит для задачи
| SKU | I-каналы | Канал U | Типичное применение |
|---|---|---|---|
| UI1 | 1 | да | Одна нагрузка с полным расчётом мощности (P, PF, Q, Wh) — типичный счётчик сети |
| UI2 | 2 | да | Два независимых прибора на одной фазе с учётом мощности по каналам (1 U + 2 I) |
| UI3 | 3 | да | Три нагрузки на одной фазе с мощностью по каналам (1 U + 3 I) |
| I1 | 1 | нет | Субсчётчик без расчёта мощности (только ток) — когда учёт сети ведётся отдельным UI1 |
| I2 | 2 | нет | Двухканальный токовый субсчётчик — разбивка по цепям |
| I3 | 3 | нет | Трёхканальный токовый субсчётчик — учёт по цепям / топология с двумя ТТ |
Что измеряет каждый канал
- U-канал (только UI): U_rms, U_peak, частота. Один* на модуль (привязан к входной фазе).
- I-channels:
- на вариантах UI — каждый канал даёт I_rms, I_peak, P (активная мощность), PF, avg_p за период.
- на вариантах I — только ток (I_rms, I_peak). Активная мощность и PF не вычисляются — для них нужно напряжение, которого у варианта I нет. Регистры
power[]/power_factor[]на вариантах I возвращают 0. - Многофазный против многоточечного: модуль НЕ различает, к какой фазе подключён каждый I-канал. Эта семантика — на стороне мастера.
Модель CT по каналам — независимая калибровка каждого канала
На модулях с несколькими каналами (I2, I3) каждый токовый канал независимо выбирает модель SCT-013. Можно, например, подключить SCT-013-005 к каналу 0 (одна розетка), SCT-013-030 к каналу 1 (линия электроплиты) и SCT-013-020 к каналу 2 (водонагреватель или бойлер).
API выбора по каналам — rbamp_set_ct_model_ch(dev, channel, code):
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013); /* once for all */
/* v1.3: channel binding order is arbitrary. */
rbamp_set_ct_model_ch(dev, 0, 1); /* channel 0: SCT-013-005 */
rbamp_set_ct_model_ch(dev, 1, 3); /* channel 1: SCT-013-030 */
rbamp_set_ct_model_ch(dev, 2, 6); /* channel 2: SCT-013-020 */
✅ Порядок привязки произволен (канон v1.3). Запись REG_CT_MODEL (0x05) лишь подготавливает значение, но не применяет его автоматически ни к одному каналу. Применение происходит только через CMD_SET_CT_MODEL_CHn по каждому каналу: команда берёт текущее подготовленное значение и записывает его в свой канал. Каналы можно настраивать в любом порядке (ch0 первым, последним или вперемешку — разницы нет); перезаписи не происходит. Упоминания «по возрастанию / по убыванию / привязывать ch0 последним» в старых документах и кодовых базах относятся к поведению до v1.3 — их можно удалить.
Каждый канал привязывается в два шага: (1) запись модели в REG_CT_MODEL (подготовка), (2) CMD_SET_CT_MODEL_CHn (привязка). Проверку (класс, модель) выполняет прошивка на шаге привязки.
Если нескольким каналам назначена одна и та же модель, можно вызывать с одним кодом — повторное применение идемпотентно:
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
rbamp_set_ct_model_ch(dev, 0, 1);
rbamp_set_ct_model_ch(dev, 1, 1);
rbamp_set_ct_model_ch(dev, 2, 1);
Альтернатива для типичного случая I2/I3 — rbamp_configure_channels(dev, class, models[], n): одна операция задаёт класс, все каналы и фиксирует всё во флеш одним завершающим CMD_SAVE_USER_CONFIG (бережно для флеша — один цикл стирания вместо N). См. главу 09 · Справочник API, раздел «Конфигурация нескольких каналов».
Форма rbamp_set_ct_model(dev, code) с одним параметром — удобный вариант для одноканальных SKU (применяется к каналу 0). На многоканальных модулях она эквивалентна rbamp_set_ct_model_ch(dev, 0, code).
Расширенная настройка: два клеща разного номинала на одном проводе
⚙ Дополнительный шаблон, а не базовый. Этот раздел описывает необязательный приём для улучшения разрешения при малых токах. Для большинства установок достаточно одного клещя, подобранного под диапазон нагрузки. Используйте двойной CT, только если у вас есть конкретное требование к точности при токах < 1 А.
Когда это применяется
- Многоканальные модули I2 / I3 (текущее оборудование).
-
Один и тот же провод нужно измерять с одинаковым качеством и для малых нагрузок (≤ 1 А), и для пиковых событий (≥ 5 А).
-
Типичный пример: вводной щит квартиры, где днём 50–100 Вт дежурного режима, а вечером пусковой ток чайника или электроплиты 3+ кВт.
Идея
Два SCT-013 разных номиналов установлены на одном проводе:
-
Канал 0 — малые клещи (например, SCT-013-005, 5 А): видят малые токи с лучшим разрешением и меньшим шумовым порогом.
-
Канал 1 — большая клипса (например, SCT-013-030 или выше): обрабатывает токи выше порога перегрузки малой клипсы без насыщения.
Мастер сам выбирает канал по величине тока: пока малая клипса в линейной зоне, её показания точнее; при превышении он переключается на большую.
Конфигурация
Класс датчика — один раз, затем модели по каналам в любом порядке (v1.3 — чистая подготовка, порядок не имеет значения):
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013); /* once */
rbamp_set_ct_model_ch(dev, 0, 1); /* ch0 = SCT-013-005 (0..5 A) — small clamp */
rbamp_set_ct_model_ch(dev, 1, 3); /* ch1 = SCT-013-030 (0..30 A) — large clamp */
Итоговое состояние: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Альтернатива через rbamp_configure_channels() — одна операция вместо двух:
uint8_t models[2] = { 1, 3 }; /* ch0=5A, ch1=30A */
rbamp_configure_channels(dev, RBAMP_SENSOR_SCT013, models, 2);
Логика агрегации на стороне мастера
Самый простой шаблон — переключение по порогу:
float read_combined_current(rbamp_handle_t dev) {
float i_low = NAN;
float i_high = NAN;
esp_err_t err_low = rbamp_read_current(dev, 0, &i_low); /* small */
esp_err_t err_high = rbamp_read_current(dev, 1, &i_high); /* large */
/* While the small clamp is far from saturation, it gives better
* accuracy at small currents. Switch to the large one as it
* approaches the overload point.
*
* The 4.5 A threshold for the SCT-013-005 is an example value;
* figures for low-current dual-CT use are not published. */
if (err_low == ESP_OK && i_low < 4.5f) {
return i_low;
}
return (err_high == ESP_OK) ? i_high : NAN;
}
Два клещя на одном проводе физически возможны на большинстве бытовых кабелей, но требуют немного места в щите.
⚙ Цифры для двойного CT. Цифры для использования двойного CT при малых токах (поведение около порога, расхождение двух клещей в перекрывающемся диапазоне) не публикуются. Считайте двойной CT пилотным шаблоном; для критичных применений предпочтителен один клещ, подобранный под верхний диапазон нагрузки.
Многоканальные модули — I2 и I3 (только ток)
Модули только с током для многоканальной топологии — I2 (два токовых канала) и I3 (три токовых канала). У обоих модулей нет U-канала, поэтому расчёт P / PF / Q на стороне модуля невозможен — они дают ток по каждому каналу (I_rms, I_peak по каждому каналу) и больше ничего.
UI2 и UI3 добавляют канал U (1 U + 2 I / 1 U + 3 I), поэтому мощность по каналам вычисляется на модуле. Там, где нужна только разбивка по токам, используйте I2/I3 как токовые субсчётчики вместе с отдельным UI1 на вводе, который даёт энергию сети и напряжение.
Чтение каналов (I2 / I3)
float i0, i1, i2;
rbamp_read_current(dev, 0, &i0); /* ch0 */
rbamp_read_current(dev, 1, &i1); /* ch1 */
rbamp_read_current(dev, 2, &i2); /* ch2 — I3 only */
/* On an I variant rbamp_read_power(...) returns 0 — this is by design. */
float p_dummy; rbamp_read_power(dev, 0, &p_dummy); /* = 0.0f */
Если вам нужна активная мощность на каждой подлинии, поставьте UI1 на вводе и распределяйте её общую мощность пропорционально токовому каналу I[k] с модулей I2/I3. Это типичное домашнее развёртывание:
/* Pseudo-pattern: UI1 on mains, I3 on 3 sub-lines */
float p_mains_total, i0, i1, i2;
rbamp_read_power(mains_ui1, 0, &p_mains_total);
rbamp_read_current(loads_i3, 0, &i0);
rbamp_read_current(loads_i3, 1, &i1);
rbamp_read_current(loads_i3, 2, &i2);
float i_sum = i0 + i1 + i2;
if (i_sum > 0.01f) {
float p0 = p_mains_total * i0 / i_sum; /* approximation */
/* ... */
}
Это приближение: разделение по току работает, когда коэффициент мощности примерно одинаков для всех нагрузок. Для точного учёта мощности по каждой нагрузке используйте вариант UI (UI1 / UI2 / UI3 / UI5 / UI7) на каждой линии.
Применение I2 / I3
-
Субучёт тока: разбивка тока по цепям, одна точка установки на щите вместо отдельного модуля на каждой линии.
-
Разложение вместе с UI1: UI1 даёт энергию / мощность сети, а I2/I3 разбивают потребление по ветвям (см. главу 06, сценарий 1).
-
Контроль тока без учёта мощности: управление перегрузкой, определение включения/выключения нагрузки, профиль I(t).
-
Двойной CT + третий канал (I3): большие клещи на канале 0 для широкого диапазона, малые на канале 1 для точности при малых токах, третий канал для отдельной вспомогательной линии. См. раздел «Расширенная настройка: два клещя разного номинала» выше.
Расчёт мощности на стороне мастера:
float i;
rbamp_read_current(dev, ch, &i);
/* If the voltage is known (from a UI module upstream or fixed) */
const float U_nominal = 230.0f;
float p_estimated = U_nominal * i; /* without PF — guaranteed overestimate */
Для точного учёта мощности используйте модуль UI (с каналом U).
Подходы к повышению чувствительности на малых токах
Если диапазон нагрузки большой (например, 1 Вт дежурного режима у роутера против водонагревателя 2000 Вт на той же розетке), одна клипса, рассчитанная на верхний предел, теряет малые токи в шуме.
Три стратегии в порядке возрастания сложности:
-
Подбирайте CT по максимуму, а не «с запасом». Самая частая ошибка — поставить SCT-013-100 (100 А) на бытовую розетку с типичным потреблением 0.5–10 А. Сигнал лежит в нижних 1–10 % диапазона датчика — там шум становится соизмерим с сигналом. Для бытового сценария (розетка 16 А) оптимален SCT-013-030; для подключения одного прибора (≤ 5 А) — SCT-013-005.
-
Топология с двумя датчиками (требуется SKU с I2/I3 — два токовых канала на одном модуле): небольшая клипса для нижнего диапазона и большая для верхнего, мастер выбирает по порогу. См. раздел «Топология с двумя датчиками» выше — шаблон является пилотным; данные для низкотоковых применений с двумя датчиками не публикуются.
-
Шумовой порог (со стороны производства): калибровка модуля уже его учитывает. Со стороны пользователя ничего делать не нужно, кроме
setSensorClass()+setCTModel(). Конкретные показатели точности при малых токах не публикуются.
Режим production и режим заводской настройки (справка по сохранению)
Модуль rbAmp работает в двух режимах, которые различаются тем, что именно сохраняется во flash. Текущий режим читается из соответствующего регистра состояния модуля.
| Команда (opcode) | Продакшн | Сохраняется |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, взведено magic-значением) |
✅ OK | Адрес I²C (см. 04 · Подключение — смена адреса) |
CMD_RESET (0x01) |
✅ OK | — (программный сброс) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (снимок периода) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS |
❌ ЗАБЛОКИРОВАНО в продакшене (возвращает ERR_PARAM) | усиления / NF / фаза (заводская калибровка) |
CMD_FACTORY_RESET |
❌ ЗАБЛОКИРОВАНО в production | — |
В производственном режиме запись заводской калибровки (CMD_SAVE_GAINS, CMD_FACTORY_RESET) отклоняется прошивкой — это защищает от случайного стирания заводских коэффициентов. Перевод в заводской режим — операция на стороне производителя; конечным пользователям он не нужен.
Защита производства принимает запись в RAM (последующее чтение возвращает записанное значение), но сохранение во флеш может быть отклонено. После перезагрузки значение откатывается к состоянию до записи. Единственный корректный способ подтвердить сохранность — перезагрузить модуль через CMD_RESET и прочитать снова:
rbamp_set_ct_model(dev, code);
rbamp_reset(dev); // CMD_RESET 0x01, works in production
vTaskDelay(pdMS_TO_TICKS(400)); // boot complete
uint8_t check; rbamp_read_ct_model(dev, 0, ✓);
assert(check == code); // ONLY now is persistence confirmed
Перекрёстная ссылка: 09 · Справочник API — подробности о конкретных кодах операций; 10 · Диагностика — что делать, если сохранение не подтверждено.
Что дальше
-
04 · Подключение — физическое подключение клипсы, ориентация стрелки, полярность L/N
-
05 · Быстрый старт — полный проект первого запуска
-
06 · Примеры — рабочие сценарии для разных нагрузок
-
10 · Диагностика — что делать, если показания странные (отрицательный PF, нестабильный I и т. д.)
Исходный код и вопросы: rb-amp/rbamp-esp-idf · эта страница в репозитории: docs/03_sensor_selection.md (v1.7.3)