rbAmp
ES
Tienda
Docs
Actualizado · Editar en GitHub [Edit on GitHub]

03 · Selección de sensor de corriente

Instalación de la pinza de CT: sujete solo el cable L, con la flecha apuntando hacia la carga.

Este capítulo responde a dos preguntas:

  1. Qué sensor de corriente elegir para una carga dada.
  2. 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.

La conexión física del sensor (orientación de la pinza, comprobación de polaridad L/N) se trata en 04_hardware.md. Este capítulo trata de la selección del modelo y de la llamada a la API.

Clase de sensor

Los módulos rbAmp funcionan con pinzas de corriente de la familia SCT-013. La clase de sensor de una pinza SCT-013 de montaje libre que usted instala se establece una sola vez con setSensorClass(Sct013), antes de elegir el modelo. Si su módulo llegó con el TC ya conectado, omita los pasos de configuración de este capítulo.

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: frigorífico, 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 Acometida grande: calefacción eléctrica, cargador de VE, vivienda unifamiliar con cargas punta
5 SCT-013-100 0…100 A ✅ caracterizado Entrada principal de servicio de una vivienda u oficina pequeña
6 SCT-013-020 0…20 A ✅ caracterizado Entrada de servicio media: electrodomésticos de 3-4 kW, grandes electrodomésticos del hogar
7 SCT-013-060 0…60 A ✅ caracterizado Submedidor industrial
Nota

Códigos aceptados: {1, 2, 3, 4, 5, 6, 7}. Un código fuera de este conjunto (por ejemplo 0 u 8) pasado a dev.setCTModel(...) (o a configureChannels(...)) devuelve false con lastError() == RB_ERR_PARAM: la biblioteca no envía la escritura al dispositivo (guarda en el cliente).

Los códigos 0x06 y 0x07 no son monótonos según el calibre: se añadieron después del conjunto original 0x01..0x05. Elija siempre por el calibre que necesite, no por el orden de los códigos.

Cómo elegir el modelo adecuado

La regla básica:

  1. Determine la corriente máxima que puede circular por el circuito (mayor carga + 30 % de margen).

  2. Lea el modelo en la etiqueta impresa en la pinza.

  3. Una regla: elija la pinza de menor calibre por encima de su mayor corriente prevista. Una pinza de calibre demasiado pequeño recorta en los picos y lee demasiado bajo; una de calibre muy superior lee con ruido a corrientes pequeñas (una SCT-013-100 en un circuito de 5 A funciona, pero con mala resolución).

Cómo elegir una pinza SCT-013: tome la mayor corriente prevista más un 30 % de margen, elija la pinza de menor calibre por encima de ella y ajuste su código de modelo.

Margen

Una pinza SCT-013 funciona sin saturación dentro de su rango nominal. Los picos breves (arranque del compresor, carga inductiva) pueden superar el nominal en 5-7 veces; esto es normal, la pinza lo soporta físicamente, pero por encima del nominal la medición se vuelve no lineal.

Si su carga tiene una corriente de pico superior a la clasificación de la pinza, elija el tamaño inmediatamente superior: la pinza clasificada más pequeña por encima del pico más un margen del 30 %. Por ejemplo, para una lavadora con una corriente de arranque de 12 A (y 2-3 A en funcionamiento), 12 A × 1.3 = 15.6 A, así que elija un SCT-013-020 (no un SCT-013-005, que recortaría el pico).

Cómo informar al módulo de su elección

Se requieren dos llamadas en el orden correcto: primero setSensorClass() y después setCTModel(). Si llama a setCTModel() antes que a setSensorClass(), el módulo devuelve un error RB_ERR_PARAM y el preajuste NO se carga.

Nota

El modelo de CT es un preajuste funcional, no una etiqueta. Escribir el modelo de CT aplica de inmediato la calibración de fábrica de ese modelo de pinza a la cadena de medición del módulo; las lecturas de corriente cambian. Cambiar sensor_class restablece el modelo de CT a su valor por defecto (0) y obliga a volver a establecerlo.

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;
    }
}
Nota

