rbAmp
ES
Tienda
Docs
Actualizado

05 · Resolución de problemas

Este capítulo es una referencia rápida de problemas habituales y sus soluciones. Cada entrada sigue la estructura:

  • Síntoma: lo que observa el usuario
  • Causas: por qué puede ocurrir
  • Qué comprobar / qué hacer— acciones concretas
    Diagrama de flujo para acotar un problema a partir del síntoma.

Bus I²C

1. NACK / sin respuesta del módulo

Síntoma: Wire.endTransmission() devuelve un valor distinto de cero; i2cdetect no muestra la dirección en Linux; rb_read_u8() devuelve 0xFF.

Causas y comprobaciones:

  • ❌ Falta la alimentación del módulo o es inestable: mida VCC con un multímetro; debe estar entre 4.5 y 5.5 V.
  • ❌ Sin masa común: el error más frecuente. La masa del master y la masa del módulo deben estar unidas.
  • ❌ SDA y SCL intercambiados: verifique con el esquema de cableado de hardware-connection.md.
  • ❌ Sin resistencias pull-up en el bus: si se han cortado las pull-up integradas en un módulo y no hay ninguna externa instalada, el bus queda inoperativo. Con todo sin alimentar, mida SDA↔VCC: debe leer 1.5–4.7 kΩ.
  • ❌ Demasiadas pull-ups en paralelo: las pull-ups integradas siguen activas en muchos módulos (cuatro o más), más las del maestro, lo que reduce la resistencia equivalente a menos de ~1 kΩ. El maestro no puede llevar el bus a BAJO. Retire las pull-ups integradas de todos los módulos menos uno.
  • ❌ Cable largo sin par trenzado ni buffer: a partir de ~0.15 m, los hilos paralelos se acoplan capacitivamente y los flancos se redondean. Use UTP cat-5 (hasta 1 m) o un buffer PCA9515 (hasta 3 m). Véase hardware-connection.md → Longitud del bus.
  • ❌ Dirección de esclavo incorrecta: es posible que el módulo se haya readdresado. Ejecute un escaneo I²C:
C++
void i2c_scan() {
  for (uint8_t addr = 0x08; addr < 0x78; addr++) {
    Wire.beginTransmission(addr);
    if (Wire.endTransmission() == 0) {
      Serial.printf("Found device at 0x%02X\n", addr);
    }
  }
}
  • ❌ Velocidad I²C demasiado alta para la longitud del cable. Reduzca a 50 kHz: Wire.setClock(50000);.

2. Tiempos de espera de lectura/escritura intermitentes

Síntoma: las transacciones a veces tienen éxito y otras veces fallan, sobre todo en entornos eléctricamente ruidosos o cerca de cargas inductivas.

Causes:

  • ❌ Cable largo sin par trenzado
  • ❌ Cable tendido en paralelo al cableado de red → acoplamiento a 50 Hz / 100 Hz
  • ❌ Masa ruidosa en el lado del master (p. ej., un regulador independiente sin condensador de masa)
  • ❌ Capacidad parásita entre SDA y GND superior a 100 pF (p. ej., un empalme con derivaciones largas)

Solutions:

  • Use par trenzado (SDA + GND en un par, SCL + GND en el otro)
  • Evite tender el I²C en paralelo con el cableado de potencia en el mismo conducto
  • Reduzca la velocidad a 50 kHz / añada 100 nF entre VCC y GND del módulo, cerca del conector
  • Para tiradas largas fuera de una carcasa, añada protección ESD (diodos TVS en SDA y SCL)
En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() agotó los reintentos de bus y rechazó lecturas
ESP-IDF rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() agotó los reintentos de bus y rechazó lecturas
Python dev.sanity_reject_count / contadores de MachineI2CBackend cuente las lecturas rechazadas; contadores de reintentos en el backend de MicroPython
ESPHome — no se exponen contadores de diagnóstico

3. DATA_VALID (0xCE) nunca pasa a 1

Síntoma: el master lee 0xCE y siempre obtiene 0x00. Otros registros también pueden quedarse en cero.

Causes:

  • ❌ El módulo no ha terminado de arrancar (normal durante los primeros ~250 ms tras el encendido)
  • ❌ Error de inicialización del firmware: lea REG_ERROR (0x02):
  • 0xFB (ERR_FLASH_PARAMS_BAD): el bloque de parámetros de la flash está dañado; el módulo funciona con valores por defecto. Recalibre o vuelva a aprovisionar.
  • 0xFA (ERR_LUT_BAD): la tabla de calibración de fábrica está dañada. No es fatal: las medidas continúan, aunque la precisión puede reducirse. Pida al proveedor que recalibre.
  • ❌ Fallo del reloj del MCU (raro): corte la alimentación del módulo

