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

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

Эта глава отвечает на два вопроса:

  1. Какой токовый датчик выбрать для заданной нагрузки.
  2. Как сообщить модулю rbAmp ваш выбор, чтобы заводская калибровка для этой комбинации загрузилась автоматически.

Физическое подключение датчика (ориентация клипсы, проверка полярности L/N) описано в 04_hardware.md. Эта глава — о выборе модели и вызовах API.

Как клещи SCT-013 надеваются на фазный проводник стрелкой к нагрузке.

Класс датчика

Модули rbAmp работают с клипсами CT семейства SCT-013. Класс датчика нужно один раз указать модулю через rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013), перед тем как выбирать конкретную модель клипсы CT через rbamp_set_ct_model().

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

Схема выбора модели SCT-013 по наибольшему ожидаемому току плюс запас 30 процентов.

Семейство 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».

Как выбрать нужную модель

Базовое правило:

  1. Определите максимальный ток, который может протекать в цепи (по самой большой нагрузке + запас 30 %).

  2. Выберите наименьшие из номинальных клещей выше этого значения.

  3. Не берите завышенный номинал более чем в 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) и требует задать её снова.

C
#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():

C
#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):

C
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 (привязка). Проверку (класс, модель) выполняет прошивка на шаге привязки.

Если нескольким каналам назначена одна и та же модель, можно вызывать с одним кодом — повторное применение идемпотентно:

C
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 — чистая подготовка, порядок не имеет значения):

C
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() — одна операция вместо двух:

C
uint8_t models[2] = { 1, 3 };   /* ch0=5A, ch1=30A */
rbamp_configure_channels(dev, RBAMP_SENSOR_SCT013, models, 2);

Логика агрегации на стороне мастера

Самый простой шаблон — переключение по порогу:

C
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)

C
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. Это типичное домашнее развёртывание:

C
/* 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 для точности при малых токах, третий канал для отдельной вспомогательной линии. См. раздел «Расширенная настройка: два клещя разного номинала» выше.

Расчёт мощности на стороне мастера:

C
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 Вт на той же розетке), одна клипса, рассчитанная на верхний предел, теряет малые токи в шуме.

Три стратегии в порядке возрастания сложности:

  1. Подбирайте CT по максимуму, а не «с запасом». Самая частая ошибка — поставить SCT-013-100 (100 А) на бытовую розетку с типичным потреблением 0.5–10 А. Сигнал лежит в нижних 1–10 % диапазона датчика — там шум становится соизмерим с сигналом. Для бытового сценария (розетка 16 А) оптимален SCT-013-030; для подключения одного прибора (≤ 5 А) — SCT-013-005.

  2. Топология с двумя датчиками (требуется SKU с I2/I3 — два токовых канала на одном модуле): небольшая клипса для нижнего диапазона и большая для верхнего, мастер выбирает по порогу. См. раздел «Топология с двумя датчиками» выше — шаблон является пилотным; данные для низкотоковых применений с двумя датчиками не публикуются.

  3. Шумовой порог (со стороны производства): калибровка модуля уже его учитывает. Со стороны пользователя ничего делать не нужно, кроме 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 и прочитать снова:

C
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 · Диагностика — что делать, если сохранение не подтверждено.

Что дальше


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