rbAmp
ES
Tienda
Docs
Actualizado

Identidad y descubrimiento

Cómo reconoce un host un módulo STD, qué es y qué puede hacer. Todos los registros de este capítulo son de solo lectura salvo que se indique lo contrario. Direcciones I²C; los espejos de descubrimiento Modbus se listan al final.

Secuencia de descubrimiento

En el primer contacto, un maestro lee el bloque de identidad en 0x0000 y condiciona todo lo demás a él:

  1. ID (0x0000, 2 bytes) debe leer 'S','T' (0x53, 0x54) — cualquier otro valor indica que no es un módulo STD.
  2. VERSION (0x0003) es la versión de disposición del mapa de registros (actual: 0x36). Las funciones nuevas la incrementan; un maestro condiciona las funciones del mapa a ella.

  3. CAPABILITIES (0x0004, u16): mapa de bits de funciones, véase más abajo. El bit 9 (direccionamiento de 16 bits) siempre está activo en el STD.

  4. N_VOLTAGE (0x0007) / N_CURRENT (0x0008) — cuántos canales están presentes. Los bloques de canal con índice ≥ N están reservados; su valor no está especificado.

  5. VARIANT (0x0009) — código del miembro de la familia.

  6. UID (0x00F4, 12 bytes) — el id único del chip. Las direcciones pueden cambiarse; el UID no: úselo como identidad del dispositivo en cualquier base de datos.

  7. FW_VER (0x0114, u32): la versión del firmware en ejecución (úsela para el inventario y las decisiones de actualización). Léala como mayor.menor: la palabra alta y la palabra baja en decimal. 0x0001007E se muestra como firmware STD 1.126. La versión del mapa de registros (VERSION, 0x0003) es independiente.

Registros de identidad

Dir. Nombre Tipo Significado
0x0000 ID 2×u8 'S','T'
0x0002 ERROR u8 resultado del último comando (véanse los Comandos)
0x0003 VERSION u8 versión del mapa de registros (0x36)
0x0004 CAPABILITIES u16 mapa de bits de funciones
0x0006 STATUS u8 bits de estado en vivo (véase Diagnóstico)
0x0007 N_VOLTAGE u8 canales de tensión, 0..8
0x0008 N_CURRENT u8 canales de corriente, 1..64
0x0009 VARIANT u8 código de miembro de la familia
0x000A HW_REV u8 revisión de hardware
0x000B FW_VERSION u16 marcador de línea del firmware: no es la versión de la imagen
0x00F4 UID 12×u8 id único del chip
0x0114 FW_VER u32 versión de firmware en ejecución: palabra alta . palabra baja, en decimal (0x0001007E = 1.126)
0x017C BOARD_ID u32 id de placa de la imagen en ejecución (véase abajo)
Seguridad

⚠ Existen dos registros de «versión de firmware» por motivos históricos. FW_VERSION (0x000B, u16) solo indica la línea de firmware. La versión real del firmware, que aumenta de forma monótona, es FW_VER (0x0114, u32), que se muestra como major.minor — úselo para inventario y decisiones de actualización.

BOARD_ID (0x017C)

BOARD_ID identifica la placa para la que se compiló la imagen en ejecución: ("BD" << 16) | número-de-canales << 8 | VARIANT = 0x4244nnvv — p. ej., 0x42440211 para STD-UI1. Cada imagen de publicación lleva la misma palabra, cubierta por las comprobaciones de integridad y firma de la imagen; una actualización de firmware con un id de placa distinto se rechaza (véase Actualización de firmware). Compare BOARD_ID con el archivo de publicación antes de enviar una actualización.

Mapa de bits CAPABILITIES (0x0004)

Bit Nombre Significado
0 SIGNED potencia/energía con signo (importación/exportación)
1 REACTIVE Q y S publicados
2 THD campos THD / PF de desplazamiento en vivo (0 → esos campos devuelven 0 en I²C, el centinela en Modbus nativo)
3 HARMONICS espectros por armónico (nivel industrial)
4 INDUSTRIAL compilación de nivel industrial
5 HUB_IFACE interfaz del lado del hub
6 OTA actualización de firmware por el bus
7 ENERGY acumuladores de energía por ventana
8 MULTI_LATCH ocho bancos de instantáneas presentes — véanse los Bancos de instantáneas
9 ADDR16 direccionamiento de registros de 16 bits (siempre 1 en STD)
10 MULTI_CHANNEL más de un canal de corriente
11 MODBUS_IFACE Transporte Modbus RTU presente
12 RTC reloj integrado con batería en el dispositivo (0 — la hora llega del maestro)
13 ONDEVICE_ENERGY contadores de energía acumulada persistidos en el dispositivo
14 CHMAP_PERSIST el mapa de modelo de TC por canal persiste (reservado; 0 hasta que se implemente)
15 ENERGY_UWH contadores de energía de resolución µWh publicados (µWh activos y µvarh reactivos) — véase Medida y energía

Un maestro trata los bits desconocidos como «función ausente» y nunca depende de campos reservados.

Regla de capacidades honestas: un módulo solo informa de lo que realmente ofrece la compilación en ejecución. Por ejemplo, el firmware trifásico informa THD = 0 y RTC = 0 (el maestro aporta el reloj); los módulos sin bancos de instantáneas informan MULTI_LATCH = 0 (la energía se lee de los contadores acumulados).

Códigos VARIANT (0x0009)

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

Los demás códigos del espacio de enumeración están reservados y no deben asumirse ausentes para siempre; un maestro decide por N_VOLTAGE / N_CURRENT + CAPABILITIES, no codificando códigos de variante fijos.

Espejo de descubrimiento Modbus

El mismo conjunto de identidad se puede leer por Modbus como registros de entrada en 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 registro) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · diagnóstico de CPU 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID está en retenido 0x831B–1C; FW_VER está en retenido 0x8315–16.