Matrix Switch Corporation MSC-CP32X1E User manual

Matrix Switch Corporation
MSC-CP32X1E
Product Manual
1RU 32x1 Remote Elastomeric Button Panel
Re ision 1.5
Page 1 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitchcorp.com

MSC-CP32X1E Product Manual
Lega Disc aimers
All material in this document is the legal property of Matrix Switch Corporation.
Information contained in this publication regarding device applications and the like is
provided for your convenience only and may be superseded by updates. It is your
responsibility to ensure that your application meets with your specications. MA RIX
SWI CH CORPORA ION MAKES NO REPRESEN A IONS OR WARRAN IES OF ANY
KIND WHE HER EXPRESS OR IMPLIED, WRI EN OR ORAL, S A U ORY OR
O HERWISE, RELA ED O HE INFORMA ION, INCLUDING BU NO LIMI ED O
I S CONDI ION, QUALI Y, PERFORMANCE, MERCHAN ABILI Y OR FI NESS 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 resulting from such use. No licenses are conveyed, implicitly
or otherwise, under any Matrix Switch Corporation intellectual property rights.
Contacting Matrix Switch Corporation
Website http://www.matrixswitch corp.com
Toll Free [phone]
Phone [phone]
Grass alley, California
Email info@matrixswitch corp.com
Page 2 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
Table 1: Document Revision History
Revision & Date Changes
Revision 1.5
2016-11-18
•Corrected External Button Control Pinout pin diagram for MSC-
HD41L, MSC-HD22L, and MSC-HD42L systems.
Revision 1.4
2016-08-01
•Mascot protocol updated to 3.0 with System Parameter commands,
Matrix I/O mapping commands, and Panel/GPIO commands.
•Improved Software Update documentation.
•Added pinouts for RS-232 and RS-485 serial port and GPIO
Auxiliary interface.
•Added XD series systems.
Revision 1.3
2016-05-17
•Added MSC-CP59X59E panel.
Revision 1.2
2015-08-20
•Added protocol 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 gure position changes.
2013-11-29 •MSC-4HDX6464 manual released.
•Updated Mascot protocol information to version 2.3.
•Added Vars Mascot command description.
Revision 1.0
2013-04-15
•Initial release of modular product manual.
Page 3 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
Tab e of Contents
1 Getting Started....................................................................................................................................................7
1.1 Device Connections......................................................................................................................................7
1.2 Powering Up The Device..............................................................................................................................7
1.3 Front Panel Button Interface.........................................................................................................................7
1.3.1 udio Breakaway..................................................................................................................................7
1.4 Web Page Interface........................................................................................................................................7
1.4.1 ccessing The Web Page Interface........................................................................................................8
1.4.2 Network Settings...................................................................................................................................8
1.4.3 Panel Remote Router IP ddress...........................................................................................................8
1.5 Network Planning..........................................................................................................................................9
1.5.1 Installation Example............................................................................................................................10
1.6 dvanced Panel Configuration...................................................................................................................10
2 Web page interface............................................................................................................................................11
2.1 Overview.....................................................................................................................................................11
2.2 Config Tab...................................................................................................................................................11
2.2.1 System Settings...................................................................................................................................12
2.2.2 Network Settings.................................................................................................................................12
2.2.3 Button Panel Settings..........................................................................................................................13
2.3 Command Tab.............................................................................................................................................13
3 Mascot Control Protocol..................................................................................................................................15
3.1 Protocol Changes........................................................................................................................................15
3.2 Telnet ccess...............................................................................................................................................16
3.3 Command Format........................................................................................................................................16
3.3.1 Command Names................................................................................................................................17
3.4 Response Format.........................................................................................................................................17
3.5 Command rguments..................................................................................................................................17
3.6 System Parameters......................................................................................................................................18
3.6.1 System Parameter Table......................................................................................................................19
3.7 Core Commands..........................................................................................................................................20
3.8 Configuration Commands...........................................................................................................................20
3.9 Miscellaneous Commands..........................................................................................................................21
3.10 Command Reference.................................................................................................................................21
3.10.1 B Command.......................................................................................................................................22
3.10.2 C Command.......................................................................................................................................22
3.10.3 DestNames Command.......................................................................................................................22
3.10.4 DHCP Command...............................................................................................................................23
3.10.5 E Command.......................................................................................................................................23
3.10.6 Firmware Command..........................................................................................................................24
3.10.7 FrameIP Command............................................................................................................................24
3.10.8 Gateway Command...........................................................................................................................24
3.10.9 Get Command....................................................................................................................................25
3.10.10 GetS Command...............................................................................................................................26
3.10.11 Help Command................................................................................................................................26
Page 4 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
3.10.12 IP Command....................................................................................................................................26
3.10.13 LockStatus Command.....................................................................................................................26
3.10.14 M C Command..............................................................................................................................27
3.10.15 MapDest Command.........................................................................................................................27
3.10.16 MapSrc Command...........................................................................................................................28
3.10.17 MascotVer Command......................................................................................................................29
3.10.18 MtxCfg Command...........................................................................................................................29
3.10.19 MtxGroup Command.......................................................................................................................31
3.10.20 NetMask Command.........................................................................................................................32
3.10.21 P Command.....................................................................................................................................32
3.10.22 P dd Command...............................................................................................................................33
3.10.23 PairIO Command.............................................................................................................................33
3.10.24 PanelCmd Command.......................................................................................................................33
3.10.25 PanelCmdEn Command..................................................................................................................34
3.10.26 PanelCond Command......................................................................................................................35
3.10.27 PanelDis Command.........................................................................................................................36
3.10.28 PanelExtEn Command.....................................................................................................................36
3.10.29 PanelRate Command.......................................................................................................................37
3.10.30 PClr Command................................................................................................................................37
3.10.31 ProtoSer Command.........................................................................................................................37
3.10.32 PsetNames Command......................................................................................................................38
3.10.33 PSub Command...............................................................................................................................38
3.10.34 PView Command.............................................................................................................................39
3.10.35 Reboot Command............................................................................................................................39
3.10.36 ReclkDis Command.........................................................................................................................40
3.10.37 RemoteSync Command...................................................................................................................40
3.10.38 S Command.....................................................................................................................................41
3.10.39 SerBaud Command..........................................................................................................................41
3.10.40 Set Command..................................................................................................................................41
3.10.41 Set Command................................................................................................................................42
3.10.42 SetS Command................................................................................................................................42
3.10.43 SrcNames Command.......................................................................................................................43
3.10.44 SysName Command........................................................................................................................43
3.10.45 SysType Command..........................................................................................................................44
3.10.46 Vars Command................................................................................................................................45
3.10.47 W Command....................................................................................................................................45
3.10.48 WebPass Command.........................................................................................................................46
3.10.49 X Command.....................................................................................................................................46
4 Software Updates..............................................................................................................................................48
4.1 Software Update on Carina Series Devices................................................................................................48
4.1.1 Software Update Requirements...........................................................................................................48
4.1.2 Power on Software Update..................................................................................................................48
4.1.3 Command Software Update................................................................................................................49
4.2 Software failsafe recovery procedure..........................................................................................................50
4.3 TFTP Software............................................................................................................................................50
4.3.1 Windows..............................................................................................................................................50
Page 5 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
4.3.2 Mac OS X............................................................................................................................................51
4.3.3 Linux....................................................................................................................................................51
5 Troubleshooting.................................................................................................................................................53
5.1 Unknown IP address....................................................................................................................................53
5.2 No Ethernet link when connected to network switch..................................................................................53
5.3 Unexpected reboots.....................................................................................................................................53
5.4 Glossary.......................................................................................................................................................53
6 Matrix Switch Corporation Warranty............................................................................................................55
Page 6 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
1 Getting Started
Congratulations on your purchase of a quality Matrix Switch Corporation product. This section contains a
general overview of device functionality and provides information to get you up and running quickly.
dditional sections in this manual can be consulted for more detailed information on the subsystems and
features of this product.
1.1 Device Connections
The MSC-CP32X1E comes with a power supply adapter and a documentation CD. dditional cables and
hardware are not usually provided.
•Power supply adapter – 5 VDC 2 mp power supply adapter is provided which is connected to the
5.5mm OD 2.5mm ID coaxial connector on the device and plugged into a 100-240V 50/60Hz C power
source.
•Ethernet connector – Connect to a network switch with an Ethernet cable. Required for controlling a
remote router, accessing the web page interface and using the TCP/IP Mascot interface. This device can
also be connected directly to a computer (for configuration purposes) or the router to control (with a
crossover Ethernet cable).
•Composite Video – Connect composite video sources to input connectors and destinations to output
connectors using 75 Ohm Coax cable with BNC connectors. Unused inputs or outputs can be left
unconnected.
1.2 Powering Up The Device
This device is not equipped with a power switch and is simply connected to the power supply adapter which is
plugged into a suitable C power source, to power it up.
Once the device is powered it goes through the following startup sequence:
•5 second startup delay to allow for Power On Software Updates.
•The remote panel will attempt to connect to the IP address assigned to the Remote Router IP ddress
setting, the panel button LEDs will cycle until a connection is established.
•The button control panel is initialized and buttons are illuminated to show the initial routing status.
1.3 Front Pane Button Interface
The MSC-CP32X1E is a 32x1 remote button panel for controlling and viewing status of a router.
This panel interface provides control of a single output. The current active input is indicated by the given
numbered input button being lit. Pressing a numbered input button will connect that input to the single output.
1.3.1 Audio Breakaway
n audio breakaway is performed by pressing and holding an input button, followed by pressing another input
button. The 1st button pressed selects the source of the primary level. The 2nd input button pressed will
become the secondary (audio) source and will flash, indicating a breakaway.
1.4 Web Page Interface
Page 7 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
ll Matrix Switch Corporation router and panel devices come with a built-in web page interface.
This interface is used for configuring this panel device.
Devices come factory configured with default settings, unless a pre-configuration request is made during
purchase, an example being a multi device application.
1.4.1 Accessing The Web Page Interface
The default network IP address for this device is 192.168.2.64. Refer to the table below for the default IP
addresses for other types of Matrix Switch Corporation devices.
De ice Type Default IP Address
Video/ udio Routers 192.168.2.60
Remote Button Panels 192.168.2.64
Remote LCD Screen Panels 192.168.2.80
Table 2: Default System IP Addresses
To access the web page interface of the device:
1. Connect the Ethernet port of a computer either directly to the device using a crossover cable to the same
Ethernet network through a network switch or other L N infrastructure.
2. Manually configure 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. 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 interface should load. If the web page interface fails to load, double
check the computer's network settings and physical Ethernet connections. In the event that the IP
address of the device is unknown, refer to the Unknown IP ddress troubleshooting section.
1.4.2 Network Settings
Network settings can be changed on the Config tab of the Web Page Interface. This includes DHCP enable, IP
address, Netmask and Gateway settings. DHCP should only be used for assigning specific network settings
from a central DHCP server or when assigned IP addresses can be determined, otherwise configuring the device
via its IP address would be prevented if the IP address is unknown. fter changing network settings, click the
Save button and then click the Reboot button 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 ddress troubleshooting section.
Refer to the Network Planning section for assistance with developing a network plan for multi-device
applications.
1.4.3 Pane Remote Router IP Address
Remote panels control Matrix Switch Corporation video/audio routers with the TCP/IP protocol via the Ethernet
Page 8 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
port.
The Remote Router IP setting on the Config Tab of the Web Page Interface defines the IP address of the
remote router which the panel interface will control. This defaults to 192.168.2.60 on remote panels, which is
the default IP address of Matrix Switch Corporation routers.
fter changing the Remote Router IP setting click the Sa e button to store the changes, which take effect
immediately (a reboot is not required).
Refer to the Config Tab - Button Panel Settings section for more details on configuring the Remote Router IP
ddress.
Refer to the Network Planning section for more details on configuring devices in multi-device applications.
1.5 Network P anning
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 L N networks
require some network planning.
NOTE: Matrix Switch Corporation can assist in planning and pre-configuring devices for specific application
requirements at purchase time. Just ask 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 M C address, the net effect still being a fixed IP for each device.
Consult your DHCP server documentation for information on assigning IP addresses by M C address, if this
option is chosen.
ll devices which need to communicate with one another (routers, remote panels and computers) need to be
physically connected to the same L N or allow IP packet routing between networks if on separate L Ns.
SECURITY WARNING: Matrix Switch Corporation devices are meant for installation in trusted L N
environments. In the event that remote device configuration or control is desired over public networks or the
Internet, it is strongly recommended that some form of inter-network security is utilized, such as firewalls and
encrypted VL N or secure data tunnels. This is necessary to prevent undesired access to devices.
Devices on the same L N need to be assigned unique IP addresses in the same IP subnet. Matrix Switch
Corporation devices are configured by default to use IP addresses in the class C IP subnet 192.168.2.x. When
integrating devices into an existing L N network, unique IP addresses should be assigned from the applicable
network and the Netmask setting of the devices should be set to reflect the class (size) of the IP network (the
default of 255.255.255.0 is for class C, which accommodates 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.
fter 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 they will control.
dditional configuration changes may be required, depending on the application and are described in
subsequent sections.
Page 9 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
1.5.1 Insta ation Examp e
The following diagram is of a simple installation example consisting of a 32x32 SDI Video Router, with a
secondary level 32x32 nalog udio router connected via the FV DB-25 interface, a 32x32 Remote Button
Panel, a 2RU LCD Remote Panel and a Computer system.
1.6 Advanced Pane Configuration
Button panel interfaces (on local and remote panels) can be configured to control a subset of destinations,
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 udio router to control Video only and an additional
16x16 remote panel to control udio independently.
•Use a 4x4 panel to independently control 4 destinations of an 8x8 router and limit selectable sources to 4
sources.
The applicable settings for advanced panel control scenarios can be found on the Config Tab of the Web Page
Interface. Refer to that section for additional details.
Page 10 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
2 Web page interface
2.1 Overview
Figure 1: Routing Tab
ll Matrix Switch Corporation Router and Remote Panel systems include a built in web page that can be used
with standards compliant Javascript enabled web browsers, including but not limited to Firefox, Chrome, Safari
and recent versions of Internet Explorer.
Figure 1 shows the Routing tab of a 16x16 switcher with 2 levels with numbered outlines 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 switchers and levels)
7. Currently selected destination (destination name followed by currently connected source names for both
levels).
2.2 Config Tab
Page 11 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
Figure 2: onfig Tab
Figure 2 depicts the Config Tab as seen on a Router system beginning with Carina Series Firmware 5.3.0.
Configuration fields vary depending on router features, firmware version and if the device is a Remote Panel.
NOTE: fter changing any configuration settings click the Sa e button. ll Network Settings changes require
a Reboot of the device in order to take effect. fter clicking Sa e, click the Reboot button to restart the device.
Remember to enter a new IP address into your Web browser's Location bar, if the device's IP address has
changed.
2.2.1 System Settings
•System Name – descriptive name of the system (up to 15 characters), displayed at the top of the Web
Page interface which is helpful when managing multiple systems.
2.2.2 Network Settings
WARNING: DHCP should only be enabled or the IP Address or Netmask changed if one has an
understanding of TCP/IP network configuration. Once the save button is pressed and the system is rebooted any
changes to DHCP enable, the IP ddress or the Netmask shall result in having to access the web page with the
new settings. If there are Matrix Switch Corporation remote control panels which access the system which has
been changed, they must also be reconfigured to use the new router IP address as well. See the Network
Planning section for more helpful information on planning your network.
Page 12 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
•Enable DHCP – Check this box to enable DHCP. Disables IP ddress, Netmask and Gateway fields as
these settings are obtained from the DHCP server.
◦WARNING: DHCP server must be present on your network for this to function properly. Using
DHCP allows for dynamic IP or fixed IP assignment from a central location (the DHCP server).
Using this option is only recommended if using fixed IP assignment based on the device's M C
address or if there is a way to determine what IPs the devices get assigned. Otherwise it may
become difficult to determine what IP address to use when accessing the Web Page or utilizing other
Ethernet control interfaces.
•IP Address – The IP address of the system.
•Netmask – The system network mask.
•Gateway – The IP address of your network's Gateway, if applicable. Only necessary on systems which
access other systems outside of your network (a remote panel which accesses a router on a different
network for example).
2.2.3 Button Pane Settings
These settings control the operation of the device's button control panel interface (if applicable).
Four fields are provided for specifying what portion of a router is controlled by the button panel interface. This
provides added flexibility in defining what destinations and sources a panel controls. Some examples of use
include, using multiple 16x1 Remote Panels (16 source, 1 destination) to control individual destinations of a
16x4 Router (16 source, 4 destination). nother usage scenario would be to have 2 separate panels control
different levels of a Video/ udio Router.
•Remote Router IP – The IP address of the remote Router to control.
•Dest Offset – This setting determines what destination the button panel starts on. Defaults to 0 which
means the control panel starts on destination 1. Setting this value to 8 for example would cause the first
destination of the button panel to control destination 9.
•Source Offset – This setting determines what source the button panel starts on. Defaults to 0 which
means the control panel starts on source 1. Setting this value to 8 for example would cause the first
source of the button panel to control source 9. NOTE: If the currently active source cannot be
represented on the control panel, no source button LED will light.
•Le el1 O erride – This setting determines the primary control level of the button interface. It defaults
to 0 which is equivalent to level 1, usually a Video level. Setting this value to 2 for example would set
the primary level to be level 2 (usually udio).
•Le el2 O erride – This setting determines the secondary control level of the button interface. It
defaults to 0, which if the Level1 Override is also 0 is equivalent to level 2, but if the Level1 Override is
a value other than 0, the secondary level control is disabled. Can only be assigned a non-zero value if
Level1 Override is also non-zero. If set to 3 for example, the secondary level would be level 3.
2.3 Command Tab
Page 13 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
Figure 3: ommand Tab
The Command Tab (Figure 3) 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 14 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
3 Mascot Contro Protoco
M SCOT (MAtrix Switch COrporation ProTocol) provides an SCII 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 – 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.
3rd Party support
The M SCOT protocol contains a subset of the basic ISIS Protocol command set and therefore some 3rd party
equipment may work without modification using this protocol. For information about other third party control
system manufacturers who support M SCOT, contact Matrix Switch Corporation.
3.1 Protoco Changes
s new commands are added or other changes occur, the M SCOT protocol version is incremented. The
protocol revision can be obtained using the MascotVer command.
Protocol re ision history
Mascot version 3.0
•dded System Parameter commands: Get, GetS, Set, Set , 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 into Core Commands, Configuration Commands, and Miscellaneous
Commands.
Mascot version 2.4 (Carina Series Firmware 5.6.3)
•dded .MtxGroup, PanelDis, and PanelExtEn commands.
Mascot version 2.3 (Carina Series Firmware 5.5.1)
•dded 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 15 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E 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.
•dded E12 “Unsupported command” error which is returned when a command is not supported by the
current system or settings.
•dded support for Line Feed character as a command terminator (to be compatible with older firmware).
Carriage Return should normally be used.
•dded “lock” (0x02) and “reclk” (0x04) to MtxCfg Command “flags” field.
3.2 Te net Access
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 Command Format
Commands consist of a command name, zero or more arguments separated by commas and a carriage return
(CR, SCII 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. 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 M SCOT commands.
# Multiple command separator, for chaining commands.
<CR> Carriage Return ( SCII 13), indicates the end of a command or chain of commands, Enter key.
<BS> Backspace character ( SCII 11), can be used to backspace characters in interactive command shells.
“ Used for double quoting string arguments.
' Used for single quoting string arguments.
Table 3: Special ommand haracters
Command example
X1,1#X2,2#S<CR>
Connects Source 1 to Destination1 and Source 2 to Destination 2, followed by displaying the ctive Routing
Page 16 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
matrix status. The <CR> is the Carriage Return character.
3.3.1 Command Names
Command names consist of one or more alphabetical characters and are case insensiti e. For convenience with
manual command entry they can also be matched using partial names. The first matching alphabetically sorted
command is used (for example: 'H', 'He', 'hEL' or 'Help' can be used to execute the Help command). However,
this feature should not be relied on with 3rd party integration, since a given partial command may execute a
different command as new ones are added to the protocol.
3.4 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 ( SCII 13 followed by
SCII 10).
The Prompt ‘>’
prompt character ‘>’ is displayed each time a command or chain of commands is entered, to indicate
readiness to receive additional commands. If an error occurs in response to a command, an error will be
displayed prior to the prompt with the following format:
E00: Error message
>
00 will contain a 2 digit decimal error code.
Table 4 shows possible error codes which may be returned in response to commands.
Error # Message Description
E01 Token too long command name or string argument was too long.
E02 Invalid command Invalid command name.
E03 Invalid argument One or more invalid argument values.
E04 Invalid destination Invalid matrix destination number.
E05 Invalid source Invalid matrix source number.
E06 Invalid level Invalid matrix level number.
E07 Invalid preset Invalid preset number.
E08 Unterminated string Double or single quoted string not terminated.
E09 Backspace limit
reached
Devices have a limited backspace buffer size, if too many characters are
backspaced and then more characters are appended, this error will occur.
E10 Buffer overflow Data exceeds maximum buffer length.
E11 Serial receive overrun One or more characters were lost on the serial interface.
E12 Unsupported command Command is not supported by the system or current configuration.
Firmware 5.3.0 and newer.
E13 I/O Error general I/O error occurred.
Table 4: Error odes
3.5 Command Arguments
Page 17 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
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
allowed).
Hex (0x3D) 0xNN where NN are 2 hex digits
from 0-9, -F or a-f
Double quoted One or more characters surrounded
by double quotes (“ n rgument”).
Single quoted One or more characters surrounded
by single quotes (' n rgument').
Table 5: Basic Argument Types
rguments are shown in the Help command output surrounded by square brackets '[ rg]' or parenthesis '( rg)'.
Square brackets indicate an optional argument and parenthesis indicate a required argument. ny optional
argument specified requires that all prior optional arguments are also specified. Table 6 lists currently used
command argument types.
Argument Valid Range Meaning
Boolean 0/1, T/F, True/False Boolean true or false value.
Cmd String M SCOT command.
Cond String Condition statement. See PanelCond C ommand.
Dest 1-N Destination number (N = Count of destinations)
IP D.D.D.D IP address string argument, specified as 4 decimal numbers from 0 to 255
separated by periods.
Json String JSON formatted string, the structure of which depends on the command.
The JSON string should be quoted in single quote characters when
specifying a JSON value in a command.
Label String string label argument, max of 8 characters.
Lvl 1-N Level number (N = Count of system levels)
Netmask D.D.D.D Network mask string argument, specified as 4 decimal numbers from 0 to
255 separated by periods. Must be a valid IPv4 netmask.
Number Numeric value. Valid values depends on command.
Preset 0-9 Preset number (preset 0 is special Startup preset)
Parameter Parameter identifier. See System Parameters.
Src 1-N or 0 Source number (N = Count of sources), 0 acts as mute (if supported).
String String generic string argument (max length depends on the command).
Value general value. Value type depends on setting. See System Parameters.
Table 6: ommand Argument Types
3.6 System Parameters
Page 18 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
M SCOT protocol version 3.0 adds commands for setting and querying configuration and other system
parameters. These commands greatly simplify the M SCOT command set and supersede several configuration
commands.
System parameter values can be set in Stored memory and/or ctive memory. Stored values are loaded on
system startup. ctive values are the current control values of the running system, but wont be retained after a
system restart if they differ from the Stored value.
Command Arguments Description
Get [Parameter] Query ctive parameter values.
Get S [Parameter] Query Stored parameter values.
Set [Parameter][Value] Set ctive/Stored parameter value (depends on parameter).
S et [Parameter][Value] Set ctive value of a parameter only.
Set S [Parameter][Value] Set Stored value of a parameter only.
Table 7: System Parameter ommands
Parameter identifiers are represented as one or more alphanumeric words separated by periods, representing a
tree structure similar to file folders or directories. Table 8 below describes the columns in the System Parameter
Table.
Parameter Parameter identifier consisting of one or more words separated by periods.
Value Value type, see the Command rguments section for details.
Access Parameter access. R for Readable settings, W for writable settings, or RW for both.
Set Default parameter memory used with the Set Command. A for ctive, S for Stored, or AS for
both. Commands which use only Stored memory require a reboot to become ctive.
Table 8: System Parameter Table olumns
3.6.1 System Parameter Tab e
Parameter Value Access Set Description
ctl.mascot.ver String R Mascot version in the form M JOR.MINOR (3.0 for example).
ctl.serial.baud Number RW S RS-232 serial port baud rate in bits/second.
ctl.serial.log Boolean RW S RS-232 serial port protocol log enable.
ctl.serial.proto String RW S RS-232 serial port protocol selection (“mascot”, “svs”, etc).
ctl.serial2.baud Number RW S RS-485 serial port baud rate in bits/second.
ctl.serial2.log Boolean RW S RS-485 serial port protocol log enable.
ctl.serial2.proto String RW S RS-485 serial port protocol selection (“mascot”, “svs”, etc).
mtx.serial Number R Current matrix serial number, incremented on every routing change.
Page 19 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com

MSC-CP32X1E Product Manual
mtx.sync Boolean RW S Keep current routing state stored to preset 0. Effectively retains last
matrix routing state even after a restart or power cycle.
net.dhcp Boolean RW S Network interface DHCP enable.
net.gateway IP RW S Network gateway address.
net.ip IP RW S Network interface IP address.
net.mac M C R Network interface M C address.
net.netmask IP RW S Network interface mask.
pnl.cmdEn Boolean RW S Panel command macro enable.
pnl.ip IP RW S Remote IP address for panel interface to control.
sys.arch String R System architecture (“Pyxis”, “Carina”, “Lynx”, etc).
sys.firmware String R Firmware series and version (“Pyxis 1.1.7” for example).
sys.name String RW S System name identifier.
3.7 Core Commands
This section outlines commands considered to be core M SCOT protocol commands and consists of matrix
routing, I/O label, preset, and other primary system commands.
Command Arguments Description
DestNames [Dest][Lvl][Label] Destination I/O names command.
E[0 | 1] Matrix connection echo enable command.
Firmware System firmware version.
Help Command help reference.
MascotVer Mascot protocol version.
MtxCfg [0-7] Current matrix config.
P[Preset] Recall a preset.
P dd (Preset)(Dest)(Src)[Lvl] dd a connection to a preset.
PClr (Preset) Clear a preset to “No Change” values.
PsetNames [Preset][Label] Preset names command.
PSub (Preset)(Dest)[Lvl] Subtract a connection from a preset.
PView [Preset] View preset.
Quit Quit TCP/IP telnet session.
Reboot Reboot the system.
S[1] Matrix routing status.
SrcNames [Src][Lvl][Label] Source names command.
SysType System hardware series.
W[Preset] Store current matrix routing to a preset.
X[Dest][Src][Lvl] Perform a matrix connect operation.
3.8 Configuration Commands
Commands in this section are for system configuration and are not considered to be a core part of the M SCOT
protocol. There may be implementation and support variations between different system types. Many of these
Page 20 of 55 © 2013-2016 Matrix Switch Corporation www.matrixswitch corp.com