rbAmp
PT
Loja
Docs
Atualizado

05 · Resolução de problemas

Este capítulo é uma referência rápida para problemas comuns e as suas soluções. Cada entrada segue a estrutura:

  • Sintoma — o que o utilizador observa
  • Causas — porque pode acontecer
  • O que verificar / fazer— ações concretas
    Fluxograma para restringir um problema a partir do sintoma.

Barramento I²C

1. NACK / sem resposta do módulo

Sintoma: Wire.endTransmission() devolve valor diferente de zero; o i2cdetect não mostra o endereço em Linux; rb_read_u8() devolve 0xFF.

Causas e verificações:

  • ❌ A alimentação do módulo está em falta ou instável — meça VCC com um multímetro; deve estar entre 4.5…5.5 V.
  • ❌ Sem massa comum — o erro mais frequente. A massa do mestre e a massa do módulo têm de estar ligadas entre si.
  • ❌ SDA e SCL trocados — verifique com o esquema de ligações em hardware-connection.md.
  • ❌ Sem resistências pull-up no barramento — se as pull-ups incorporadas tiverem sido cortadas num módulo e não houver nenhumas externas instaladas, o barramento fica inoperante. Com tudo sem alimentação, meça SDA↔VCC: deve ler 1.5–4.7 kΩ.
  • ❌ Demasiados pull-ups em paralelo — os pull-ups integrados continuam ativos em muitos módulos (quatro ou mais), somados aos pull-ups do mestre, baixando a resistência equivalente para menos de ~1 kΩ. O mestre não consegue puxar o barramento para LOW. Corte os pull-ups integrados em todos os módulos exceto um.
  • ❌ Cabo longo sem par entrançado nem buffer — a partir de ~0.15 m, os fios paralelos acoplam-se capacitivamente e as arestas arredondam. Use UTP cat-5 (até 1 m) ou um buffer PCA9515 (até 3 m). Veja hardware-connection.md → Comprimento do barramento.
  • ❌ Endereço de escravo errado — o módulo pode ter sido readdressado. Execute uma varredura 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);
    }
  }
}
  • ❌ Velocidade I²C demasiado alta para o comprimento do cabo. Reduza para 50 kHz: Wire.setClock(50000);.

2. Timeouts intermitentes de leitura/escrita

Sintoma: as transações por vezes têm êxito e por vezes falham — sobretudo em ambientes com muito ruído elétrico ou perto de cargas indutivas.

Causes:

  • ❌ Cabo longo sem par entrançado
  • ❌ Cabo passado em paralelo com a cablagem da rede → acoplamento a 50 Hz / 100 Hz
  • ❌ Massa ruidosa do lado do mestre (p. ex., um regulador separado sem capacitância de massa)
  • ❌ Capacidade parasita entre SDA e GND > 100 pF (por exemplo, uma emenda com derivações longas)

Solutions:

  • Use par entrançado (SDA + GND num par, SCL + GND no outro)
  • Evite encaminhar o I²C em paralelo com a cablagem de potência no mesmo tubo
  • Reduza para 50 kHz / adicione 100 nF entre VCC e GND do módulo, junto ao conector
  • Em trajetos longos fora de uma caixa, acrescente proteção ESD (díodos TVS em SDA e SCL)
Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() esgotou as repetições de barramento e rejeitou leituras
ESP-IDF rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() esgotou as repetições de barramento e rejeitou leituras
Python dev.sanity_reject_count / contadores de MachineI2CBackend contar leituras rejeitadas; contadores de repetição no backend MicroPython
ESPHome — sem contadores de diagnóstico expostos

3. DATA_VALID (0xCE) nunca passa a 1

Sintoma: o mestre lê 0xCE e obtém sempre 0x00. Outros registos também podem ficar a zero.

Causes:

  • ❌ O módulo ainda não terminou o arranque (normal nos primeiros ~250 ms após ligar)
  • ❌ Erro de inicialização do firmware — ler REG_ERROR (0x02):
  • 0xFB (ERR_FLASH_PARAMS_BAD) — o bloco de parâmetros da flash está corrompido; o módulo funciona com valores predefinidos. Recalibre / volte a aprovisionar.
  • 0xFA (ERR_LUT_BAD) — a tabela de calibração de fábrica está danificada. Não é fatal — as medições continuam; a precisão pode ser reduzida. Peça ao fornecedor que recalibre.
  • ❌ Falha do relógio do MCU (rara) — desligue e volte a ligar o módulo

