background image

MSC-5-3232 Product Manual

Mascot version 2.1 (Carina Series Firmware 5.3.0)

New commands: 

PairIO

 – for paired I/O 3D support, 

PanelOfs

 – for defining remote panel I/O regions 

to control, 

PanelRate

 – to set remote panel refresh rate, 

ReclkDis

 – for disabling SDI reclockers and 

RemoteSync

 – for synchronizing two video router systems for 3D use.

Added E12 “Unsupported command” error which is returned when a command is not supported by the 
current system or settings.

Added support for Line Feed character as a command terminator (to be compatible with older firmware).
Carriage Return should normally be used.

Added “lock” (0x02) and “reclk” (0x04) t

MtxCfg Command

 “flags” field.

3.2 Telnet Access

A telnet client can be used to access the command interface on TCP/IP port 40.  Many operating systems come 
with a Telnet client or one can be easily obtained.  To control a device using Telnet the IP address and TCP/IP 
port number will need to be supplied.  This is typically added as arguments when executing the “telnet” 
command via your operating system's command prompt or run dialog.  Here is an example command to connect
to a device on the IP address 192.168.2.60 (press ENTER after the command):

telnet 192.168.2.60 40

Pressing the ENTER key after successfully connecting should display the command “>” prompt character.

3.3 Serial Access

Matrix Switch router systems come equipped with a serial port which can be used as another means of sending 
Mascot commands.  Connect a Computer system to the device using a 9 pin RS-232 serial cable.  Using this 
interface requires a serial terminal program, such as HyperTerminal on Windows.  Configure the terminal 
software for 9600 bps 8N1.  In addition Local Echo should be on in order to see what is typed.  Pressing the 
Enter key once connected should yield the “>” prompt character.

3.4 Command Format

Commands consist of a command name, zero or more arguments separated by commas and a carriage return 
(CR, ASCII 13 - the Enter key on a keyboard).  Optionally multiple commands can be combined by separating 
them with a '#' character and the command chain is terminated with a CR character.  Spaces are not required 
between arguments, but can be optionally supplied for readability.  A space is also not required between 
command names and their first argument, if the argument is numeric.  Table 3 lists characters which have 
special meaning in MASCOT commands.

#

Multiple command separator, for chaining commands.

<CR>

Carriage Return (ASCII 13), indicates the end of a command or chain of commands, Enter key.

<BS>

Backspace character (ASCII 11), can be used to backspace characters in interactive command shells.

Used for double quoting string arguments.

'

Used for single quoting string arguments.

Page 20 of 61

© 2013-2016 Matrix Switch Corporation

www.matrixswitch

 

 corp.com

Содержание MSC-5-3232

Страница 1: ...Matrix Switch Corporation MSC 5 3232 Product Manual 4RU 32 input 32 output VGA Analog Video Router Revision 1 4 Page 1 of 61 2013 2016 Matrix Switch Corporation www matrixswitchcorp com ...

Страница 2: ...ALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSE Matrix Switch Corporation disclaims all liability arising from this information and its use Use of Matrix Switch Corporation devices in life support and or safety applications is entirely at the buyer s risk and the buyer agrees to defend indemnify and hold harmless Matrix Switch Corporation from any and all damages claims suits or expenses ...

Страница 3: ...rotocol commands MtxGroup PanelDis and PanelExtEn Updated Mascot protocol information to version 2 4 New manuals for MSC V1616 LS DC MSC 1HD1616 LS DC Revision 1 1 2014 06 24 Updated External Button Control Pinout section Added External Button Control information for MSC HD42L 2014 03 17 Fixed some document cross references Minor text content and figure position changes 2013 11 29 MSC 4HDX6464 man...

Страница 4: ...14 2 3 2 Saving Work Matrix to a target 14 2 3 3 Usage scenarios 14 2 4 Labels Tab 14 2 5 Config Tab 15 2 5 1 System Settings 16 2 5 2 Network Settings 16 2 5 3 Button Panel Settings 17 2 6 Command Tab 18 3 Mascot Control Protocol 19 3 1 Protocol Changes 19 3 2 Telnet Access 20 3 3 Serial Access 20 3 4 Command Format 20 3 4 1 Command Names 21 3 5 Response Format 21 3 6 Command Arguments 22 3 7 Sys...

