rbAmp
PT
Loja
Docs
Atualizado

Identidade e descoberta

Como um anfitrião reconhece um módulo STD, o que é e o que sabe fazer. Todos os registos deste capítulo são só de leitura, salvo indicação em contrário. Endereços I²C; os espelhos de descoberta Modbus estão listados no fim.

Sequência de descoberta

No primeiro contacto, um mestre lê o bloco de identidade em 0x0000 e condiciona tudo o resto a esse bloco:

  1. ID (0x0000, 2 bytes) tem de ler 'S','T' (0x53, 0x54) — qualquer outra coisa não é um módulo STD.
  2. VERSION (0x0003) é a versão do layout do mapa de registos (atual: 0x36). Novas funcionalidades incrementam-na; um mestre condiciona as funcionalidades do mapa por ela.

  3. CAPABILITIES (0x0004, u16) — mapa de bits de funcionalidades, ver abaixo. O bit 9 (endereçamento de 16 bits) está sempre ativo no STD.

  4. N_VOLTAGE (0x0007) / N_CURRENT (0x0008) — quantos canais estão preenchidos. Os blocos de canal com índice ≥ N são reservados; o seu valor não é especificado.

  5. VARIANT (0x0009) — código do membro da família.

  6. UID (0x00F4, 12 bytes) — o id único do chip. Os endereços podem ser alterados; o UID não: use-o como identidade do dispositivo em qualquer base de dados.

  7. FW_VER (0x0114, u32) — a versão do firmware em execução (use-a para inventário e decisões de atualização). Leia-a como major.minor = a palavra alta e a palavra baixa em decimal: 0x0001007E é apresentada como firmware STD 1.126. A versão do mapa de registos (VERSION, 0x0003) é separada.

Registos de identidade

Endereço Nome Tipo Significado
0x0000 ID 2×u8 'S','T'
0x0002 ERROR u8 resultado do último comando (ver Comandos)
0x0003 VERSION u8 versão do mapa de registos (0x36)
0x0004 CAPABILITIES u16 mapa de bits de funcionalidades
0x0006 STATUS u8 bits de estado em tempo real (ver Diagnóstico)
0x0007 N_VOLTAGE u8 canais de tensão, 0..8
0x0008 N_CURRENT u8 canais de corrente, 1..64
0x0009 VARIANT u8 código de membro da família
0x000A HW_REV u8 revisão de hardware
0x000B FW_VERSION u16 marcador de linha do firmware — não é a versão da imagem
0x00F4 UID 12×u8 id único do chip
0x0114 FW_VER u32 versão do firmware em execução: palavra alta . palavra baixa, em decimal (0x0001007E = 1.126)
0x017C BOARD_ID u32 id da placa da imagem em execução (ver abaixo)
Segurança

⚠ Existem dois registos de "versão de firmware" por razões históricas. FW_VERSION (0x000B, u16) apenas marca a linha de firmware. A versão real, monotonicamente crescente, é FW_VER (0x0114, u32), apresentada como major.minor — use-a para inventário e decisões de atualização.

BOARD_ID (0x017C)

BOARD_ID identifica a placa para a qual a imagem em execução foi compilada: ("BD" << 16) | contagem-de-canais << 8 | VARIANT = 0x4244nnvv — p. ex. 0x42440211 para STD-UI1. Cada imagem de versão traz a mesma palavra, coberta pelas verificações de integridade e assinatura da imagem; uma atualização de firmware com um id de placa diferente é recusada (ver Atualização de firmware). Compare BOARD_ID com o ficheiro de versão antes de enviar uma atualização.

Mapa de bits CAPABILITIES (0x0004)

Bit Nome Significado
0 SIGNED potência/energia com sinal (importação/exportação)
1 REACTIVE Q e S publicados
2 THD campos de THD / PF de deslocamento ativos (0 → esses campos leem 0 em I²C, o sentinela no Modbus nativo)
3 HARMONICS espetros por harmónica (nível industrial)
4 INDUSTRIAL versão de nível industrial
5 HUB_IFACE interface do lado do hub
6 OTA atualização de firmware pelo barramento
7 ENERGY acumuladores de energia por janela
8 MULTI_LATCH oito bancos de instantâneos presentes — ver Bancos de instantâneos
9 ADDR16 endereçamento de registos de 16 bits (sempre 1 no STD)
10 MULTI_CHANNEL mais de um canal de corrente
11 MODBUS_IFACE Transporte Modbus RTU presente
12 RTC relógio no dispositivo com bateria (0 — a hora vem do mestre)
13 ONDEVICE_ENERGY contadores de energia acumulados persistidos no dispositivo
14 CHMAP_PERSIST o mapa de modelo de TC por canal persiste (reservado; 0 até ser implementado)
15 ENERGY_UWH contadores de energia em resolução µWh publicados (µWh ativos e µvarh reativos) — ver Medição e energia

Um mestre trata os bits desconhecidos como "funcionalidade ausente" e nunca depende de campos reservados.

Regra de capacidades honestas: um módulo só comunica o que a compilação em execução fornece de facto. Por exemplo, o firmware trifásico comunica THD = 0 e RTC = 0 (o mestre fornece o relógio); os módulos sem bancos de instantâneos comunicam MULTI_LATCH = 0 (a energia é lida a partir de contadores acumulados).

Códigos VARIANT (0x0009)

Código Membro Canais
0x11 STD-UI1 1 V + 1 I
0x63 STD-U3I3 3 V + 3 I (trifásico)

Os outros códigos do espaço de enumeração são reservados e não devem ser considerados ausentes para sempre; um mestre decide por N_VOLTAGE / N_CURRENT + CAPABILITIES, não codificando códigos de variante.

Espelho de descoberta Modbus

O mesmo conjunto de identidade é legível por Modbus como registos de entrada em 0x6000: MAGIC 0x6000 · MAP_VERSION 0x6001 · FW_VERSION 0x6002 · HW_REV 0x6003 · CAPABILITIES 0x6004 · N_VOLTAGE 0x6005 · N_CURRENT 0x6006 · VARIANT 0x6007 · TIER 0x6008 · STATUS 0x6009 · ERROR 0x600A · UID 0x600B–0x6010 (12 bytes, big-endian por registo) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · diagnóstico da CPU 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID está em holding 0x831B–1C; FW_VER está em holding 0x8315–16.