147
Set
tings
SYSTEM, GET, SET, INC, DEC, SUBSCRIBE
and
UNSUBSCRIBE
messages can be sent
from the client to the device;
DATA
and
ERROR
messages are sent from the device to the
client.
SYSTEM PING
is the only
SYSTEM
message sent by the device if the optional
PINGPONG
parameter is specified in the client
SYSTEM CONNECT
message.
Communication is initiated when a client sends a
SYSTEM CONNECT
message to the
device. As UDP communication is connectionless (unlike TCP communication), the device
stores the IP address of the client sending the
SYSTEM CONNECT
message to be used as
a destination for the messages generated by the device itself
(DATA
and
ERROR
). After
receiving a connection message, the device performs a data dump by sending all
implemented
DATA
values one by one.
Communication can be terminated in two ways:
•
Manually:
when the client sends the
SYSTEM DISCONNECT
message
,
which
cancels all subscriptions and stops the sending of
DATA
and
ERROR
•
Automatically:
if in the initial
SYSTEM CONNECT
message the optional parameter
PINGPONG
was specified and the client has not received
SYSTEM PONG
messages
for a period over 10 seconds (assumed loss of communication).
SET
messages sent by the client have no feedback, i.e. The device does not send a
DATA
message after processing the
SET
message. The client updates the value internally with
the data sent to the device and, if necessary, uses a
GET
message to verify that the
parameter has been correctly processed in the device.
•
Numerical values are always unsigned whole numbers (positive numbers without
decimals).
•
[PINGPONG]
is an optional parameter used to configure communication with the
client so that it is possible to determine whether either party has terminated
communication. When configured in this way, the device sends a
SYSTEM PING
message periodically (once every second) to the client, which must reply with a
SYSTEM PONG
message. If either party does not receive the relevant message
within 10 seconds, communication is deemed to have been terminated.
•
<Input Channel>
and
<Output Channel>
are numeric values that identify an input
or output channel on the device.
•
<Preset Number>
is a numeric value that identifies one of the Presets available in
the device's memory.
•
<Level>,
<Pre VUmeter Level>
and
<Post VUmeter Level>
are numerical values in
the range [0-100] which define values on a scale equivalent to [-inf-0] in dB
•
<GPI>
and
<GPO>
are numeric values in the range [1-8].
•
<GPI Value>
is a numeric value in the range [0-100] that indicates the value of an
analogue input. If the input is digital, the two possible values are 0 and 100.
