Table of Contents PREFACE ................................3 About Thinklogical ........................3 A BELDEN BRAND About This Manual ..............................4 Active Links .............................. 4 Note and Warning Symbols ........................4 Font Conventions Used in this Manual ....................4 REGULATORY & SAFETY COMPLIANCE ......................5 Class 1 Laser Information ............................
Page 3
• Diagnostic Commands ........................... 18 XTEST1 ..............................18 XTEST2 ..............................18 XTEST3 ..............................18 TLX Matrix Switch Port Numbering ........................19 The TLX12 ............................. 19 The TLX24 ............................. 19 The TLX48 ............................. 19 The TLX48 2RU ............................. 19 The TLX80 ............................. 20 The TLX160 ............................
Thinklogical products are designed and manufactured in the USA and are certified to the ISO 9001:2015 standard. Thinklogical is headquartered in Milford, Connecticut and is owned by Belden, Inc., St. Louis, MO (http://www.belden.com). For more information about Thinklogical products and services, please visit https://www.thinklogical.com.
About This Manual This document describes the command set used to control Thinklogical's TLX series of Matrix Switches. The TLX Matrix Switch API commands are based on the command set used by our VX Matrix Switches and are detailed in the document: Matrix_Switch_ASCII_API. •...
REGULATORY & SAFETY COMPLIANCE Class 1 Laser Information TLX Matrix Switches, like all Thinklogical fiber-optic products, are designed and identified as Class 1 LASER ® products. This means the maximum permissible exposure (MPE) cannot be exceeded when viewing the laser with the naked eye or with the aid of typical magnifying optics (magnifying glass, eye loupe, etc.). Symbols Found on Our Products Markings and labels on our products follow industry-standard conventions.
European Union Declaration of Conformity Manufacturer’s Name & Address: Thinklogical, A BELDEN BRAND 100 Washington Street Milford, Connecticut 06460 USA Thinklogical’s products comply with the requirements of the Low Voltage Directive 2006/95/EC, the EMC Directive 2004/108/EC, the RoHS Directive 2011/65/EU, the WEEE Directive...
Product Serial Number Thinklogical products have a unique serial number, which includes a date-code, printed on an adhesive label that is affixed to the unit. The format for the date-code is 2 digits for the month, dash, 2 digits for the year, plus at least four digits for a unique unit number. For example: 07-230015 indicates the unit was built in the month of...
CONVENTIONS Port Numbers All port numbers are four places long, begin with 1 and have leading zeros. For example, port 15 is ▪ encoded as 0015. A port number of 4 zeros is used in response to a status command to signify that no port is in use. ▪...
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 connections to input 5. The 'i' and 'o' may be of either case. CixxxxOyyyyO...
To turn off all the ports, set the input to all zeros and the output to 9999. An 'M' without inputs or outputs is valid. This allows external systems to determine if the API version supports the macro command. M0000001101230000 Example: disconnect output 11 disconnect input 123...
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.
XINSTALLED Returns an inventory of installed I/O cards. A zero means the card is not installed and a one means the card is installed. The number of cards determines the number of zeros and ones returned and the number of cards varies for each TLX model. The cards are listed from left to right, with the leftmost digit used for the card that has port 1.
XCTIME The latest API now collects data on how long a port is connected. This is a cumulative amount, not how long the current connection has been in place. It is kept for both the input and output sides of a connection.
XLASTEVENT Returns a time-stamp string that was set the last time a connection was made or broken. This can be used to determine if the switch status has changed since the last XLASTEVENT command was issued. Format: XLASTEVENT R0027OKThu Jul 1 11:23:52 2010 Example Results: XPORTCONFIG...
XQUIT Ends the network connection. XCRON and XCROFF Enables or disables sending CR's on each line. XCRON is typically used when a (Windows) telnet client connecting to the switch requires each line to end with a CR/LF pair. Format: XCRON XCROFF Example Results: R0003OK...
XTXPWR This command returns the transmitter power of SFPs in a numerical format. The value returned is a four-digit representation of the SFP transmitter power in microwatts (uW). The port inquiry is specified by the four-digit port number (nnnn). nnnn = 9999 returns all ports. Format: XTXPWRnnnn XTXPWR0014...
XHELP Print a list of valid commands. This is a multi-line response that does NOT start with OK or ER or end with a length. It is intended as a debugging aid and not for use in a production environment. It does not follow XHELP the format rules for command responses.
• Diagnostic Commands These commands are used to test the ability of the switch to make connections. They will connect each of the input ports to each of the output ports in one of three ways, as described below. XTEST1 Connects all the ports on the Matrix Switch (n to n).
TLX Matrix Switch Port Numbering Connections on a TLX Matrix Switch can be made between any ports on any card. When making or breaking connections, be sure to identify the 'direction' of the connection, which refers to the extenders’ data flow, from transmitter to receiver, or receiver to transmitter. •...
The TLX80 TLX80 Port numbers begin at the bottom and start with the left I/O Card. The TLX160 TLX160 Port numbers begin at the bottom and start with the left I/O Card. Controller Cards The TLX320 TLX Matrix Switch ASCII API V5, Rev. M, July 2023...
The TLX640 TLX640 Port numbers begin at the Lower Card Cage and start with the left I/O Card (Ports 1- 20), proceeding up to the Upper Card Cage’s left I/O Card (Ports 21-40). Port numbers then move to the second I/O Card on the Lower Card Cage (Ports 41-60) and proceed up to the second I/O Card on the Upper Card Cage (61-80), etc.
The TLX1280 Port numbering begins at the bottom of the TLX1280’s chassis and starts with Card 1, the leftmost I/O card of the Lower Card Cage. Card 2 is directly above Card 1 in the Upper Card Cage. When installing fewer than 40 I/O Cards, cards slots may be chosen at the user’s discretion.
Error and Status Codes – Syntax error. 0001 – The command is missing an input port field. 0002 – The command is missing an output port field. 0003 – The command has multiple input fields, but only 1 is allowed. 0004 –...
For any product issues or questions, or for technical assistance, please call us and let us help. If you need to write us or return a product, please use the following address: Please include the Return Merchandise Authorization number: Thinklogical, A BELDEN BRAND 100 Washington Street Milford, CT 06460 USA Attn: RMA#...
Appendix A: Switch Status Broadcast The API program will periodically broadcast the current switch connection map over the network. This data may be used to keep external systems in sync with the switch. Previously, either the XGET or XSAVE command was needed to obtain the connection map. In systems with many external controls trying to stay synchronized to the Matrix Switch, the switch would spend a lot of its resources trying to answer these status requests.
Appendix C: Connecting Extenders The following are sample commands needed to connect selected transmitters and receivers through a TLX Matrix Switch. These examples will reference the appropriate Quick Start Guide. VEL-24 through a TLX320 VX320Video_VEL-24_VEL-38_QSG Quick Start Guide: Number of fibers: 3: L1, L2, L3 Backchannel fiber: L2 (data from receiver to transmitter) Tx24 fiber connections Rx24 fiber connections...
Appendix D: Point-to-Point Switching Mode Point-to-Point Switching Mode, or P2P, disables broadcasting by ensuring that input ports are restricted to one output port at a time on the same Matrix Switch. To specify which inputs will be P2P, the user must provide a P2P definition file with a table defining each input that will have an output restriction on the Matrix Switch.
Page 30
2) Fully verify the P2P Policy on the active Primary Controller Card before implementing single-output control domains on the same Matrix Switch. 3) In a redundant system, make the Back-Up Controller Card active by disconnecting the LAN cable from the Primary Controller Card’s LAN port. The Back-Up Controller Card, upon becoming active, will evaluate its P2P Table.
Page 31
NOTES: ____________________________________________________________________________________________ TLX Matrix Switch ASCII API V5, Rev. M, July 2023...
Need help?
Do you have a question about the thinklogical TLX Series and is the answer not in the manual?
Questions and answers