® Table of Contents PREFACE..............................1 About Thinklogical ........................1 ® About This Manual ........................2 Note and Warning Symbols ...................... 2 Font Conventions Used in this Manual ..................2 REGULATORY & SAFETY REQUIREMENTS ..................3 Symbols Found on Our Products ....................3 Regulatory Compliance ........................
Page 4
The TLX320 ..........................17 The TLX640 ..........................18 The TLX1280 ..........................19 Error and Status Codes.........................20 Product Serial Number ........................... 20 Connection to the Product ........................20 THINKLOGICAL SUPPORT ........................ 21 ® CUSTOMER SUPPORT ........................21 Website ............................21 Email ............................21 Telephone ..........................
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 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 (e.g.
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 2012/19/EU and carry the markings accordingly.
® Overview This document describes the command set used to control Thinklogical's TLX series of Matrix Switches. The commands are all ASCII based and are terminated with either a linefeed character or a carriage-return/linefeed pair. Port numbers are all 4 digits in length and filled with leading zeros (Example: port 12 is encoded as 0012).
® 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.
® Disconnect Disconnect one or more input or output ports. Disconnecting an output will only affect that port, but disconnecting an input will affect every output connected to that input. The 'i' and 'o' may be of either case. Dixxxx… Doyyyy…...
® XPUT Restore the entire switch connection state. The output from XGET (pg. 7) is used by this command. Format: XPUTstr • The XPUT command will turn off all outputs and then make the connections that are listed in 'str', which is the response that was returned from a XGET command. •...
® 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. XLASTEVENT Format: Example Results: •...
® XOPTIONS This command returns a numeric response that is a bit map of options available in the version of the API. The value returned is a four-digit decimal number of the binary bit map. For example, if the value returned was 0015, then bits 0, 1, 2, and 3 would be on (bit 0 is the lsb). The following bits are defined: 0: Reserved for HDX Matrix Switches.
® 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 When making or breaking connections on a TLX Matrix Switch, it is important to identify the 'direction' of the connection. In this context, connection direction refers to data flow from the extender transmitter to the extender 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. The TLX320 Controller Cards TLX Matrix Switch ASCII API V5 Rev.
® 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.
API V5 does not use this error code. Product Serial Number (MM-YY1234) 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.
Email Thinklogical is staffed Monday through Friday from 8:30am to 5:00pm, Eastern Time Zone. We will do our best to respond to your email inquiries promptly. Please use the following email addresses: – Information on Thinklogical and our products.
Thinklogical warrants this product against defects in materials and workmanship for a period of one year from the date of delivery, with longer term available at time of purchase on most products. Thinklogical and its suppliers disclaim all other warranties. Please refer to your product invoice for the Warranty Terms &...
® 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. A) 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...
Page 29
® B) VEL-38 through a TLX320 VX320Video_VEL-24_VEL-38_QSG Quick Start Guide: Number of fibers: 5, L1, L2, L2, L3, L4, L5 Backchannel fiber: L2 (data flows from receiver to transmitter) Tx38 fiber connections Rx38 fiber connections • L1 -> 8R L1 -> 9T •...
® Appendix D: Point-to-Point Connection Mode Version 5.0 of The API may be configured so that input ports are restricted to one output port at a time. If input X is first connected to output A, then connected to output B, X will be disconnected from A and moved to B.
Need help?
Do you have a question about the TLX Series and is the answer not in the manual?
Questions and answers