Solutions:

  • Aguarde 300 ms após ligar antes de fazer polling de 0xCE.
  • Se DATA_VALID = 1 não for visto após > 1 s — desligue e volte a ligar a alimentação.
  • Se o problema persistir após desligar e voltar a ligar a alimentação — verifique a alimentação (ripple, queda de tensão).
Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() aguardar o indicador de pronto; ler o código de erro do dispositivo
ESP-IDF rbamp_wait_ready() / rbamp_read_last_error() aguardar o indicador de pronto; ler o código de erro do dispositivo
Python dev.wait_ready(timeout_ms=1000) / dev.read_last_error() aguardar o sinalizador de pronto (gera erro em timeout); ler o código de erro do dispositivo
ESPHome verificação de prontidão de update() / get_last_error_str() as leituras são publicadas quando o módulo indica que está pronto; o código de erro em texto

Calibração e precisão

4. I_rms próximo de 0 enquanto uma carga está em funcionamento

Sintoma: a lâmpada está acesa, o aquecedor está quente, mas I_rms mostra 0.001 A ou oscila entre 0 e alguns mA.

Causas (por ordem decrescente de frequência):

  • ❌ Pinça de TC não está no fio — o condutor passa ao lado da pinça em vez de passar por dentro dela.
  • ❌ Pinça de TC em L e em N ao mesmo tempo — os fluxos da fase e do neutro anulam-se, o sensor lê perto de zero. Ver hardware-connection.md → Sensor de corrente. A pinça tem de estar num só condutor (fase/L).
  • ❌ Pinça não totalmente fechada — uma folga > 0.1 mm entre as metades do núcleo aumenta muito a relutância magnética, pelo que a saída do sensor desce bastante abaixo do normal. Solte e volte a fechar até encaixar. Sujidade ou oxidação na folga é uma causa comum — limpe as superfícies de contacto.
  • ❌ Ficha jack de 3.5 mm solta — retire e volte a inserir a ficha.
  • ❌ REG_CT_MODEL não definido — o módulo não conhece a sensibilidade do sensor. Ver initialization.md → Definir a classe do sensor e o modelo de TC. O registo 0x05 tem de conter o código de modelo correto.
  • ❌ Código de modelo errado escrito — por exemplo, um sensor SCT-013-030 com o código SCT-013-010 → a corrente mostrada será ~3× mais baixa do que a real (e, inversamente, um código demasiado grande lê alto). Confirme a marcação do sensor na caixa face ao código de modelo.
  • ❌ Corrente abaixo do limiar de ruído — para cargas muito pequenas (< ~10 mA numa pinça de 30 A) a saída do sensor fica perto do ruído. O firmware aplica a subtração de ruído em quadratura: I_corrected = √(I_raw² − NF²). Se I_raw ≤ NF, o resultado é limitado a 0. Este comportamento é intencional.

5. I_rms errado por um fator grande

Sintoma: a carga real é ~10 A (segundo o contador de referência), o módulo mostra 3 A ou 30 A.

