Ecler TP-NET - Manual (Page 20)

20
 UNSUBSCRIBE
 DATA
 ERROR
En las tablas del final del documento se describen los distintos tipos de mensajes y sus
correspondientes parámetros asociados.
Los mensajes tipo
SYSTEM, GET, SET, INC, DEC, SUBSCRIBE y UNSUBSCRIBE son los que pueden
ser enviados del cliente al dispositivo EclerNet, mientras que los mensajes DATA y ERROR son los
enviados del dispositivo EclerNet al cliente. Como excepción, el mensaje SYSTEM PING es el único
mensaje de tipo SYSTEM enviado por el dispositivo EclerNet si en el mensaje SYSTEM CONNECT del
cliente se especificó el parámetro opcional PINGPONG .
La comunicación (ya sea vía UDP o RS-232) se inicia cuando un cliente envía el mensaje
SYSTEM
CONNECT al dispositivo EclerNet. Como la comunicación UDP es sin conexión (al contrario que la
comunicación TCP), el dispositivo EclerNet guarda la dirección IP del cliente que le envía el mensaje
SYSTEM CONNECT para usarla como destino de los mensajes generados por el propio dispositivo
( DATA y ERROR ). Tras recibir el mensaje de conexión, el dispositivo EclerNet realiza un volcado de
datos (“dump”) enviando uno por uno todos los valores DATA implementados.
La comunicación se puede terminar de dos formas distintas:
 Manualmente: cuando el cliente envía el mensaje SYSTEM DISCONNECT , el cual cancela
todas las subscripciones y deja de enviar DATA y ERROR
 Automáticamente: si en el mensaje SYSTEM CONNECT inicial se especificó el parámetro
opcional PINGPONG y el cliente no ha recibido mensajes SYSTEM PONG durante un período
superior a 10 segundos (presumiendo pérdida de comunicación)
Los mensajes del tipo
SET enviados por el cliente no tienen realimentación, es decir, el dispositivo
EclerNet no envía el mensaje DATA correspondiente tras procesar el mensaje SET . Es responsabilidad
del cliente actualizar el valor internamente con el dato enviado al dispositivo y, en caso de ser
necesario, emplear el mensaje
GET correspondiente para verificar que el parámetro fue correctamente
procesado en el dispositivo.
NOTAS:
 Los valores numéricos son siempre números enteros sin signo (números positivos sin decimales)
 [PINGPONG] es un parámetro opcional que sirve para configurar la comunicación con el cliente
de manera que sea posible determinar si alguno de los dos ha terminado la comunicación.
Cuando se configura de esta forma, el dispositivo envía un mensaje
SYSTEM PING
periódicamente (una vez por segundo) al cliente, el cual debe contestar con un mensaje
SYSTEM PONG . Si cualquiera de las partes no recibe el correspondiente mensaje en un período
de 10 segundos, se considera que la comunicación ha terminado
 <Input Channel> y <Output Channel> son valores numéricos que identifican un canal de
entrada o de salida en el dispositivo EclerNet:
o Este valor puede estar en un rango [1..8] para unidades MIMO88 configuradas como
Master 8x8, y [1..16] para parejas de MIMO88 configuradas como Master 16x16
o Para los amplificadores serie NPA, <Output Channel> puede estar en el rango [1..2]
o Para los amplificadores serie NZA puede ser un número en el rango [1..4] o [1..6],
dependiendo si el modelo es de 4 o 6 canales
 <Preset Number> es un valor numérico que identifica uno de los distintos Preset disponibles en
la memoria del dispositivo EclerNet:
o Para el MIMO88 este valor puede estar en el rango [1..100]