rbAmp
ES
Tienda
Docs
Actualizado

Transporte Modbus RTU

Con el ajuste Modbus del conmutador de modo de interfaz, el módulo es un esclavo Modbus RTU en sus líneas UART (un transceptor externo las adapta a RS-485). La capa Modbus es una traducción sobre el mismo archivo de registros que I²C: mismas magnitudes, mismos comandos, una sola cola de comandos; solo cambia el formato en el cable.

Serie

  • Trama: RTU estándar [dirección][función][datos][CRC16], polinomio CRC16 0xA001 (reflejado), LSB primero. Una trama con CRC incorrecto no recibe respuesta (comportamiento estándar de RTU).

  • Id de unidad: 1..247, por defecto 1 (CFG_MODBUS_ADDR). 0 = difusión (solo escrituras en lista blanca, véase más abajo). Los ids 248..255 se rechazan en la configuración.

  • Baudios: por defecto 9600. Códigos en CFG_MB_BAUD: 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1000000. El módulo acepta los códigos 0–10; la velocidad de línea por RS-485 la fija el transceptor externo. Si el código guardado es inválido, el módulo arranca a 9600.

  • Formato de trama: CFG_MB_FRAME 0=8N1 · 1=8E1 · 2=8O1 · 3=8N2.

  • Retención de respuesta: CFG_TX_DELAY 0..100 ms, para adaptadores RS-485 de sentido automático que necesitan tiempo para liberar la línea.

  • Los ajustes serie se validan al escribirlos (excepción 03). Una escritura solo deja el valor en RAM; para que surta efecto: guarde (COMMAND 0x04) y reinicie (COMMAND 0x02, condicionado a UNLOCK); el módulo arranca con los valores guardados. Paso a paso: Secuencias D4.

  • Latencia de respuesta: el rango solicitado se copia de forma atómica desde la imagen publicada, así que incluso una lectura de 125 registros es internamente coherente; el dispositivo responde en < 20 ms a cualquier velocidad en baudios (adecuado para consultas de inversor a 3–5 Hz).

  • Las respuestas a comandos que causan un reinicio (RESET, ACTIVATE de firmware, cambio de dirección por UID) pueden estar truncadas o ausentes: el dispositivo puede reiniciarse antes de completar la respuesta, y un retardo de transmisión configurado puede suprimirla por completo. Confírmelo volviendo a sondear tras el reinicio, no por la respuesta.

Códigos de función

FC03 lectura de retenidos · FC04 lectura de entrada · FC06 escritura simple · FC16 escritura múltiple. Cualquier otro código de función → excepción 01.

Límites: FC03/FC04 cantidad 1..125, FC16 1..123; fuera de ellos → excepción 03. FC16 es todo o nada: la trama completa se valida primero; un registro incorrecto → no se aplica nada. COMMAND (retenido 0x8113) es solo de escritura: leerlo → excepción 02.

Espacios de registros

Las direcciones Modbus son un espacio propio, independiente de las direcciones I²C. Estructura:

Espacio Rango Contenido
Entrada 0x0000–0x03FF Perfil float32 (13 puntos en vivo, abajo)
Entrada 0x6000–0x6FFF perfil nativo de enteros a escala (descubrimiento, canales, energía, totales)
Holding (retención) 0x8000–0x83FF configuración nativa · hora/comandos · actualización de firmware
Holding (retención) 0x8400–0x847F ventana de seguridad (certificado del dispositivo / atestación; flujo de bytes)
Holding (retención) 0xA000–0xAFFF espejo de solo lectura de la entrada nativa (= dirección de entrada + 0x4000) para maestros que solo usan FC03
— todo lo demás no asignado → excepción 02

Las direcciones nativas y holding de cada bloque figuran con el mapa I²C en el mapa de registros.

Perfil nativo (entrada 0x6000+)

Enteros de escala fija, con las mismas unidades que I²C. Orden de palabras ABCD (primero la palabra alta) por defecto; CFG_WORD_ORDER = 1 cambia a palabra baja primero para todos los números de varios registros del perfil nativo de entrada (i64 = las cuatro palabras invertidas), y los centinelas de canales ausentes se invierten del mismo modo. Las ventanas de retenidos (0x81xx/0x83xx) son siempre de palabra alta primero, con independencia de CFG_WORD_ORDER. i32 = 2 registros, i64 = 4 registros. Los totales P/Q/S se publican como i64 por Modbus (con extensión de signo desde los valores del dispositivo).

Perfil float32 (entrada 0x0000)

Modbus RTU con un perfil de registros float32 de 13 valores. Las direcciones de registro y el orden de palabras ABCD siguen el mapa de registros SDM públicamente documentado. No hemos probado el módulo con ningún dispositivo SDM, ni con software SDM de terceros, un inversor, un PLC o un sistema SCADA.

IEEE-754 float32, siempre ABCD, unidades físicas (V/A/W/kWh), exportación como magnitud positiva. Puntos en vivo (13):

Dir. de entrada Punto
0x0000 / 0x0002 / 0x0004 tensión L1 / L2 / L3, V
0x0006 / 0x0008 / 0x000A corriente L1 / L2 / L3, A
0x000C / 0x000E / 0x0010 potencia activa L1 / L2 / L3, W
0x0034 potencia activa total, W
0x0046 frecuencia, Hz
0x0048 / 0x004A energía importada / exportada, kWh