Causes:

  • ❌ Código de modelo de CT errado — o caso mais comum. Veja #4.
  • ❌ Modelo de CT errado instalado — alguém montou uma pinça de 100 A onde a configuração pede uma de 30 A (ou o contrário).
  • ❌ Pinça não totalmente fechada (ver #4) — tipicamente lê 5–20 % abaixo.
  • ❌ Suspeita de deriva da calibração de fábrica — se tudo o anterior for excluído e a discrepância persistir numa carga de referência conhecida, contacte o fornecedor do módulo; a recalibração é uma operação de fábrica.

6. O sinal de P_real está errado (o consumo aparece como exportação)

Sintoma: a carga está claramente a consumir (aquecedor quente, lâmpada acesa), mas P_real < 0.

Causas e soluções:

  • ❌ L e N trocados nos terminais de tensão — a causa mais comum. Ver hardware-connection.md → Sensor de tensão. Troque L e N na placa.
  • ❌ Pinça TC instalada ao contrário — a seta na pinça tem de apontar no sentido da corrente em direção à carga (quadro → carga). Se apontar para o outro lado, solte e inverta a pinça.
  • ❌ Inverter fisicamente não é prático — no BASIC o acumulador do período (PERIOD_AVG_P_W) põe a zero as amostras negativas; com polaridade invertida o registo de energia fica a 0 até a polaridade física ser corrigida — negar no código do mestre (p_corrected = -p_raw) só corrige a sua própria integração RT, nunca os dados do período no módulo. Corrija a ligação.

7. O total de energia difere de um contador de referência em alguns por cento

Sintoma: E_Wh ao longo de uma hora difere do contador da concessionária em 2–10 %.

Causas prováveis (por ordem decrescente):

  • ❌ Pinça não totalmente fechada (folga) — tipicamente −5 a −20 % abaixo. A causa mais comum. Solte, limpe as superfícies de contacto e volte a fechar até ficar totalmente fechada.
  • ❌ Pinça instalada num fio "secundário" — dentro do quadro de disjuntores, numa ligação curta depois de um disjuntor. Os campos parasitas dos disjuntores vizinhos introduzem erros. Mova a pinça para a alimentação principal ou para uma secção isolada do condutor.
  • ❌ Perto de cargas reativas fortes — junto a transformadores, motores assíncronos, UPS. Os campos magnéticos de indutores vizinhos criam um sinal parasita. Afaste a pinça ≥ 10 cm de qualquer componente ferromagnético.
  • ❌ PF baixo (≤ 0.5) — cargas reativas grandes exigem compensação de fase precisa. A exatidão é especificada para cargas resistivas (PF ≈ 1); não é especificada para cargas fortemente reativas. Se a exatidão num perfil de PF específico for crítica, contacte o fornecedor do módulo para orientação.
  • ❌ Tensão da rede distorcida (micro-quedas, harmónicos de ordem elevada) — o cálculo RMS e média é mais robusto do que a deteção de picos, mas a precisão não está especificada para tensão de rede fortemente distorcida; contacte o fornecedor se isto for relevante para a sua instalação.
  • ❌ Cabo da pinça CT danificado ou ficha solta — circuito aberto ou soldadura fria dentro da ficha. Verifique com um multímetro, com a ficha desligada do módulo (a pinça CT é um transformador redutor; o enrolamento secundário deve medir 50–200 Ω, conforme o modelo).

8. avg_P_W está muito abaixo do esperado

Sintoma: um aquecedor de 1000 W está ligado, o RT P_real ≈ 1000 W, mas PERIOD_AVG_P_W lê ~200 W num período de um minuto.

Causes:

  • ❌ A carga é de facto intermitente (termóstato de ciclo, elemento a pulsar) — avg_P_W reporta corretamente a média no tempo. Confronte com PERIOD_MAX_P_W (0xE0) para ver o pico dentro de qualquer janela de medição.
  • ❌ Se a carga for estável e P_real ≈ avg_P_W do tempo real não se verificar:
  • No nível BASIC: verifique o sinal RT de P_real. Se P for ocasionalmente negativa (um inversor solar a injetar na rede, por exemplo), as amostras negativas são excluídas de PERIOD_AVG_P_W, o que faz descer a média. Ver period-metering.md → nível BASIC.

9. PERIOD_VALID = 0 após um instantâneo

Sintoma: o mestre emite CMD_LATCH_PERIOD, lê 0x07 e obtém 0. O instantâneo não está atualizado.

Causes:

  • ❌ Instantâneos demasiado próximos — não foi concluída nenhuma janela RT (~100 ms a partir da v1.2; 200 ms antes) entre dois instantâneos. O acumulador está vazio e o instantâneo é descartado.
  • ❌ Corrida com um commit RT — raro: o mestre escreveu o comando no instante exato em que o firmware fazia commit do acumulador ao vivo. Possível em mestres muito rápidos.

Solução — o padrão de repetição (veja 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
}
Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() verificar o bit de instantâneo pronto; tirar e validar um instantâneo de período
ESP-IDF rbamp_is_period_valid() / rbamp_read_period_snapshot() verificar o bit de instantâneo pronto; tirar e validar um instantâneo de período
Python dev.is_period_valid() / dev.read_period_snapshot() verificar o bit de instantâneo pronto; tirar e validar um instantâneo de período
ESPHome Instantâneo do período inválido o que o componente regista quando o sinalizador de validade é 0; o primeiro instantâneo após o arranque é descartado

Problemas com vários módulos

10. Colisão de endereços

Sintoma: vários módulos ligados ao barramento — alguns "desaparecem" ou devolvem lixo. O mesmo endereço responde com valores diferentes.

Causa: dois ou mais módulos partilham o mesmo endereço → arbitragem / colisão I²C. Frequente logo após desembalar, quando todos os módulos estão no endereço de fábrica 0x50.

Forma mais subtil: o endereço responde de forma estável, mas o UID lido em 0x5C (cap. 11 §4.8) não corresponde a nenhum módulo conhecido. Dois módulos estão a responder em conjunto — o barramento faz AND por fios das saídas e produz um UID estável mas fictício. Se um hub vir um "UID desconhecido" num endereço que provisionou, suspeite de colisão antes de suspeitar de um módulo estranho.

Solution:

  1. Desligue todos os módulos.
  2. Ligue um de cada vez — nunca altere o endereço com dois módulos de fábrica no barramento; altere o endereço de cada um para um endereço único.
  3. Depois de reatribuir o endereço a todos os módulos, volte a ligá-los em paralelo e verifique cada endereço lendo o seu UID.

Veja initialization.md → Fluxo de trabalho recomendado.

Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmpFleet::checkConflict() / RbAmpFleet::scan() verifique um endereço para um segundo dispositivo; procure módulos no barramento
ESP-IDF rbamp_fleet_check_conflict() / rbamp_fleet_scan() verifique um endereço para um segundo dispositivo; procure módulos no barramento
Python fleet.check_conflict(addr) / fleet.scan() verifique um endereço para um segundo dispositivo; procure módulos no barramento
ESPHome rbamp: lista um bloco por módulo, cada um com o seu próprio id e address

11. O DRDY com OR-cabeado dispara várias vezes em rápida sucessão

Sintoma: com DRDY em OR por fio, o EXTI do mestre dispara a cada 1–5 ms, várias vezes seguidas.

Causa: os módulos não estão perfeitamente sincronizados — cada um tem o seu próprio cristal, e os períodos das janelas RT diferem ligeiramente (99.9 ms vs 100.1 ms). Ao longo do intervalo das janelas, os módulos puxam a linha em instantes ligeiramente diferentes.

Isto é normal. Soluções:

  • Ignore os disparos "duplos": depois do primeiro disparo, leia todos os módulos; suprima novos disparos durante ~10 ms.
  • Use o instantâneo de difusão (ver period-metering.md → Abordagem 2) para sincronização precisa — mas apenas para instantâneos de período, não para RT.
  • Passar para DRDY por módulo — cada módulo no seu próprio GPIO.

12. Barramento I²C ocupado quando o DRDY dispara

Sintoma: o DRDY dispara enquanto o mestre já está numa transação com outro módulo. O handler de EXTI fica atrasado.

Isto é normal. Os registos RT mantêm-se válidos até à próxima confirmação (uma janela, ~100 ms, depois). O mestre:

  • Termina a transação atual.
  • Atende o EXTI atrasado e lê o módulo seguinte.
  • Latência: tipicamente 1–10 ms — não é crítica.

13. Deriva de relógio entre vários módulos em testes longos

Sintoma: a energia acumulada diverge entre módulos em frações de percentagem ao longo de uma semana.

Causa: cada rbAmp tem o seu próprio cristal com deriva de ±50 ppm (1–5 s/dia).

Solução — incorporada na arquitetura: o mestre usa o seu próprio relógio para multiplicar pelo dt. Todos os módulos partilham a mesma referência temporal, pelo que o total Wh de todo o sistema não diverge.

Para medir a deriva do chip para QA, compare PERIOD_LATCH_MS (0xEC) com o dt do mestre:

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);

Limiar de aceitação para PERIOD_LATCH_MS: uma subcontagem de até 30 % sob carga é normal (rácio até ~0.70). A base de tempo interna de diagnóstico do módulo lê baixo quando o módulo está ocupado — por desenho. O envelope de 30 % é uma propriedade da base de tempo do módulo, não uma avaria. Aplique este limiar de forma uniforme em todos os SKU e níveis.

O limiar antigo de 3 % da documentação anterior está errado para a v1.3 e rejeitará em massa módulos saudáveis; não o use.

Esta deriva afeta apenas o registo de diagnóstico do lado do circuito integrado; a precisão da energia não é afetada porque o Wh é calculado do lado do mestre como avg_P × master_dt (veja period-metering.md). Se o próprio master_dt derivar (o relógio do MCU do mestre desvia-se), aplique a correção NTP/SNTP do próprio mestre — PERIOD_LATCH_MS não é a referência certa.

Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::readPeriodLatchMs() ler o comprimento do período do lado do módulo (apenas diagnóstico)
ESP-IDF rbamp_read_period_latch_ms() ler o comprimento do período do lado do módulo (apenas diagnóstico)
Python dev.read_period_latch_ms() ler o comprimento do período do lado do módulo (apenas diagnóstico)
ESPHome — não exposto