Solutions:

  • Espere 300 ms tras el encendido antes de sondear 0xCE.
  • Si no aparece DATA_VALID = 1 tras más de 1 s, corte y restablezca la alimentación.
  • Si el problema persiste tras un corte de alimentación, compruebe la alimentación (rizado, caídas de tensión).
En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() espere el indicador de listo; lea el código de error del dispositivo
ESP-IDF rbamp_wait_ready() / rbamp_read_last_error() espere el indicador de listo; lea el código de error del dispositivo
Python dev.wait_ready(timeout_ms=1000) / dev.read_last_error() espere el indicador de listo (lanza excepción si hay tiempo de espera); lea el código de error del dispositivo
ESPHome comprobación de disponibilidad de update() / get_last_error_str() las lecturas se publican una vez que el módulo informa de que está listo; el código de error en texto

Calibración y precisión

4. I_rms cercana a 0 mientras hay una carga en marcha

Síntoma: la lámpara está encendida, el calefactor está caliente, pero I_rms muestra 0.001 A o oscila entre 0 y unos pocos mA.

Causas (en orden decreciente de frecuencia):

  • ❌ Pinza CT que no rodea el cable: el conductor pasa junto a la pinza en lugar de atravesarla.
  • ❌ Pinza CT en L y N a la vez: los flujos de línea y neutro se cancelan y el sensor lee casi cero. Vea hardware-connection.md → Sensor de corriente. La pinza debe ir en un solo conductor (línea/L).
  • ❌ Pinza no cerrada del todo: un hueco > 0.1 mm entre las mitades del núcleo aumenta mucho la reluctancia magnética y la salida del sensor cae muy por debajo de lo normal. Desenganche y vuelva a encajar hasta que haga clic. El polvo o el óxido en el hueco son una causa frecuente: limpie las superficies de contacto.
  • ❌ Conector de 3.5 mm suelto: retire el conector y vuelva a insertarlo.
  • ❌ REG_CT_MODEL sin establecer: el módulo no conoce la sensibilidad del sensor. Vea initialization.md → Configuración de la clase del sensor y del modelo de CT. El registro 0x05 debe contener el código de modelo correcto.
  • ❌ Código de modelo incorrecto escrito: por ejemplo, un sensor SCT-013-030 con el código SCT-013-010 → la corriente mostrada será ~3× menor que la real (y a la inversa, un código demasiado grande lee alto). Compruebe el marcado de la carcasa del sensor frente al código de modelo.
  • ❌ Corriente por debajo del nivel de ruido: para cargas muy pequeñas (< ~10 mA en una pinza de 30 A) la salida del sensor está cerca del nivel de ruido. El firmware aplica una sustracción de ruido en cuadratura: I_corrected = √(I_raw² − NF²). Si I_raw ≤ NF, el resultado se fija en 0. Es un comportamiento previsto.

5. I_rms desviado en un factor grande

Síntoma: la carga real es ~10 A (según el medidor de referencia), el módulo muestra 3 A o 30 A.