La biblioteca NO llama a setSensorClass() por cuenta del usuario de forma intencionada. Si se omite este paso, setCTModel() devuelve false con RB_ERR_PARAM sin escribir en flash. Así el comportamiento es predecible 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 nuevo flasheo 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 llamada a dev.readCurrent(0) ya devuelve un valor en amperios con la escala correcta.

El tiempo total de ambas llamadas es 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 flash). Se hace una sola vez en la primera instalación; el ajuste se guarda en flash y no se repite.

Nota

Si ya seleccionó el sensor en el primer arranque y simplemente reinicia el controlador, no necesita repetir las llamadas setSensorClass() y setCTModel(): el módulo recuerda la elección anterior. Pero repetirlas tampoco hace daño: llamar de nuevo con el mismo valor solo reescribe el mismo byte.

Verificación de la configuración

Una comprobación sencilla tras 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);
}

Con una carga puramente resistiva (lámpara incandescente, hervidor eléctrico, elemento calefactor), espere:

  • U ≈ 220–240 V (para red de 230 V)
  • I ≈ la potencia de la carga (P / U)
  • P > 0 y estable
  • PF ≈ 1.0 (firmemente positivo)

Si algo no cuadra, consulte 10_troubleshooting.md.

Módulos con varios canales de corriente

La gama de SKU: qué encaja con cada tarea

SKU Canales I Canal U Uso típico
UI1 1 sí Una sola carga con cálculo completo de potencia (P, PF, Q, Wh): un contador de red típico
UI2 2 sí Dos cargas independientes en una fase con potencia por canal
UI3 3 sí 1 U + 3 I: tres cargas en una fase con potencia por canal (P, FP, Q, Wh)
I1 1 no Submedidor sin cálculo de potencia (solo corriente): cuando un UI1 aparte se encarga de la medición de la red
I2 2 no Submedidor de corriente de dos canales: desglose por circuito
I3 3 no Submedidor de corriente de tres canales: desglose por circuito / topología de doble TC

Qué mide cada canal

  • Canal U (solo UI): U_rms, U_pico, frecuencia. Uno* por módulo.
  • Canales I:
  • en variantes UI: cada canal aporta I_rms, I_pico, P (potencia activa), PF, avg_p durante el período.
  • en variantes I: solo corriente (I_rms, I_pico). La potencia activa y el PF no se calculan: requieren tensión, que la variante I no tiene. Los registros power[]/powerFactor[] en las variantes I devuelven 0.
  • Módulo monofásico: todos los canales I deben estar en la misma fase a la que está conectado el canal U.

Modelo de CT por canal: calibración independiente por canal

En los módulos multicanal (I2, I3), cada canal de corriente tiene una selección de modelo SCT-013 independiente. Puede, por ejemplo, conectar un SCT-013-005 al canal 0 (una sola toma), un SCT-013-030 al canal 1 (un circuito de cocina) y un SCT-013-020 al canal 2 (la acometida).

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

Una sola llamada configura la clase de sensor y todos los canales en una operación con un solo SAVE_USER_CONFIG. Medido en banco: ~1.4 segundos para 1-SAVE frente a ~3.5 segundos para 3 ciclos SAVE separados (setCTModel() + guardado manual). El punto clave: el desgaste de los ciclos de flash es 3× menor en la misma página de flash.

Método 2: setCTModel(channel, code) por canal — en cualquier orden

La API para la selección por canal es 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)
Seguridad

✅ El orden de asociación es arbitrario (v1.3). Escribir REG_CT_MODEL (0x05) solo prepara el valor, pero no lo aplica automáticamente a ningún canal. La aplicación ocurre únicamente mediante CMD_SET_CT_MODEL_CHn por canal, que toma el valor preparado actual y lo escribe en su canal. Los canales pueden configurarse en cualquier orden (setCTModel(0, ...) primero, último o intercalado: no importa); no se produce sobrescritura. Cualquier mención a «ascendente / descendente / asociar el canal 0 el último» en documentos y código antiguos se refiere al comportamiento anterior a la v1.3: puede eliminarse.

Dicho esto, vincular cada canal sigue siendo un proceso de dos pasos a nivel de protocolo de cable (preparar REG_CT_MODEL → vincular CMD_SET_CT_MODEL_CHn); el setCTModel(channel, code) de la biblioteca envuelve ambos pasos.

