05 · Consulta em tempo real
Como ler valores em tempo real de um módulo STD sem perder ou contar em dobro uma janela. Detalhe ao nível dos registos: Modelo de medição e de energia e Saída de dados disponíveis e eventos.
A janela de medição
As amostras agregam-se em janelas de ciclos completos da rede mais próximos de 100 ms — 5 ciclos a 50 Hz, 6 a 60 Hz. Cada janela concluída é publicada de forma atómica como um instantâneo completo (todos os canais e totais), e WIN_SEQ (0x0016) avança exatamente 1. São cerca de dez instantâneos por segundo. Consultar mais depressa devolve os mesmos dados.
Sem rede elétrica, o módulo continua a publicar num ciclo de reserva mais lento (500 ms) que atualiza o estado e o relógio; nesse ciclo WIN_SEQ avança, mas não há impulso DRDY.
Opção 1 — consultar WIN_SEQ
- Leia
WIN_SEQ. Se não mudou desde a última leitura, não há instantâneo novo. - Se mudou, leia os blocos de que precisa — uma transação por bloco, até 128 bytes; os campos numa transação vêm de uma só publicação e não podem ficar desfasados.
Opção 2 — reagir ao flanco DRDY
DRDY é uma saída de dreno aberto sem resistência de pull-up no módulo; ao usar DRDY, instale uma resistência de pull-up do lado do mestre — recomenda-se 10 kΩ para a alimentação lógica de 3.3 V do mestre. Fica em repouso alto e dá um pulso baixo de ~10 µs por cada nova janela, depois de os registos serem atualizados — uma leitura disparada pela descida do flanco vê sempre o instantâneo atual.
- Em cada flanco atendido, verifique se
WIN_SEQavançou exatamente 1; um salto maior significa flancos perdidos. - Modo de alarme: um bit de evento ativo em
EVENT_FLAGSe emEVENT_MASKmantém DRDY em LOW até o sinalizador ser limpo ou desmascarado. Ainda em LOW após ~100 µs significa alarme — leiaEVENT_FLAGS.
O que um instantâneo lhe dá
Por canal de tensão: tensão RMS. Por canal de corrente: corrente RMS, potência ativa (com sinal; positiva = importação), potência reativa (positiva = indutiva), potência aparente, fator de potência (com sinal). Por dispositivo: frequência e totais (k = 0 total geral, k = 1..3 por fase). Unidades e escalas estão no mapa de registos.
Abaixo de cerca de 20 mA, a corrente publicada também é suavizada durante alguns segundos para uma leitura estável; a potência e a energia não são afetadas.
Após um reinício
Detete um reinício com UPTIME (0x08A0, a diminuir) ou BOOT_COUNT (0x00CE, a saltar). Depois: volte a armar a máscara e os limiares de eventos, defina a hora de novo e volte a ancorar as diferenças de energia. Logo após o arranque WIN_SEQ lê 0 durante cerca de uma janela, FREQ lê 0 durante ~2 s, e as primeiras ~3 janelas não acrescentam energia; aguarde ~1 s antes de avaliar a saúde.
Nas bibliotecas cliente
readAll() devolve um instantâneo coerente nas duas linhas de produtos; as bibliotecas emparelham-no com DRDY ou com WIN_SEQ por si. Veja Exemplos. Num módulo com bancos de instantâneos e contadores de energia use Arduino 1.6.2 ou posterior ou ESP-IDF 1.7.3 ou posterior.