Matrix Switch Corporation MSC-2HD2408L Product Manual Download Page 20

MSC-2HD2408L Product Manual

3 Mascot Control Protocol

MASCOT (

MA

trix 

S

witch 

CO

rporation Pro

T

ocol) provides an ASCII text based command interface via 

several different transports to control and get status from Matrix Switch Corporation devices.  This command 
protocol can be utilized for manual control or for integration with automation control systems.

Mascot command interface options

Web Page Command Tab

 – The most convenient user command interface, which can be accessed using a

Web Browser on a Computer by the device's IP address.

TCP/IP port 40 – A TCP/IP command interface is provided on port 40 which uses the device's Ethernet 
connector as a physical transport and can be accessed via a telnet application.

RS-232 Serial Port – Serial can also be used with the configuration parameters: 9600 bps 8N1.

3rd Party support

The MASCOT protocol contains a subset of the basic ISIS Protocol command set and therefore some 3

rd

 party 

equipment may work without modification using this protocol.  For information about other third party 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

Adde

System Parameter

 commands: 

Get

GetS

Set

SetA

, and 

SetS

 commands.

Current system parameters are defined in the 

System Parameter Table

, superseding many configuration 

commands.

New commands for defining matrix I/O mapping: 

MapDest

, and 

MapSrc

 commands.

New commands for panel/GPIO command macros and conditions: 

PanelCmd

PanelCmdEn

, and 

PanelCond

.

Commands now grouped int

Core Commands

Configuration Commands

, and 

Miscellaneous 

Commands

.

Mascot version 2.4 (Carina Series Firmware 5.6.3)

Added .

MtxGroup

PanelDis

, and 

PanelExtEn

 commands.

Mascot version 2.3 (Carina Series Firmware 5.5.1)

Adde

Quit Command

SysType Command

 and 

Vars Command

 which have previously been supported 

on the MSC-GCP2U32 only.

Mascot version 2.2 (Carina Series Firmware 5.5.0)

The 

X Command

 now accepts a 0 valued wild card destination to switch all destinations to a given 

source.

Page 20 of 61

© 2013-2016 Matrix Switch Corporation

www.matrixswitch

 

 corp.com

Summary of Contents for MSC-2HD2408L

Page 1: ...ix Switch Corporation MSC 2HD2408L Product Manual 2RU 24 input 8 output 3G SDI Video Router with Button Control Panel Revision 1 4 Page 1 of 61 2013 2016 Matrix Switch Corporation www matrixswitchcorp...

Page 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 su...

Page 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 C...

Page 4: ...anging a connection 14 2 2 2 Loading a preset 14 2 3 Presets Tab 14 2 3 1 Loading Work Matrix from a source target 15 2 3 2 Saving Work Matrix to a target 15 2 3 3 Usage scenarios 15 2 4 Labels Tab 15...

Page 5: ...mmand 37 3 11 21 P Command 38 3 11 22 PAdd Command 38 3 11 23 PairIO Command 38 3 11 24 PanelCmd Command 39 3 11 25 PanelCmdEn Command 40 3 11 26 PanelCond Command 40 3 11 27 PanelDis Command 41 3 11...

Page 6: ...Command Software Update 54 4 2 Software failsafe recovery procedure 55 4 3 TFTP Software 55 4 3 1 Windows 55 4 3 2 Mac OS X 56 4 3 3 Linux 57 5 Troubleshooting 58 5 1 Unknown IP address 58 5 2 No Ethe...

Page 7: ...er reduction Adaptive cable equalization on each input can equalize input signals from Belden type 1694A cables up to lengths of 120m 3G 140m HD and 400m SD SDI BNC Video Outputs Connect SDI destinati...

Page 8: ...rrent active output 1 3 1 Audio Breakaway An audio breakaway is performed by first selecting the desired output by pressing the relevant output button then pressing and holding an input button followe...

Page 9: ...utton to restart the device Refer to the Config Tab Network Settings section for more details In the event that the device s IP address is unknown refer to the Unknown IP Address troubleshooting secti...

Page 10: ...k a sales or customer service representative Manual IP address management is recommended although a DHCP server can be a convenient option for centrally managing IP addresses by device MAC address the...

Page 11: ...els need to be assigned the correct IP addresses to their Remote Router IP setting of the router they will control Additional configuration changes may be required depending on the application and are...

Page 12: ...nations sources and or levels Example use scenarios Utilize an 8x1 remote panel to control a single destination of an 8x8 video router Use the local panel of a 16x16 two level Video and Audio router t...

Page 13: ...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 Sys...

Page 14: ...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 L...

Page 15: ...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 T...

Page 16: ...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...

Page 17: ...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...

Page 18: ...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 Mo...

Page 19: ...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 displ...

Page 20: ...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 p...

Page 21: ...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...

Page 22: ...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...

Page 23: ...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 arg...

Page 24: ...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 Para...

Page 25: ...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 N...

Page 26: ...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...

Page 27: ...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...

Page 28: ...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...

Page 29: ...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 wh...

Page 30: ...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...

Page 31: ...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 refer...

Page 32: ...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 Unsupport...

Page 33: ...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...

Page 34: ...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 us...

Page 35: ...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 se...

Page 36: ...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...

Page 37: ...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...

Page 38: ...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 T...

Page 39: ...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...

Page 40: ...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 Exam...

Page 41: ...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 quer...

Page 42: ...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...

Page 43: ...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...

Page 44: ...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 LEVE...

Page 45: ...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...

Page 46: ...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...

Page 47: ...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...

Page 48: ...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 n...

Page 49: ...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 Mat...

Page 50: ...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 conf...

Page 51: ...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 I...

Page 52: ...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 typic...

Page 53: ...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...

Page 54: ...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 o...

Page 55: ...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...

Page 56: ...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 ch...

Page 57: ...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...

Page 58: ...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 lin...

Page 59: ...bit s 1 485 Gbit s 2 97 Gbit s Input Output Return Loss 15dB HD 12dB 3G Input Level 800 mV P P 20 Input Impedance 75 Ohms 1 Cable equalization 1694A coax 400m SD 140m HD 120m 3G Output Level 800 mV P...

Page 60: ...n 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 D...

Page 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...

Reviews: