rbAmp
ES
Tienda
Docs
Actualizado

01 · Conexión de hardware

Este capítulo describe la conexión física de rbAmp a un dispositivo master y los requisitos de alimentación. El módulo llega listo para funcionar. El usuario trabaja solo con el lado de baja tensión (BT): cuatro hilos para I²C, una línea DRDY opcional y (en los modelos con CT externo) un conector de 3.5 mm para la pinza.

Seguridad

⚠ Lado de red. Para trabajar dentro de un cuadro eléctrico, llame a un electricista cualificado.

La pinza va en un solo conductor (L), nunca en todo el cable. No tiene contacto eléctrico, pero necesita un conductor con el aislamiento intacto. La toma L necesita un fusible (vea Cable y fusible más abajo).

Pinout del lado de baja tensión

El módulo funciona con lógica de 3.3 V y tolera la lógica de 5 V en las líneas I²C. Todos los pines del lado de baja tensión están aislados galvánicamente de la red.

Pin de rbAmp Señal Función
VCC +4.5 … +5.5 V (alimentación) Alimentación del módulo; mínimo 4.5 V para un funcionamiento correcto
GND Tierra Masa común con el master: obligatoria
SDA SDA I²C datos I²C
SCL SCL I²C Reloj I²C
DRDY Datos listos (opcional) Pulso LOW de drenador abierto de ~10 µs en cada ventana de medición (~100 ms, v1.2 y posteriores)
Patillaje del lado de baja tensión de rbAmp: VCC, GND, SDA, SCL y la línea opcional DRDY.

Pull-ups I²C: instaladas en la placa

Importante: cada módulo rbAmp tiene resistencias pull-up integradas de 4.7 kΩ en SDA y SCL a 3.3 V. Para un bus de un solo módulo no se necesitan pull-ups externas: conecte el master directamente.

Cuándo desactivar las pull-ups integradas

Con cuatro o más módulos rbAmp (u otros dispositivos I²C con sus propias pull-ups) en el bus, o en un bus más largo, su combinación en paralelo produce una resistencia efectiva demasiado baja, lo que:

  • Aumenta el consumo de potencia del bus
  • Puede superar la corriente máxima de sumidero de la etapa de salida del master I²C (típicamente ≤ 3 mA a lógica de 3.3 V)
  • Añade carga capacitiva en buses largos, aportando poco a la inmunidad al ruido

Con dos o tres módulos en un bus de hasta 15 cm, no toque las resistencias pull-up integradas (vea la tabla siguiente). En caso contrario: cada módulo tiene cortes de puente de soldadura en la parte inferior de la PCB, junto a las resistencias pull-up. La serigrafía dice Pull-Up. Corte la pista con una cuchilla afilada para desconectar la pull-up:

  • Con cuatro o más módulos, o en un bus más largo, deje las pull-ups activas en solo un módulo del bus (o reubíquelas en un único punto cerca del master).
  • Corte los puentes de soldadura de los demás módulos.
  • Si la placa del master ya aporta pull-ups de bus y el bus tiene cuatro o más módulos (o es más largo), corte los puentes de todos los módulos rbAmp. Con dos o tres módulos, mida primero (vea En caso de duda más abajo) y corte solo si la lectura es inferior a ~1 kΩ.

Regla general

módulos rbAmp en el bus Pull-ups
1 No tocar (resistencia interna de 4.7 kΩ)
2 Déjelas en ambos (bus de hasta 15 cm)
3 Déjelas en los tres (bus de hasta 15 cm)
4…6 Corte en todos los módulos; par externo de 2.2…2.7 kΩ cerca del master
7…16 Corte en todos los módulos; par externo de 1.5…2.2 kΩ cerca del maestro; compruebe la capacidad total del bus (≤ 400 pF) y reduzca la velocidad del bus si hace falta
Nota

Estos son valores recomendados calculados a partir de la especificación I²C (corriente de absorción de la pull-up ≤ 3 mA a 3.3 V, capacidad del bus ≤ 400 pF); no son una garantía medida para cada cable y maestro. Conecte las pull-ups externas a 3.3 V (el nivel lógico del bus), no a la alimentación de 5 V VCC. Maestro de 5 V: véase Compatibilidad de tensión I²C más abajo.

La fila de 3 módulos está medida (cables de 15 cm, 50 kHz); las demás filas están calculadas a partir de la especificación I²C.

