Table of Contents
Advertisement
8. Programmer's reference
Users can connect to the matrix through Ethernet, serial port or USB. After establishing
connection, there is no difference between connection types (except some rare cases,
which are uniquely noted).
Lightware matrix routers can be controlled with external devices which can communicate
according to the router protocol. Lightware routers have a special protocol, but to
interoperate with third party devices, a secondary protocol is also provided.
Please see section 5.5 on page 60 about remote operation and connection setup.
Renewed protocol
The MX-CPU2 processor board works with a similar but renewed protocol as the earlier
generation matrix frames with 'CPU1'.
This icon indicates functions which are heavily modified in the MX-CPU2.
8.1. Changing protocols
The router is equipped with multiple router protocols. Different control interfaces can be
set to use different protocols. E.g. the Ethernet interface can use the Lightware protocol
while the Serial interface uses Protocol#2 at the same time.
The currently used protocol can be viewed or changed any time on the matrix front panel
(see section 5.5.5 on page 62) or with protocol commands.
8.2. Protocol description
The protocol description hereinafter stands for Lightware protocol.
The matrices accept commands surrounded by curly brackets - { } - and responds data
surrounded by round brackets - ( ) - only if a command was successfully executed. All
input commands are converted to uppercase, but respond commands can contain upper
and lower case letters as well.
Legend for control commands:
<in>
<out>
<in²>
<out²>
<loc>
<id>
<id²>
CrLf
●
→
←
Page 100 / 137
=
input number in 1 or 2 digit ASCII format (01,5,07,16 etc.)
=
output number in 1 or 2 digit ASCII format
=
input number in 2 digit ASCII format (01, 02, 10, 12 etc.)
=
output number in 2 digit ASCII format (01, 02, 10, 12 etc.)
=
location number in 1, 2 or 3 digit ASCII format
=
id number in 1 or 2 digit ASCII format
=
id number in 2 digit ASCII format
=
Carriage return, Line feed (0x0D, 0x0A)
=
space character (0x20)
=
each command issued by the controller
=
each response received from the router
Section 8. Programmer's reference
Advertisement
Table of Contents