Causes:

  • ❌ Código de modelo de CT incorrecto: el caso más frecuente. Véase #4.
  • ❌ Modelo de CT incorrecto instalado: se ha colocado una pinza de 100 A donde la configuración exige una de 30 A (o al revés).
  • ❌ Pinza no cerrada del todo (vea #4): normalmente lee un 5–20 % bajo.
  • ❌ Sospecha de deriva de la calibración de fábrica: si se descartan todas las causas anteriores y la discrepancia persiste con una carga de referencia conocida, contacte con su proveedor de módulos; la recalibración es una operación de fábrica.

6. El signo de P_real es incorrecto (el consumo aparece como exportación)

Síntoma: la carga claramente consume (calefactor caliente, lámpara encendida), pero P_real < 0.

Causas y soluciones:

  • ❌ L y N intercambiados en los bornes de tensión: la causa más frecuente. Vea hardware-connection.md → Sensor de tensión. Intercambie L y N en la PCB.
  • ❌ Pinza CT instalada al revés: la flecha de la pinza debe apuntar en el sentido de la corriente hacia la carga (cuadro → carga). Si apunta al revés, desenganche la pinza y gírela.
  • ❌ La inversión física no es práctica: en BASIC el acumulador de periodo (PERIOD_AVG_P_W) fija a cero las muestras negativas, así que con la polaridad invertida el registro de energía se queda en 0 hasta que se corrige la polaridad física; invertir el signo en el código del maestro (p_corrected = -p_raw) solo corrige su propia integración RT, nunca los datos de periodo del módulo. Corrija el cableado.

7. El total de energía difiere de un medidor de referencia en unos pocos por ciento

Síntoma: E_Wh durante una hora difiere del contador de la compañía en un 2–10 %.

Causas probables (en orden decreciente):

  • ❌ Pinza no cerrada del todo (hueco): normalmente −5 a −20 % bajo. La causa más común. Desenganche, limpie las superficies de contacto y vuelva a encajar hasta cerrarla por completo.
  • ❌ Pinza instalada en un cable «secundario»: dentro del cuadro de distribución, en un latiguillo corto tras un magnetotérmico. Los campos parásitos de los magnetotérmicos vecinos introducen errores. Traslade la pinza al alimentador principal o a un tramo aislado del conductor.
  • ❌ Cerca de cargas reactivas fuertes: cerca de transformadores, motores asíncronos, SAI. Los campos magnéticos de inductores vecinos generan una señal espuria. Aleje la pinza ≥ 10 cm de cualquier componente ferromagnético.
  • ❌ FP bajo (≤ 0.5): las cargas reactivas grandes exigen una compensación de fase precisa. La precisión se especifica para cargas resistivas (FP ≈ 1); no se especifica para cargas muy reactivas. Si la precisión con un perfil de FP concreto es crítica, contacte con su proveedor de módulos para orientación.
  • ❌ Tensión de red distorsionada (microcortes, armónicos de orden alto): el cálculo RMS y el valor medio son más robustos que la detección de pico, pero la precisión no está especificada para tensión de red muy distorsionada; si esto afecta a su instalación, consulte a su proveedor.
  • ❌ Cable de CT dañado o conector flojo: circuito abierto o soldadura fría dentro del conector. Compruébelo con un multímetro, con la toma desconectada del módulo (la pinza CT es un transformador reductor; el devanado secundario debe medir entre 50 y 200 Ω según el modelo).

8. avg_P_W es mucho menor de lo esperado

Síntoma: un calentador de 1000 W está encendido, RT P_real ≈ 1000 W, pero PERIOD_AVG_P_W marca ~200 W en un periodo de un minuto.

Causes:

  • ❌ La carga es realmente intermitente (termostato de ciclo, elemento que pulsa): avg_P_W informa correctamente de la media temporal. Compruebe con PERIOD_MAX_P_W (0xE0) para ver el pico dentro de cualquier ventana de medición.
  • ❌ Si la carga es estable y RT P_real ≈ avg_P_W no se cumple:
  • En nivel BASIC: compruebe el signo en RT de P_real. Si P es ocasionalmente negativa (por ejemplo, porque un inversor solar devuelve energía a la red), las muestras negativas se excluyen de PERIOD_AVG_P_W, lo que arrastra la media a la baja. Vea period-metering.md → nivel BASIC.

9. PERIOD_VALID = 0 tras una instantánea

Síntoma: el master emite CMD_LATCH_PERIOD, lee 0x07 y obtiene 0. La instantánea no es reciente.

Causes:

  • ❌ Instantáneas demasiado juntas: no se completó ninguna ventana RT (~100 ms desde la v1.2; 200 ms antes) entre dos instantáneas. El acumulador está vacío y la instantánea se descarta.
  • ❌ Carrera con una confirmación RT: raro; el master escribió el comando en el instante exacto en que el firmware confirmaba el acumulador en vivo. Posible en masters muy rápidos.

Solución: el patrón de reintento (véase period-metering.md → Ciclo básico):

C++
if ((rb_read_u8(0x50, 0x07) & 0x01) == 0) {
  delay(250);   // let at least one RT window complete
  rb_write_u8(0x50, 0x01, 0x27);
  delay(50);
  // retry read of PERIOD_VALID
}
En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() compruebe el bit de instantánea lista; tome y valide una instantánea de periodo
ESP-IDF rbamp_is_period_valid() / rbamp_read_period_snapshot() compruebe el bit de instantánea lista; tome y valide una instantánea de periodo
Python dev.is_period_valid() / dev.read_period_snapshot() compruebe el bit de instantánea lista; tome y valide una instantánea de periodo
ESPHome Instantánea de período no válida lo que registra el componente cuando el indicador de validez es 0; la primera instantánea tras el arranque se descarta

Problemas con varios módulos

10. Colisión de direcciones

Síntoma: se añadieron varios módulos al bus; algunos «desaparecen» o devuelven basura. La misma dirección responde con valores distintos.

Causa: dos o más módulos comparten la misma dirección → arbitraje / colisión I²C. Es frecuente justo tras desembalar, cuando todos los módulos están en la dirección de fábrica 0x50.

Forma más sutil: la dirección responde de forma estable, pero el UID leído en 0x5C (cap. 11 §4.8) no coincide con ningún módulo conocido. Dos módulos responden a la vez: el bus combina sus salidas en un AND por cable y produce un UID estable pero ficticio. Si un hub ve un «UID desconocido» en una dirección que aprovisionó, sospeche una colisión antes que un módulo ajeno.

Solution:

  1. Desconecte cada módulo.
  2. Reconecte uno a uno: nunca cambie la dirección con dos módulos de fábrica en el bus; cambie la dirección de cada uno a una dirección única.
  3. Tras readdresar todos los módulos, conéctelos en paralelo y verifique la dirección de cada uno leyendo su UID.

Véase initialization.md → Flujo de trabajo recomendado.

En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmpFleet::checkConflict() / RbAmpFleet::scan() compruebe una dirección por si hay un segundo dispositivo; escanee el bus en busca de módulos
ESP-IDF rbamp_fleet_check_conflict() / rbamp_fleet_scan() compruebe una dirección por si hay un segundo dispositivo; escanee el bus en busca de módulos
Python fleet.check_conflict(addr) / fleet.scan() compruebe una dirección por si hay un segundo dispositivo; escanee el bus en busca de módulos
ESPHome rbamp: lista un bloque por módulo, cada uno con su propio id y address

11. El DRDY en OR cableado se dispara varias veces en rápida sucesión

Síntoma: con DRDY wired-OR, el EXTI del maestro se dispara cada 1–5 ms varias veces seguidas.

Causa: los módulos no están perfectamente sincronizados; cada uno tiene su propio cristal, y los periodos de ventana RT difieren ligeramente (99.9 ms frente a 100.1 ms). A lo largo del intervalo de ventanas, los módulos tiran de la línea en instantes ligeramente distintos.

Esto es normal. Soluciones:

  • Ignore los disparos «dobles»: tras el primer disparo, lea todos los módulos; suprima nuevos disparos durante ~10 ms.
  • Use la instantánea de difusión (vea period-metering.md → Enfoque 2) para una sincronización precisa, pero solo para instantáneas de período, no para RT.
  • Pase a DRDY por módulo: cada módulo en su propio GPIO.

12. Bus I²C ocupado cuando se activa DRDY

Síntoma: DRDY se activa mientras el master ya está en una transacción con otro módulo. El manejador de EXTI se retrasa.

Esto es normal. Los registros RT siguen válidos hasta el siguiente commit (una ventana, ~100 ms después). El maestro:

  • Termina la transacción en curso.
  • Atiende el EXTI retardado y lee el siguiente módulo.
  • Latencia: normalmente 1–10 ms; no es crítica.

13. Deriva del reloj de varios módulos en pruebas largas

Síntoma: la energía acumulada diverge entre módulos en fracciones de un por ciento a lo largo de una semana.

Causa: cada rbAmp tiene su propio cristal con deriva de ±50 ppm (1–5 s/día).

Solución: integrada en la arquitectura: el master usa su propio reloj para multiplicar por dt. Todos los módulos comparten la misma referencia de tiempo, así que el total de Wh del sistema no diverge.

Para medir la deriva del chip con fines de QA, compare PERIOD_LATCH_MS (0xEC) con el dt del master:

C++
uint32_t chip_dt = rb_read_u32(0x50, 0xEC);
float ratio = (float)chip_dt / (float)master_dt;
printf("Chip drift: %.3f (1.000 = perfect)\n", ratio);

Umbral de aceptación para PERIOD_LATCH_MS: un recuento inferior de hasta un 30 % es normal bajo carga (cociente tan bajo como ~0.70). La base de tiempos interna de diagnóstico del módulo se lee corta cuando el módulo está ocupado: es así por diseño. El margen del 30 % es una propiedad de la base de tiempos del módulo, no un fallo. Aplique este umbral de forma uniforme en todos los modelos y niveles.

El umbral heredado del 3 % de la documentación anterior es incorrecto para v1.3 y rechazará en masa módulos sanos; no lo use.

Esta deriva solo afecta al registro de diagnóstico del lado del chip; la precisión de la energía no se ve afectada, porque Wh se calcula en el lado del maestro como avg_P × master_dt (véase period-metering.md). Si el propio master_dt se desvía (el reloj del MCU maestro deriva), aplique la corrección NTP/SNTP propia del maestro: PERIOD_LATCH_MS no es la referencia adecuada.

En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::readPeriodLatchMs() lea la longitud de periodo del lado del módulo (solo diagnóstico)
ESP-IDF rbamp_read_period_latch_ms() lea la longitud de periodo del lado del módulo (solo diagnóstico)
Python dev.read_period_latch_ms() lea la longitud de periodo del lado del módulo (solo diagnóstico)
ESPHome — no expuesto

Alimentación y flash

14. Corte de alimentación durante un comando de escritura en flash → escritura parcial en flash

Síntoma: tras un corte de alimentación durante un comando de escritura en flash (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR), el módulo arranca con REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) y el bit3 de EVENT_FLAGS activado.