Страница 5: ...Cmd Command 38 3 11 25 PanelCmdEn Command 39 3 11 26 PanelCond Command 39 3 11 27 PanelDis Command 40 3 11 28 PanelExtEn Command 41 3 11 29 PanelRate Command 41 3 11 30 PClr Command 42 3 11 31 ProtoSer Command 42 3 11 32 PsetNames Command 42 3 11 33 PSub Command 43 3 11 34 PView Command 43 3 11 35 Reboot Command 44 3 11 36 ReclkDis Command 44 3 11 37 RemoteSync Command 44 3 11 38 S Command 45 3 11...

Страница 6: ...e recovery procedure 54 4 3 TFTP Software 54 4 3 1 Windows 54 4 3 2 Mac OS X 55 4 3 3 Linux 56 5 Troubleshooting 57 5 1 Unknown IP address 57 5 2 No Ethernet link when connected to network switch 57 5 3 Unexpected reboots 57 6 Reference 58 6 1 Specifications 58 6 2 Serial Interface Pinout 58 6 3 Glossary 59 7 Matrix Switch Corporation Warranty 61 Page 6 of 61 2013 2016 Matrix Switch Corporation ww...

Страница 7: ...ations to output connectors using 75 Ohm Coax cable with BNC connectors Unused inputs or outputs can be left unconnected VGA Video Connect VGA video sources to input connectors and destinations to output connectors using standard D15 VGA connector cables Unused inputs or outputs can be left unconnected External Audio Router Optional An additional Matrix Switch Corporation AES or analog audio route...

Страница 8: ...re the computer s IP address to be a unique address on the same IP subnet as the device For example 192 168 2 10 The Netmask should be 255 255 255 0 A Gateway address is not necessary for this purpose but could be set to 192 168 2 1 3 Make sure the device is powered on 4 Using a web browser on the computer enter the device s IP address into the Location bar and press ENTER The device web page inte...

Страница 9: ...ace Refer to the Presets Tab section for more details 1 4 Network Planning The default device settings can be used without change in applications with a single router and optionally one remote panel on the same Ethernet network Larger installations or integration with existing IP LAN networks require some network planning NOTE Matrix Switch Corporation can assist in planning and pre configuring de...

Страница 10: ...tes up to 254 addresses The Gateway setting is required to be set to the IP address of the network gateway on remote panels which will be accessing routers across network subnets but this setting is otherwise not needed After assigning device network settings including unique IP addresses remote panels need to be assigned the correct IP addresses to their Remote Router IP setting of the router the...

Страница 11: ...nstallation example consisting of a 32x32 SDI Video Router with a secondary level 32x32 Analog Audio router connected via the AFV DB 25 interface a 32x32 Remote Button Panel a 2RU LCD Remote Panel and a Computer system Page 11 of 61 2013 2016 Matrix Switch Corporation www matrixswitchcorp com ...

Страница 12: ...lines to aid in further description below The web page interface for other router systems is sized appropriately Remote Panels show only the Config and Command tabs Numbered sections in Figure 1 1 System name can be assigned on the Config tab 2 System firmware series and version 3 Tab navigation 4 Preset load drop down selection 5 Source connect buttons 6 Mute button may not be available on all sw...

Страница 13: ...e Destination or a single level is selected 2 2 2 Loading a preset Presets store connection states for one or more Destinations Loading a Preset on the Routing tab consists of simply clicking on the Load preset drop down selector 4 in Figure 1 and selecting the desired preset which is then loaded and applied to the current routing matrix More information on Presets is contained in the following Pr...

Страница 14: ...o a Preset will store the Work Matrix state to non volatile memory which persists through device power cycles and can be recalled at a later time 2 3 3 Usage scenarios The flexibility of the Presets Tab interface allows for several useful scenarios some of which are described below Batch connection operations To perform several connection operations all at the same time make the desired connection...

