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:
ID(0x0000, 2 bytes) tem de ler'S','T'(0x53, 0x54) — qualquer outra coisa não é um módulo STD.-
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. -
CAPABILITIES(0x0004, u16) — mapa de bits de funcionalidades, ver abaixo. O bit 9 (endereçamento de 16 bits) está sempre ativo no STD. -
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. -
VARIANT(0x0009) — código do membro da família. -
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. -
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 comomajor.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) |
⚠ 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.