TLX Matrix Switch ASCII API V5 9 Rev. I, January 2019
XSTATUSIO and XSTATUSOI
These commands return the current switch connection state. The switch state is returned as
pairs of ports: input port and output port for the 'IO' command and output port and input port for the
'OI' command. A data pair is returned for each active connection. The semi-colon is always present in
an 'OK' response.
These commands use four-digit, zero-filled decimal values. For example: the value 12 is encoded as:
0012. There is only one 'I' or 'O' in the response. It is immediately after the 'OK' and is there to identify
which port (input or output) appears first in the data pair. The order in which the ports are listed is not
defined.
Format: XSTATUSIO
Format: XSTATUSOI
This will return a (very) long string listing every connection. The connection list consists of pairs of
port numbers.
Example Results:
• XSTATUSIO: R0027OKI0010012300120015;
• XSTATUSOI: R0027OKO0015001201230010;
• XSTATUSOI: R0011OKO;
• XSTATUSOI: R0019OKO0015001201230010;
• R0005OKI;
• R0005OKO;
• R0007ERnnnn
XGET
Like the XSTATUSIO and XSTATUSOI commands, this command returns the entire switch
connection state. The output from this command is used by the XPUT command (see pg. 6).
Format: XGET
• This will return a (very) long string listing every connection. The connection list consists of
a series of input port numbers, followed by output port numbers.
• The XPUT command requires all the characters from the response that come after the 'OK'.
Example Results:
• R0039OKI00010003I00020004I00100010I00110012
• R0030OKI00010003I00100010I00110012
• R0012OKI01230145
• R0003OK or R0007ERnnnn
System Information Commands
XVERSION
Returns the API program version number.
Format: XVERSION
Example Results: R0009OKV5.00