Qué pull-ups I²C conservar o cortar según cuántos módulos rbAmp comparten el bus.

En caso de duda

: mida la resistencia entre SDA y VCC con todos los dispositivos sin alimentar. Para un bus de un solo módulo el valor típico es ~4.7 kΩ (una pull-up integrada); en un bus de varios módulos la combinación en paralelo baja al rango de 1.5–4.7 kΩ según cuántas pull-up integradas sigan activas. Por debajo de ~1 kΩ hay demasiadas pull-up activas en paralelo: vea la tabla de arriba.

Potencia

Parámetros de VCC

  • Tensión nominal: 5 V CC
  • Rango aceptable: 4.5 … 5.5 V
  • Consumo de corriente: ~15 mA típico, ~25 mA de pico durante la escritura en flash
  • Rizado: < 50 mV pico a pico (para la precisión de medida)
Seguridad

⚠ Respete la polaridad de la alimentación. La polaridad inversa en la entrada de 5 V no está soportada: compruebe el cableado VCC/GND antes de encender. Verifique el código de colores de su mazo de cables antes del primer encendido, sobre todo si fabrica sus propios cables.

Compatibilidad de tensión I²C

  • SDA/SCL funcionan con lógica de 3.3 V (las pull-ups integradas las llevan a 3.3 V).
  • Las líneas toleran 5 V, así que un maestro de 5 V (Arduino UNO / Nano) lee ALTO (~3.3 V) correctamente y puede accionar el bus.
  • Configuración estándar: pull-ups a 3.3 V. Solo si desea deliberadamente niveles de bus de 5 V, desactive las pull-up integradas y añada pull-ups externas a +5 V en el lado del master.

Comportamiento al encendido

  • Arranque en frío: ~250 ms hasta el primer resultado de medida válido.
  • Tras RESET (software o caída de tensión): ~250 ms para recuperarse.
  • Antes del primer resultado válido, los registros leen 0 y DATA_VALID (0xCE) es 0.

Aislamiento

El módulo en sí es todo de baja tensión; no hay ningún circuito de medida de alta tensión en él. La corriente se lee con una pinza CT que se acopla magnéticamente desde fuera del conductor aislado, sin contacto eléctrico con el cable de red. En las variantes con sensado de tensión (UI), la única referencia a red es el terminal L–N, que alimenta un divisor de sensado aislado galvánicamente*; las variantes solo de amperios no tienen conexión a red en absoluto. En consecuencia:

  • La masa del módulo no está conectada a la fase ni al neutro de la red.
  • Conectar el lado de BT a un master de 5 V es seguro: no hay riesgo de cortocircuito a través de la masa.
Nota

No abra la carcasa: anularía la calibración de fábrica.

Bus I²C

Parámetros

  • Dirección por defecto: 0x50 (7 bits)
  • Rango de direcciones: 0x08..0x77 (reaprovisionable mediante commit en dos fases, véase initialization.md)
  • Velocidad (recomendación; la elige el usuario): 50 kHz en masters ESP32 y ESP8266 (una limitación del controlador I²C de ESP-IDF, no del módulo); 100 kHz en otros masters; no use 400 kHz. 100 kHz también es viable en ESP32/ESP8266 con reintento a nivel de aplicación.
  • Autoincremento en lectura: SÍ: lectura en ráfaga soportada (registros multibyte, bloque RT V03, ventana DIGEST).
  • Autoincremento en ESCRITURA: NO. Cada byte escrito necesita una dirección de registro explícita, incluidos los campos de varios bytes (escriba primero el byte bajo y después el alto, por separado).
  • Clock-stretching: el módulo no lo usa como control de flujo. El maestro debe respetar un hueco entre transacciones (tBUF) de ≥ 100 µs.

Longitud del bus

I²C es, por defecto, un bus corto (~15 cm). Muchos usuarios conectan los módulos con cables puente de baja calidad, que captan mucho ruido y pierden muchas transferencias: de ahí el límite corto. Topologías recomendadas para rbAmp:

Topología del cableado Longitud máxima Velocidad
Cable plano estándar JST / de 4 hilos hasta 0.15 m 100 kHz
Par trenzado UTP (cat-5/5e/6): SDA+GND y SCL+GND en pares separados hasta 1 m 100 kHz
Par trenzado UTP + buffer I²C (PCA9515 / TCA9617) hasta 3 m 100 kHz
Bus diferencial (PCA9615 / LTC4332) hasta 100 m 100 kHz
Seguridad

