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

04 · Cableado

Este capítulo describe el cableado físico del módulo rbAmp a placas de la familia ESP32: pinout del lado de baja tensión, requisitos de alimentación, compatibilidad de niveles de tensión I²C, longitud del bus y los pines por defecto de los 7 chips ESP32 compatibles (esp32, esp32s2, esp32s3, esp32c2, esp32c3, esp32c6, esp32h2).

El módulo en sí es todo de baja tensión; en las variantes UI* la referencia de red única es una toma L–N tras un divisor aislado galvánicamente. El lado de BT (alimentación + I²C + DRDY opcional) se describe primero; la conexión a la red y a la pinza de CT está más abajo, en Conexión a la red y a la pinza de CT.

Pinout del lado de baja tensión

Los pines de baja tensión del módulo: VCC, GND, SDA, SCL y la línea opcional de datos listos.
El módulo funciona con lógica I²C de 3.3 V y esTolerante a 5 Ven las líneas de señal. Todos los pines de baja tensión están totalmente aislados galvánicamente de la red.

Pin Señal Finalidad
VCC +5 V (4.5..5.5 V) Alimentación del módulo; mínimo 4.5 V para un funcionamiento correcto
GND Tierra Compartido con el maestro: obligatorio
SDA SDA I²C Datos I²C
SCL SCL de I²C Reloj I²C
DRDY Datos listos (opcional) Drenador abierto, pulso BAJO de ~10 µs cada ~100 ms

Potencia

Parámetros de VCC

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

El módulo lleva un regulador integrado, un filtro RC, condensadores cerámicos y una perla de ferrita: no se requiere filtrado adicional por parte del usuario. El módulo puede alimentarse desde el carril +5V o +5V0 de cualquier placa DevKitC (alimentada por USB-5V).

Compatibilidad de niveles de tensión I²C

  • SDA / SCL funcionan con lógica de 3.3 V (las pull-ups integradas llevan las líneas a 3.3 V).

  • Las líneas toleran 5 V, pero la familia ESP32 ya funciona a 3.3 V de todos modos: no hacen falta convertidores de nivel.

  • El driver i2c_master de ESP-IDF usa salidas de colector abierto en los GPIO: compatibles con los pull-ups integrados del módulo.

Comportamiento al encender

  • Arranque en frío: ~250 ms hasta el primer resultado válido.
  • Tras un reinicio (por software o por caída de tensión): ~250 ms para recuperarse.
  • Hasta el primer resultado válido, los registros se leen como 0, con el indicador DATA_VALID = 0.

El componente espera a que el módulo esté listo dentro de la propia rbamp_begin(dev): el código del usuario simplemente llama a rbamp_begin() y continúa.

Aislamiento

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

Consequences:

  • El GND del módulo no está conectado a la red ni al neutro.
  • Los terminales LV se conectan al ESP32 sin referencia de red: la pinza se acopla magnéticamente y la toma de tensión UI pasa por un divisor aislado galvánicamente. Esto no sustituye las precauciones de cableado de red de la siguiente sección.
Seguridad

⚠ No abra la carcasa del módulo: anula la calibración de fábrica.

Conexión a la red y a la pinza de CT

Cableado del lado de red: la toma de tensión L y N y la pinza en el conductor de línea.

Seguridad

⚠ La tensión de red puede matar. Desconecte y bloquee el circuito antes de conectar los terminales L/N o colocar la pinza; que un técnico cualificado haga el cableado de red y cualquier trabajo dentro de un cuadro. Pinze UN solo conductor (L): nunca el cable completo. Proteja la derivación L con fusible según la normativa local (obligatorio, hasta 0.1 A; con cable AWG26–22 basta: el sensor de tensión consume muy poca corriente).

  • Tensión (solo variantes UI): el módulo mide la tensión desde la conexión L/N de su lado de red: la placa expone los terminales L (fase) y N (neutro), y la polaridad importa para el signo de la potencia. Las variantes I (I1/I2/I3) no tienen entrada de tensión.

  • Corriente: la pinza SCT-013 se conecta a la toma de CT de 3.5 mm del módulo (con muesca para la polaridad correcta; cada toma de la placa está rotulada con su canal, I0, I1, …) y se cierra alrededor del conductor de línea (L). La flecha del cuerpo de la pinza apunta en la dirección de la corriente hacia la carga. Una pinza al revés da una P negativa en una carga consumidora.

  • Pinza el conductor de línea, no el neutro ni los dos conductores juntos.

  • No abra la carcasa del módulo: se anula la calibración de fábrica. Los puentes de pull-up mencionados más abajo están en la cara inferior de la placa; siga las instrucciones del módulo para acceder a ellos.

