rbAmp
PT
Loja
Docs
Atualizado

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_SEQ mas 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_FLAGS como em EVENT_MASK manté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.

Tempo real acionado por flanco (menor latência, mínimo tráfego no barramento):

  1. Configure uma interrupção por flanco descendente em DRDY.
  2. Na extremidade: leia WIN_SEQ + os campos de medição necessários numa só transação.
  3. 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):

  1. Escreva THRESH_I / THRESH_P e ative os bits pretendidos em EVENT_MASK.
  2. Aguarde até DRDY descer (e ficar) BAIXO.
  3. Leia EVENT_FLAGS, trate e escreva 1 para limpar. DRDY liberta-se quando não resta nenhum sinalizador mascarado.
  4. 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.