Alimentação e flash

14. Corte de energia durante um comando de escrita em flash → escrita parcial em flash

Sintoma: após uma interrupção de alimentação durante um comando de escrita na flash (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR), o módulo arranca com REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) e EVENT_FLAGS.bit3 ativo.

O que aconteceu: o firmware detetou uma falha de CRC no bloco de configuração do utilizador na flash, carregou as predefinições de fábrica e voltou a gravá-las.

Solution:

  • As predefinições de fábrica são repostas — o módulo funciona, mas o endereço personalizado / a configuração do sensor perderam-se.
  • Reaplique a configuração: defina SENSOR_CLASS + associe CT_MODEL por canal + execute CMD_SAVE_USER_CONFIG (e refaça a alteração de endereço, se necessário).
  • Para evitar isto no futuro: não corte a alimentação durante pelo menos 1 segundo após qualquer comando de escrita na flash. A janela de apagamento + escrita da flash é ~700 ms; deixe margem.

15. O módulo está quente

Sintoma: a caixa está notoriamente quente.

Normal: com corrente da rede até ao nominal (conforme o SKU), é esperado um ligeiro aquecimento do lado BT (regulador LDO) até ~40 °C.

Não é normal: caixa quente (≥ 60 °C), cheiro a queimado, descoloração do plástico.

Causes:

  • ❌ Sobretensão no lado de baixa tensão (VCC > 5.5 V) — verifique a alimentação.
  • ❌ Dano interno do lado da rede (curto no divisor ou no circuito da CT).
  • ❌ Pinça CT externa sobrecarregada (corrente acima da gama do sensor).

Ação: desligue a alimentação imediatamente, isole o módulo, contacte o fornecedor.

Ligação do sensor — erros críticos

16. Verificação de sanidade — o que significa "ligado corretamente"

Depois de instalar ou reinstalar um módulo, execute um teste de funcionamento com uma carga puramente resistiva conhecida (lâmpada incandescente, chaleira elétrica, elemento de aquecimento) — por exemplo, uma lâmpada de 100 W a 230 V.

Expected:

  • U_rms ≈ 220..240 (depende da rede local)
  • I_rms ≈ 100 W / 230 V ≈ 0.43 A
  • P_real ≈ +100 W (positivo, consumo)
  • PF ≈ 0.998..1.000 (carga resistiva)
  • Q ≈ 0 (sem conteúdo reativo)

Se P_real for negativo: veja #6 — L/N trocados ou CT instalada ao contrário. Se |I_rms − esperado| > 10 %: veja #5 — modelo de CT errado ou pinça não fechada. Se |P_real − U × I| > 5 % com PF = 1: a compensação de fase pode estar desligada — contacte o fornecedor.

17. Lista de verificação antes da colocação em funcionamento

Antes de ligar um módulo num sistema de produção:

  • [ ] L ligado ao terminal L da placa (não trocado com N)
  • [ ] Pinça CT no condutor L (não no N, nem em ambos ao mesmo tempo)
  • [ ] Seta na pinça TC apontada para a carga
  • [ ] Pinça TC completamente fechada (sem folga, sem solta — pressione até encaixar)
  • [ ] Cabo da pinça intacto, ficha jack bem encaixada na tomada
  • [ ] Alimentação VCC dentro de 4.5…5.5 V, massa limpa
  • [ ] Pull-ups I²C verificados (veja hardware-connection.md → Pull-ups I²C)
  • [ ] Para os módulos da série BASIC SCT: REG_CT_MODEL escrito e gravado de acordo com o sensor instalado
  • [ ] Teste de funcionamento com carga resistiva concluído — todos os cinco valores (U, I, P, PF, Q) dentro das faixas esperadas