Qué ocurrió: el firmware detectó un fallo de CRC en el bloque de configuración de usuario de la flash, cargó los valores de fábrica y los volvió a escribir.

Solution:

  • Se restauran los valores de fábrica: el módulo funciona, pero se pierden su dirección personalizada y la configuración del sensor.
  • Vuelva a aplicar la configuración: fije SENSOR_CLASS + vincule CT_MODEL por canal + ejecute CMD_SAVE_USER_CONFIG (y repita el cambio de dirección si hace falta).
  • Para evitarlo en el futuro: no corte la alimentación durante al menos 1 segundo después de cualquier comando de escritura en flash. La ventana de borrado y escritura de la flash en sí es de ~700 ms; deje margen.

15. El módulo está caliente

Síntoma: la carcasa se nota claramente caliente.

Normal: con corriente de red hasta la nominal (según el modelo), es normal un ligero calentamiento del lado de BT (regulador LDO) hasta ~40 °C.

No es normal: carcasa caliente (≥ 60 °C), olor a quemado, decoloración del plástico.

Causes:

  • ❌ Sobretensión en el lado de baja tensión (VCC > 5.5 V): compruebe la alimentación.
  • ❌ Daño interno en el lado de red (cortocircuito en el divisor o en el circuito de la CT).
  • ❌ Pinza CT externa sobrecargada (corriente por encima del rango del sensor).

