03 · Выбор токового датчика
Эта глава отвечает на два вопроса:
- Какой токовый датчик выбрать для заданной нагрузки.
- Как сообщить модулю 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. Всегда выбирайте по нужному номиналу, а не по порядку кодов.
Как выбрать правильную модель
Базовое правило:
-
Определите максимальный ток, который может протекать в цепи (самая большая нагрузка + 30 % запаса).
-
Модель считайте с этикетки, напечатанной на клещах.
- Одно правило: выбирайте наименьший клещ с номиналом выше вашего максимального ожидаемого тока. Клещ с малым номиналом упирается в пики и занижает показания; слишком большой клещ на малых токах шумит (SCT-013-100 на цепи 5 А работает, но с плохим разрешением).
Запас
Токовый клещ 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), и её нужно задать заново.
#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():
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 (вводной кабель).
Способ 1: configureChannels() — один вызов, один цикл записи во флеш (рекомендуется)
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):
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) библиотеки объединяет оба шага.
Если все каналы получают одну и ту же модель, порядок не важен (побочный эффект идемпотентен):
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)
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 и больше не нужен.)
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. ✓
Логика агрегации на стороне мастера
Самый простой шаблон — включить по порогу:
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;
}
⚙ Ограничение. Данные по использованию двух ТТ на малых токах (поведение около порога, температурный дрейф, расхождение двух клещей в перекрывающемся диапазоне) не публикуются. Считайте схему с двумя ТТ пилотным шаблоном; для ответственных применений предпочтителен один клещ, подобранный под верхний предел диапазона нагрузки.
Подходы к повышению чувствительности на малых токах
Если нагрузка имеет широкий динамический диапазон (например, 1 Вт в режиме ожидания у роутера и 2000 Вт у погружного нагревателя на той же розетке), один клещ, рассчитанный на верхний предел, теряет малые токи в шуме.
Три стратегии в порядке возрастания сложности:
-
Подбирайте ТТ по максимуму, а не «с запасом». Самая частая ошибка — ставить SCT-013-100 (100 А) на бытовую розетку с типичным потреблением 0.5–10 А. Сигнал лежит в нижних 1–10 % диапазона датчика, где шум становится соизмерим с сигналом. Для бытового сценария (розетка 16 А) оптимален SCT-013-030; для подключения одного прибора (≤ 5 А) — SCT-013-005.
-
Топология с двумя CT (нужен SKU I2/I3 — два токовых канала на одном модуле): малый клещ для нижнего диапазона и большой для верхнего, мастер выбирает по порогу. См. раздел «Топология с двумя CT» выше — схема пилотная, цифры по ней не публикуются.
-
Заводской уровень шума: калибровка модуля уже учитывает его шум. Со стороны пользователя ничего делать не нужно, кроме
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 и прочитать значение снова:
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 · Устранение неполадок — что делать, если сохранение не подтверждается.
Что дальше
-
04 · Подключение — физическое подключение клещей, ориентация стрелки, полярность L/N
-
05 · Быстрый старт — полный скетч первого запуска
-
06 · Примеры — рабочие сценарии для разных нагрузок
-
10 · Устранение неполадок — что делать, если показания странные (отрицательный PF, нестабильный I и т. п.)
Исходный код и задачи: rb-amp/rbamp-arduino · эта страница в репозитории: docs/03_sensor_selection.md (v1.6.2)