Documentación técnica

Instalar, integrar y diagnosticar

Guías de instalación en planta y la referencia del contrato de integración: registros Modbus, comandos y telemetría.

Registros y telemetría

Referencia de los registros que usa VarioField para leer y gobernar un variador de la familia SAJ, y de cómo se traducen a la telemetría que ve la aplicación.

Funciones Modbus

  • FC 0x03 — lectura de holding registers
  • FC 0x06 — escritura de un registro
  • Máximo 12 registros por lectura continua de parámetros

Registros de telemetría y control

DirecciónAccesoSignificado
0x1000R/WConsigna de frecuencia en % de f.max (−10000…10000 = −100,00 %…100,00 %)
0x1001RFrecuencia de marcha (0,01 Hz)
0x1002RTensión de bus (0,1 V)
0x1003RTensión de salida (1 V)
0x1004RCorriente de salida (0,01 A)
0x1005…0x100ERPotencia, par, rpm, entradas/salidas digitales, analógicas, horas y energía
0x1010RPresión real (0,1 bar)
0x2000WComando: 1 = directa, 2 = inversa, 5 = parada libre, 6 = parada por rampa, 7 = reset de fallo
0x3000REstado: 1 = directa, 2 = inversa, 3 = detenido

El registro 0x100F («presión consignada» del monitor) no se usa como camino de escritura: en unidades PDM de campo devuelve valores inconsistentes. La consigna real se escribe siempre sobre el parámetro del perfil activo.

Escalas

Los registros son enteros sin signo; la unidad de ingeniería sale de dividir por el factor de la tabla. Una lectura de 4999 en 0x1001 son 49,99 Hz, y 612 en 0x1004 son 6,12 A. La consigna de frecuencia es la excepción por llevar signo: se interpreta como entero con signo de −10000 a 10000, donde el negativo indica marcha inversa.

Telemetría

Con el flujo activado (stream on), el equipo publica aproximadamente una vez por segundo:

{"freq":0.00,"amp":0.00,"vdc":0.0,"vout":0.0,"pset":2.0,"pfb":0.0,"status":"stop"}
CampoUnidad y origen
freqHz — registro 0x1001
ampA — registro 0x1004
vdc / voutV — bus y salida
psetbar — consigna, según el perfil activo
pfbbar — presión real, registro 0x1010
statusrun, rev, stop o unknown

Podés ver este mismo flujo, con este mismo formato, corriendo en el demo interactivo.

Errores frecuentes

MensajeCausa habitual
ERR: TimeoutSin respuesta: polaridad, dirección Modbus o baud
CRC errorRuido o cambio de sentido del transceptor demasiado temprano
ERR: BusyOtra transacción en curso
ERR: unknownComando inexistente
PING FAIL step N: … rx_len=KEl enlace con el variador no completó la secuencia

Un rx_len=0 apunta al cableado o al direccionamiento; un rx_len distinto de cero con error de CRC apunta a ruido o a temporización del bus.