Acción: desconecte la alimentación de inmediato, aísle el módulo y contacte con el proveedor.

Cableado del sensor: errores críticos

16. Comprobación de coherencia: qué significa «cableado correctamente»

Tras instalar o reinstalar un módulo, ejecute una prueba de humo con una carga conocida puramente resistiva (bombilla incandescente, hervidor eléctrico, resistencia calefactora); por ejemplo, una bombilla de 100 W a 230 V.

Expected:

  • U_rms ≈ 220..240 (depende de la red local)
  • I_rms ≈ 100 W / 230 V ≈ 0.43 A
  • P_real ≈ +100 W (positiva, consumo)
  • PF ≈ 0.998..1.000 (carga resistiva)
  • Q ≈ 0 (sin contenido reactivo)

Si P_real es negativa: véase #6; L/N intercambiados o CT instalada al revés. Si |I_rms − esperada| > 10 %: véase #5; modelo de CT incorrecto o pinza sin cerrar. Si |P_real − U × I| > 5 % con PF = 1: la compensación de fase puede estar desajustada; póngase en contacto con el proveedor.

17. Lista de comprobación previa a la puesta en marcha

Antes de alimentar un módulo en un sistema de producción:

  • [ ] L conectado al terminal L de la placa (no intercambiado con N)
  • [ ] Pinza CT en el conductor L (no en N, ni en ambos a la vez)
  • [ ] Flecha de la pinza CT apuntando hacia la carga
  • [ ] Pinza CT completamente cerrada (sin hueco ni holgura: encájela hasta que haga clic)
  • [ ] Cable de la pinza CT íntegro, conector totalmente insertado en la toma
  • [ ] Alimentación VCC dentro de 4.5…5.5 V, masa limpia
  • [ ] Pull-ups I²C verificadas (véase hardware-connection.md → Pull-ups I²C)
  • [ ] En los módulos BASIC de la serie SCT: REG_CT_MODEL escrito y guardado para que coincida con el sensor instalado
  • [ ] Prueba de funcionamiento con carga resistiva completada: los cinco valores (U, I, P, FP, Q) dentro de los rangos esperados

