rbAmp
RU
Магазин
Документация

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

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

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

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

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

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

Модули rbAmp работают с токовыми клещами семейства SCT-013. Класс датчика для накладного клипсового клещя SCT-013, который вы устанавливаете сами, задаётся один раз командой setSensorClass(Sct013) до выбора модели. Если модуль поставлен уже с подключённым ТТ, пропустите настроечные вызовы из этой главы.

Выбор модели 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 ✅ охарактеризовано Большой вводной кабель — электрическое отопление, зарядка EV, частный дом с пиковыми нагрузками
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), переданный в dev.setCTModel(...) (или в configureChannels(...)), возвращает false с lastError() == RB_ERR_PARAM — библиотека не отправляет запись на устройство (защита на стороне клиента).

Коды 0x06 и 0x07 не монотонны по номиналу — они добавлены после исходного набора 0x01..0x05. Всегда выбирайте по нужному номиналу, а не по порядку кодов.

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

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

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

  2. Модель считайте с этикетки, напечатанной на клещах.

  3. Одно правило: выбирайте наименьший клещ с номиналом выше вашего максимального ожидаемого тока. Клещ с малым номиналом упирается в пики и занижает показания; слишком большой клещ на малых токах шумит (SCT-013-100 на цепи 5 А работает, но с плохим разрешением).

Как выбрать токовый клещ SCT-013: возьмите максимально ожидаемый ток плюс 30 % запаса, выберите наименьший клещ с номиналом выше него и задайте его код модели.

Запас

Токовый клещ SCT-013 работает без насыщения в пределах своего номинала. Короткие пики (пуск компрессора, индуктивная нагрузка) могут превышать номинал в 5–7 раз — это нормально, клещ физически выдерживает такой пик, но измерение становится нелинейным выше номинала.

Если пиковый ток нагрузки выше номинала клещей, выберите следующий размер: наименьший номинальный клещ выше пика плюс запас 30 %. Например, для стиральной машины с пусковым током 12 A (и 2–3 A в работе): 12 A × 1.3 = 15.6 A, значит выбирайте SCT-013-020 (а не SCT-013-005, который обрежется на пике).

Сообщение модулю о вашем выборе

Требуются два вызова в правильном порядке — сначала setSensorClass(), затем setCTModel(). Если вызвать setCTModel() раньше setSensorClass(), модуль вернёт ошибку RB_ERR_PARAM, и предустановка НЕ загрузится.

Примечание

Модель ТТ — это функциональная предустановка, а не метка. Запись модели ТТ немедленно применяет заводскую калибровку для этой модели клеща к измерительному тракту модуля; показания тока меняются. Смена sensor_class сбрасывает модель ТТ на значение по умолчанию (0), и её нужно задать заново.

C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin();
    while (!dev.begin()) { delay(500); }

    // Step 1: select the sensor family. REQUIRED before setCTModel().
    if (!dev.setSensorClass(RbAmpSensorClass::Sct013)) {
        // setSensorClass failed — check the connection, power, and address.
        return;
    }

    // Step 2: select the model within the family.
    if (!dev.setCTModel(RbAmpCTModel::Sct013_030)) {
        // Possible causes (any → RB_ERR_PARAM):
        //  1. setSensorClass() was not called before setCTModel()
        //  2. code not in the per-class accept-set (for Sct013: {1,2,3,4,5,6,7})
        //  3. no factory preset for the selected class
        //     (applies to WiredCT / BuiltinCT in the current firmware)
        //  4. communication error (RB_ERR_IO, not RB_ERR_PARAM — a separate code)
        return;
    }
}
Примечание

Библиотека намеренно НЕ вызывает setSensorClass() от имени пользователя. Если этот шаг пропущен, setCTModel() возвращает false с RB_ERR_PARAM и не пишет во флеш. Так поведение остаётся предсказуемым и явным — никакой «магии» в публичном API.

После этих двух вызовов:

  • Модуль хранит оба значения во флеш — настройка переживает сброс, отключение питания и повторную прошивку.

  • Коэффициенты калибровки для этой конкретной комбинации (класс датчика + модель) загружаются из заводской таблицы пресетов. Трогать ручные регистры калибровки не нужно.

  • Следующий вызов dev.readCurrent(0) уже вернёт значение в амперах с правильным масштабом.

