00 · Visión general
rbAmp es un módulo compacto para medir parámetros de red de CA a través de una interfaz I²C. Se suministra con calibración guardada de fábrica.
Qué es rbAmp
Desde el punto de vista del integrador, rbAmp se comporta como un esclavo I²C estándar: se aplica la alimentación y se leen registros, y se reciben valores listos para usar en unidades físicas (voltios, amperios, vatios). No se requiere procesado de señal en el lado del maestro.
Qué mide
BASIC informa las magnitudes siguientes como valores de punto flotante en unidades base. La línea STD informa sus magnitudes, con contadores de energía en el módulo, en la documentación de STD.
| Magnitud | BASIC |
|---|---|
| Tensión RMS, U_rms | float32, V |
| Tensión de pico, U_peak | float32, V |
| Corriente RMS, I_rms | float32, A |
| Corriente de pico, I_peak | float32, A |
| Potencia activa, P | float32, W, con signo |
| Potencia reactiva, Q | float32, var, sin signo (≥ 0) |
| Factor de potencia, PF | float32, −1…+1 |
| Frecuencia de la red | u8, Hz: 50 o 60 (detectado, no medido) |
| Potencia media sobre un período | float32, W; una instantánea (P media y de pico) |
| Energía | no se conserva en el módulo: lo integra el host (biblioteca) |
La precisión no forma parte de esta tabla: para BASIC con sensor SCT-013 vea la tabla de características SCT-013 más abajo; las especificaciones de cada módulo se dan con las descripciones de modelo. El mapa de registros de BASIC está en realtime-polling.md, period-metering.md y api-reference.md.
Precisión de los canales de corriente con sensores SCT-013
Módulos BASIC (serie SCT-UI) con su propio sensor SCT-013: carga resistiva, medida a 50 Hz. (Los módulos con pinza CT emparejada de fábrica, y los módulos STD, se especifican por separado; esta tabla no les aplica.)
| Característica | SCT-013-005 | SCT-013-010 | SCT-013-020 | SCT-013-030 | SCT-013-050 | SCT-013-060 | SCT-013-100 |
|---|---|---|---|---|---|---|---|
| Mínimo detectable (la lectura sin carga) | ~3 mA | 6–9 mA | ~10 mA | ~13 mA | ~25 mA | ~30 mA | ~60 mA |
| Mínimo legible (error ≤ 10 %; 0.5 % del calibre) | 25 mA | 50 mA | 0.10 A | 0.15 A | 0.25 A | 0.30 A | 0.50 A |
| Clase cercana al mínimo, UI1 / UI2 / UI3 (±1 % de la media, desde ~0.7 % del calibre) | desde 35 mA | desde 70 mA | desde 0.14 A | desde 0.21 A | desde 0.35 A | desde 0.42 A | desde 0.70 A |
| Clase cercana al mínimo, UI5 / UI7 (±0.5 %, desde el 2 % del calibre) | desde 0.10 A | desde 0.20 A | desde 0.40 A | desde 0.60 A | desde 1.0 A | desde 1.2 A | desde 2.0 A |
| Clase en el rango de trabajo (5–100 % del calibre, sobre la media) | ≤ 0.5 % | 0.16–0.35 % | ≤ 0.5 % | 0.53 % | ≤ 0.5 % | ≤ 0.5 % | 0.47 % |
| Tolerancia de la unidad sensora (se suma a la clase) | ≤ 0.8 % | 0.5–1.0 % | 0.8 % | 1.2 % | 0.7 % | 0.3–0.4 % | 0.45 % |
| Paso de un valor instantáneo | 4.1 mA | 8.1 mA | 16 mA | 24 mA | 41 mA | 49 mA | 83 mA |
| Gama alta (recorte, onda senoidal) | ~6.0 A | 11.9 A | ~24 A | 35 A | ~60 A | ~72 A | ~117 A |
Fuente: verificado en varias pruebas de banco de laboratorio. Tenga en cuenta que los sensores SCT-013 reales tienen un error real de alrededor del 1 %, que puede crecer con el tiempo o con la temperatura. Si necesita buena calidad de medición con corrientes pequeñas, elija un sensor de calibre menor.
- El paso de un valor instantáneo es de unos 0.08 % de la potencia nominal. La lectura RMS se calcula sobre toda la ventana de 100 ms y se devuelve como número fraccionario, por lo que es más fina que el paso: por ejemplo, con el sensor de 5 A la lectura en vacío es ~3 mA aunque el paso sea 4.1 mA. La resolución real la limita el ruido, no el paso.
- Cerca del suelo: una sola lectura (una ventana de 100 ms) al 1 % de la nominal es ruidosa, con un error de 0.6–2 %. La media sobre un período y la energía se mantienen dentro de la clase que muestra la tabla.
- UI5 / UI7 por debajo del 2 % del calibre: la dispersión entre módulos es de hasta ±5 %, así que en estos módulos la clase cerca del mínimo empieza en el 2 % del calibre.
- «Media» = la media de varias ventanas de medición de 100 ms, tal como se usa para la energía y la potencia media.
- El recorte es una propiedad del sensor SCT-013 (su nivel de salida a la corriente nominal); manténgase por debajo del calibre para lecturas fiables.
- Cambiar el modelo del sensor consiste en escribir el código de modelo en el módulo: sin paso de recalibración.
Aplicaciones
- Medición tarifaria: contabilidad de energía en intervalos de 1 min, 15 min, 1 hora, diarios, mensuales o anuales
- Hogar inteligente: monitorización del consumo de toda la vivienda, submedición por carga y seguimiento de la generación
- Control de carga: señal de realimentación para dispositivos que regulan potencia (calentadores de agua, cargas resistivas, inversores)
- Balance energético: contabilidad separada del consumo y de la generación en viviendas con solar
- Monitorización de la calidad de red: tanto en el lado del consumidor como en el lado de la compañía
Variantes del módulo
Línea actual de productos BASIC: SCT-UI1, SCT-UI2, SCT-UI3, SCT-UI5, SCT-UI7, SCT-I1, SCT-I2, SCT-I3. En el código, UIn significa una entrada de tensión y n canales de corriente; In significa solo n canales de corriente. Los módulos se suministran sin sensor; las características de cada calibre SCT-013 están en la tabla SCT-013. Otras líneas de módulos tienen una composición distinta; se añadirá aquí una tabla para cada línea a medida que salga a la venta.
BASIC: para sensores tipo SCT-013
| Módulo | U | Canales I | P | Cuándo elegirlo |
|---|---|---|---|---|
| SCT-UI1 | sí | 1 | sí | punto único de contabilidad: contador general de la vivienda, caldera, inversor único |
| SCT-UI2 | sí | 2 | sí | dos submedidores en una misma fase (iluminación + tomas, generación + consumo) |
| SCT-UI3 | sí | 3 | sí | tres flujos en una fase |
| SCT-UI5 / SCT-UI7 | sí | 5 / 7 | sí | monitorización de fases con gran número de canales (cuadros grandes, bancos de laboratorio) |
| SCT-I1 | no | 1 | no | monitor solo de corriente (el master calcula P con su propia fuente de U) |
| SCT-I2 | no | 2 | no | monitor de corriente de dos canales |
| SCT-I3 | no | 3 | no | monitor de corriente de tres canales |
BASIC: con pinzas CT emparejadas de fábrica (serie CT)
| Módulo | U | Canales I | P | Cuándo elegirlo |
|---|---|---|---|---|
| CT-UI1 | sí | 1 | sí | un punto de medición con una pinza calibrada y lista |
| CT-UI2 | sí | 2 | sí | dos submedidores en una fase |
| CT-UI3 | sí | 3 | sí | tres flujos en una fase |
| CT-UI5 / CT-UI7 | sí | 5 / 7 | sí | medición por fase con gran número de canales |
Un módulo de la serie CT se entrega con una pinza de corriente en cada canal. La pinza y el canal se calibran juntos en fábrica y se marcan con el número de canal: no hay nada que seleccionar ni configurar. Los calibres de las pinzas son 1, 5, 10, 20, 30, 50 o 100 A. La entrada de tensión es la misma que en la serie SCT. Vea Módulos de la serie CT: arranque sin configuración.
En las variantes solo de corriente, la potencia activa no se calcula (P_real = 0) y PERIOD_AVG_P_W devuelve 0. El maestro debe proporcionar su propia fuente de tensión para el cálculo de potencia, o usar solo los datos de corriente.
Niveles de producto
rbAmp se ofrece en dos niveles de producto. Cada nivel es una combinación completa de revisión de hardware y firmware, no un simple indicador de firmware. Pasar de un nivel a otro requiere un cambio físico de SKU, no una actualización de firmware.
BASIC: línea de producto de entrada
- Hardware: frontal analógico de coste optimizado, adecuado para cargas residenciales habituales.
- Firmware: medición de consumo unidireccional. El acumulador de periodo fija a cero cada muestra de potencia activa por ventana antes de integrar: solo se cuenta la energía positiva (consumida), como un contador mecánico de disco que solo gira hacia delante.
PERIOD_AVG_P_Wes siempre ≥ 0; los eventos de flujo inverso se descartan del acumulador de periodo.- Casos de uso: hogares sin generación propia; submedición de consumidores puros (calefactores, motores, electrodomésticos).
STD: una línea de producto aparte
STD es una línea de producto aparte: módulos monofásicos y trifásicos con contadores de energía en el módulo y Modbus RTU. Tiene su propio mapa de registros y su propia documentación: vea la documentación de STD.
Dónde aparece el nivel en esta documentación
Esta documentación describe el mapa de registros BASIC de 8 bits (0x00..0xCF). Los módulos STD usan un mapa de registros distinto de 16 bits y están documentados en la documentación de STD; en STD estas funciones funcionan de otra manera.
Características principales
- Esclavo I²C: 50 kHz en hosts ESP32 y ESP8266 (limitación del driver ESP-IDF), 100 kHz en otros hosts; no se recomienda 400 kHz.
- Dirección: 7 bits
0x50por defecto, reaprovisionable al rango0x08..0x77mediante confirmación en dos fases (vea initialization.md). - DATA_READY (DRDY): pin opcional de drenador abierto, pulso LOW de ~10 µs en cada ventana de medición (~100 ms desde v1.2; 200 ms antes), que marca el momento en que los registros RT son coherentes.
- Instantánea atómica del periodo: el comando
0x27congela la potencia promediada por periodo; una sola escritura cierra y abre el periodo: sin muestras perdidas ni duplicadas en el límite. - Instantánea de difusión General Call: la dirección
0x00está reservada para una instantánea simultánea en todos los módulos que comparten un bus. Habilitación opcional por módulo medianteFLEET_CONFIG.bit0(por defecto DESACTIVADA). Cuando está desactivada, la trama GC recibe NACK a nivel de bus: los masters lo detectan y recurren a una instantánea secuencial por módulo (el desfase en un bus de 50 kHz es ~1 ms × N, ≪ 0.03 % de un período de 60 s). Vea period-metering.md para la secuencia de habilitación y el formato de trama. - Reloj de pared del lado del maestro: la energía se calcula en el lado del maestro como
avg_P × dt_master; el registro de marca temporal del periodo en el chip (0xEC) es solo de diagnóstico (puede contar de menos hasta un ~30 % bajo carga, por diseño). Elimina la deriva de cristal de cada módulo en sistemas de varios módulos. - Calibración en flash: la calibración de fábrica se guarda en el módulo; no se requiere calibración de usuario. En los módulos BASIC de la serie SCT el master escribe solo
SENSOR_CLASSyCT_MODELpor canal para el sensor SCT-013 conectado. En los módulos de la serie CT el host no escribe nada: vea arranque sin configuración. - Autoconfiguración: el módulo empieza a medir de inmediato tras el encendido (~250 ms hasta el primer resultado válido, ~700 ms adicionales para la primera escritura persistente).
Lo que rbAmp no hace
- No integra la energía (Wh) internamente; la acumulación de energía es responsabilidad del maestro (véase period-metering.md)
- No acciona cargas, no contiene lógica de automatización ni ejecuta reglas programables
- No tiene pantalla integrada
Siguiente
- hardware-connection.md: conexión, alimentación, cableado
- initialization.md: primer encendido