Resistencias pull-up integradas — en la placa

Importante: cada módulo rbAmp tiene resistencias de pull-up integradas de 4.7 kΩ en SDA y SCL a 3.3 V. Para un único módulo en el bus no hacen falta pull-ups externos: conecte el ESP32 directamente.

El i2c_master_bus_config_t de ESP-IDF también le permite activar los pull-ups internos de GPIO mediante flags.enable_internal_pullup = true. Son débiles (~50 kΩ en el ESP32) y trabajan en paralelo con los 4.7 kΩ externos del módulo: la combinación da unos 4.4 kΩ efectivos, lo que es aceptable. En despliegues de producción, prefiera confiar en los 4.7 kΩ externos del módulo; los pull-ups internos de GPIO son opcionales con los pull-ups propios del módulo y sirven sobre todo para pruebas de banco sin un módulo a mano (por ejemplo, al comprobar un escaneo del bus).

Cuándo desactivar las pull-ups integradas

Si hay varios módulos rbAmp en el bus (u otros dispositivos I²C con sus propios pull-ups), conectarlos en paralelo produce una resistencia efectiva demasiado baja, lo que:

  • Aumenta el consumo de corriente del bus
  • Puede superar la corriente máxima de absorción de la etapa de salida del master I²C
  • Añade capacidad capacitiva en un bus largo aportando poco a la inmunidad al ruido

Solución: en la cara inferior de la placa de cada módulo, junto a las resistencias de pull-up, hay puentes de soldadura (jumpers) (serigrafía Pull-Up). Córtelos con una cuchilla afilada:

  • Deje las resistencias pull-up habilitadas en solo un módulo (o muévalas a un único punto cerca del ESP32).

  • Corte los puentes de los módulos restantes.

Regla general

Reglas de pull-up para uno a tres módulos en un bus corto y para cuatro o más.
| Módulos rbAmp en el bus | Pull-ups | |:---:|---| | 1 | Déjelas como están (la de 4.7 kΩ integrada sirve) | | 2 | Déjelas en uno, corte en el otro | | 3 | Corte en todos los módulos y coloque un par externo de 2.7…3.3 kΩ cerca del ESP32 | | 4…6 | Corte en todos los módulos y un par externo de 2.2…2.7 kΩ cerca del ESP32 | | 7…16 | Corte en todos los módulos y un par externo de 1.5…2.2 kΩ cerca del ESP32; compruebe la capacidad del bus (≤ 400 pF) y reduzca la velocidad del bus si hace falta |

Los valores externos son valores recomendados (calculados a partir de la especificación I²C: corriente de sumidero ≤ 3 mA a 3.3 V, capacidad del bus ≤ 400 pF). Conecte las resistencias de pull-up externas a 3.3 V (el nivel lógico del bus), no a la alimentación de 5 V VCC.

En caso de duda

: mida la resistencia entre SDA y la línea de 3V3 con todos los dispositivos sin alimentar. Debe estar en el rango 1.5..4.7 kΩ. Si es menor, hay demasiadas resistencias pull-up activas en paralelo.

Parámetros del bus I²C

  • Dirección por defecto: 0x50 (7 bits)
  • Rango de direcciones: 0x08..0x77 (reasignable en fábrica)
  • Velocidad recomendada en ESP32: 50 kHz (vea la sección sobre la disciplina de reintento y verificación de coherencia más abajo)

  • Autoincremento del puntero: solo en lecturas. Una lectura en ráfaga + N bytes devuelve N bytes consecutivos a partir de addr (autoincremento). Las escrituras NO se autoincrementan: una escritura en ráfaga + N bytes solo deja el primer byte; el resto se descarta. Los registros de varios bytes se escriben byte a byte: una transacción de un byte separada por cada dirección. Para más detalles vea 09 · Referencia de la API, la sección «Escrituras de varios bytes».