Страница 15: ...umns for Video and Audio Sources and Destinations Single level routers will have a column for Source labels and one for Destination labels On multi level routers secondary levels can be left blank to use the same label as the first level Presets can also be assigned label names Click the Save button to save changes that have been made 2 5 Config Tab Page 15 of 61 2013 2016 Matrix Switch Corporatio...

Страница 16: ...riptive name of the system up to 15 characters displayed at the top of the Web Page interface which is helpful when managing multiple systems Disable Reclockers Disable SDI reclockers not supported by all Routers added with Carina Series Firmware 5 3 0 3D I O Pairing Enable pairing of destinations sources for two channel 3D support only supported by Routers with 2 or more destinations added with C...

Страница 17: ...nation to control individual destinations of a 16x4 Router 16 source 4 destination Another usage scenario would be to have 2 separate panels control different levels of a Video Audio Router Control Mode Set the matrix control mode only present on Routers added with Carina Series Firmware 5 3 0 Available options include Local Button panel controls the router itself Remote Button panel controls a re...

Страница 18: ...The Command Tab Figure 5 provides access to the Mascot protocol interface Commands are typed on the Command text entry line followed by pressing the Enter key to execute them The results will be displayed in the text area below the command line Clicking the Clear Output button will clear all command output in the lower area See the section Mascot Control Protocol for more information Page 18 of 61...

Страница 19: ...control system manufacturers who support MASCOT contact Matrix Switch Corporation 3 1 Protocol Changes As new commands are added or other changes occur the MASCOT protocol version is incremented The protocol revision can be obtained using the MascotVer command Protocol revision history Mascot version 3 0 Added System Parameter commands Get GetS Set SetA and SetS commands Current system parameters ...

Страница 20: ... prompt character 3 3 Serial Access Matrix Switch router systems come equipped with a serial port which can be used as another means of sending Mascot commands Connect a Computer system to the device using a 9 pin RS 232 serial cable Using this interface requires a serial terminal program such as HyperTerminal on Windows Configure the terminal software for 9600 bps 8N1 In addition Local Echo shoul...

Страница 21: ...y integration since a given partial command may execute a different command as new ones are added to the protocol 3 5 Response Format Most command responses consist of one or more values separated by newlines and ending with the prompt character Newlines consist of a Carriage Return New Line CR LF pair of characters ASCII 13 followed by ASCII 10 The Prompt A prompt character is displayed each time...

Страница 22: ...t configuration Firmware 5 3 0 and newer E13 I O Error A general I O error occurred Table 4 Error Codes 3 6 Command Arguments Command arguments are separated into two categories numeric and string arguments These are further explained in Table 5 Numeric String Decimal 123 1 to 3 decimal digits Unquoted Commands with string arguments automatically interpret argument as string spaces and commas not ...

Страница 23: ...orted String String A generic string argument max length depends on the command Value A general value Value type depends on setting See System Parameters Table 6 Command Argument Types 3 7 System Parameters MASCOT protocol version 3 0 adds commands for setting and querying configuration and other system parameters These commands greatly simplify the MASCOT command set and supersede several configu...

Страница 24: ...rial port baud rate in bits second ctl serial2 log Boolean RW AS RS 485 serial port protocol log enable ctl serial2 proto String RW AS RS 485 serial port protocol selection mascot svs etc mtx serial Number R Current matrix serial number incremented on every routing change mtx sync Boolean RW AS Keep current routing state stored to preset 0 Effectively retains last matrix routing state even after a...

Страница 25: ...implementation and support variations between different system types Many of these commands have been superseded by System Parameters in Mascot protocol version 3 0 Command Arguments Description DHCP 0 1 DHCP enable FrameIP IP Remote router IP address the panel will control Gateway IP Network gateway IP address IP IP System IP address MAC MAC address MapDest Dest Dest Lvl Matrix destination remap ...

Страница 26: ...systems are supported RemoteSync 0 1 Query or assign remote router syncing Useful for creating a 3D system out of 2 routers 3 11 Command Reference This section documents each MASCOT command in detail Please note that command availability may vary between firmware series and versions Details of availability are documented for each command 3 11 1 B Command Carina series only The B command is used fo...

