Linx Matrix Switcher Programmer s Guide for Crestron Controllers

Transcription

1 SPECTRUM Linx Matrix Switcher Programmer s Guide for Crestron Controllers June 2012 Spectrum 950 Marina Village Parkway Alameda, CA 94501

2 DOCUMENT Linx Matrix Switcher Programmer s Guide for Crestron Controllers P/N v1.0 June 2012 COPYRIGHT Copyright 2012 Spectrum, Inc. All rights reserved. This guide is for use with the Spectrum Linx Matrix Switchers. Use for any other purpose is not permitted. This guide was prepared for viewing on a PC; a copy may be printed as required. Linx and CrossXFormat are registered trademarks of Spectrum, Inc. NOTICE Spectrum reserves the right to make any modification to this guide or the information contained herein at any time without notice. All features, functions, and specifications are subject to change without notice or obligation. Spectrum 950 Marina Village Parkway Alameda, CA Telephone: (510) Fax: (510) COMPANY ADDRESS Crestron and SIMPL are registered trademarks of Crestron Electronics, Inc. AMX is a registered trademark of AMX, LLC registered in the U.S. and other countries. Windows is a registered trademark of Microsoft Corporation in the United States and other countries v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 2

3 SPECTRUM LICENSE AGREEMENT Code Block and Touch Panel Software Files for the Crestron Control Systems Distribution and End User License Agreement for Use on Personal Computers 1. WARRANTY DISCLAIMER, BINDING AGREEMENT. 1.1 NO WARRANTY. THE SOFTWARE AND OTHER INFORMATION LICENSED IN THIS AGREEMENT IS MADE AVAILABLE TO YOU AS IS. SPECTRUM AND ITS SUPPLIERS DO NOT WARRANT THE PERFORMANCE OR RESULTS OBTAINED BY USING THE SOFTWARE. SPECTRUM AND ITS SUPPLERS MAKE NO WARRANTIES, CONDITIONS, REPRESENTATIONS, OR TERMS (EXPRESS OR IMPLIED WHETHER BY STATUTE, COMMON LAW, CUSTOM, USAGE, OR OTHERWISE) AS TO ANY MATTER INCLUDING WITHOUT LIMITATION NONINFRINGEMENT OF ANY PARTY S RIGHTS, MERCHANTABILITY, INTEGRATION, SATISFACTORY QUALITY, OR FITNESS FOR ANY PARTICULAR PURPOSE. YOU MAY BE ENTITLED TO WARRANTIES UNDER LAW IN YOUR JURISDICTION. The foregoing exclusions and limitations will apply to the maximum extent permitted by applicable law, even if any remedy fails in its essential purpose. 1.2 END USER BINDING AGREEMENT. THIS IS A CONTRACT BETWEEN SPECTRUM AND THE END USER ( End User ). Use of these software files indicates acceptance of this agreement. This agreement is effective against Spectrum only if End User has provided Spectrum with information about its intended distribution and Spectrum has confirmed its acceptance of this agreement in writing to the End User. If you enter into this agreement in error, you may rescind your acceptance prior to distributing or using the Software by returning this agreement, along with a signed written statement of your desire to rescind this agreement, to: Spectrum. 2. Definitions Spectrum means Spectrum, 950 Marina Village Parkway, Alameda, California Personal Computer or PC shall mean a hardware product which is designed and marketed with the primary purpose of operating a wide variety of productivity, entertainment, and other software applications provided by unrelated third party software vendors, which operates depending upon the use of a full function and full feature set computer operating system of the type(s) then in widespread use with hardware to operate general purpose laptop, desktop, server and large format tablet microprocessor based computers. This definition of Personal Computer shall exclude hardware products that are designed and/or marketed to have as their primary purpose any number of the following: television, television receiver, portable media player, audio/video receiver, radio, audio headphone, audio speaker, personal digital assistant ( PDA ), telephone or similar telephony based device, game console, personal video recorder ( PVR ), player for digital versatile disc ( DVD ) or other optical media, video camera, still camera, camcorder, video editing and format conversion device, video image projection device, and shall further exclude any similar type of consumer, professional, or industrial device. Software Files means Spectrum provided files which are used with AMX or CRESTRON control systems, touch panels and software v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 3