Longitud del bus

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

Cable Longitud máxima Velocidad
JST estándar / 4 conductores planos 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 + buffer I²C (PCA9515 / TCA9617) hasta 3 m 100 kHz
Bus diferencial (PCA9615 / LTC4332) hasta 100 m 100 kHz
Seguridad

Las longitudes anteriores se verificaron a 100 kHz. La velocidad de bus por defecto del componente es 50 kHz (véase «Patrón de NACK de referencia del ESP32» más abajo), que tolera mejor cables más largos; mantenga 50 kHz y no supere estas longitudes.

Para longitudes superiores a 0.15 m es obligatorio un par trenzado: SDA y SCL deben estar en pares distintos, cada uno con su propia masa. SDA y SCL en el mismo par crean un acoplamiento capacitivo 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: la topología principal

El caso de uso canónico de la biblioteca es varios módulos rbAmp en un único bus I²C, gestionados por un ESP32 mediante un manejador de flota. Todas las reglas y optimizaciones siguientes están pensadas precisamente para esta topología; un módulo único es un caso particular (el mismo manejador, pero las llamadas de flota se reducen a triviales).

Varios módulos rbAmp en un mismo bus I2C con las resistencias pull-up gestionadas según las reglas.

Despliegues típicos

Escenario Configuración Número de módulos
Canon del 80 %: acometida principal de la vivienda + submedidores 1× UI1 (principal, energía de red) + 3-6× UI1 (cargas; potencia y Wh requieren una variante UI) 4-7
Subcuadro con desglose de corriente 1× UI1 (principal) + 1-2× I2/I3 (corriente por circuito) 3-5
Submedición industrial 1× UI1 (principal) + N× I2/I3 (por máquina, desglose de corriente) hasta ~16

Restricciones eléctricas

  • Número de módulos: hasta ~16 (capacidad total del bus ≤ 400 pF a 100 kHz).
  • Direcciones: cada módulo tiene su propia dirección de 7 bits (rango 0x08..0x77). Todos salen de fábrica en 0x50: reasígnelos de uno en uno antes de conectarlos en paralelo (vea más abajo la confirmación en dos fases y el aprovisionamiento mediante rbamp_provision()).
  • Pull-ups (importante para el bus de una flota): las pull-ups internas del ESP32 (~45 kΩ) son demasiado débiles para un bus multimódulo con trazas largas y ruido. Para un funcionamiento fiable necesita pull-ups externas (2.7…3.3 kΩ para 3 módulos, menores para buses mayores: véase la tabla anterior) hacia 3.3 V en SCL/SDA en un único punto del bus + desde 4 módulos (o antes, en un bus de más de 15 cm), las pull-ups integradas se cortan en todos los módulos salvo uno; con 2–3 módulos en un bus de hasta 15 cm, déjelas en paz (ese caso está medido), o córtelas en todos y conserve solo las externas. Esto forma parte de la mitigación de tres capas contra el bloqueo del bus en un bus marginal: véase 10 · Solución de problemas.

Direccionamiento — aprovisionamiento y cambio en campo

La dirección de fábrica por defecto es 0x50. Cada módulo nuevo o de reemplazo pasa por el aprovisionamiento (una vez): reasignación de la dirección de 0x50 a una dirección de trabajo, más el guardado opcional de la configuración (modelo de CT, group_id, etiqueta) en flash.

En el código es una sola llamada: rbamp_provision(bus, desired_addr, save_config, &dev). Verifica que realmente hay un único módulo virgen en 0x50 en el bus, lo reasigna mediante una confirmación en dos fases (vea más abajo), guarda opcionalmente la configuración del usuario y devuelve un manejador listo.

Flujo de aprovisionamiento: conecte un módulo nuevo en la dirección 0x50, asígnele su dirección y después el siguiente.

Seguridad