Las longitudes anteriores se indican para 100 kHz; la recomendación de 50 kHz para masters ESP32/ESP8266 (§Parámetros) se aplica a toda topología: la velocidad menor solo añade margen.

Para tiradas de más de 0.15 m es obligatorio el par trenzado: SDA y SCL deben ir en pares separados, cada uno con su propia masa (por ejemplo, azul + azul-blanco para SDA, verde + verde-blanco para SCL). Poner SDA y SCL en el mismo par causa un acoplamiento cruzado que distorsiona los flancos.

⚠ Dentro de un armario eléctrico, apantalle el cable I2C. Los campos magnéticos intensos cerca de conductores de red, contactores y transformadores inducen ruido en un cable sin apantallar. Mantenga el cable lo más corto posible y alejado del cableado de red.

Bus multimódulo

Varios módulos rbAmp pueden compartir un único bus I²C:

Varios módulos rbAmp que comparten un bus I²C con un único master.

  • Número de módulos: hasta ~16 (limitado por la capacidad total del bus: ≤ 400 pF a 100 kHz)
  • Direcciones: cada módulo tiene su propia dirección de 7 bits. Todos los módulos salen de fábrica en 0x50; readdreselos uno a uno antes de conectarlos en paralelo (véase initialization.md → Cambio de dirección).
  • Pull-ups: siga la tabla de número de módulos de arriba (valores recomendados); con 2–3 módulos en un bus de hasta 15 cm deje las pull-up integradas como están; con 4 o más módulos córtelas todas y use un par externo dimensionado para el número de módulos.
  • Retirar un módulo: para quitar un módulo de un bus compartido, desconecte sus hilos de bus (o el módulo entero), no solo su alimentación: un módulo sin alimentar carga SDA y SCL y puede bloquear el bus para los demás.

Conexiones del sensor (lado de red)

Conexión del lado de red de un módulo rbAmp dentro de un cuadro: la toma L y N y la pinza de corriente en el conductor L.

Sensor de tensión (variantes UI*)

La PCB expone L (línea / fase) y N (neutro). La polaridad importa para el signo de la potencia activa:

  • Cableado correcto (L → L, N → N): P > 0 significa consumo (corriente que entra en la carga desde la red), P < 0 significa exportación a la red (generación).
  • Cableado invertido (L y N intercambiados): el signo de P se invierte; el consumo aparece como potencia negativa.

Cable y fusible. No hace falta un cable grueso para la conexión de tensión: basta con AWG26–22, porque el sensor de tensión consume muy poca corriente. Un fusible en la línea L es obligatorio, de hasta 0.1 A.

La polaridad correcta es crítica para:

  • Contabilidad precisa de nivel BASIC (BASIC cuenta solo max(P, 0); una polaridad invertida anula el total de energía).
  • Separación correcta del consumo y la generación en la línea STD.
Comprobación rápida

: con una carga puramente resistiva (hervidor eléctrico, calefactor, bombilla incandescente), P > 0 y PF ≈ 1.0. Si P es negativa mientras la carga consume, intercambie L y N en la placa.

Sensor de corriente: SCT-013 (para SKU con CT externa)

Las pinzas SCT-013 se conectan al módulo mediante un conector de 3.5 mm. El conector tiene una guía que garantiza la polaridad correcta sin ajustes; no hay decisiones de cableado que tomar. Características de cada calibre SCT-013 (umbrales, clase, tolerancia, saturación): vea la tabla SCT-013.

Cómo la pinza de corriente se conecta al módulo rbAmp a través del conector de 3.5 mm.
El cuerpo de la pinza lleva unaflechaque indica el sentido del flujo de energía para la orientación «normal»:

La pinza de corriente cerrada alrededor del cable L con la flecha apuntando hacia la carga.

Rules:

  • Coloque la pinza alrededor del cable de línea (L) que va al consumidor.
  • La flecha de la pinza debe apuntar en el sentido de la corriente hacia la carga (desde el cuadro de distribución hacia la carga).
  • La pinza debe cerrarse por completo: no puede haber hueco entre las dos mitades del núcleo magnético. Un hueco de más de 0.1 mm aumenta mucho la reluctancia magnética y degrada la precisión.
Seguridad

⚠️ Advertencia: no pase L y N por la misma pinza. Sus flujos magnéticos son iguales y opuestos, así que se cancelan: el sensor lee una corriente cercana a cero incluso con carga real.