4 3. License, Distribution. 3.1 License. Subject to the terms of this agreement, including the requirements and restrictions below, and only for purposes of achieving the distribution described in Exhibit A. Spectrum grants End User a non-exclusive, non-transferable, worldwide, royalty-free license to reproduce and distribute the Software Files, in all cases solely for the complete installation and use of the unmodified Software Files on Personal Computers on the Authorized Operating Systems and platforms, as defined in Exhibit A. 3.2 Distribution. End User may: a. Distribute the Software Files on a standalone basis only on physical media (such as CD- ROMs, DVDs, hard disk, etc.); and b. Distribute the Software files as a part of or with third party electronic software (i) through electronic means such as electronic download including, without limitation, electronic software download for example bundled in an installation program, which in turn is downloaded through the Internet and (ii) on physical media (such as CD-ROMs, DVDs, hard disk, etc.). In all cases the Software file is to be distributed in complete form and only for purposes of complete installation and use by the End User. 3. Technical Support. Spectrum shall not be obligated to provide any technical support to suppliers, its distributors, or end users for the Software files. Spectrum - Technical Support can be contacted via telephone at (510) Option 1 or via at tech@rgb.com. 4. Limitation of Liability. IN NO EVENT WILL SPECTRUM OR ITS SUPPLIERS BE LIABLE TO DISTRIBUTOR FOR ANY DAMAGES, CLAIMS OR COSTS WHATSOEVER ARISING FROM THIS AGREEMENT AND/ OR DISTRIBUTOR S USE OF THE SOFTWARE, INCLUDING WITHOUT LIMITATION ANY CONSEQUENTIAL, INDIRECT, OR INCIDENTAL DAMAGES, OR ANY LOST PROFITS OR LOST SAVINGS, EVEN IF AN SPECTRUM REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS, DAMAGES, CLAIMS, OR COSTS FOR ANY CLAIM BY ANY THIRD PARTY. THE FOREGOING LIMITATIONS AND EXCLUSIONS APPLY TO THE EXTENT PERMITTED BY APPLICABLE LAW IN DISTRIBUTOR S JUSISDICTION. IN ANY EVENT, SPECTRUM S AGGREGATE LIABILITY AND THAT OF ITS SUPPLIERS UNDER OR IN CONNECTION WITH THIS AGREEMENT WILL BE LIMITED TO FIFTY U.S. DOLLARS ($50.00). Nothing contained in this agreement limits Spectrum s or its suppliers liability to distributor in the event of death or personal injury resulting from negligence or for the tort of deceit (fraud). Spectrum is acting on behalf of its suppliers for the purpose of disclaiming, excluding and/or limiting obligations, warranties and liability as provided in this agreement, but in no other respects and for no other purpose v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 4

5 5. Export Rules. Distributor agrees, and will ensure that its distributors and resellers agree, that the Software will not be shipped, transferred for exported to any country or used in any manner prohibited by the United States Export Administration Act or any other export laws, restrictions (collectively the Export Laws ). In addition, if the Software is identified as export controlled items under the Export Laws, Distributor represents and warrants that Distributor is not a citizen, or otherwise located within, an embargoed nation (including without limitation Iran, Syria, Sudan, Cuba, and North Korea) and that Distributor is not otherwise prohibited under the Export Laws from distributing the Software. All rights granted under this agreement are granted on condition that such rights are forfeited if Distributor fails to comply with the terms of this agreement. 6. Governing Law. This agreement will be governed by and construed in accordance with the substantive laws in force in the State of California and the competent courts of Alameda County, California shall each have non-exclusive jurisdiction over all disputes relating to this agreement. This agreement will not be governed by the conflict law rules of any jurisdiction of the United Nations Convention on Contracts for the International Sale of Goods, the application of which is expressly excluded. 7. General Provisions. If any part of this agreement is found void and unenforceable, it will not affect the validity of the balance of this agreement, which shall remain valid and enforceable according to its terms. This agreement shall not prejudice the statutory rights of any party dealing as a consumer. This agreement may only be modified by a writing signed by an authorized officer of Spectrum. This is the entire agreement between Spectrum and End User relating to reproduction and distribution of the Software and it supersedes any prior representations, discussions, undertakings, communications, or advertising relating to the Software. Exhibit A RBG Spectrum software files to be distributed Authorized Operating System(s) and platform(s) Number of end-users you will be distributing to? Intended method of distribution Product specific Code Blocks and Touch Panel software sample files. Windows x86, Compatible AMX or CRESTRON Controller and Touch Panels Unlimited Fixed Media (CD/DVD/bundled as ZIP file) or Web download Effective date v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 5

6 General Information 1. General Information Supported Linx Matrix Switchers: Linx DVI 800/1600/3200 Linx CrossXFormat 900/1700/3400 Linx Prime 1000/1800/3400 Linx Firmware: Summary: Crestron Hardware Required: Version 4.1 or higher recommended Controls the Spectrum Linx Switcher family via RS-232 or Ethernet control. Control Processor (2 or 3 Series) and Touch Panel or XPanel Crestron Firmware: Tested with version RS-232 Settings: Baud: 9600 (Linx default); 115,200 recommended Parity: None Data Bits: 8 Stop Bits: 1 Hardware Control: OFF Note The FReeZe (FRZ) command for Scaler card output is handled in reverse order in firmware releases up to This means the FRZ OFF command causes the freeze to become active. The FRZ ON command causes the frozen image to become unfrozen. Beginning with firmware version 4.1 the FRZ ON command causes the image to freeze and the FRZ OFF command causes the frozen image to become unfrozen. 2. Connections All connectors on the Linx switchers are on the back panel. The positions of connectors will vary by model. Figure 1 illustrates the rear panel of the Linx Prime CONTROL DVI In DVI In DVI In DVI In HD/3G-SDI In active active HD/3G-SDI In active active FiberDVI In link status link status FiberDVI In link status link status Inputs Ethernet RS-232 CPU rst RS-232 Serial 100/1000 BASE-T power rfd ready DVI Out DVI Out DVI Out DVI Out DVI Out VAC 6A 50/60 Hz DVI Out link status link status link status link status FiberDVI Out FiberDVI Out Outputs INPUT MODULES I AC Power Power Switch OUTPUT MODULES Figure 1 Linx Prime 1800 Rear Panel v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 6

7 Control Commands 2.1 RS-232 Serial Connector Figure 2 RS-232 Connector Table 1 RS-232 Pin Assignments Pin Signal Description 1 CD Carrier Detect 2 TD Transmit Data 3 RD Received Data 4 (not connected) 5 AB Signal Ground (common return) 6 DSR Data Set Ready 7 CTS Clear to Send 8 RTS Request to Send 9 (not connected) 2.2 Ethernet Connector The Ethernet connector uses port number The port password is. 1 8 Figure 3 Ethernet Connector Table 2 Ethernet Pin Assignments Pin Signal Wire Color 1 TX Data + White/Orange 2 TX Data - Orange 3 RX Data + White/Green 4 Blue 5 White/Blue 6 RX Data - Green 7 White/Brown 8 Brown 3. Control Commands Table 3 Linx Control Commands Command Type Description FORCEHotPlug Switch Forces a hot plug event on one or more inputs. FReeZe Scaler Freezes the image in a window. On scaled outputs HDCP Switch Enables/disables HDCP authentication. On inputs INputSouRCe Switch Selects analog or digital input for CrossXFormat cards. RECALLPreSeT Switch Loads a saved preset. Changes both inputs and outputs RESYNCAUDIO Switch Forces a resynchronization of HDMI audio. On inputs ROUTE Switch Sets routing path from input # to output #. SYStemReSeT Miscellaneous Restarts the system without powering off and on v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 7

8 Control Modules 4. Control Modules 4.1 Input Module Crestron Module: Linx Inputs.umc Linx Commands: FORCEHotPlug, RESYNCAUDIO, HDCP, and INputSouRCe Figure 4 Linx Inputs Figure 5 Inputs Force Hot Plug v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 8

9 Control Modules 4.2 Misc Module Crestron Module: Linx Misc.umc Linx Commands: SYStemReSeT 4.3 Output Module Figure 6 Linx Misc Crestron Module: Linx Outputs.umc Linx Commands: FReeZe Figure 7 Linx Outputs Figure 8 Linx Outputs Freeze v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 9

10 Control Modules 4.4 Preset Module Crestron Module: Linx Presets.umc Linx Commands: RECALLPreSeT 4.5 Routing Module Figure 9 Linx Presets Crestron Module: Linx Routing.umc Linx Commands: ROUTE Figure 10 Linx Routing v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 10

11 Communications Queue Modules 5. Communications Queue Modules While the control modules will work alone, using one of the queue modules will ensure smoother operation. The control modules can generate commands faster than the Linx Switcher can accept them. The queue modules send one command at a time and wait for a response from the Linx 5.1 Ethernet Module Use this module if the Linx Switcher is connected via Ethernet. This module handles all Ethernet communications internally. You do not need a TCP/IP Client symbol in SIMPL. Files Tx Queue - Ethernet v1.0.ush Tx Queue - Ethernet v1.0.usp Input Signals Connect - Tells the module to establish a connection to the Linx Switcher. It's usually safe to put a 1 on this signal, but if the Linx is on a power sequencer, make sure the Crestron isn't trying to connect while the Linx is powered off. tx$ - Connect this signal to the tx$ output signal on the Linx control modules. Output Signals Figure 11 Ethernet Queue Module ConnectStatus - This signal is only used for troubleshooting. In most cases you can put // on the signal. Read the SIMPL help for the status signal on a TCP/IP Client for an explanation of the analog values. 5.2 RS-232 Serial Module Use this module if the Linx Switcher is connected via RS-232. Files Tx Queue - RS-232 v1.0.ush Tx Queue - RS-232 v1.0.usp v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 11

12 Demonstration Program Inputs Signals tx$in - Connect this signal to the tx$ outputs on the Linx control modules. Figure 12 Tx Queue Module Output Signals tx$in - Connect this signal to the tx$ input on the SIMPL Serial Driver. rx$ - Connect this signal to the rx$ output on the SIMPL Serial Driver. 6. Demonstration Program This program may be used to recall presets Included are communications modules for both Ethernet and RS-232; before compiling and uploading the program, comment out the one not to be used. You may also use Test Manager to trigger the other commands. Files Linx Demo.smw Linx Demo.vtp Figure 13 illustrates the Crestron Touch Panel file Linx Demo.vtp, a controller for Linx presets. Figure 13 Touch Panel v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 12

13 Contact Spectrum 7. Contact Spectrum Spectrum can be reached via phone, fax, mail and as listed below: Spectrum 950 Marina Village Parkway Alameda, CA Phone: (510) Fax: (510) Technical support: Sales and product information: Website: v1.0 Linx Matrix Switcher Programmer s Guide for Crestron Controllers 13