Общее время обоих вызовов — около 1.4 секунды (две операции записи во флеш × ~700 мс каждая, ограничено временем стирания страницы флеша). Выполняется один раз при первой установке; настройка хранится во флеше и не повторяется.

Примечание

Если вы уже выбрали датчик при первом запуске и просто перезагружаете контроллер, повторять вызовы setSensorClass() и setCTModel() не нужно — модуль помнит предыдущий выбор. Но и вреда от повтора нет: повторный вызов с тем же значением просто перезаписывает тот же байт.

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

Простая проверка после setCTModel():

C++
void setup() {
    Wire.begin();
    while (!dev.begin()) { delay(500); }
    dev.setSensorClass(RbAmpSensorClass::Sct013);
    dev.setCTModel(RbAmpCTModel::Sct013_030);

    Serial.print(F("Ready. Connect a purely resistive load "));
    Serial.println(F("(for example, an incandescent lamp)."));
    Serial.println(F("Expect a steady PF ≈ 1.0 and positive P."));
}

void loop() {
    Serial.print(F("U=")); Serial.print(dev.readVoltage(), 1);
    Serial.print(F("V  I=")); Serial.print(dev.readCurrent(0), 2);
    Serial.print(F("A  P=")); Serial.print(dev.readPower(0), 1);
    Serial.print(F("W  PF=")); Serial.println(dev.readPowerFactor(0), 2);
    delay(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 да Две независимые нагрузки на одной фазе с мощностью по каждому каналу
UI3 3 да 1 U + 3 I — три нагрузки на одной фазе с мощностью по каждому каналу (P, PF, Q, Wh)
I1 1 нет Субсчётчик без расчёта мощности (только ток) — когда отдельный UI1 ведёт учёт сети
I2 2 нет Двухканальный токовый субсчётчик — разбивка по цепям
I3 3 нет Трёхканальный токовый субсчётчик — учёт по цепям / топология с двумя ТТ

Что измеряет каждый канал

  • Канал U (только UI): U_rms, U_peak, частота. Один* на модуль.
  • Каналы I:
  • на вариантах UI — каждый канал даёт I_rms, I_peak, P (активная мощность), PF, avg_p за период.
  • на вариантах I — только ток (I_rms, I_peak). Активная мощность и PF не считаются — им нужно напряжение, которого у варианта I нет. Регистры power[]/powerFactor[] на вариантах I возвращают 0.
  • Однофазный модуль: все каналы I должны быть на той же фазе, к которой подключён канал U.

Модель CT по каналам — независимая калибровка каналов

На многоканальных модулях (I2, I3) каждый токовый канал имеет независимый выбор модели SCT-013. Например, можно подключить SCT-013-005 к каналу 0 (одна розетка), SCT-013-030 к каналу 1 (цепь плиты) и SCT-013-020 к каналу 2 (вводной кабель).

C++
uint8_t models[3] = {1, 3, 6};   // ch0=SCT-013-005, ch1=SCT-013-030, ch2=SCT-013-020
dev.configureChannels(RbAmpSensorClass::Sct013, models, 3);

Один вызов настраивает класс датчика и все каналы за одну операцию с одной командой SAVE_USER_CONFIG. Измерено на стенде: ~1.4 секунды для 1-SAVE против ~3.5 секунды за 3 отдельных цикла SAVE (setCTModel() + ручное сохранение). Главное — износ флеша в 3× меньше на той же странице флеша.

Способ 2: поканально setCTModel(channel, code) — в любом порядке

API побканального выбора — setCTModel(channel, code):

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);   // once for all channels

// v1.3: binding order is arbitrary.
dev.setCTModel(0, 1);   // SCT-013-005
dev.setCTModel(1, 3);   // SCT-013-030
dev.setCTModel(2, 6);   // SCT-013-020

dev.saveUserConfig();    // explicit save at the end (3-SAVE alternative, slower)
Безопасность

✅ Порядок привязки произвольный (v1.3). Запись REG_CT_MODEL (0x05) лишь ставит значение в staging, но не применяет его ни к одному каналу автоматически. Применение происходит только через побканальную CMD_SET_CT_MODEL_CHn, которая берёт текущее значение staging и пишет его в свой канал. Каналы можно настраивать в любом порядке (setCTModel(0, ...) первым, последним или вперемешку — разницы нет); затирания не происходит. Упоминания «по возрастанию / по убыванию / привязать ch0 последним» в старых документах и кодовых базах относятся к поведению до v1.3 — их можно удалить.

Тем не менее привязка каждого канала остаётся двухшаговой на уровне протокола на линии (подготовка REG_CT_MODEL → привязка CMD_SET_CT_MODEL_CHn); setCTModel(channel, code) библиотеки объединяет оба шага.

Если все каналы получают одну и ту же модель, порядок не важен (побочный эффект идемпотентен):

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);
dev.setCTModel(0, RbAmpCTModel::Sct013_005);
dev.setCTModel(1, RbAmpCTModel::Sct013_005);   // ch0 is rewritten with the same value — no effect
dev.setCTModel(2, RbAmpCTModel::Sct013_005);
Обратная совместимость