Se algum item não estiver marcado, espere leituras estranhas. As causas mais comuns de erros de medição são problemas de instalação dos sensores, e não falhas de firmware ou de eletrónica.

Série CT (pinças emparelhadas de fábrica)

  • ❌ As leituras parecem erradas num canal — a pinça não está no seu próprio canal ou foi substituída. Volte a ligar a pinça marcada com esse número de canal; uma pinça que pertence a outro canal dá um valor errado.
  • ❌ Uma escrita da classe do sensor ou do modelo devolve ERR_PARAM (0xFE) — esperado no firmware 1.4.22 e posteriores: um módulo da série CT recusa estas escritas. Não as escreva (veja arranque sem configuração).
  • ❌ Uma pinça ou um canal está danificado — não são substituíveis no local; contacte o serviço técnico de fábrica.
  • ❌ A corrente é negativa / a energia vai no sentido errado — a pinça está invertida: a seta tem de apontar para a carga.

Códigos de erro (REG_ERROR = 0x02)

Código Nome Significado Ação
0x00 ERR_OK Normal — a última escrita teve êxito —
0xF9 ERR_CLONE Reservado — não gerado Se alguma vez for observado, contacte o fornecedor.
0xFA ERR_LUT_BAD falhou o CRC da tabela de calibração de fábrica; o módulo funciona com uma aproximação linear Não é fatal. As medições continuam; a exatidão pode ficar reduzida. Peça ao fornecedor para recalibrar.
0xFB ERR_FLASH_PARAMS_BAD Bloco de parâmetros da flash corrompido; predefinições repostas Reconfigure o endereço / SENSOR_CLASS / CT_MODEL e execute CMD_SAVE_USER_CONFIG (0x32). Normal num módulo virgem (veja o capítulo 11 §6.5) — não interrompa o primeiro provisionamento por causa de 0xFB.
0xFC ERR_NOT_READY A primeira janela RT ainda não terminou após o arranque Aguarde 300 ms.
0xFD ERR_SENSOR_OVERFLOW Corte do sinal de entrada (escala completa ultrapassada) Reduza a corrente ou use uma pinça CT maior.
0xFE ERR_PARAM Código de comando inválido ou valor fora de gama Verifique o comando e a gama de valores.
0xFF ERR_UNHANDLED HardFault ou condição não tratada Desligar e voltar a ligar a alimentação. Se voltar a acontecer, contacte o fornecedor.

Semântica — REG_ERROR NÃO é persistente (v1.3)

REG_ERROR guarda o resultado da última transação de escrita. Cada escrita seguinte — bem-sucedida ou não — sobrescreve-o. Não é preciso limpar REG_ERROR entre tentativas; aliás, ler mais tarde do que imediatamente após a escrita falhada pode mostrar um resultado mais recente de uma operação posterior.

Se precisar de um sinal de erro durável que sobreviva a escritas posteriores, use EVENT_FLAGS.bit3 (ERROR_OCCURRED) — fica travado em W1C e só se limpa quando o mestre escreve 1 no bit. Veja o capítulo 11 §5.3 para o modelo de erros completo.

Limpeza explícita (raramente necessária): CMD_CLEAR_ERROR (opcode 0x31) põe REG_ERROR a zero.

Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::readLastError() / RbAmp::clearError() ler o código de erro da última escrita; limpá-lo
ESP-IDF rbamp_read_last_error() / rbamp_clear_error() ler o código de erro da última escrita; limpá-lo
Python dev.read_last_error() / dev.clear_error() ler o código de erro da última escrita; limpá-lo
ESPHome get_last_error_str() / write_clear_error() o código de erro em texto; limpar o erro

Quando contactar o fornecedor

Sintomas que justificam assistência:

  • O módulo não sai de DATA_VALID = 0 após três ciclos de alimentação
  • ERR_UNHANDLED (0xFF) repete-se
  • Suspeita de deriva de calibração — desvio > 5 % face a um contador de referência numa carga resistiva conhecida, mesmo depois de cumprida a lista de verificação do ponto #17
  • A caixa está quente ou cheira a material queimado
  • Desvio face a um contador de referência > 5 % apesar de a lista de verificação do ponto #17 estar cumprida
  • Um módulo novo arranca com ERR_LUT_BAD (0xFA) na primeira ligação

Seguinte