Marcas de canal en la placa

Cada conector de la PCB lleva el nombre del canal (I0, I1, I2, …) y un marcador de color. Los cables SCT-013 son eléctricamente simétricos: la orientación la establece la flecha de la pinza y su colocación en el cable, no el extremo del cable que entra en el conector.

Polaridad y signo de P

  • Flecha en el sentido correcto + polaridad L/N correcta → P > 0 para consumo, P < 0 para exportación.
  • Pinza instalada al revés (la flecha contra el sentido de la corriente) → el signo de P se invierte.

Pinzas de corriente: serie CT

Cada canal de un módulo de la serie CT tiene su propia pinza con un cable de 1 m. El cable llega conectado al módulo y está marcado con el número de canal; conéctelo al conector de ese canal. Mantenga cada pinza en su propio canal, también cuando reconecte el cuadro más adelante: una pinza en otro canal da lecturas erróneas y el módulo no lo informa.

  • No mueva una pinza a otro canal ni conecte otra pinza: la calibración pertenece al par.
  • Coloque la pinza en el conductor L con la flecha apuntando hacia la carga (el consumidor); el conductor debe pasar por la ventana y la pinza debe cerrar por completo.
  • El tamaño de la ventana depende de la calificación: 6 mm para 1–10 A, 10 mm para 20–50 A, 16 mm para 100 A. El conductor con su aislamiento debe caber en la ventana.
  • Alimentación y bus, pull-ups, velocidad del bus, cable de tensión y fusible: como en todos los módulos BASIC (véanse las secciones anteriores). La entrada de tensión es la misma que en los módulos SCT-UI: cable AWG26–22, fusible en la línea L de hasta 0.1 A.

DATA_READY (DRDY)

Pin opcional para un sondeo optimizado. Si su aplicación se conforma con sondear a su propio intervalo fijo (100 ms o más lento), puede dejar DRDY desconectado.

Parámetros eléctricos

  • Tipo de salida: drenador abierto (sin pull-up activa a VCC)
  • Nivel en reposo: ALTO (requiere una pull-up en el lado del maestro: pull-up interna del MCU o resistencia externa; recomendado 10 kΩ a 3.3 V)
  • Pulso de listo: LOW durante ~10 µs, después de que los registros RT (0x86..0xCF) se hayan refrescado
  • Frecuencia de pulsos: ~10 Hz (un pulso por ventana RT de ~100 ms; ~5 Hz en imágenes anteriores a la v1.2)

Semántica

El flanco de bajada de DRDY garantiza que todos los registros RT son coherentes y se han publicado recientemente (el firmware actualiza los registros de forma atómica dentro de una ISR antes de bajar el pin). El master puede leer 0x86..0xCD justo en el flanco de bajada sin riesgo de muestra partida.

Uso en el lado del maestro

  • Interrupción EXTI / GPIO por flanco de bajada: despierta al maestro y dispara una lectura.
  • Use cualquier GPIO con capacidad de entrada: los números de pin de los ejemplos (p. ej., GPIO 15) son ilustrativos, no un requisito.
  • Pull-up de 10 kΩ a 3.3 V en el lado del maestro.
  • Varios DRDY de módulos pueden combinarse en un wired-OR (véase realtime-polling.md → DRDY multimódulo).

Aplicabilidad

  • DRDY se activa solo en actualizaciones de tiempo real (en cada ventana de medida, ~100 ms desde la v1.2).
  • DRDY no se activa en las instantáneas de período (estas se actualizan con el comando de instantánea que emite el master, así que el master ya sabe cuándo leer).
  • Para masters de sondeo lento (cada 1 s o 60 s), DRDY puede ignorarse.
En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::setDrdyPin(pin) / RbAmp::waitDataReady(timeout_ms, ev) conecte el pin DRDY; espere a la siguiente ventana publicada
ESP-IDF rbamp_set_drdy_gpio() / rbamp_wait_data_ready() conecte el pin DRDY; espere a la siguiente ventana publicada
Python — la biblioteca no usa el pin DRDY
ESPHome drdy_pin: entrada DRDY opcional; solo se registra, no se usa como disparador de lectura

Ejemplo de cableado de referencia (ESP32, un módulo)

Otras variantes de módulo

Las demás variantes de módulo usan la misma distribución de pines del lado de baja tensión (VCC / GND / SDA / SCL / DRDY); solo cambia el lado de red.

Siguiente