: целочисленная перегрузка setCTModel(uint8_t code) сохранена. Соответствие v1.3: 1=Sct013_005, 2=Sct013_010, 3=Sct013_030, 4=Sct013_050, 5=Sct013_100, 6=Sct013_020, 7=Sct013_060. Типизированный enum RbAmpCTModel::Sct013_NNN — рекомендуемая форма (компилятор поймает недопустимые значения до обращения к шине). На многоканальных модулях однозначный вызов setCTModel(code) применяется к каналу 0 — это эквивалентно setCTModel(0, code).

Многоканальные модули — I2 и I3 (только ток)

Актуальное аппаратное обеспечение для многоканальной топологии — I2 (два токовых канала) и I3 (три токовых канала). Оба модуля не имеют канала U, поэтому расчёт P / PF / Q на стороне модуля невозможен — они дают ток по каждому каналу (I_rms, I_peak на каждом канале) и больше ничего.

UI2 (1 U + 2 I) и UI3 (1 U + 3 I) добавляют канал напряжения в ту же многоканальную схему, поэтому мощность по каналам вычисляется на самом модуле. Когда мощность на стороне модуля не нужна, используйте I2/I3 как токовые субсчётчики в паре с отдельным UI1 на вводе, который даёт энергию сети и напряжение.

Чтение каналов (I2 / I3)

C++
float i0 = dev.readCurrent(0);   // ch0
float i1 = dev.readCurrent(1);   // ch1
float i2 = dev.readCurrent(2);   // ch2 — I3 only

// On an I variant readPower(...) returns 0.0 — this is by design.
float p_dummy = dev.readPower(0);  // = 0.0f

Если нужна активная мощность на каждой сублинии, установите UI1 на вводе и распределите её общую мощность пропорционально току каждого канала I[k] с I2/I3. Это типичное бытовое развёртывание (см. главу 06 · Примеры, сценарий 1).

Примечание

Это приближение: разбиение по току работает, если коэффициент мощности примерно одинаков для всех нагрузок. Для точного учёта мощности каждой нагрузки используйте вариант UI на каждой линии (когда станут доступны UI2/UI3).

Применения I2 / I3

  • Учёт субнагрузок по токам: разбивка тока по цепям, одна точка установки на щите вместо отдельного модуля на каждую линию.

  • Разделение нагрузки в паре с UI1: UI1 даёт энергию / мощность сети, I2/I3 разбивают потребление по ветвям (см. главу 06, сценарий 1).

  • Контроль тока без учёта мощности: контроль перегрузки, определение включения / выключения нагрузки, профиль I(t).

  • Два датчика + третий канал (I3): большой клещ на канале 0 для широкого диапазона, малый клещ на канале 1 для точности на малых токах, а третий канал — для отдельной вспомогательной линии. См. раздел «Расширенная настройка: два клеща разного номинала» ниже.

Расширенная настройка: два клеща разного номинала на одном проводе

Примечание

⚙ Продвинутый шаблон, а не базовый. Раздел описывает необязательный приём для повышения разрешения на малых токах. Для большинства установок достаточно одного клеща, подобранного под диапазон нагрузки. Используйте двойной ТТ, только если у вас есть конкретное требование к точности при токах < 1 А.

Когда это применимо

  • Многоканальные модули I2 / I3 (текущее оборудование).
  • Один и тот же провод нужно измерять и для малых нагрузок (≤ 1 A), и для пиковых событий (≥ 5 A) с одинаковым качеством.

  • Типичный пример: квартирный ввод с дневным потреблением в режиме ожидания 50–100 Вт и вечерним пуском чайника или плиты мощностью 3+ кВт.

Идея