Si algún elemento no está marcado, espere lecturas extrañas. Las causas más habituales de error de medida son problemas de instalación del sensor, no fallos de firmware ni de electrónica.

Serie CT (pinzas emparejadas de fábrica)

  • ❌ Lecturas erróneas en un canal: la pinza no está en su propio canal o ha sido sustituida. Reconecte la pinza marcada con ese número de canal; una pinza que pertenece a otro canal da un valor incorrecto.
  • ❌ Una escritura de la clase de sensor o del modelo devuelve ERR_PARAM (0xFE): es lo esperado en el firmware 1.4.22 y posteriores, donde un módulo de la serie CT rechaza estas escrituras. No las escriba (véase arranque sin configuración).
  • ❌ Una pinza o un canal está dañado: no son sustituibles en campo; póngase en contacto con el servicio técnico de fábrica.
  • ❌ La corriente es negativa / la energía va en sentido contrario: la pinza está al revés; la flecha debe apuntar hacia la carga.

Códigos de error (REG_ERROR = 0x02)

Código Nombre Significado Acción
0x00 ERR_OK Normal: la última escritura se realizó correctamente —
0xF9 ERR_CLONE Reservado: no se eleva Si llega a observarse, póngase en contacto con el proveedor.
0xFA ERR_LUT_BAD falló el CRC de la tabla de calibración de fábrica; el módulo funciona con aproximación lineal No es fatal. Las mediciones continúan; la precisión puede reducirse. Pida al proveedor una recalibración.
0xFB ERR_FLASH_PARAMS_BAD El bloque de parámetros de la flash está dañado; se restauran los valores por defecto Reconfigure la dirección / SENSOR_CLASS / CT_MODEL y ejecute CMD_SAVE_USER_CONFIG (0x32). Normal en un módulo virgen (véase el capítulo 11 §6.5): no aborte el primer aprovisionamiento por 0xFB.
0xFC ERR_NOT_READY La primera ventana RT aún no se ha completado tras el arranque Espere 300 ms.
0xFD ERR_SENSOR_OVERFLOW Recorte de la señal de entrada (se supera la escala completa) Reduzca la corriente o use una pinza CT mayor.
0xFE ERR_PARAM Código de comando no válido o valor fuera de rango Compruebe el comando y el rango de valores.
0xFF ERR_UNHANDLED HardFault o condición no gestionada Corte la alimentación. Si vuelve a aparecer, póngase en contacto con el proveedor.

Semántica: REG_ERROR NO es persistente (v1.3)

REG_ERROR guarda el resultado de la última transacción de escritura. Cada escritura posterior, tenga éxito o no, lo sobrescribe. No hace falta borrar REG_ERROR entre intentos; de hecho, leerlo más tarde que inmediatamente después de la escritura fallida puede mostrar un resultado más reciente de una operación posterior.

Si necesita una señal de error duradera que sobreviva a escrituras posteriores, use EVENT_FLAGS.bit3 (ERROR_OCCURRED): queda enclavado con W1C y solo se borra cuando el maestro escribe 1 en ese bit. Véase el capítulo 11 §5.3 para el modelo completo de errores.

Borrado explícito (raramente necesario): CMD_CLEAR_ERROR (código de operación 0x31) pone a cero REG_ERROR.

En las bibliotecas cliente

— la misma tarea sin acceso a registros:

Biblioteca Llamada Qué hace
Arduino RbAmp::readLastError() / RbAmp::clearError() lea el código de error de la última escritura; bórrelo
ESP-IDF rbamp_read_last_error() / rbamp_clear_error() lea el código de error de la última escritura; bórrelo
Python dev.read_last_error() / dev.clear_error() lea el código de error de la última escritura; bórrelo
ESPHome get_last_error_str() / write_clear_error() el código de error en texto; borre el error

Cuándo ponerse en contacto con el proveedor

Síntomas que justifican una visita de servicio:

  • El módulo no sale de DATA_VALID = 0 tras tres ciclos de alimentación
  • ERR_UNHANDLED (0xFF) reaparece
  • Sospecha de deriva de calibración: la discrepancia con un medidor de referencia es superior al 5 % con una carga resistiva conocida, y persiste tras cumplir la lista de comprobación del punto #17
  • La carcasa está caliente o huele a material quemado
  • Discrepancia con un medidor de referencia > 5 % pese a cumplir la lista de comprobación del punto #17
  • Un módulo nuevo arranca con ERR_LUT_BAD (0xFA) en el primer encendido

Siguiente