Страница 27: ... thereby indicating that the first level label should be used 3 11 4 DHCP Command NOTE Superseded by the net dhcp System Parameter Query or assign DHCP enable A value of 0 disables DHCP client support and will therefore use the manual values assigned via the IP Netmask and Gateway commands A value of 1 enables DHCP and will obtain the values for the IP address Netmask and Gateway from your DHCP se...

Страница 28: ...ing this feature may slow down the system significantly during excessive matrix routing changes especially when enabled on a serial port interface Also of note is that this option takes effect only while the system remains powered serial port or for the duration of the connection TCP IP telnet sessions This command is not supported by the HTTP web command interface Command Description E Query matr...

Страница 29: ...ter Query or assign the network Gateway IP address This is usually only needed on Remote Panel systems which control a Router device on a different network This setting is saved and recalled on power up Command Description Gateway Query IP address of network Gateway Gateway IP Set IP address of network Gateway 3 11 9 Get Command Protocol version 3 0 The Get command is used for querying values of c...

Страница 30: ...t ip 192 168 2 60 3 11 10 GetS Command Protocol version 3 0 Gets system parameter values in Stored memory The Get Command can be used to query current Active values of parameters and can also be referenced for more details Command Description GetS Display all system parameter Stored values Output consists of one parameter per line with the parameter identifier separated by an equals character and ...

Страница 31: ...ockStatus Command Routers only Query the video lock status and video rate of a Video Router s outputs This command is only supported on some Router systems Unsupported systems will return an Unsupported command error on version 2 1 and newer protocol versions and blank output on older versions Command Description LockStatus Displays Video lock status and rate detection for outputs Format is one de...

Страница 32: ...e examples above are for a 2 level router The first example queries the entire destination map which shows that destination 1 is remapped to physical destination 4 on both levels and destination 2 is remapped to destination 3 on the first level and destination 2 on the second level The second example queries the mapping for a single destination The third example maps destination 1 to physical dest...

Страница 33: ...e 6 on the second level only 3 11 17 MascotVer Command NOTE Superseded by the ctl mascot ver System Parameter Query Mascot protocol version This is useful for software which interacts with a device using the Mascot protocol and wants to discover what protocol version is in use The returned value is either an integer such as 2 or major and minor version numbers separated by a period such as 2 3 Exa...

Страница 34: ...upport Example MtxCfg 8 8 3 4 8 0 The example above is simple output no arguments for a matrix with 2 levels the first has 8 destinations 8 sources and supports mute and lock status query 1 2 3 The second level has 4 destinations 8 sources and does not support mute lock status query or reclocker disable If an argument is specified 0 7 then a more descriptive JSON structure is returned of the follo...

Страница 35: ...for the level SRC_COUNT Count of sources for the level FLAGS A space separated list of flag keywords indicating support for various features as defined by the Name column in the Flags table above SRC Source values for matrix state and preset data Values start from 1 0 represents mute and 1 represents No Change for preset data only Example Newlines and spaces added to response as a visual aid MtxCf...

Страница 36: ...al audio streams for example Command Description MtxGroup Query current I O grouping MtxGroup LEVEL1 Set level 1 I O grouping 0 or 1 disables grouping MtxGroup LEVEL1 LEVEL2 Set level 1 and level 2 I O grouping 0 or 1 disables grouping Example querying and assigning I O grouping MtxGroup 1 1 MtxGroup 2 4 MtxGroup 2 4 The first example MtxGroup command shows that I O grouping is disabled on both le...

Страница 37: ...GCP2U32 only Preset add command Adds a connection to a preset This can be used to incrementally create a preset without changing the active matrix routing 0 can be used for SRC for Mute if supported This command stores preset information which is retained and available through system power cycles Command Description PAdd PRESET DEST SRC Add a connection of SRC to DEST on PRESET for all levels PAdd...

Страница 38: ... button GPIO command macros This system provides a means to easily implement custom functionality in response to a panel button press or GPIO auxiliary port contact closure button or switch to ground Panel buttons and GPIO pins are specified by numeric ID Panel buttons are numbered beginning with ID number 1 Panel button order depends on the panel but generally has the top left button as button 1 ...

