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.
⚠ 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) |
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 |
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.
: 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)
⚠ 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.
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 |
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:
- 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)
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 > 0significa consumo (corriente que entra en la carga desde la red),P < 0significa 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.
: 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.
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.
⚠️ 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 > 0para consumo,P < 0para 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.
— 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
- initialization.md: primera conexión, prueba de funcionamiento, cambio de dirección
- troubleshooting.md → Pinza CT y polaridad: qué hacer si el signo de P es incorrecto o I_rms es inestable