rbAmp STD — referencia técnica
Referencia técnica completa de la línea de módulos rbAmp STD: mapa de registros, transportes, comandos, modelo de medida y energía, actualización de firmware, diagnóstico e integración con el host.
Versión del mapa de registros 0x36.
Esta referencia describe el núcleo de firmware común a todos los módulos STD. Miembros: STD-UI1 (1 canal de tensión + 1 de corriente) y STD-U3I3 (3 canales de tensión + 3 de corriente, trifásico). Ambos usan el mismo mapa y solo difieren en N_VOLTAGE / N_CURRENT y en el código de variante, por lo que todo aquí se escribe de forma genérica según el número de canales.
Contenido
| # | Archivo | Incluye |
|---|---|---|
| 1 | Identidad y descubrimiento | magic, versiones, capacidades, códigos de variante, número de canales, UID, id de placa |
| 2 | Transporte I²C | puntero de registro de 16 bits, secuencias de lectura/escritura, estiramiento de reloj, cambio de dirección |
| 3 | Transporte Modbus RTU | trama, perfiles, espacios de registros, excepciones, UNLOCK, reglas de comportamiento |
| 4 | Mapa de registros | cada bloque con dirección, tipo, unidades, escala y acceso |
| 5 | Comandos | registro de comandos, semántica de ocupado/resultado, códigos de error, control de acceso |
| 6 | Salida de datos listos y eventos | contrato DRDY, WIN_SEQ, indicadores de evento, umbrales, alarma |
| 7 | Modelo de medida y energía | ventanas, unidades, contadores de energía, historial, registro de eventos, hora |
| 8 | Configuración, persistencia y calibración | qué sobrevive a un reinicio o apagado, cómo se guarda, calibración visible para el usuario |
| 9 | Actualización de firmware | protocolo OTA del lado del host por I²C y Modbus |
| 10 | Diagnóstico | indicadores de estado, causa de reinicio, contadores, lista de comprobación de salud, LED |
| 11 | Interfaz de hardware | señales, cableado, conmutador de modo de interfaz, DRDY, reinicio |
| 12 | Integración con el host | secuencias de registros en bruto sin nuestras bibliotecas; punteros a las bibliotecas |
| 13 | Secuencias | flujos canónicos paso a paso: inicialización, comandos, configuración, cambio de dirección, energía, historial, OTA, desbloqueo |
Convenciones usadas en todo el documento
-
Direcciones. Las direcciones de registro I²C son de 16 bits y se escriben
0xNNNN. Las direcciones de registro Modbus son un espacio independiente (véase Transporte Modbus); una dirección Modbus nunca equivale a «la dirección I²C del mismo valor»: las tablas de correspondencia se dan explícitamente. -
Orden de bytes. Los valores de varios bytes en I²C son little-endian. En Modbus, el perfil nativo usa orden de palabras big-endian ABCD (configurable); el perfil float32 es siempre ABCD.
-
Unidades (enteros de escala fija, nunca float, en I²C y en el perfil nativo de Modbus):
| Magnitud | Unidad | A SI |
|---|---|---|
| Tensión | mV | ÷1000 → V |
| Corriente | µA | ÷1 000 000 → A |
| Potencia activa | mW (con signo) | ÷1000 → W |
| Potencia reactiva | mvar (con signo) | ÷1000 → var |
| Potencia aparente | mVA | ÷1000 → VA |
| Factor de potencia | Q10 (con signo) | ÷1024 → PF |
| Frecuencia | cHz | ÷100 → Hz |
| Energía acumulada | Wh / varh (i64, con signo) y mWh (i64); contadores µWh (i64) y µvarh (i64) | — |
| Ángulo de fase de tensión | centígrados (i16, con signo) | ÷100 → ° |
| Energía por ventana | mW·muestras (i64, con signo) | vea el modelo de medición |
| THD | centi-por ciento | ÷100 → % |
-
Signos. P > 0 = importación (consumo); la exportación es negativa. Q sigue IEC 62053-23 (Q > 0 inductivo). El PF lleva el signo de P. La energía de importación y de exportación se guarda en contadores separados.
-
Centinelas — por transporte. Un campo que una versión concreta no ofrece devuelve, en el perfil nativo de Modbus, un centinela:
0x8000(i16),0x80000000(i32),0xFFFF(u16); en el perfil float32 devuelve 0; en I²C esos campos simplemente devuelven 0, y las direcciones I²C no asignadas devuelven0xFF. -
Regla de control de acceso. Un maestro debe controlar el acceso a los canales según
N_VOLTAGE/N_CURRENT, y el acceso a las funciones segúnCAPABILITIES— los registros de los canales ≥ N y de las funciones ausentes no son datos.