rbAmp
PT
Loja
Docs
Atualizado

04 · Primeiros passos com o STD

As primeiras leituras de um módulo STD por I²C e por Modbus RTU. Os endereços dos registos são apontadores I²C de 16 bits; os endereços Modbus estão indicados entre parênteses. Os fluxos completos estão na referência de sequências.

0. Selecionar o transporte

Defina o comutador de 3 posições do modo de interface antes de ligar: Modbus RTU (definições de série guardadas), Modbus predefinido (Modbus RTU a 9600 8N1, ID de unidade 1) ou I²C. O comutador só é lido no arranque, por isso uma alteração aplica-se após um reinício. Veja Hardware.

1. Identificar o módulo

Leia 12 bytes em 0x0000 numa só transação (I²C: escreva o ponteiro de 16 bits 0x0000, depois leia 12 bytes):

Deslocamento Campo Espere
0x0000 ID (2 bytes) 'S', 'T'
0x0002 ERROR resultado do último comando
0x0003 VERSION 0x36 ou superior
0x0004 CAPABILITIES (u16) bit 9 (endereçamento de 16 bits) ativo; bit 8 (bancos de instantâneos) ativo quando o módulo os tem
0x0006 STATUS bit 1 sensor ok, bit 2 rede ok
0x0007 / 0x0008 N_VOLTAGE / N_CURRENT STD-UI1: 1 / 1 · STD-U3I3: 3 / 3
0x0009 VARIANT 0x11 STD-UI1 · 0x63 STD-U3I3
0x000A HW_REV revisão de hardware

O layout exato dos bytes está em Identidade e descoberta. Decida o que o módulo pode fazer a partir de N_VOLTAGE, N_CURRENT e dos bits de CAPABILITIES — nunca a partir de códigos de variante codificados.

Depois leia o UID único (0x00F4, 12 bytes) para a sua base de dados e a versão do firmware FW_VER (0x0114, u32): a palavra alta e a palavra baixa em decimal dão a versão, por exemplo 0x0001007E = firmware STD 1.126.

2. Aguardar dados em tempo real

Após ligar, aguarde cerca de um segundo: WIN_SEQ (0x0016) tem de ser diferente de zero e estar a avançar, e o bit 1 de STATUS (sensor ok) tem de estar ativo. Veja prontidão no arranque.

3. Primeiras leituras (I²C)

Leia os blocos de tempo real, cada um numa transação (até 128 bytes, coerente):

  • canal de tensão v: base 0x0200 + v·0x20 — tensão RMS;
  • canal de corrente c: base 0x1000 + c·0x40 — corrente, P, Q, S, PF;
  • totais: 0x0300 + k·0x40 — k = 0 total geral, k = 1..3 por fase;
  • frequência FREQ (0x0010, cHz).

As layouts completas dos blocos estão no mapa de registos. Os valores são inteiros de escala fixa: tensão em mV, corrente em µA, potência em mW / mvar / mVA.

4. Primeiras leituras (Modbus RTU)

Por defeito: unidade 1, 9600 8N1. O bloco de descoberta é legível como registos de entrada a partir de 0x6000 (magic, versão do mapa, capacidades, contagens de canais, variante, UID). Os valores em tempo real estão no perfil nativo (entrada 0x6000+) ou, para um inversor ou SCADA, no perfil float32 (entrada 0x0000: tensão, corrente e potência por fase, potência total, frequência, energia importada e exportada). Detalhes: Transporte Modbus.

Os módulos não guardam relógio com bateria. Os contadores acumulam sem ele; os registos de histórico horário só são escritos depois de definida a hora. Defina a hora fazendo o mestre escrever a época em TIME_SET (0x08C0) e emitir o comando 0x06. Faça-o na descoberta e sempre que o bit 4 de STATUS (hora válida) ler 0 após um reinício.

Nas bibliotecas cliente

As bibliotecas fazem tudo o que está acima em begin() e expõem as mesmas chamadas de leitura nos módulos STD e BASIC; ver Exemplos. Num módulo com bancos de instantâneos e contadores de energia, use a Arduino 1.6.2 ou posterior ou a ESP-IDF 1.7.3 ou posterior.