Si todos los canales reciben el mismo modelo, el orden no importa (el efecto secundario es idempotente):

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);
Compatibilidad con versiones anteriores

: la sobrecarga entera setCTModel(uint8_t code) se conserva. Equivalencia de la v1.3: 1=Sct013_005, 2=Sct013_010, 3=Sct013_030, 4=Sct013_050, 5=Sct013_100, 6=Sct013_020, 7=Sct013_060. La forma tipada RbAmpCTModel::Sct013_NNN es la recomendada (el compilador detecta los valores no válidos antes de la llamada al bus). En módulos multicanal, la forma de un solo argumento setCTModel(code) se aplica al canal 0; equivale a setCTModel(0, code).

Módulos multicanal — I2 e I3 (solo corriente)

El hardware actual para la topología multicanal es I2 (dos canales de corriente) e I3 (tres canales de corriente). Ambos módulos no tienen canal U, así que el cálculo de P / PF / Q en el lado del módulo no es posible: aportan corriente por canal (I_rms, I_pico en cada canal) y nada más.

UI2 (1 U + 2 I) y UI3 (1 U + 3 I) añaden el canal de tensión a la misma disposición multicanal, de modo que la potencia por canal se calcula en el propio módulo. Cuando no se necesita la potencia del lado del módulo, use I2/I3 como submedidores de corriente junto con un UI1 separado en la acometida, que proporciona la energía de red y la tensión.

Lectura de canales (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

Si necesita potencia activa en cada sublínea, instale un UI1 en la acometida y reparta su potencia total proporcionalmente a la corriente por canal I[k] de I2/I3. Es un despliegue doméstico típico (véase el capítulo 06 · Ejemplos, escenario 1).

Nota

Es una aproximación: dividir por corriente funciona cuando el factor de potencia es aproximadamente el mismo en todas las cargas. Para una medición de potencia precisa por carga, use una variante UI en cada línea (cuando estén disponibles UI2/UI3).

Aplicaciones I2 / I3

  • Submedición de corriente: desglose de corriente por circuito, con un único punto de instalación en el cuadro en lugar de un módulo por línea.

  • Desagregación combinada con UI1: UI1 aporta la energía / potencia de la red, e I2/I3 desglosan el consumo por ramal (véase el capítulo 06, escenario 1).

  • Monitorización de corriente sin medición de potencia: control de sobrecarga, detección de encendido/apagado de carga, perfil I(t).

  • Doble TC + un tercer canal (I3): una pinza grande en el canal 0 para un rango amplio, una pequeña en el canal 1 para precisión a corrientes bajas, y el tercer canal para una línea auxiliar independiente. Véase la sección «Configuración avanzada: dos pinzas de distinto calibre» más abajo.

Configuración avanzada: dos pinzas de distinto calibre en un mismo cable

Nota

⚙ Un patrón avanzado, no uno básico. Esta sección describe una técnica opcional para mejorar la resolución a corrientes bajas. En la mayoría de las instalaciones basta una pinza adaptada al rango de carga. Use el doble TC solo si tiene un requisito de precisión específico para corrientes < 1 A.

Cuándo aplica

  • Módulos multicanal I2 / I3 (hardware actual).
  • La misma línea debe medirse tanto para cargas pequeñas (≤ 1 A) como para eventos de pico (≥ 5 A) con la misma calidad.

  • Un ejemplo típico: una acometida de piso con 50-100 W de consumo en espera durante el día y un arranque de hervidor o cocina de 3+ kW por la tarde.

La idea

Dos pinzas SCT-013 de clasificaciones distintas se instalan en el mismo cable:

  • Canal 0: una pinza pequeña (por ejemplo, SCT-013-005, 5 A): detecta corrientes pequeñas con mejor resolución y un suelo de ruido más bajo.

  • Canal 1: una pinza grande (por ejemplo, SCT-013-030 o superior): maneja corrientes por encima del punto de sobrecarga de la pinza pequeña sin saturarse.

El propio maestro elige el canal según el valor de corriente: mientras la pinza pequeña está en su rango lineal, su lectura es más precisa; al superarlo, pasa a la grande.

Configuración (en cualquier orden, v1.3)

La clase de sensor primero, una sola vez, y después los modelos por canal en cualquier orden. En firmware v1.3, escribir REG_CT_MODEL solo prepara un valor; la vinculación se hace mediante el comando por canal CMD_SET_CT_MODEL_CHn, de modo que los canales nunca se pisan entre sí. (El workaround de «orden descendente» se aplicaba solo al firmware anterior a v1.3 y ya no es necesario.)

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)

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:

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;
}

Instalación con doble CT: dos pinzas en un mismo cable L, una de rango bajo y otra de rango alto, ambas con la flecha hacia la carga.

Nota

⚙ Limitación. No se publican cifras para el uso de doble TC a corriente baja (comportamiento cerca del umbral, deriva térmica, divergencia de las dos pinzas en el rango de solapamiento). Trate el doble TC como un patrón piloto; en aplicaciones críticas es preferible una sola pinza adaptada al extremo superior del rango de carga.

Enfoques para mejorar la sensibilidad a corrientes bajas

Si su carga tiene un rango dinámico amplio (por ejemplo, 1 W en reposo de un router frente a un calentador de inmersión de 2000 W en la misma toma), una sola pinza dimensionada para el límite superior pierde las corrientes bajas en el ruido.

Tres estrategias en orden creciente de complejidad:

  1. Dimensione el TC para el máximo, no «con margen». 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 del sensor, donde el ruido se vuelve comparable a la señal. Para un escenario doméstico (toma de 16 A) un SCT-013-030 es óptimo; para conectar un solo aparato (≤ 5 A), un SCT-013-005.

  2. Topología de doble CT (requiere un SKU I2/I3: dos canales de corriente en un mismo módulo): una pinza pequeña para el rango inferior y una grande para el superior, con el maestro eligiendo por umbral. Véase la sección «Topología de doble CT» más arriba: el patrón es un piloto y no se publican cifras para él.

  3. Suelo de ruido calibrado en fábrica: la calibración del módulo ya tiene en cuenta su suelo de ruido. En el lado del usuario no hay que hacer nada más que setSensorClass() + setCTModel(). No se publican cifras de precisión concretas a corrientes bajas.

Modo de producción frente a modo de fábrica (referencia de persistencia)

El módulo rbAmp funciona en dos modos que difieren en qué se guarda exactamente en flash. El modo actual se lee del registro de estado correspondiente.

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 (véase 04 · Conexión, cambio de dirección)
CMD_RESET (0x01) ✅ OK — (reinicio por software)
CMD_LATCH_PERIOD (0x27) ✅ OK — (instantánea de periodo)
CMD_CLEAR_ERROR ✅ OK —
CMD_SAVE_GAINS ❌ BLOQUEADO en producción (rechazo silencioso; REG_ERROR=0xFE; el reinicio lo revierte) ganancias / NF / fase (calibración de fábrica)
CMD_FACTORY_RESET ❌ BLOQUEADO en producción —

En modo producción, las escrituras de calibración de fábrica (CMD_SAVE_GAINS, CMD_FACTORY_RESET) son rechazadas por el firmware: esto protege contra la sobrescritura accidental de los coeficientes de fábrica. El despliegue del modo fábrica es una operación del lado del fabricante.

Leer lo escrito ≠ persistencia.

La guarda de producción acepta una escritura en RAM (una lectura posterior devuelve lo escrito), pero el guardado en flash puede ser rechazado. Tras un reinicio, el valor vuelve a su estado anterior. La única forma válida de confirmar la persistencia es reiniciar el módulo mediante CMD_RESET y volver a leer:

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) lee la dirección ACTIVA al arrancar (v1.3). Tras un reinicio posterior al commit, leer 0x30 mostrará la nueva dirección activa. El eco de preparación (tras una escritura del host) se mantiene por diseño hasta CMD_COMMIT_ADDR + reinicio.

Referencia cruzada: 09 · Referencia de API — detalles de códigos de operación concretos; 10 · Solución de problemas — qué hacer si no se confirma la persistencia.

Lo que viene después


Fuente y incidencias: rb-amp/rbamp-arduino · esta página en el repositorio: docs/03_sensor_selection.md (v1.6.2)