Saída de dados prontos e eventos
Os anfitriões que consultam por temporizador desperdiçam transações no barramento e ainda assim chegam atrasados aos dados. O módulo STD oferece uma linha DRDY (dados prontos) em hardware, além de um modelo de eventos nos registos, comum a toda a família rbAmp.
Contrato da linha DRDY
- Elétrico: saída de dreno aberto sem resistência de pull-up no módulo — quando DRDY é usado, 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); em repouso ALTA.
-
Impulso: impulso BAIXO de ~10 µs por cada nova janela de medição — o módulo publica um instantâneo completo uma vez por janela de medição finalizada: ciclos completos da rede, o mais próximo possível de 100 ms (5 a 50 Hz, 6 a 60 Hz), ou seja, cerca de 10 impulsos por segundo. Sem nova janela, o módulo continua a publicar num ciclo fixo de reserva mais lento (500 ms) que atualiza o estado e o relógio; essa publicação de reserva avança
WIN_SEQmas não dá nenhum flanco DRDY. O impulso dispara depois de os registos serem atualizados — uma leitura disparada pelo flanco de descida vê sempre o instantâneo atual. -
WIN_SEQ(0x0016, u16) incrementa exatamente 1 no mesmo instante do impulso (e também numa publicação de recurso, que não tem impulso). Regra de emparelhamento: -
com a linha DRDY: em cada flanco atendido, verifique se WIN_SEQ avançou 1 — um salto maior significa flancos perdidos;
-
sem a linha: consulte WIN_SEQ; uma alteração significa um instantâneo novo.
- Modo de alarme: qualquer bit de evento ativo tanto em
EVENT_FLAGScomo emEVENT_MASKmantém DRDY em LOW fixo até o sinalizador ser limpo ou desmascarado. O alarme ativa-se na próxima marca de publicação e liberta-se de imediato com escrita de 1 para limpar ou com desmascaramento (NVM_FAULT volta a ativar a cada publicação enquanto a falha persistir). O anfitrião distingue impulso de alarme pelo nível: ainda em LOW após ~100 µs = alarme → leia EVENT_FLAGS.
EVENT_FLAGS (0x00C0) / EVENT_MASK (0x00C1)
os bits de EVENT_FLAGS são persistentes e limpos ao escrever 1 no bit (escrita-1-para-limpar). EVENT_MASK seleciona quais deles ativam o alarme DRDY. Ambos residem na RAM — os valores por defeito são restaurados em cada reinício do módulo, pelo que o anfitrião volta a armar a sua máscara após qualquer reinício que detete.
| Bit | Nome | Ativado quando |
|---|---|---|
| 0 | PERIOD_READY | um resumo de 15 minutos foi concluído |
| 1 | THRESH_I | qualquer canal de corrente excedeu THRESH_I |
| 2 | THRESH_P | |potência ativa total| excedeu THRESH_P |
| 3 | ERROR | um comando terminou com um resultado diferente de OK |
| 4 | CONFIG_CHANGED | SAVE_CONFIG / SAVE_CAL concluído com êxito |
| 5 | RESET_OCCURRED | definido em todos os arranques (o único sinalizador ativo no arranque) — um anfitrião que o veja sabe que o módulo reiniciou |
| 6 | NVM_FAULT | o armazenamento de energia passou a FAULT/CORRUPT |
No arranque, EVENT_FLAGS = 0x20 (apenas RESET_OCCURRED) e ambos os limiares voltam a 0xFFFFFFFF (desativados).
Limiares: THRESH_I (0x00C4, µA) dispara quando qualquer canal de corrente sobe acima dele; THRESH_P (0x00C8, mW) compara a magnitude da potência ativa total (independente da direção). 0xFFFFFFFF desativa (predefinido). Ambos em RAM.
Padrões recomendados para o anfitrião
Tempo real acionado por flanco (menor latência, mínimo tráfego no barramento):
- Configure uma interrupção por flanco descendente em DRDY.
- Na extremidade: leia WIN_SEQ + os campos de medição necessários numa só transação.
- Se WIN_SEQ avançou mais de 1 — perdeu janelas (não é um erro; os dados são atuais).
Despertar por alarme (o anfitrião dorme, o módulo vigia):
- Escreva THRESH_I / THRESH_P e ative os bits pretendidos em EVENT_MASK.
- Aguarde até DRDY descer (e ficar) BAIXO.
- Leia EVENT_FLAGS, trate e escreva 1 para limpar. DRDY liberta-se quando não resta nenhum sinalizador mascarado.
- Após qualquer reset do módulo detetado (RESET_OCCURRED, salto em BOOT_COUNT, descontinuidade de WIN_SEQ): volte a escrever os limiares e a máscara — estão em RAM.
Consulta pura (sem GPIO livre): consulte WIN_SEQ a ≤ à taxa da janela; leia os dados quando mudarem; consulte EVENT_FLAGS com a latência de alarme que for aceitável.
Equivalentes Modbus: EVENT_FLAGS holding 0x8120 (escrita-1-para-limpar), EVENT_MASK 0x8121, THRESH_I 0x8122–23, THRESH_P 0x8124–25. A própria linha DRDY é independente do transporte.