TLX Matrix Switch ASCII API V5 6 Rev. I, January 2019
Results
Results from commands are ASCII strings terminated with a newline (linefeed). The first character is
an 'R', followed by a 4 digit, zero-filled length. The length includes the trailing newline. Following the
length will be either 'OK', or 'ERnnnn'. OK signifies the command was successful, while ERnnnn is an
error code. After the OK or ERnnnn, a comment may appear giving more detailed information.
In the case of a status command, the OK is followed by the status response.
Note: Users must wait for a result response before sending another command.
There are several command line options to available control the output from the API. These options
are described in detail in the document:
Manual_Configuring_the_TLX_ASCII_Interface.
Two of the commonly used options are:
1. [--CR] Include a carriage return on each line output. (Useful for Windows)
2. [--verbose] Append a comment to each response with more information about an error code or
repeat the successful command. Comments will start with the '#' character.
Examples of Verbose Output
Command: CI0004O0007
Normal: R0003OK
Verbose: R0015OK#CI0004O0007
Command: CI0004O0087
Normal: R0007ER0007
Verbose: R0072ER0007#Output port number 87 is out of range (1 thru 80):
'CI0004O0087'
Commands
Connection Commands
Connect
Connect one input port to one or more output ports. Connections are additive.
For example, connecting input 5 to output 7 will result in 7 being added to any existing con-nections
to input 5. The 'i' and 'o' may be of either case.
Format: CixxxxOyyyyO...
• xxxx of all 9's is illegal.
• yyyy of all 9's will connect xxxx to all outputs.
• Connections will be made in the order specified.
Example Results: R0003OK or R0007ERnnnn
____________________________________________________________________________________
Warning! When switching keyboard/mouse channels it is now possible to connect one
keyboard/mouse to multiple computers. Unless the appropriate video connections are
also made, you will be sending commands to computers that you are not currently
viewing. This could have disastrous results!
___________________________________________________________________________________