03 · Selección de sensor de corriente
Este capítulo responde a dos preguntas:
- Qué sensor de corriente elegir para una carga dada.
- Cómo indicarle al módulo rbAmp su elección para que la calibración de fábrica de esa combinación se cargue automáticamente.
El cableado físico del sensor (orientación de la pinza, comprobación de polaridad L/N) se trata en 04_hardware.md. Este capítulo trata de elegir el modelo y de las llamadas a la API.
Clase de sensor
Los módulos rbAmp funcionan con pinzas CT de la familia SCT-013. La clase de sensor la determina la revisión de hardware del módulo y se fija en fábrica; el usuario indica su elección mediante dev.set_sensor_class() antes de seleccionar un modelo concreto de pinza CT.
Elegir un modelo SCT-013
Dentro de la familia SCT-013 se admiten siete modelos (códigos {1, 2, 3, 4, 5, 6, 7}).
code |
Modelo | Rango de corriente | Estado | Uso típico |
|---|---|---|---|---|
| 1 | SCT-013-005 | 0…5 A | ✅ caracterizado | Cargas pequeñas: lámparas, electrónica de bajo consumo, un único interruptor |
| 2 | SCT-013-010 | 0…10 A | ✅ caracterizado | Un electrodoméstico de potencia media: nevera, lavadora, aire acondicionado de hasta 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ caracterizado | Acometida doméstica de tamaño medio: hasta ~7 kW |
| 4 | SCT-013-050 | 0…50 A | ✅ caracterizado | Entrada de servicio grande: calefacción eléctrica, cargador de VE, vivienda unifamiliar con cargas de pico |
| 5 | SCT-013-100 | 0…100 A | ✅ caracterizado | Entrada de servicio principal |
| 6 | SCT-013-020 | 0…20 A | ✅ caracterizado | Acometida media: electrodomésticos de 3–4 kW y equipamiento doméstico pesado |
| 7 | SCT-013-060 | 0…60 A | ✅ caracterizado | Submedidor industrial |
Códigos aceptados — {1, 2, 3, 4, 5, 6, 7}. Llamar a dev.set_ct_model_ch(ch, code) con un código fuera de este conjunto, por ejemplo 0 u 8 (o pasar ese código a dev.configure_channels(...)), lanza RbAmpParamError: la biblioteca no envía la escritura al dispositivo (protección en el cliente _validate_ct_code; REG_ERROR en el dispositivo se mantiene en 0x00).
Conjuntos aceptados por clase: - RbAmpSensorClass.SCT_013 → {1, 2, 3, 4, 5, 6, 7} - RbAmpSensorClass.WIRED_CT → {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12} (serie de pinzas emparejadas de fábrica; los códigos 11 y 13 no están disponibles) - RbAmpSensorClass.BUILTIN_CT → ∅ (CT integrado, sin códigos)
Los códigos 0x06 y 0x07 no son monótonos por potencia nominal (se añadieron tras los originales 0x01..0x05). Elija según la potencia nominal que necesite.
Cómo elegir el modelo adecuado
La regla única: elija la pinza de menor calibre por encima de su mayor corriente prevista más un margen del 30 %. Una pinza sobredimensionada (por ejemplo, una de 100 A en un circuito que nunca supera 5 A) sigue funcionando, pero da poca resolución y un error grande con valores típicos.
Margen
Una pinza SCT-013 funciona sin saturación dentro de su rango nominal. Los picos breves (arranque de compresor, carga inductiva) pueden superar la nominal: la pinza lo soporta, pero por encima de la nominal la medición deja de ser lineal.
Cuente un arranque habitual como parte de su «mayor corriente esperada». Por ejemplo, para una lavadora con 12 A de corriente de arranque (y 2–3 A en funcionamiento): 12 A × 1.3 = 15.6 A, así que la pinza nominal inmediatamente superior es la SCT-013-020 (código 6).
Cómo indicar al módulo su elección
Dos llamadas en el orden correcto son obligatorias: primero dev.set_sensor_class() y después dev.set_ct_model(). Si llama a dev.set_ct_model() antes que a dev.set_sensor_class(), el paquete lanza RbAmpModeError:
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Modelo de CT: un preajuste funcional, no una etiqueta. Escribir el modelo de CT aplica de inmediato la línea base NF, la ganancia y el factor de forma: las lecturas de corriente cambian. Cambiar sensor_class restablece CT_MODEL a su valor por defecto y hay que volver a fijarlo.
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() acepta una enumeración o un int simple: ambas formas son equivalentes:
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
El paquete NO llama deliberadamente a set_sensor_class() en su nombre. Si se omite este paso, set_ct_model() lanza RbAmpModeError sin escribir en la flash. Es por diseño, para que el comportamiento sea previsible y explícito: sin «magia» en la API pública.
Tras estas dos llamadas:
-
El módulo guarda ambos valores en flash: el ajuste sobrevive a un reinicio, a un corte de alimentación y a un reflasheo del firmware.
-
Los coeficientes de calibración de esa combinación concreta (clase de sensor + modelo) se cargan desde la tabla de valores de fábrica. No necesita tocar ningún registro de calibración manual.
-
La siguiente lectura de
dev.current[0](odev.read_current(0)) ya devuelve un valor en amperios con la escala correcta.
Tiempo total de ambas llamadas de unos 1.4 segundos (dos operaciones de escritura en flash × ~700 ms cada una, limitadas por el tiempo de borrado de página de la flash). Se hace una vez en la primera instalación; el ajuste se guarda en flash y no se repite.
Si ya eligió el sensor en la primera ejecución y solo reinicia el script, no hace falta repetir las llamadas set_sensor_class() y set_ct_model(): el módulo recuerda la elección anterior. Pero tampoco hay ningún problema en repetirlas: llamar de nuevo con el mismo valor solo reescribe el mismo byte.
Cambio de modelo y reinicio. En el firmware del módulo hasta la 1.4.19, un cambio de modelo reinicia el módulo una vez (alrededor de un segundo); desde la 1.4.20 el módulo se corrige solo. La corrección de la clasificación SCT escala la corriente, la potencia y la energía, nunca la tensión ni el factor de potencia.
Verificación de la configuración
Una comprobación sencilla tras 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)
En MicroPython, sustituya time.sleep(2) por time.sleep_ms(2000).
Con una carga puramente resistiva (lámpara incandescente, hervidor eléctrico, resistencia calefactora) debe esperar:
U≈ 220–240 V (para red de 230 V)I≈ coincide con la potencia de la carga (P / U)P> 0 y establePF≈ 1.0 (claramente positivo)
Si algo no cuadra, véase 10_troubleshooting.md.
Módulos con varios canales de corriente
Gama de SKU — qué encaja con cada tarea
| SKU | Canales I | Canal U | Uso típico |
|---|---|---|---|
| UI1 | 1 | sí | Una carga con cálculo completo de potencia (P, PF) |
| UI2 | 2 | sí | Dos cargas independientes en la misma fase (entrada de servicio + un consumidor grande) |
| UI3 | 3 | sí | Tres cargas independientes en la misma fase |
| I1 | 1 | no | Submedidor sin cálculo de potencia (solo corriente) |
| I2 | 2 | no | Dos submedidores, o una topología de doble CT en una sola línea |
| I3 | 3 | no | Tres submedidores, o doble CT más un tercer canal de corriente |
Qué mide cada canal
- Canal U (solo UI): U_rms, U_pico, frecuencia. Uno* por módulo.
- Canales I (todos los SKU): cada canal de forma independiente: I_rms, I_peak, P (potencia activa), PF, avg_p por periodo.
- Variantes I: I1/I2/I3 no tienen canal U; el cálculo de P/PF no es posible en el dispositivo (solo I_rms por canal).
- Módulo monofásico: las corrientes UI2/I2/I3 son monofásicas. Todos los canales I deben estar en la misma fase (o, en las variantes I, también en la misma fase si quiere calcular P correctamente en el lado del maestro).
Modelo de CT por canal: calibración independiente
En los módulos UI2, I2 e I3, cada canal de corriente tiene una selección de modelo SCT-013 independiente. Puede conectar, por ejemplo, un SCT-013-005 en el canal 0 (una sola toma), un SCT-013-030 en el canal 1 (una línea de cocina) y un SCT-013-020 en el canal 2 (una acometida media: solo I3).
La API para la selección por canal es 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)
✅ El orden de asociación de canales no importa. Escribir REG_CT_MODEL (0x05) prepara el valor, pero ya no lo aplica automáticamente a ch0. La aplicación se hace solo mediante CMD_SET_CT_MODEL_CHn. Esto significa que puede configurar los canales en cualquier orden sin sobrescribir nada.
La forma de un solo argumento dev.set_ct_model(code) es una forma de conveniencia para variantes de un solo canal (se aplica al canal 0). En módulos multicanal equivale a dev.set_ct_model_ch(0, code).
Configuración avanzada: dos pinzas de distinto calibre en un mismo cable
⚙ Un patrón adicional, no el básico. Esta sección describe una técnica opcional para mejorar la resolución a corrientes bajas. En la mayoría de instalaciones basta una pinza ajustada al rango de carga. Use el doble CT solo si tiene un requisito de precisión concreto a corrientes < 1 A.
Cuándo aplica
- Módulos multicanal UI2 / I2 / I3 (al menos 2 canales I).
-
El mismo cable debe medirse con igual calidad tanto para cargas pequeñas (≤ 1 A) como para eventos de pico (≥ 5 A).
-
Un ejemplo típico: la entrada de servicio de un piso donde durante el día hay 50–100 W de consumo en reposo, y por la noche un hervidor o una cocina con un pico de arranque de 3+ kW.
La idea
Dos pinzas SCT-013 de clasificaciones distintas se instalan en el mismo cable:
-
Canal 0: la pinza pequeña (p. ej., SCT-013-005, 5 A): ve corrientes pequeñas con mejor resolución y un suelo de ruido más bajo.
-
Canal 1 — la pinza grande (p. ej., SCT-013-030 o superior): maneja corrientes por encima del punto de sobrecarga de la pinza pequeña sin saturarse.
El propio maestro elige qué canal usar según el valor de corriente: mientras la pinza pequeña está en su rango lineal, su lectura es más precisa; al superarlo, cambia a la grande.
Configuración (independiente del orden)
Primero la clase de sensor una vez, luego los modelos por canal en cualquier orden. En el firmware actual, escribir REG_CT_MODEL (0x05) solo prepara el valor; la vinculación a un canal concreto se hace exclusivamente mediante el opcode por canal CMD_SET_CT_MODEL_CHn. El método heredado de «orden descendente» que exigía el firmware v1.2 ya no es necesario.
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)
Estado final: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Lógica de agregación en el lado del maestro
El patrón más sencillo es activar con un umbral:
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
⚙ Cifras de doble pinza. No se publican las cifras para uso de doble pinza con corriente baja (comportamiento cerca del umbral, deriva térmica, divergencia de las dos pinzas en el rango de solapamiento). Trate la doble pinza como un patrón piloto; para aplicaciones críticas es preferible una pinza única ajustada al extremo superior del rango de carga.
Enfoques para mejorar la sensibilidad a corrientes bajas
Si su carga tiene un gran rango dinámico (por ejemplo, 1 W de consumo en reposo de un router frente a un calentador de agua de 2000 W en la misma toma), una única pinza dimensionada para el límite superior pierde las corrientes bajas en el ruido.
Tres estrategias en orden creciente de complejidad:
-
Dimensione el CT para la mayor corriente esperada (la regla anterior). El error más común es poner un SCT-013-100 (100 A) en una toma doméstica con un consumo típico de 0.5–10 A. La señal queda en el 1–10% inferior del rango de entrada, donde el ruido se vuelve comparable a la señal. Para un escenario doméstico (toma de 16 A) el SCT-013-030 es el óptimo; para conectar un solo aparato (≤ 5 A), el SCT-013-005.
-
Topología de doble CT (requiere una SKU UI2/UI3): una pinza pequeña para el rango bajo y una grande para el alto, eligiendo el maestro según un umbral. Véase la sección «Topología de doble CT» de arriba: el patrón es piloto; las cifras de doble CT a corrientes bajas no se publican.
-
El suelo de ruido lo gestiona la fábrica. Por parte del usuario, no hay nada que hacer más allá de
set_sensor_class()+set_ct_model(). Las cifras para el uso de doble CT a corrientes bajas no se publican.
Modo de producción frente a modo de fábrica (referencia de persistencia)
El módulo rbAmp funciona en dos modos, que se diferencian en qué se guarda exactamente en la flash.
| Comando (opcode) | Producción | Persiste |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / CT por canal / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, armado con número mágico) |
✅ OK | Dirección I²C (confirmación de dirección en dos fases, véase 04 · Cableado) |
CMD_RESET (0x01) |
✅ OK | — (reinicio por software) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (instantánea de periodo) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS (0x26) |
❌ BLOQUEADO en producción (devuelve DEV_ERR_PARAM; el reinicio revierte el cambio) — solo de fábrica |
ganancias / NF / fase (calibración de fábrica) |
CMD_FACTORY_RESET |
❌ BLOQUEADO en producción | — |
En modo de producción, el firmware rechaza las escrituras de calibración de fábrica, como protección contra borrar por accidente los coeficientes de fábrica.
. El guardia de producción acepta la escritura en RAM (una lectura posterior devuelve lo escrito), pero el guardado en flash puede ser rechazado. La única forma válida de confirmar la persistencia es reiniciar el módulo mediante CMD_RESET y volver a leer:
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
La dirección es una excepción: REG_I2C_ADDRESS lee la dirección activa al arrancar. Tras prepararla, devuelve eco del candidato hasta CMD_COMMIT_ADDR + reinicio.
Enlace cruzado: 09 · Referencia de la API — detalles de opcodes concretos; 10 · Solución de problemas — qué hacer si no se confirma la persistencia.
Lo que viene después
-
04 · Cableado — conexión física de la pinza, orientación de la flecha, polaridad L/N
-
05 · Inicio rápido — el script completo de primera luz para ambos backends
-
06 · Ejemplos — escenarios de trabajo para distintos consumidores
-
10 · Solución de problemas: qué hacer si las lecturas parecen raras (PF negativo, I inestable, etc.)
Fuente e incidencias: rb-amp/rbamp-python · esta página en el repositorio: docs/03_sensor_selection.md (v1.6.1)