⚠ Disciplina de aprovisionamiento (OBLIGATORIO): debe haber exactamente un módulo virgen (en 0x50) en el bus en el momento en que se llama a rbamp_provision(). Si dos módulos en la misma dirección responden por I²C a la vez — una colisión en la fase de datos —, el comportamiento está indefinido y no hay forma de distinguirlos (open-drain en AND cableado). Ruta de recuperación: corte la alimentación, pase físicamente a una puesta en marcha con un solo módulo, aprovisione uno a uno y después conecte el resto. Véase 10 · Solución de problemas, la sección «Fallo de aprovisionamiento / conflicto de dirección».

Si no tiene un manejador de flota y reasigna la dirección a mano con rbamp_prepare_address_change() + rbamp_commit_address_change() (la forma de bajo nivel), la disciplina es exactamente la misma: un virgen cada vez.

Confirmación en dos fases para un cambio de dirección

El firmware admite un cambio de dirección en modo de producción mediante una secuencia en dos fases:

Los pasos de un cambio de dirección en dos fases: desde la preparación de la nueva dirección hasta su verificación.

Text
1. write candidate_addr → REG_I2C_ADDRESS (0x30, in RAM)
2. write 0xA5 → REG_ADDR_COMMIT_MAGIC (0x31, armed)
3. issue CMD_COMMIT_ADDR (opcode 0x30 in REG_COMMAND)
4. issue CMD_RESET (0x01)
5. wait ~300 ms; the new address is active

El componente envuelve esto en rbamp_prepare_address_change() / rbamp_commit_address_change() — véase 09 · Referencia de API. La persistencia se confirma solo tras un reinicio (véase el aviso «Modo de producción frente a modo de fábrica» en 03_sensor_selection.md).

Presupuesto energético del bus: cuántos módulos puede sostener su frecuencia de sondeo

En un bus de 50 kHz, una transacción de lectura de un registro ≈ 200-400 µs (depende del driver del MCU). Un bloque RT completo de un canal (U + I + P + PF) = 4 floats = 16 bytes + 4 fases de dirección ≈ 5-8 ms por canal.

Configuración Bus por ciclo A 50 kHz Frecuencia máxima de sondeo
1× UI1, bloque RT ~5 ms < 5 ms 100+ Hz (pero el módulo actualiza a 10 Hz)
1× I3, bloque RT + período ~25 ms ~25 ms hasta 10 Hz
5× UI1, bloque RT ~25 ms ~25 ms hasta 10 Hz
16× I3, RT + período ~400 ms 400 ms > 100 ms no puede seguir el ritmo del módulo (10 Hz); como mucho ~2 Hz
Nota

Las cifras anteriores son estimaciones y dependen del MCU anfitrión y del driver.

Regla: a 50 kHz, los límites cómodos son 8–10× I3 o 15–16× UI1 con sondeo a 5 Hz (cada segunda ventana de módulo), y aproximadamente la mitad a los 10 Hz completos. Por encima de eso:

  • Reduzca la frecuencia de sondeo (1 Hz = 10× de margen).
  • Pase a 100 kHz con reintento (espere NACK frecuentes y confíe en el reintento).
  • Use el pin DRDY para trabajo asíncrono: no sondee módulos que todavía no están listos.

Sincronización de período: sincronizar períodos para una sincronía ajustada

Para la medición tarifaria, todos los módulos deben tomar su instantánea en el mismo intervalo de tiempo. Dos estrategias:

Enclavamiento secuencial de cada módulo, comparado con una trama General-Call que enclava todos los módulos a la vez.

Estrategia 1 — instantánea secuencial + asentamiento compartido (funciona con cualquier firmware):

C
/* Phase 1: sequential snapshot */
for (int i = 0; i < n; i++) {
    rbamp_latch_period(devs[i]);
}

/* Phase 2: shared settle (≥ 50 ms for the snapshot + ~1 commit cycle for witness) */
vTaskDelay(pdMS_TO_TICKS(50));

/* Phase 3: read snapshots with skip_latch=true */
rbamp_period_snapshot_t snaps[n];
for (int i = 0; i < n; i++) {
    rbamp_read_period_snapshot(devs[i], &snaps[i], 0, /*skip_latch=*/true);
}

Desfase entre módulos: 16 módulos × ~1 ms/instantánea = ~16 ms respecto a un período de 60 segundos → 0.027 %. Despreciable.

