Ecler TP-NET - Manual (Page 5)

5
At the end of this document you’ll find all the available messages and their parameters for each model of
EclerNet compatible device.
The
SYSTEM, GET, SET, INC, DEC, SUBSCRIBE & UNSUBSCRIBE messages can be sent from the
client to the EclerNet device. The DATA & ERROR messages can be sent from the device to the client.
The only exception is the SYSTEM PING message, that is a SYSTEM type message that is sent from
the EclerNet device when the initial message from the client to the device was SYSTEM CONNECT
PINGPONG.
The communication (using UDP or RS-232) starts when a client sends the message
SYSTEM
CONNECT to the EclerNet device. As far as the UDP communication requires no connection (unlike the
TCP), the EclerNet device stores this client’s IP address, and then uses it as the destination IP address
for the messages that it generates (
DATA & ERROR ). After receiving the SYSTEM CONNECT
message, the device dumps its entire configuration using several consecutive DATA messages.
The communication can be terminated by two methods:
 Manually: when the client sends the SYSTEM DISCONNECT message, cancelling all the
subscriptions and stopping the DATA & ERROR messages
 Automatically: in case the initial message was SYSTEM CONNECT PINGPONG and the client
didn’t get any SYSTEM PONG message in a period longer than 10 seconds (presuming a
communication breakdown)
The
SET messages don’t have an automatic acknowledgement with a DATA message sent from the
EclerNet device after it has processed the SET command. The client must update the values itself and
must send the needed GET message if it requires confirmation from the device.
NOTES:
 The numerical values are always integer numbers without +, –, comma or dot symbols.
 [PINGPONG] is an optional parameter used to configure the device-client communication with a
periodical check, to see whether the client or the device have terminated it. When configured this
way, the device sends a
SYSTEM PING once per second, and the client must answer with a
SYSTEM PONG message. If anyone doesn’t get these messages along a 10 seconds period, the
communication will be considered terminated
 & are numerical values that identify an input or output
channel of the EclerNet device:
o It can be within a [1..8] range for MIMO88 single units (8x8 matrix masters), and [1..16] for
MIMO88 couples configured as 16x16 matrix masters
o For the NPA series, can be within a [1..2] range
o For the NXA and NZA series it can be within the [1..4] or [1..6] range, for 4 or 6 channel
amplifiers
 is a numerical value that identifies one available Preset stored in the EclerNet
device’s memory:
o For the MIMO88 it can be within the [1..100] range
o For the NPA series it can be within the [1..10] range
o For the NXA and NZA series it can be within the [1..5] range
 , y are numerical values in the [0..100]
range that define values in a scale equivalent to [-inf..0] dB
 & are numerical values within the [1..8] range for the MIMO88 configured as 8x8
matrix masters (single units), and [1..16] for MIMO88 couples configured as 16x16 matrix