rbAmp
RU
Магазин
Документация
Обновлено · Редактировать на GitHub (Edit on GitHub)

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

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

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

  1. Какой токовый датчик выбрать для заданной нагрузки.
  2. Как сообщить модулю 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). Выбирайте по нужному номиналу.

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

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

Одно правило: выберите наименьшие клещи с номиналом выше вашего наибольшего ожидаемого тока плюс запас 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:

Text
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Примечание

Модель CT — функциональный пресет, а не метка. Запись модели CT сразу применяет базовую линию NF, усиление и коэффициент формы — показания тока меняются. Смена sensor_class сбрасывает CT_MODEL на значение по умолчанию и требует установить его снова.

Python
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 — обе формы эквивалентны:

Python
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():

Python
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):

Python
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, больше не нужен.

Python
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. ✓

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

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

Python
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

Два клеща разного номинала на одном проводе L, обе стрелки к нагрузке

Примечание

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

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

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

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

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

  2. Топология dual-CT (нужен SKU UI2/UI3): малые клещи на нижнем диапазоне и большие на верхнем, мастер выбирает по порогу. См. раздел «Dual-CT topology» выше — шаблон пилотный; данных по dual-CT при малых токах не публикуется.

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

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