Estrategia 2 — instantánea de difusión General-Call (requiere habilitación):

Todos los módulos reciben la instantánea en una única trama I²C en la dirección 0x00:

Disposición de la trama de 5 bytes de instantánea General-Call enviada a la dirección 0x00.

Text
addr=0x00 | A5 27      (5 bytes)

Desfase = 0 (atómico). Preconfiguración:

  1. En cada módulo habilite REG_FLEET_CONFIG.bit0 = 1 mediante CMD_SAVE_USER_CONFIG.
  2. CMD_RESET — la recepción GC se activa al arrancar.
  3. Tras el reinicio, el maestro envía la trama de 5 bytes.
  4. Testigo: para cada módulo esperado, lea REG_V03_PERIOD_VALID (0x07). !=1 → vuelva a la estrategia 1.

Cuándo usar cada uno:

  • < 8 módulos: estrategia 1 (más sencilla, no requiere habilitación).
  • ≥ 8 módulos o sincronización estrecha: estrategia 2.

Filtrado por grupo GC: un bus multiinquilino

REG_GROUP_ID (0x28) le permite tener varios dominios GC en un único bus:

  • group = 0x00 → llamada general (todos los módulos con GC habilitado toman la instantánea).
  • group = N → solo los módulos con REG_GROUP_ID = N toman la instantánea.

Ejemplo: un bus con 10 módulos, donde necesita tomar instantáneas de 5 para la tarifa A y 5 para la tarifa B de forma independiente:

Text
write REG_GROUP_ID = 1 on the 5 tariff-A modules
write REG_GROUP_ID = 2 on the 5 tariff-B modules

GC frame [A5 27 01 tl th] → only tariff A takes a snapshot
GC frame [A5 27 02 tl th] → only tariff B takes a snapshot
GC frame [A5 27 00 tl th] → all 10 take a snapshot (all-call)

Modos de fallo en un bus con varios módulos

Síntoma Causa Qué hacer
i2c bus scan muestra varios módulos en la misma dirección tras añadir uno en campo El nuevo módulo en 0x50 entra en conflicto con uno ya direccionado Vuelva a grabar la nueva dirección del módulo por separado antes de añadirlo al bus
Un módulo empieza a dar NACK más a menudo que los demás Fallo de cable / caída de VCC en ese módulo Compruebe VCC con carga y los niveles lógicos
Los Wh de un módulo divergen de forma constante El temporizador propio del módulo difiere del reloj del maestro Integre la energía frente al reloj maestro (master_dt_ms)
Tras una trama GC, un módulo no toma la instantánea FLEET_CONFIG.bit0 = 0 o grupo no coincidente Compruebe REG_FLEET_CONFIG y REG_GROUP_ID

Notas de diseño del bus

  • Estiramiento de reloj (clock stretching): el firmware actual minimiza el estiramiento (la ventana __disable_irq en LatchPeriod es corta, ~µs). La instantánea en sí no retiene SCL de forma significativa. Para el Raspberry Pi BCM283x (un error hardware conocido de estiramiento de reloj): aplique la precaución habitual — ya se recomiendan 50 kHz + reintento.
  • Longitud del bus con más de 4 módulos: incluso con par trenzado, la capacidad efectiva crece linealmente con el número. Considere un buffer I²C (PCA9515) con ≥ 8 módulos y una longitud superior a 1 m.

Los escenarios detallados con varios módulos están en 06 · Ejemplos, en los escenarios «Submedición en bus compartido» e «Instantánea de difusión GC».

Pinout en la familia ESP32

Los 7 chips enumerados al inicio de este capítulo son compatibles (según idf_component.yml). A continuación se indican los pines I²C por defecto recomendados; en despliegues de producción, elija el GPIO según la disposición concreta de su placa.

ESP32 (original / DevKitC / WROOM)

Cableado de referencia de un ESP32 a un módulo rbAmp con la pinza en la toma I0.

