03 · Selección del 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.
La conexión física del sensor (orientación de la pinza, comprobación de la polaridad L/N) está 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 trabajan con pinzas de CT de la familia SCT-013. Debe indicar al módulo la clase de sensor una vez, con rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013), antes de elegir un modelo concreto de pinza CT con rbamp_set_ct_model().
Elegir el modelo SCT-013
La familia SCT-013 tiene siete modelos que se diferencian por la corriente máxima del circuito primario. Se admiten los siete 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 único aparato de potencia media: frigorífico, lavadora, aire acondicionado de hasta 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ caracterizado | Acometida de una vivienda 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 con cargas punta |
| 5 | SCT-013-100 | 0…100 A | ✅ caracterizado | Acometida principal de una vivienda o pequeña oficina |
| 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}. Un código fuera de este conjunto (por ejemplo 0 u 8) pasado a rbamp_set_ct_model_ch devuelve ESP_ERR_INVALID_ARG + REG_ERROR = 0xFE (ERR_PARAM). Vea 09 · Referencia de la API, sección «Modelo de errores v1.3», para el detalle de cómo devuelve el componente este error.
Cómo elegir el modelo adecuado
La regla básica:
-
Determine la corriente máxima que puede circular por el circuito (según la carga mayor + un margen del 30 %).
-
Elija la pinza nominal más pequeña por encima de este valor.
- No sobredimensione en más de 5×. Una pinza SCT-013-100 en un circuito de 5 A máximo funcionará, pero da poca resolución y un gran error con valores típicos.
Margen
Una pinza SCT-013 funciona sin saturación dentro de su rango nominal. Los picos breves (arranque de un compresor, carga inductiva) pueden superar la nominal en 5–7 veces: esto es normal, la pinza lo soporta físicamente, pero la medida se vuelve no lineal por encima de la nominal.
Si su carga tiene un pico de corriente por encima de la clasificación de la pinza, elija el siguiente tamaño. Por ejemplo, para una lavadora con una corriente de arranque de 12 A (mientras que la corriente de régimen es de 2–3 A): 12 A × 1.3 = 15.6 A, así que la pinza nominal más pequeña por encima de ese valor es la SCT-013-020 (código 6), mejor que una SCT-013-005.
Cómo indicar al módulo su elección
Dos llamadas son obligatorias, en el orden correcto: primero rbamp_set_sensor_class() y después rbamp_set_ct_model(). Si llama a rbamp_set_ct_model() antes que a rbamp_set_sensor_class(), el componente devuelve ESP_ERR_INVALID_STATE y el preajuste NO se carga.
Un modelo de CT es un preajuste funcional, no una etiqueta. Escribir el modelo de CT aplica de inmediato la línea base de ruido (NF), la ganancia y el factor de forma a la cadena de medida 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.
#include "driver/i2c_master.h"
#include "rbamp.h"
void setup_sensor(rbamp_handle_t dev) {
/* Step 1: select the sensor family.
* MANDATORY before rbamp_set_ct_model(). */
esp_err_t err = rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
if (err != ESP_OK) {
ESP_LOGE("app", "set_sensor_class: %s", rbamp_err_to_str(err));
return;
}
/* Step 2: select the 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. */
err = rbamp_set_ct_model(dev, 3); /* e.g. SCT-013-030 */
if (err != ESP_OK) {
/* Possible causes:
* ESP_ERR_INVALID_STATE — rbamp_set_sensor_class() was not called
* before rbamp_set_ct_model()
* ESP_ERR_INVALID_ARG — code not in {1,2,3,4,5,6,7}
* ESP_FAIL — communication error (NACK after retry)
*/
ESP_LOGE("app", "set_ct_model: %s", rbamp_err_to_str(err));
return;
}
}
El componente NO llama deliberadamente a rbamp_set_sensor_class() por usted. Si se omite este paso, rbamp_set_ct_model() devuelve ESP_ERR_INVALID_STATE sin escribir en flash. Es así para que el comportamiento sea 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 una nueva grabación del firmware.
-
Los coeficientes de calibración para esta combinación concreta (clase de sensor + modelo) se cargan desde la tabla de preajustes de fábrica. No necesita tocar ningún registro de calibración manual.
-
La siguiente llamada
rbamp_read_current(dev, 0, &i)ya devuelve un valor en amperios con el escalado correcto.
Tiempo total de ambas llamadas: 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 vez en la primera instalación; el ajuste se guarda en flash y no se repite.
Si ya seleccionó el sensor en el primer arranque y solo reinicia el ESP32, no necesita repetir las llamadas rbamp_set_sensor_class() y rbamp_set_ct_model(): el módulo recuerda la elección anterior. Tampoco hace daño repetirlas: volver a llamar con el mismo valor solo reescribe el mismo byte.
Verificación de la configuración
Una comprobación sencilla tras rbamp_set_ct_model():
#include
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
static const char *TAG = "rbamp_check";
void sanity_check(rbamp_handle_t dev) {
ESP_LOGI(TAG, "Ready. Connect a purely resistive load "
"(e.g. an incandescent lamp).");
ESP_LOGI(TAG, "Expect a stable PF ~= 1.0 and positive P.");
while (1) {
float u = NAN, i = NAN, p = NAN, pf = NAN;
rbamp_read_voltage(dev, 0, &u);
rbamp_read_current(dev, 0, &i);
rbamp_read_power(dev, 0, &p);
rbamp_read_power_factor(dev, 0, &pf);
ESP_LOGI(TAG, "U=%.1f V I=%.2f A P=%.1f W PF=%.2f",
(double)u, (double)i, (double)p, (double)pf);
vTaskDelay(pdMS_TO_TICKS(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≈ corresponde a 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 | I-canales | Canal U | Uso típico |
|---|---|---|---|
| UI1 | 1 | sí | Una sola carga con cálculo completo de potencia (P, PF, Q, Wh): el contador de red típico |
| UI2 | 2 | sí | Dos cargas independientes en una misma fase con potencia por canal (1 U + 2 I) |
| UI3 | 3 | sí | Tres cargas en una fase con potencia por canal (1 U + 3 I) |
| I1 | 1 | no | Submedidor sin cálculo de potencia (solo corriente): cuando la medición de la red la gestiona un UI1 aparte |
| 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_peak, frecuencia. Uno* por módulo (ligado a la fase de entrada).
- I-channels:
- 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_peak). La potencia activa y el PF no se calculan: requieren tensión, que la variante I no tiene. Los registros
power[]/power_factor[]en las variantes I devuelven 0. - Multifase frente a multipunto: el módulo NO distingue a qué fase está conectado cada canal de corriente. Esa semántica está en el lado del maestro.
Modelo de CT por canal — calibración independiente por canal
En los módulos multicanal (I2, I3) cada canal de corriente tiene una elección independiente de modelo SCT-013. Puede conectar, por ejemplo, un SCT-013-005 al canal 0 (una sola toma), un SCT-013-030 al canal 1 (la línea de la cocina eléctrica) y un SCT-013-020 al canal 2 (un calentador de agua o caldera).
La API para la selección por canal es rbamp_set_ct_model_ch(dev, channel, code):
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013); /* once for all */
/* v1.3: channel binding order is arbitrary. */
rbamp_set_ct_model_ch(dev, 0, 1); /* channel 0: SCT-013-005 */
rbamp_set_ct_model_ch(dev, 1, 3); /* channel 1: SCT-013-030 */
rbamp_set_ct_model_ch(dev, 2, 6); /* channel 2: SCT-013-020 */
✅ El orden de asociación es arbitrario (canon v1.3). Escribir REG_CT_MODEL (0x05) deja el valor preparado, pero no lo aplica automáticamente a ningún canal. La aplicación ocurre solo mediante CMD_SET_CT_MODEL_CHn por canal, que toma el valor preparado actual y lo escribe en su propio canal. Los canales pueden configurarse en cualquier orden (ch0 primero, último o intercalado: no importa); no se produce sobrescritura. Cualquier mención a «ascendente / descendente / asociar ch0 al final» en documentos y código antiguos se refiere al comportamiento anterior a la v1.3; puede eliminarse.
Cada canal se vincula en dos pasos: (1) escribir el modelo en REG_CT_MODEL (preparación), (2) CMD_SET_CT_MODEL_CHn (vinculación). La validación (clase, modelo) la hace el firmware en el paso de vinculación.
Si varios canales reciben el mismo modelo, puede llamar con el mismo código: la aplicación repetida es idempotente:
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
rbamp_set_ct_model_ch(dev, 0, 1);
rbamp_set_ct_model_ch(dev, 1, 1);
rbamp_set_ct_model_ch(dev, 2, 1);
Una alternativa para el caso típico I2/I3 es rbamp_configure_channels(dev, class, models[], n): una sola operación configura la clase + todos los canales + guarda todo en flash con un único CMD_SAVE_USER_CONFIG final (favorable a la flash: un ciclo de borrado en lugar de N). Vea el capítulo 09 · Referencia de la API, sección «Configuración multicanal».
La forma de un solo parámetro rbamp_set_ct_model(dev, code) es una forma de conveniencia para SKU de un solo canal (se aplica al canal 0). En módulos multicanal equivale a rbamp_set_ct_model_ch(dev, 0, code).
Configuración avanzada: dos pinzas de distinto calibre en un mismo cable
⚙ Un patrón adicional, no uno básico. Esta sección describe una técnica opcional para mejorar la resolución con corrientes bajas. En la mayoría de instalaciones basta con una sola pinza dimensionada para el rango de carga. Use el doble CT solo si tiene un requisito concreto de precisión con corrientes inferiores a 1 A.
Cuándo aplica
- Módulos multicanal I2 / I3 (hardware actual).
-
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 acometida de un piso, con 50–100 W de consumo en espera durante el día y la corriente de arranque de un hervidor o una cocina eléctrica de 3+ kW por la noche.
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 el canal según el valor de corriente: mientras la pinza pequeña está en su zona lineal, su lectura es más precisa; cuando se supera, cambia a la grande.
Configuración
La clase de sensor una vez, y después los modelos por canal en cualquier orden (v1.3 es un preparado puro: el orden no importa):
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013); /* once */
rbamp_set_ct_model_ch(dev, 0, 1); /* ch0 = SCT-013-005 (0..5 A) — small clamp */
rbamp_set_ct_model_ch(dev, 1, 3); /* ch1 = SCT-013-030 (0..30 A) — large clamp */
Estado final: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Una alternativa mediante rbamp_configure_channels(): una operación en lugar de dos:
uint8_t models[2] = { 1, 3 }; /* ch0=5A, ch1=30A */
rbamp_configure_channels(dev, RBAMP_SENSOR_SCT013, models, 2);
Lógica de agregación en el lado del maestro
La plantilla más sencilla consiste en activar algo al superar un umbral:
float read_combined_current(rbamp_handle_t dev) {
float i_low = NAN;
float i_high = NAN;
esp_err_t err_low = rbamp_read_current(dev, 0, &i_low); /* small */
esp_err_t err_high = rbamp_read_current(dev, 1, &i_high); /* large */
/* While the small clamp is far from saturation, it gives better
* accuracy at small currents. Switch to the large one as it
* approaches the overload point.
*
* The 4.5 A threshold for the SCT-013-005 is an example value;
* figures for low-current dual-CT use are not published. */
if (err_low == ESP_OK && i_low < 4.5f) {
return i_low;
}
return (err_high == ESP_OK) ? i_high : NAN;
}
Dos pinzas en un mismo cable son físicamente posibles en la mayoría de cables de calibre doméstico, pero requieren algo de espacio en el cuadro.
⚙ Cifras del doble CT. Las cifras del uso de doble CT con corrientes bajas (comportamiento cerca del umbral, divergencia de las dos pinzas en el rango de solapamiento) no se publican. Trate el doble CT como un patrón piloto; para aplicaciones críticas es preferible una sola pinza dimensionada para el rango superior de carga.
Módulos multicanal — I2 e I3 (solo corriente)
Los módulos de solo corriente para la topología multicanal son 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 es imposible: solo aportan corriente por canal (I_rms, I_peak en cada canal) y nada más.
UI2 y UI3 añaden el canal U (1 U + 2 I / 1 U + 3 I), así que la potencia por canal se calcula en el módulo. Donde solo se necesita un desglose de corriente, use I2/I3 como subcontadores de corriente junto con un UI1 separado en la acometida, que aporta la energía de red y la tensión.
Lectura de canales (I2 / I3)
float i0, i1, i2;
rbamp_read_current(dev, 0, &i0); /* ch0 */
rbamp_read_current(dev, 1, &i1); /* ch1 */
rbamp_read_current(dev, 2, &i2); /* ch2 — I3 only */
/* On an I variant rbamp_read_power(...) returns 0 — this is by design. */
float p_dummy; rbamp_read_power(dev, 0, &p_dummy); /* = 0.0f */
Si necesita potencia activa en cada línea secundaria, ponga un UI1 en la acometida y reparta su potencia total en proporción a la corriente por canal I[k] de los I2/I3. Este es el despliegue doméstico típico:
/* Pseudo-pattern: UI1 on mains, I3 on 3 sub-lines */
float p_mains_total, i0, i1, i2;
rbamp_read_power(mains_ui1, 0, &p_mains_total);
rbamp_read_current(loads_i3, 0, &i0);
rbamp_read_current(loads_i3, 1, &i1);
rbamp_read_current(loads_i3, 2, &i2);
float i_sum = i0 + i1 + i2;
if (i_sum > 0.01f) {
float p0 = p_mains_total * i0 / i_sum; /* approximation */
/* ... */
}
Se trata de una aproximación: dividir por corriente funciona cuando el factor de potencia es aproximadamente el mismo en todas las cargas. Para una contabilidad precisa de la potencia por carga, use una variante UI (UI1 / UI2 / UI3 / UI5 / UI7) en cada línea.
Aplicaciones de I2 / I3
-
Submedición de corriente: desglose de corriente por circuito, un único punto de instalación en el cuadro en lugar de un módulo por línea.
-
Desagregación junto con un UI1: el UI1 proporciona la energía y la potencia de la red, y los I2/I3 desglosan el consumo por ramal (véase el capítulo 06, escenario 1).
-
Monitorización de corriente sin contabilidad de potencia: control de sobrecarga, detección de encendido/apagado de cargas, perfil I(t).
-
Doble CT más 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 con corrientes bajas, y el tercer canal para una línea auxiliar independiente. Vea la sección «Configuración avanzada: dos pinzas de distinta nominal» más arriba.
Cálculo de potencia en el lado del master:
float i;
rbamp_read_current(dev, ch, &i);
/* If the voltage is known (from a UI module upstream or fixed) */
const float U_nominal = 230.0f;
float p_estimated = U_nominal * i; /* without PF — guaranteed overestimate */
Para una contabilidad de potencia precisa, use un módulo UI (con un canal U).
Enfoques para mejorar la sensibilidad a corrientes bajas
Si su carga tiene un rango dinámico amplio (p. ej., 1 W en espera de un router frente a un calentador de agua de 2000 W en la misma toma), una pinza única dimensionada para el límite superior pierde las corrientes bajas en el ruido.
Tres estrategias, en orden de complejidad creciente:
-
Dimensione la pinza al máximo, no «con margen». El error más común es poner una SCT-013-100 (100 A) en una toma doméstica con un consumo típico de 0.5–10 A. La señal está en el 1–10 % inferior del rango del sensor, donde el ruido se vuelve comparable a la señal. Para el escenario doméstico (toma de 16 A) la SCT-013-030 es la óptima; para conectar un único aparato (≤ 5 A) la SCT-013-005.
-
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 bajo y una grande para el superior, y el maestro selecciona por umbral. Véase la sección «Topología de doble CT» más arriba: el patrón es un piloto; no se publican cifras para el uso con doble CT en corrientes bajas.
-
Suelo de ruido (lado de fábrica): la calibración del módulo ya lo tiene en cuenta. Por el lado del usuario no hay que hacer nada más que
setSensorClass()+setCTModel(). No se publican cifras concretas de precisión con corrientes bajas.
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 flash. El modo actual se lee del registro de estado del módulo correspondiente.
| Comando (opcode) | Producción | Persiste |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, armado con número mágico) |
✅ OK | Dirección I²C (véase 04 · Cableado — 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 (devuelve ERR_PARAM) | ganancias / NF / fase (calibración de fábrica) |
CMD_FACTORY_RESET |
❌ BLOQUEADO en producción | — |
En modo de producción, las escrituras de la calibración de fábrica (CMD_SAVE_GAINS, CMD_FACTORY_RESET) son rechazadas por el firmware: esto protege frente a borrar por accidente los coeficientes de fábrica. Poner el módulo en modo de fábrica es una operación del fabricante; los usuarios finales no lo necesitan.
La protección de producción acepta una escritura en RAM (una lectura posterior devuelve el valor escrito), pero el guardado en flash puede rechazarse. Tras un reinicio, el valor vuelve al estado previo a la escritura. La única forma válida de confirmar la persistencia es reiniciar el módulo mediante CMD_RESET y volver a leer:
rbamp_set_ct_model(dev, code);
rbamp_reset(dev); // CMD_RESET 0x01, works in production
vTaskDelay(pdMS_TO_TICKS(400)); // boot complete
uint8_t check; rbamp_read_ct_model(dev, 0, ✓);
assert(check == code); // ONLY now is persistence confirmed
Referencia cruzada: 09 · Referencia de API — detalles de códigos de operación concretos; 10 · Diagnósticos — qué hacer si la persistencia no se confirma.
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 proyecto completo de primera luz
-
06 · Ejemplos — escenarios de trabajo para distintas cargas
-
10 · Diagnóstico: qué hacer si las lecturas son extrañas (PF negativo, I inestable, etc.)
Fuente y incidencias: rb-amp/rbamp-esp-idf · esta página en el repositorio: docs/03_sensor_selection.md (v1.7.3)