03 · Выбор токового датчика
Эта глава отвечает на два вопроса:
- Какой токовый датчик выбрать для заданной нагрузки.
- Как сообщить модулю rbAmp ваш выбор, чтобы заводская калибровка для этой комбинации загрузилась автоматически.
Физическая проводка датчика (ориентация клещей, проверка полярности L/N) описана в 04_hardware.md. Эта глава — о выборе модели и вызовах API.
Класс датчика
Модули rbAmp работают с клещами CT из семейства SCT-013. Класс датчика определяется ревизией железа модуля и задаётся на заводе; пользователь сообщает свой выбор через dev.set_sensor_class() до выбора конкретной модели CT-клещей.
Выбор модели 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}. Вызов dev.set_ct_model_ch(ch, code) с кодом вне этого набора, например 0 или 8 (или передача такого кода в dev.configure_channels(...)), выбрасывает RbAmpParamError — библиотека не отправляет запись на устройство (клиентская проверка _validate_ct_code, REG_ERROR на устройстве остаётся 0x00).
Допустимые наборы по классам: - RbAmpSensorClass.SCT_013 → {1, 2, 3, 4, 5, 6, 7} - RbAmpSensorClass.WIRED_CT → {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12} (ряд заводски спаренных клещей; коды 11 и 13 недоступны) - RbAmpSensorClass.BUILTIN_CT → ∅ (встроенный CT, кодов нет)
Коды 0x06 и 0x07 не монотонны по номиналу (добавлены после исходных 0x01..0x05). Выбирайте по нужному номиналу.
Как выбрать нужную модель
Одно правило: выберите наименьшие клещи с номиналом выше вашего наибольшего ожидаемого тока плюс запас 30 %. Слишком большие клещи (например, 100 А на цепи, которая никогда не превышает 5 А) тоже работают, но дают низкое разрешение и большую погрешность при типичных значениях.
Запас
Токовые клещи SCT-013 работают без насыщения в пределах своего номинала. Кратковременные пики (пусковой ток компрессора, индуктивная нагрузка) могут превышать номинал — клещи это выдерживают, но выше номинала измерение становится нелинейным.
Учитывайте обычный пусковой ток как часть вашего «наибольшего ожидаемого тока». Например, для стиральной машины с пусковым током 12 A (и 2–3 A в работе): 12 A × 1.3 = 15.6 A, поэтому наименьшие подходящие клещи выше этого значения — SCT-013-020 (код 6).
Как сообщить модулю ваш выбор
Два вызова в правильном порядке обязательны — сначала dev.set_sensor_class(), затем dev.set_ct_model(). Если вызвать dev.set_ct_model() до dev.set_sensor_class(), пакет выбрасывает RbAmpModeError:
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Модель CT — функциональный пресет, а не метка. Запись модели CT сразу применяет базовую линию NF, усиление и коэффициент формы — показания тока меняются. Смена sensor_class сбрасывает CT_MODEL на значение по умолчанию и требует установить его снова.
from rbamp import RbAmp, RbAmpSensorClass, RbAmpModeError
with RbAmp(bus, 0x50) as dev:
# Step 1: sensor class. MANDATORY before set_ct_model().
try:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
except RbAmpModeError as e:
# Possible causes: communication failure (see 10 · Troubleshooting),
# invalid argument (cls outside the known values)
print("set_sensor_class failed:", e)
raise SystemExit(1)
# Step 2: 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.
try:
dev.set_ct_model(3) # e.g. SCT-013-030
except RbAmpModeError:
print("Sensor class must be set first")
except ValueError:
print("Code not in per-class accept-set (SCT_013: {1,2,3,4,5,6,7})")
set_sensor_class() принимает либо перечисление, либо обычный int — обе формы эквивалентны:
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
Пакет намеренно НЕ вызывает set_sensor_class() за вас. Если этот шаг пропущен, set_ct_model() возбуждает RbAmpModeError без записи во flash. Так задумано, чтобы поведение было предсказуемым и явным — никакой «магии» в публичном API.
После этих двух вызовов:
-
Модуль сохраняет оба значения во flash — настройка переживает сброс, отключение питания и перепрошивку.
-
Коэффициенты калибровки для этой конкретной комбинации (класс датчика + модель) загружаются из заводской таблицы пресетов. Трогать ручные регистры калибровки не нужно.
-
Следующее чтение
dev.current[0](илиdev.read_current(0)) уже вернёт значение в амперах с правильным масштабом.
Общее время обоих вызовов около 1.4 секунды (две операции записи во флеш по ~700 мс каждая, ограничено временем стирания страницы флеша). Выполняется один раз при первой установке; настройка сохраняется во флеш и не повторяется.
Если вы уже выбрали датчик при первом запуске и просто перезапускаете скрипт, повторять set_sensor_class() и set_ct_model() не нужно — модуль помнит прежний выбор. Но и вреда нет: повторный вызов с тем же значением просто перезапишет тот же байт.
Смена модели и перезапуск. На прошивке модуля до 1.4.19 смена модели перезапускает модуль один раз (около секунды); начиная с 1.4.20 модуль корректирует себя сам. Коррекция по номиналу SCT масштабирует ток, мощность и энергию, но никогда не напряжение или коэффициент мощности.
Проверка настройки
Простая проверка после set_ct_model():
import time
from rbamp import RbAmp, RbAmpSensorClass
def sanity_check(dev):
print("Ready. Connect a purely resistive load",
"(e.g. an incandescent lamp).")
print("Expect a stable PF ~= 1.0 and a positive P.")
while True:
u = dev.voltage # property — one I²C transaction
i = dev.read_current(0)
p = dev.read_power(0)
pf = dev.read_power_factor(0)
print(f"U={u:.1f} V I={i:.2f} A P={p:.1f} W PF={pf:.2f}")
time.sleep(2)
with RbAmp(bus, 0x50) as dev:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
dev.set_ct_model(3)
sanity_check(dev)
На MicroPython замените time.sleep(2) на time.sleep_ms(2000).
На чисто активной нагрузке (лампа накаливания, электрочайник, нагревательный элемент) ожидайте:
U≈ 220–240 В (для сети 230 В)I≈ соответствует мощности нагрузки (P / U)P> 0 и стабильноPF≈ 1.0 (определённо положительный)
Если что-то не сходится, см. 10_troubleshooting.md.
Модули с несколькими токовыми каналами
Линейка SKU — что подходит для задачи
| SKU | каналы I | Канал U | Типичное применение |
|---|---|---|---|
| UI1 | 1 | да | Одна нагрузка с полным расчётом мощности (P, PF) |
| UI2 | 2 | да | Две независимые нагрузки на одной фазе (вводной щиток + крупный потребитель) |
| UI3 | 3 | да | Три независимые нагрузки на одной фазе |
| I1 | 1 | нет | Субсчётчик без расчёта мощности (только ток) |
| I2 | 2 | нет | Два субсчётчика или топология с двумя CT на одной линии |
| I3 | 3 | нет | Три субсчётчика, или dual-CT + третий токовый канал |
Что измеряет каждый канал
- Канал U (только UI): U_rms, U_peak, частота. Один* на модуль.
- Каналы I (все артикулы): каждый канал независимо — I_rms, I_peak, P (активная мощность), PF, avg_p за период.
- Варианты I: I1/I2/I3 не имеют канала U — вычислить P/PF на устройстве невозможно (только I_rms по каналам).
- Однофазный модуль: токовые UI2/I2/I3 однофазные. Все I-каналы должны быть на одной фазе (или, для I-вариантов, тоже на одной фазе, если хотите корректно считать P на стороне мастера).
Модель CT на канал — независимая калибровка
На модулях UI2, I2 и I3 у каждого токового канала независимый выбор модели SCT-013. Можно подключить, например, SCT-013-005 на канале 0 (одна розетка), SCT-013-030 на канале 1 (линия плиты) и SCT-013-020 на канале 2 (средний ввод — только I3).
API выбора по каналу — dev.set_ct_model_ch(channel, code):
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once for all channels
# Binding order does NOT matter.
dev.set_ct_model_ch(0, 1) # channel 0: SCT-013-005
dev.set_ct_model_ch(1, 3) # channel 1: SCT-013-030
dev.set_ct_model_ch(2, 6) # channel 2: SCT-013-020 (I3 only)
✅ Порядок привязки каналов не имеет значения. Запись REG_CT_MODEL (0x05) лишь подготавливает значение, но больше не применяет его к ch0 автоматически. Применение происходит только через CMD_SET_CT_MODEL_CHn. Поэтому каналы можно настраивать в любом порядке — без перезаписи.
Однокомпонентный dev.set_ct_model(code) — удобная форма для однокалибровочных артикулов (применяется к каналу 0). На многоканальных модулях он эквивалентен dev.set_ct_model_ch(0, code).
Расширенная настройка: два клеща разного номинала на одном проводе
⚙ Дополнительный паттерн, а не базовый. Этот раздел описывает необязательную технику для повышения разрешения при малых токах. Для большинства установок достаточно одних клещей, подобранных под диапазон нагрузки. Dual-CT используйте, только если есть конкретное требование к точности при токах < 1 A.
Когда это применяется
- Многоканальные модули UI2 / I2 / I3 (минимум 2 токовых канала).
-
Один и тот же провод нужно измерять с одинаковым качеством и для малых нагрузок (≤ 1 А), и для пиковых событий (≥ 5 А).
-
Типичный пример: квартирный вводной щиток, где днём 50–100 Вт в режиме ожидания, а вечером — бросок чайника или плиты на 3+ кВт.
Идея
Два SCT-013 разных номиналов установлены на одном проводе:
-
Канал 0 — малые клещи (например, SCT-013-005, 5 А): видят малые токи с лучшим разрешением и меньшим шумовым порогом.
-
Канал 1 — большая клипса (например, SCT-013-030 или выше): обрабатывает токи выше порога перегрузки малой клипсы без насыщения.
Мастер сам выбирает канал по текущему значению: пока малые клещи в линейном диапазоне, их показание точнее; как только он превышен, мастер переключается на большие.
Конфигурация (порядок не важен)
Сначала класс датчика один раз, затем модели по каналам в любом порядке. На текущей прошивке запись REG_CT_MODEL (0x05) только ставит в очередь значение; привязка к конкретному каналу происходит исключительно через опкод по каналу CMD_SET_CT_MODEL_CHn. Устаревший обходной путь «нисходящего порядка», нужный на прошивке v1.2, больше не нужен.
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once
# Any order is valid — each call binds its own channel.
dev.set_ct_model_ch(0, 1) # ch0 = SCT-013-005 (0..5 A)
dev.set_ct_model_ch(1, 3) # ch1 = SCT-013-030 (0..30 A)
Итоговое состояние: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Логика агрегации на стороне мастера
Самый простой шаблон — включить по порогу:
import math
def read_combined_current(dev):
"""Read the combined current — picks low-CT when in its linear range,
otherwise falls back to the high-CT.
"""
i_low = dev.read_current(0) # the small clamp
i_high = dev.read_current(1) # the large clamp
# While the small clamp is far from saturation, it gives better
# accuracy at low currents. Switch to the large one when
# approaching the overload point.
#
# The 4.5 A threshold for SCT-013-005 is an example value;
# pick the switch-over point for your own installation.
if not math.isnan(i_low) and i_low < 4.5:
return i_low
return i_high
⚙ Данные для двойного CT. Цифры для двойного CT при малых токах не публикуются (поведение вблизи порога, дрейф температуры, расхождение двух клещей в зоне перекрытия). Считайте двойной CT пилотным шаблоном; для критичных применений предпочтительнее один клещ, подобранный под верхний край диапазона нагрузки.
Подходы к повышению чувствительности на малых токах
Если у вашей нагрузки большой динамический диапазон (например, 1 Вт в режиме ожидания у роутера и 2000 Вт у водонагревателя на той же розетке), один клещ, рассчитанный на верхний предел, теряет малые токи в шуме.
Три стратегии в порядке возрастания сложности:
-
Подбирайте CT по наибольшему ожидаемому току (правило выше). Самая частая ошибка — ставить SCT-013-100 (100 A) на бытовую розетку с типичным потреблением 0.5–10 A. Сигнал лежит в нижних 1–10% входного диапазона, где шум становится сопоставим с сигналом. Для бытового сценария (розетка 16 A) оптимален SCT-013-030; для подключения одного прибора (≤ 5 A) — SCT-013-005.
-
Топология dual-CT (нужен SKU UI2/UI3): малые клещи на нижнем диапазоне и большие на верхнем, мастер выбирает по порогу. См. раздел «Dual-CT topology» выше — шаблон пилотный; данных по dual-CT при малых токах не публикуется.
-
Шумовой порог обрабатывается на заводе. Со стороны пользователя ничего не нужно, кроме
set_sensor_class()+set_ct_model(). Данные по low-current dual-CT не публикуются.
Режим 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 (0x26) |
❌ ЗАБЛОКИРОВАНО в продакшене (возвращает DEV_ERR_PARAM; перезагрузка откатывает изменение) — только для завода |
усиления / NF / фаза (заводская калибровка) |
CMD_FACTORY_RESET |
❌ ЗАБЛОКИРОВАНО в production | — |
В продуктивном режиме записи заводской калибровки отклоняются прошивкой — защита от случайного стирания заводских коэффициентов.
. Защита продакшена принимает запись в RAM (последующее чтение вернёт записанное), но сохранение во flash может быть отклонено. Единственный корректный способ подтвердить сохранение — перезагрузить модуль через CMD_RESET и прочитать заново:
dev.set_ct_model(code)
dev.reset() # CMD_RESET 0x01, works in production
time.sleep(0.3) # boot complete (300 ms)
check = dev.read_reg(0x05)
assert check == code # ONLY now is persistence confirmed
Адрес — исключение: REG_I2C_ADDRESS читает активный адрес при загрузке. После постановки в очередь он эхом повторяет кандидата до CMD_COMMIT_ADDR + сброса.
Перекрёстная ссылка: 09 · Справочник API — подробности о конкретных опкодах; 10 · Устранение неполадок — что делать, если сохранение не подтверждается.
Что дальше
-
04 · Подключение — физическое подключение клещей, ориентация стрелки, полярность L/N
-
05 · Быстрый старт — полный скрипт первого запуска для обоих бэкендов
-
06 · Примеры — рабочие сценарии для разных потребителей
-
10 · Troubleshooting — что делать, если показания выглядят странно (отрицательный PF, нестабильный I и т.д.)
Исходники и задачи: rb-amp/rbamp-python · эта страница в репозитории: docs/03_sensor_selection.md (v1.6.1)