C
const i2c_master_bus_config_t bus_cfg = {
    .i2c_port  = I2C_NUM_0,
    .sda_io_num = GPIO_NUM_21,
    .scl_io_num = GPIO_NUM_22,
    .clk_source = I2C_CLK_SRC_DEFAULT,
    .glitch_ignore_cnt = 7,
    .flags.enable_internal_pullup = true,
};
Pin GPIO
SDA GPIO21
SCL GPIO22
DRDY cualquier GPIO libre que no sea de arranque (en el ESP32 clásico evite GPIO0/2/12/15)

ESP32-S2

Los mismos GPIO21/22 por defecto que el ESP32 original. El S2 no tiene Bluetooth: queda disponible unos ~30 kB adicionales de heap para escenarios TLS.

ESP32-S3

El S3 no tiene I²C fijos en el hardware: cualquier GPIO mediante la matriz. En la mayoría de las placas de desarrollo WROOM-S3, GPIO8/GPIO9 son una opción cómoda (compruebe el esquema de su placa: en la N16R8 estos pines pueden estar ocupados por la flash QSPI; USB-JTAG usa GPIO19/20). Ajuste los campos sda_io_num / scl_io_num de i2c_master_bus_config_t:

C
.sda_io_num = GPIO_NUM_8,
.scl_io_num = GPIO_NUM_9,

El S3 tiene USB-OTG: puede usarse para depurar sin un chip USB-UART externo.

ESP32-C2 / C3 / C6 / H2

Chips mononúcleo RISC-V (el C3 y el C6 son mononúcleo; el H2 es mononúcleo con BLE+802.15.4; el C2 es mononúcleo con RAM limitada). Los pines I²C no están fijados en hardware: aquí tiene un ejemplo para el ESP32-C3 (en la C3-SuperMini, GPIO5/GPIO6 son cómodos; en la C3-DevKitM-1 el USB-JTAG ocupa GPIO18/19, y GPIO8/9 son de arranque):

C
const i2c_master_bus_config_t bus_cfg = {
    .i2c_port  = I2C_NUM_0,
    .sda_io_num = GPIO_NUM_5,
    .scl_io_num = GPIO_NUM_6,
    .clk_source = I2C_CLK_SRC_DEFAULT,
    .glitch_ignore_cnt = 7,
    .flags.enable_internal_pullup = true,
};

Para los demás chips, consulte la documentación de ESP-IDF específica del objetivo (docs.espressif.com → ESP-IDF v5.2+ → su chip → referencia de API → periféricos → I2C).

ESP32-P4: no es un objetivo admitido

El ESP32-P4 no está en la lista de objetivos compatibles: el soporte de P4 requiere ESP-IDF v5.3+, mientras que el mínimo del componente es v5.2 (una compilación v5.2 para esp32p4 fallaría con «target esp32p4 not in idf»).

Patrón base de NACK del ESP32: velocidad de bus de 50 kHz

Con el driver i2c_master de ESP-IDF v5, rbAmp presenta NACK frecuentes a 100 kHz, muchos menos a 50 kHz (una característica del driver en el lado del ESP32, no del esclavo). El componente lo cubre en dos capas:

  1. Velocidad de bus por defecto de 50 kHz mediante el Kconfig CONFIG_RBAMP_DEFAULT_I2C_FREQ_HZ=50000. El componente solicita esta frecuencia al añadir su manejador de dispositivo al bus que usted crea.

  2. Reintento por byte — CONFIG_RBAMP_NACK_RETRY_ATTEMPTS=3 × pausa de 5 ms. A 50 kHz la tasa de error residual es < 0.8 %.

Si es necesario, sustituya el valor mediante idf.py menuconfig:

Text
CONFIG_RBAMP_DEFAULT_I2C_FREQ_HZ=50000
CONFIG_RBAMP_NACK_RETRY_ATTEMPTS=5     # for dense workloads
CONFIG_RBAMP_NACK_RETRY_GAP_MS=5
CONFIG_RBAMP_I2C_TIMEOUT_MS=200

Para más detalles sobre el diagnóstico de problemas a nivel de bus, vea 10 · Solución de problemas.

DATA_READY (DRDY)

Un pin opcional para optimizar el sondeo. Si la aplicación consulta el módulo como máximo una vez cada 100 ms, DRDY puede quedar sin conectar.