Cualquier otra dirección en 0x0000–0x03FF lee 0; un inversor o SCADA que necesite registros fuera de la lista anterior no los obtiene de este perfil. Las fases que el módulo no tiene leen 0.0 (STD-UI1 publica su canal como L1; sus direcciones L1 contienen tensión, corriente, potencia, frecuencia, energía importada y exportada). Los puntos de S, Q, PF y energía total leen 0. Los miembros monofásicos publican su canal como L1. Este perfil no tiene alias de configuración: la configuración se hace con los registros retenidos nativos.

Ids de unidad virtuales

Con CFG_VIRTUAL_IDS = 1 (guardado + reinicio; surte efecto al arrancar), un módulo con más de un canal de corriente también responde en los ids de unidad base+1 … base+N_CURRENT (limitado a 247): cada id es una vista float32 de un solo canal, de solo lectura de un canal de corriente — su tensión, corriente, potencia, potencia total = la potencia de ese canal, frecuencia; los puntos de energía devuelven 0. Cualquier escritura en un id virtual → excepción 02. Elija el id de unidad base de forma que los ids derivados no colisionen con otros medidores del bus.

(La tabla de configuración METER_GROUP del mapa está reservada — la composición de grupos no es configurable.)

Difusión (id de unidad 0)

Solo se aceptan estas escrituras por difusión; cualquier otra se rechaza en silencio (sin respuesta de excepción en la difusión, según el estándar Modbus):

  • fijar la hora — dos tramas: FC16 a 0x8100–0x8101 (época, primero la palabra alta), y luego FC06 COMMAND 0x8113 = 0x0006 — sincronización de reloj en todo el bus;

  • LATCH_BANK / PERIOD_ARM 0x8110–11 y COMMAND 0x03: instantánea sincronizada entre módulos (bit 8 de capacidades);

  • preparación de dirección por UID 0x8118–0x811E + COMMAND 0x16: puesta en servicio en un bus compartido.

Un FC16 de difusión debe mantenerse dentro de los registros de la lista blanca — una trama que toque cualquier otra cosa se rechaza entera.

UNLOCK (comandos protegidos)

Los comandos que cambian el estado del dispositivo deben ir precedidos de la escritura de la clave de desbloqueo 0xA5C3 en el retenido 0x8112:

  • La clave es válida durante 10 s y la consume un comando protegido.
  • Escribir un valor incorrecto borra un desbloqueo activo.
  • Un comando condicionado sin un desbloqueo válido → excepción 03.
  • Leer 0x8112 devuelve el indicador de desbloqueo (0/1) tal como se fijó por última vez — tómelo solo como informativo.
  • Desbloqueo y comando pueden ir en una trama FC16 en 0x8112–0x8113 (primero la clave, después el opcode).

Conjunto protegido: 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (donde esté implementado) · 0x10/0x12/0x13/0x14 (actualización de firmware) · 0x15 (servicio). Sin protección: 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 escritura de página · 0x16 dirección por UID. En los módulos que no implementan un opcode, la negativa es la excepción 03 antes de comprobar siquiera el control de acceso. Los comandos de energía de vida útil usan un mecanismo de clave de un solo uso distinto (LT_KEY), no UNLOCK — véanse los Comandos.

Reglas de comportamiento (contrato de la familia)

  • Los valores de COMMAND, LATCH_BANK y PERIOD_ARM mayores que 0xFF generan la excepción 03 (sin truncamiento silencioso del byte bajo).

  • Una escritura en COMMAND mientras un comando todavía se está ejecutando → excepción 06 (dispositivo ocupado).

  • Ventanas de pares de bytes (seguridad 0x8400+, carga útil del firmware 0x8380+, registro de historial 0x8180+): el registro k contiene los bytes 2k (alto) y 2k+1 (bajo). Las escrituras que tocan bytes de solo lectura → excepción

  • La ventana de seguridad es un flujo de bytes little-endian: los campos numéricos que contiene se decodifican en LE desde los bytes, no como registros big-endian.

  • Una sola tabla de valores de configuración válidos sirve para ambos transportes: un valor no válido por Modbus → excepción 03; el mismo valor por I²C se rechaza en SAVE_CONFIG con ERROR 0xFD; en ambos casos no se guarda nada.

  • Los campos que la compilación no ofrece (canales ausentes; magnitudes de THD y desplazamiento con el bit 2 de CAPABILITIES = 0) devuelven el valor centinela en el perfil nativo (0xFFFF / 0x8000…); en el perfil float32 devuelven 0.

Excepciones

Código Significado
01 función no válida (cualquiera que no sea FC03/04/06/16)
02 dirección fuera del mapa · escritura en un registro de entrada, holding de solo lectura o id de unidad virtual · lectura de un registro de solo escritura
03 valor no válido (id de unidad / código de velocidad / valor de configuración incorrecto · código de operación de comando no válido · valor de COMMAND/LATCH demasiado grande · cantidad fuera de rango · comando condicionado sin desbloqueo)
04 fallo interno del dispositivo
06 dispositivo ocupado (comando u operación de firmware en curso)

La última excepción se conserva para diagnóstico en LAST_EXCEPTION (FC<<24 | code<<16 | address), legible en ambos transportes: I²C 0x0158, retenido de Modbus 0x830A–0B.