Два SCT-013 разных номиналов установлены на одном проводе:

  • Канал 0 — малый клещ (например, SCT-013-005, 5 А): лучше видит малые токи с более высоким разрешением и меньшим уровнем шума.

  • Канал 1 — большой клещ (например, SCT-013-030 или выше): обрабатывает токи выше порога перегрузки малого клеща без насыщения.

Мастер сам выбирает канал по текущему значению: пока малый клещ работает в линейном диапазоне, его показание точнее; при превышении диапазона переключается на большой.

Конфигурация (в любом порядке — v1.3)

Сначала класс датчика один раз, затем модели по каналам в любом порядке. На прошивке v1.3 запись REG_CT_MODEL только подготавливает значение; привязка выполняется поканальной командой CMD_SET_CT_MODEL_CHn, поэтому каналы никогда не перезаписывают друг друга. (Обходной приём «обратного порядка» касался только прошивки старше v1.3 и больше не нужен.)

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);  // once

// Order is arbitrary — staging is decoupled from binding.
dev.setCTModel(0, RbAmpCTModel::Sct013_005);   // ch0 (range 0..5 A)
dev.setCTModel(1, RbAmpCTModel::Sct013_030);   // ch1 (range 0..30 A)

Итоговое состояние: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓

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

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

C++
float read_combined_current(RbAmp& dev) {
    const float i_low  = dev.readCurrent(0);   // small clamp
    const float i_high = dev.readCurrent(1);   // large clamp

    // While the small clamp is well clear of saturation, it gives
    // better accuracy at low currents. We switch to the large one as
    // it approaches the overload point.
    //
    // The 4.5 A threshold for the SCT-013-005 is PROVISIONAL; the exact
    // value will be determined by bench validation (see below).
    // Behavior in the vicinity of the threshold is a matter of
    // measurement, not estimation.
    if (!isnan(i_low) && i_low < 4.5f) {
        return i_low;
    }
    return i_high;
}

Установка двух CT: два клеща на одном проводе L, малого и большого диапазона, оба стрелками к нагрузке.

Примечание

⚙ Ограничение. Данные по использованию двух ТТ на малых токах (поведение около порога, температурный дрейф, расхождение двух клещей в перекрывающемся диапазоне) не публикуются. Считайте схему с двумя ТТ пилотным шаблоном; для ответственных применений предпочтителен один клещ, подобранный под верхний предел диапазона нагрузки.

Подходы к повышению чувствительности на малых токах

Если нагрузка имеет широкий динамический диапазон (например, 1 Вт в режиме ожидания у роутера и 2000 Вт у погружного нагревателя на той же розетке), один клещ, рассчитанный на верхний предел, теряет малые токи в шуме.

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

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

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

  3. Заводской уровень шума: калибровка модуля уже учитывает его шум. Со стороны пользователя ничего делать не нужно, кроме setSensorClass() + setCTModel(). Конкретные цифры точности на малых токах не публикуются.

Режим production и режим заводской настройки (справка по сохранению)

Модуль rbAmp работает в двух режимах, которые различаются тем, что именно сохраняется во флеш. Текущий режим читается из соответствующего регистра состояния.

Команда (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 ❌ ЗАБЛОКИРОВАНО в production (тихий отказ; REG_ERROR=0xFE; перезагрузка откатывает) усиления / NF / фаза (заводская калибровка)
CMD_FACTORY_RESET ❌ ЗАБЛОКИРОВАНО в production —

В производственном режиме записи заводской калибровки (CMD_SAVE_GAINS, CMD_FACTORY_RESET) отвергаются прошивкой — это защищает от случайной перезаписи заводских коэффициентов. Перевод в заводской режим — операция стороны производителя.

Обратное чтение ≠ сохранение.

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

C++
dev.setCTModel(code);
dev.reset();                     // CMD_RESET 0x01, works in production
delay(300);                      // boot complete
uint8_t check = dev.ctModel(0);
assert(check == code);           // ONLY now is persistence confirmed

✅ REG_I2C_ADDRESS (0x30) читает АКТИВНЫЙ адрес при загрузке (v1.3). После перезагрузки после фиксации чтение 0x30 покажет новый активный адрес. Эхо промежуточной записи (после записи мастером) остаётся по замыслу до CMD_COMMIT_ADDR и сброса.

Перекрёстная ссылка: 09 · Справочник API — подробности по конкретным опкодам, 10 · Устранение неполадок — что делать, если сохранение не подтверждается.

Что дальше


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