Parámetros eléctricos

  • Tipo de salida: drenador abierto (sin pull-up activa a VCC)
  • Nivel de reposo: ALTO (requiere una resistencia pull-up en el lado del maestro — un gpio_pullup_en() interno o una resistencia externa; se recomienda 10 kΩ a 3.3 V)

  • Pulso de listo: BAJO durante ~10 µs después de que los registros RT se hayan actualizado con datos nuevos

  • Frecuencia de pulso: ~10 Hz (un pulso por ventana RT de ~100 ms)

Semántica

Un flanco de bajada en DRDY garantiza que todos los registros RT están sincronizados y publicados (el firmware los actualiza de forma atómica en la ISR antes de bajar el pin). Tras el flanco de bajada, el master puede leer el bloque RT sin riesgo de obtener una muestra partida.

Patrón de interrupción: semáforo de FreeRTOS

ESP-IDF ofrece un modelo limpio: una ISR en IRAM activa un semáforo binario, y una tarea de FreeRTOS separada espera el semáforo y lee RT.

C
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/semphr.h"
#include "driver/gpio.h"

#define DRDY_GPIO GPIO_NUM_4   /* a free GPIO; do not use
                                 * GPIO0/2/12/15 — strapping pins
                                 * (ESP32 classic), they can disrupt boot
                                 * if the open-drain DRDY goes LOW
                                 * during reset */
static SemaphoreHandle_t drdy_sem;

static void IRAM_ATTR drdy_isr_handler(void *arg) {
    BaseType_t hi_task_woken = pdFALSE;
    xSemaphoreGiveFromISR(drdy_sem, &hi_task_woken);
    if (hi_task_woken) portYIELD_FROM_ISR();
}

void bidir_task(void *arg) {
    rbamp_handle_t dev = arg;
    while (1) {
        if (xSemaphoreTake(drdy_sem, portMAX_DELAY) == pdTRUE) {
            float p;
            if (rbamp_read_power(dev, 0, &p) == ESP_OK) {
                /* integrate + publish */
            }
        }
    }
}

void app_main(void) {
    /* ...rbamp_new + rbamp_begin... */

    drdy_sem = xSemaphoreCreateBinary();

    /* The ISR service is installed ONCE for the whole project — if another
     * component (LCD, encoder, anything) has already installed it,
     * gpio_install_isr_service() returns ESP_ERR_INVALID_STATE.
     * This is normal, do not fail on it. ESP_INTR_FLAG_IRAM keeps the
     * ISR dispatcher in IRAM — important for the single-core C3/C6/H2/S2,
     * where non-IRAM code is unavailable while the flash cache is disabled. */
    esp_err_t err = gpio_install_isr_service(ESP_INTR_FLAG_IRAM);
    if (err != ESP_OK && err != ESP_ERR_INVALID_STATE) {
        ESP_ERROR_CHECK(err);
    }

    gpio_config_t io_cfg = {
        .pin_bit_mask = 1ULL << DRDY_GPIO,
        .mode         = GPIO_MODE_INPUT,
        .pull_up_en   = GPIO_PULLUP_ENABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type    = GPIO_INTR_NEGEDGE,
    };
    gpio_config(&io_cfg);
    gpio_isr_handler_add(DRDY_GPIO, drdy_isr_handler, NULL);

    /* Priority 6 — above idle (0), below WiFi (23) and the standard
     * MQTT (5+). 4096 bytes of stack are enough for rbamp_read_* +
     * ESP_LOG; if you add an MQTT publish right in this task —
     * raise it to 6144. On dual-core ESP32/S3, for a clean
     * separation from the WiFi task (usually core 0), you can pin
     * this task to core 1: xTaskCreatePinnedToCore(..., 1).
     * On the single-core C3/C6/H2/S2 — keep xTaskCreate. */
    xTaskCreate(bidir_task, "bidir", 4096, dev, 6, NULL);
}

DRDY es opcional: sondear a cualquier frecuencia ≤ 10 Hz funciona también sin él. El componente no depende de DRDY en ninguna de sus rutas.


Fuente y incidencias: rb-amp/rbamp-esp-idf · esta página en el repositorio: docs/04_hardware.md (v1.7.3)