Страница 39: ...ds for more details Command Description PanelCmdEn Query panel button GPIO command and conditions enable PanelCmd 0 1 Enable or disable panel button GPIO command and conditions 0 disable 1 enable Examples for querying and enabling panel command conditions PanelCmdEn 0 PanelCmdEn 1 3 11 26 PanelCond Command Protocol Version 3 0 Query and assign panel button GPIO status and indicator conditions Pane...

Страница 40: ...ill clear the condition two consecutive single or double quotes represents an empty string Examples PanelCond 1 P0 2 P1 67 P0 PanelCond 1 1 P0 PanelCond 68 P1 PanelCond 68 The first example above queries the currently assigned panel GPIO conditions which shows that button number 1 and 2 have P0 and P1 conditions assigned respectively which lights the button LEDs when the current matrix routing mat...

Страница 41: ...En 0 PanelExtEn 1 The first command queries the current external panel interface setting 0 disabled The second command enables the external panel interface 3 11 29 PanelRate Command Protocol Version 2 1 For changing remote button panel refresh rate When a button panel is configured to control a remote router the current connection status is refreshed at regular intervals This command can be used t...

Страница 42: ...l serial2 proto System Parameters Query or assign the serial protocol The only available option is currently the case insensitive value Mascot however additional control protocols may be added in the future Value is stored and recalled on power up Command Description ProtoSer Query the protocol used on the serial port ProtoSer PROTO Assign the protocol used on the serial port the only valid value ...

Страница 43: ... command changes preset data which is stored and persists through power cycles Command Description PSub PRESET DEST Remove any existing connection to DEST in PRESET for any level PSub PRESET DEST LEVEL Remove any existing connection to DEST LEVEL in PRESET Example PSub 1 2 PSub 1 3 2 The first command removes any connection to Destination 2 in Preset 1 The second command removes any connection to ...

Страница 44: ...3 11 35 Reboot Command Instructs the system to reboot which is done after a brief delay Ensures that all outstanding data writes are written to non volatile memory prior to the reboot 3 11 36 ReclkDis Command Routers only Protocol Version 2 1 Command for disabling or enabling SDI reclockers Not all router systems support this option Value is saved and recalled on power up Command Description Reclk...

Страница 45: ...he final command sets the IP address of the router to sync secondary router 3 11 38 S Command Routers and MSC GCP2U32 only Query the current matrix routing state Source values for all levels of every destination are shown This command without an argument is equivalent to the X Command with no arguments If an argument value of 1 is supplied then the matrix state is displayed with labels The state o...

Страница 46: ...nd or Stored parameter values Behavior depends on the parameter and is defined in the System Parameter Table Values in Stored memory are loaded at system startup See System Parameters for more details Command Description Set List all parameter identifiers which can be set one per line Set Parameter Value Set a parameter s Active and or Stored value depends on parameter Examples of listing all writ...

Страница 47: ...system parameter Stored values only Values set with this command will not take effect until the system is restarted NOTE Some parameters may not be assignable in Stored memory for example if it does not make sense to recall a value on start up See System Parameters for more details Command Description SetS List all parameter identifiers which can be set in Stored memory one per line SetS Parameter...

Страница 48: ...t level label should be used 3 11 44 SysName Command NOTE Superseded by the sys name System Parameter Query or assign system name The system name is provided for convenience when managing multiple Matrix Switch Corporation systems This value is stored and recalled on power up Command Description SysName Query system name SysName STR Set system name up to 15 characters Example for querying and assi...

Страница 49: ...system with older firmware not supporting the SysType command the second example is what might be returned by an MSC GCP2U32 LCD panel 3 11 46 Vars Command Protocol Version 2 3 Display all system configuration variables Useful in serial terminal or telnet sessions to view all configuration values Command Description Vars Display all system configuration parameters Note that variables consisting of...

Страница 50: ... PRESET Write current matrix routing state to PRESET Example to save state to preset 1 W 1 3 11 48 WebPass Command Assign a web password to password protect the web page interface The serial and TCP IP port Mascot protocol control is not protected by this password This value is stored and recalled on power up Command Description WebPass STR Set web page password blank to disable Examples of settin...

Страница 51: ...can be used for SRC to Mute a destination if supported for a given level Examples X 1 1 2 2 3 8 0 4 X 3 3 8 X 3 4 X 4 0 2 In the above examples the first command queries the matrix routing state typical of a 16x4 system for example the second command queries destination 3 only the third command connects source 4 to destination 3 on all levels and the fourth command mutes destination 4 level 2 Comm...

Страница 52: ...a fixed update IP address of 192 168 2 59 whereas CSU uses the device s configured IP address POSU should be available even if a device s firmware gets corrupted from a previous update attempt whereas CSU will likely no longer be possible POSU has a shorter TFTP update time window of 5 seconds and the TFTP transfer has to occur within this period after power cycling the device This means the PC ne...

Страница 53: ...is an Ethernet switch between the device and update PC Steps for executing a Command Software Update 1 Ensure that the Software Update Requirements are met 2 Configure the PC for a unique IP address on the same IP network as the device if not already Make sure that there are no IP conflicts with the PC or device 3 Prepare the TFTP program to transfer the firmware file to the device but do not init...

Страница 54: ...ng order If network communication with the device is not working ensure network cabling and interconnect hardware is functioning ensure the proper IP address is being used to connect to the device is unique on the network and that the system being used to connect to the device has a unique IP on the same network subnet Consult the Unknown IP address section for details on recovering from an unknow...

Страница 55: ...rmware file to somewhere easily accessible from the Terminal application for example your home directory at Users your_user_name 2 Open a terminal Applications Utility Terminal 3 Use cd commands to change to the location of the firmware file for example cd Users your_user_name followed by the ENTER key 4 Execute the tftp command with the IP address of the device make sure to use the device s confi...

Страница 56: ...he ENTER key 4 Execute the tftp command with the IP address of the device make sure to use the device s configured IP if the update method being used utilizes the devices IP address tftp 192 168 2 59 5 Execute the following commands from within the tftp program pressing ENTER after each line except the last one to prepare the TFTP transfer binary put MSC Carina Firmware x x x hex 6 Make sure to re...

Страница 57: ...erminal application once connected and a prompt character should be displayed Type the following commands pressing ENTER after each one to get the IP address and netmask ip netmask 5 2 No Ethernet link when connected to network switch This device utilizes a 10 BaseT Ethernet interface In the event that the device is connected to a network switch and no physical link is established please try the f...

Страница 58: ... all hostile 40dB at 40MHz all hostile S N Ratio 75dB 0 to 5MHz 40dB 0 to 100MHz HV Channels Input Impedance 200 Ohms Output Impedance 75 Ohms Input Level 2V 4V P P Output Level 2V 4V into 75 Ohms Bandwidth 0 3dB to 60MHz Reference Signal Connector Type Analog BNC with pass through Format NTSC PAL and Tri level sync Digital Audio optional additional device Connector Type BNC Input level 200mV to 5...

Страница 59: ...An abbreviation of MAtrix Switch COrporation proTocol An ASCII text based protocol for interfacing to Matrix Switch Corporation devices Matrix Used when referring to a Router s entire routing state Mute When supported a destination can be muted which for video means the output is turned off and for audio means it is silenced Output Synonymous with Destination Preset Matrix Switch Corporation Route...

Страница 60: ...MSC 5 3232 Product Manual devices for remote panel control the MASCOT network interface and the web page interface Page 60 of 61 2013 2016 Matrix Switch Corporation www matrixswitchcorp com ...

Страница 61: ...which shall be placed on the outside of the shipping package 6 This warranty does not apply if the product has been damaged by accident abuse misuse misapplication or modification EXCEPT AS SET FORTH ABOVE NO OTHER WARRANTIES ARE EXPRESSED OR IMPLIED INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE MSC EXPRESSLY DISCLAIMS ALL EXPRESS OR IMP...

Отзывы: