Matrix Switch Corporation MSC-CP4X4E User manual

Matrix Switch Corporation
MSC-CP4X4E
Product Manual
1RU 4x4 Remote Elastomeric Button Panel
Revision 1 2
Page 1 of 48 © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Legal Disclaimers
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.matrix-switch.tv
Phone [phone]
Email [email protected]
Page 2 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Publication History
Revision & Date Changes
Revision 1.2
2015-08-20
•Added protocol commands: MtxGroup, PanelDis, PanelExtEn, and
Sierra.
•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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Table of Contents
1 Getting Started 7
1.1 Device Connections......................................................................................................................................7
1.2 Powering p The Device..............................................................................................................................7
1.3 Front Panel Button Interface.........................................................................................................................7
1.3.1 Audio Breakaway..................................................................................................................................7
1.4 Web Page Interface........................................................................................................................................7
1.4.1 Accessing The Web Page Interface........................................................................................................8
1.4.2 Network Settings...................................................................................................................................8
1.4.3 Panel Remote Router IP Address...........................................................................................................8
1.5 Network Planning..........................................................................................................................................9
1.5.1 Installation Example............................................................................................................................10
1.6 Advanced 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 access................................................................................................................................................16
3.3 Command format........................................................................................................................................16
3.3.1 Command names.................................................................................................................................16
3.3.2 Command arguments...........................................................................................................................17
3.4 Response format..........................................................................................................................................17
3.5 Command argument values.........................................................................................................................17
3.6 Error codes..................................................................................................................................................18
3.7 Basic command reference...........................................................................................................................18
3.8 Advanced command reference....................................................................................................................19
3.9 B Command................................................................................................................................................20
3.10 C Command..............................................................................................................................................20
3.11 DestNames Command...............................................................................................................................21
3.12 DHCP Command.......................................................................................................................................21
3.13 E Command...............................................................................................................................................22
3.14 Firmware Command..................................................................................................................................22
3.15 FrameIP Command...................................................................................................................................23
3.16 Gateway Command...................................................................................................................................23
3.17 Help Command.........................................................................................................................................23
3.18 IP Command..............................................................................................................................................23
3.19 LockStatus Command...............................................................................................................................24
3.20 MAC Command........................................................................................................................................24
3.21 MascotVer Command................................................................................................................................24
Page 4 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
3.22 MtxCfg Command....................................................................................................................................25
3.23 MtxGroup Command................................................................................................................................27
3.24 NetMask Command..................................................................................................................................28
3.25 P Command...............................................................................................................................................28
3.26 PAdd Command........................................................................................................................................28
3.27 PairIO Command......................................................................................................................................29
3.28 PanelOfs Command..................................................................................................................................29
3.29 PanelDis Command...................................................................................................................................30
3.30 PanelExtEn Command..............................................................................................................................31
3.31 PanelRate Command.................................................................................................................................31
3.32 PClr Command..........................................................................................................................................31
3.33 PsetNames Command...............................................................................................................................32
3.34 PSub Command.........................................................................................................................................32
3.35 PView Command......................................................................................................................................33
3.36 Reboot Command......................................................................................................................................33
3.37 ReclkDis Command..................................................................................................................................33
3.38 RemoteSync Command.............................................................................................................................34
3.39 S Command...............................................................................................................................................34
3.40 Sierra Command........................................................................................................................................35
3.41 SrcNames Command.................................................................................................................................35
3.42 SysName Command..................................................................................................................................36
3.43 SysType Command...................................................................................................................................36
3.44 Vars Command..........................................................................................................................................37
3.45 W Command.............................................................................................................................................38
3.46 WebPass Command...................................................................................................................................38
3.47 X Command..............................................................................................................................................38
4 Software Updates 40
4.1 Software pdate on Carina Series Devices................................................................................................40
4.1.1 Software pdate Requirements...........................................................................................................40
4.1.2 Power on Software pdate..................................................................................................................40
4.1.3 Command Software pdate................................................................................................................41
4.2 TFTP Software............................................................................................................................................42
4.2.1 Windows XP........................................................................................................................................42
4.2.2 Windows Vista and Windows 7...........................................................................................................42
4.2.3 Mac OSX.............................................................................................................................................42
4.2.4 Linux....................................................................................................................................................43
4.3 Software pdate Errata...............................................................................................................................44
4.3.1 pgrading from version 4.x.x or older firmware................................................................................44
4.3.2 Downgrading from version 5.4.0 to a previous version......................................................................45
5 Troubleshooting 46
5.1 nknown IP address....................................................................................................................................46
5.2 No Ethernet link when connected to network switch..................................................................................46
5.3 nexpected reboots.....................................................................................................................................46
6 Reference 47
6.1 Glossary.......................................................................................................................................................47
Page 5 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
7 Matrix Switch Corporation Warranty 48
Page 6 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E 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.
Additional 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-CP4X4E comes with a power supply adapter and a documentation CD. Additional cables and
hardware are not usually provided.
•Power supply adapter – A 5 Volt 2 Amp 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 AC 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. A crossover
cable can also be utilized for connecting directly to a computer (for configuration purposes) or the router
to control.
1.2 Powering p 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 AC 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 pdates.
•The remote panel will attempt to connect to the IP address assigned to the Remote Router IP Address
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 Panel Button Interface
The MSC-CP4X4E is a 4x4 remote button panel for controlling and viewing status of a router.
This panel interface provides independent status and control of 4 outputs. For each output there are 4 input
buttons indicated by the digits 1 through 4 centered vertically on the panel. The currently connected input is
indicated by the input button being lit, for each of the outputs. Pressing one of the input buttons of an output
will cause that input to be connected to the given output.
1.3.1 Audio Breakaway
An audio breakaway is performed by pressing and holding an input button in an output group, followed by
pressing another input button in the same output group. 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
All 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.
Device Type Default IP Address
Video/Audio Routers 192.168.2.60
Remote Button Panels 192.168.2.64
Remote LCD Screen Panels 192.168.2.80
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 or to the
same Ethernet network through a network switch or other LAN 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. The Gateway doesn't
matter for this purpose, but could be set to 192.168.2.1.
3. Make sure the device is powered on.
4. sing a web browser on the computer, enter the device's IP address into the Location bar and press
ENTER. The 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 nknown IP Address 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. After 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 nknown IP Address troubleshooting section.
Refer to the Network Planning section for assistance with developing a network plan for multi-device
applications.
1.4.3 Panel Remote Router IP Address
Remote panels control Matrix Switch Corporation video/audio routers with the TCP/IP protocol via the Ethernet
port.
The Remote Router IP setting on the Config Tab of the Web Page Interface defines the IP address of the
Page 8 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
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.
After changing the Remote Router IP setting click the Save 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
Address.
Refer to the Network Planning section for more details on configuring devices in multi-device applications.
1.5 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 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 MAC address, the net effect still being a fixed IP for each device.
Consult your DHCP server documentation for information on assigning IP addresses by MAC address, if this
option is chosen.
All devices which need to communicate with one another (routers, remote panels and computers) need to be
physically connected to the same LAN or allow IP packet routing between networks if on separate LANs.
SECURITY WARNING: Matrix Switch Corporation devices are meant for installation in trusted LAN
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 VLAN or secure data tunnels. This is necessary to prevent undesired access to devices.
Devices on the same LAN 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 LAN 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.
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 they will control.
Additional configuration changes may be required, depending on the application and are described in
subsequent sections.
Page 9 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
1.5.1 Installation Example
The following diagram is of a simple installation 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 2R LCD Remote Panel and a Computer system.
1.6 Advanced Panel 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
•tilize an 8x1 remote panel to control a single destination of an 8x8 video router.
•se the local panel of a 16x16 two level Video and Audio router to control Video only and an additional
16x16 remote panel to control Audio independently.
•se 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
2 Web page interface
2.1 Overview
Figure 1: Routing Tab
All 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Figure 2: Config 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: After changing any configuration settings click the Save button. All Network Settings changes require
a Reboot of the device in order to take effect. After clicking Save, 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 – A 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 Address 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
•Enable DHCP – Check this box to enable DHCP. Disables IP Address, Netmask and Gateway fields as
these settings are obtained from the DHCP server.
◦WARNING: A DHCP server must be present on your network for this to function properly. sing
DHCP allows for dynamic IP or fixed IP assignment from a central location (the DHCP server).
sing this option is only recommended if using fixed IP assignment based on the device's MAC
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 Panel 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). Another usage scenario would be to have 2 separate panels control
different levels of a Video/Audio 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.
•Level1 Override – 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 Audio).
•Level2 Override – 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Figure 3: Command 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 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
3 Mascot Control Protocol
MASCOT (MAtrix Switch COrporation ProTocol) 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.
3rd Party support
The MASCOT 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 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 2.4 (Carina Series Firmware 5.6.3)
•Added .MtxGroup, PanelDis, PanelExtEn, and Sierra commands.
Mascot version 2.3 (Carina Series Firmware 5.5.1)
•Added Quit Command, SysType Command and Vars Command which have previously been supported
on the MSC-GCP2 32 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.
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 “ nsupported 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) to MtxCfg Command “flags” field.
Page 15 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
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 for a device on the
IP address 192.168.2.60:
telnet 192.168.2.60 40
Press the Enter key which should display the command “>” prompt character, confirming that the device is
connected.
3.3 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.
Special command characters
# 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.
“ sed for double quoting string arguments.
' sed for single quoting string arguments.
Command example
X1,1#X2,2#S<CR>
Connects Source 1 to Destination1 and Source 2 to Destination 2, followed by displaying the Active Routing
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 insensitive. 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.
Page 16 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
3.3.2 Command arguments
Command arguments are separated into two categories: numeric and string arguments. These are further
explained in the table below:
Command argument types
Numeric String
Decimal (123) 1 to 3 decimal digits nquoted 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, A-F or a-f
Double quoted One or more characters surrounded
by double quotes (“An Argument”).
Single quoted One or more characters surrounded
by single quotes ('An Argument').
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 (ASCII 13 followed by
ASCII 10).
The Prompt ‘>’
A 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.
3.5 Command argument values
Command arguments are shown in the Help command output surrounded by square brackets '[ARG]' or
parenthesis '(ARG)'. Square brackets indicate an optional argument and parenthesis indicate a required
argument. Any optional argument specified requires that all prior optional arguments are also specified.
Argument Valid Range Meaning
DEST 1-N Destination number (N = Count of destinations)
SRC 1-N or 0 Source number (N = Count of sources), 0 acts as
mute (if supported).
Page 17 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
LEVEL 1-N Level number (N = Count of system levels)
PRESET 0-9 Preset number (preset 0 is special Startup preset)
IP D.D.D.D IP address string argument, specified as 4 decimal
digits from 0 to 255 separated by periods.
NETMASK D.D.D.D Network mask string argument, specified as 4
decimal digits from 0 to 255. Must be a valid
IPv4 netmask.
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 A string label argument, max of 8 characters.
STR string A generic string argument (max length depends
on the command).
3.6 Error codes
This following table shows possible error codes which may be returned in response to commands.
Error # Message Description
E01 Token too long A 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 nterminated 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 HTTP buffer overflow Only applicable to the web page command interface.
nlimited command input or output can be handled,
but not both.
E11 Serial receive overrun One or more characters were lost on the serial
interface.
E12 nsupported command Command is not supported by the system or current
configuration. Firmware 5.3.0 and newer.
3.7 Basic command reference
Basic commands consist of those commands which are used for modifying routing and other simple commands.
Mascot version where a command was added is indicated in parenthesis, (2.3) for example.
Page 18 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
Command Arguments Description
Help Display command help reference.
P * [PRESET] Recall a preset.
PAdd * (PRESET)(DEST)(SRC)
[LEVEL]
Add a connection to a preset.
PClr * (PRESET) Clear a preset to “No Change” values.
PSub * (PRESET)(DEST)
[LEVEL]
Subtract a connection from a preset.
PView * [PRESET] View preset contents.
Quit (2.3) Quit TCP/IP telnet session.
S * [1] Matrix routing status (supplying 1 will
display labels).
SysType (2.3) Query system hardware series.
Vars (2.3) Query all system configuration variables.
W * [PRESET] Store current matrix routing to a preset.
X * [DEST][SRC][LEVEL] Perform a matrix connect operation.
* Router systems and MSC-GCP2U32 LCD panel only
3.8 Advanced command reference
These additional commands consist of those which are not as commonly used as the basic commands, such as
system configuration commands.
Mascot protocol versions where a command was added is indicated in parenthesis, (2.3) for example.
Command Arguments Description
B (0 | 1) Reboot system into Bootloader, typically
used for software update. A 0 or 1 value is
required and selects the Bootloader IP
address. A value of 0 uses 192.168.2.59 and
1 uses configured system IP.
C * Query system matrix info, which is
displayed in the format
DESTS,SRCS,LEVELS,FLAGS1,FLAGS2.
MtxCfg command supersedes this
command
DestNames * [DEST][LEVEL]
[LABEL]
Query or assign destination names.
DHCP [0 | 1] Query or assign DHCP enable.
E * [0 | 1] Query or assign matrix connection echo
enable.
Firmware Query system firmware version.
FrameIP [IP] Remote router IP address the panel will
control.
Gateway [IP] Query or assign network gateway IP
address.
IP [IP] Query or assign device system IP address.
Page 19 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv

MSC-CP4X4E Product Manual
LockStatus + Get video lock status and rate detection
information (not all HD router systems are
supported).
MAC Query system MAC address
MascotVer Query Mascot protocol version.
MtxCfg * (2.0) [0-7] Query current matrix config.
MtxGroup + (2.4) [LVL1][LVL2] Query or assign I/O grouping.
NetMask [NETMASK] Query or assign network mask.
PairIO + (2.1) [0 | 1] Query or assign I/O pairing enable (3D
support). MtxGroup supersedes this
command
PanelDis (2.4) [0 | 1] Query or assign internal panel button
interface disable.
PanelExtEn (2.4) [0 | 1] Query or assign external panel interface
enable (if available).
PanelOfs (2.1) [DEST][SRC]
[LVL1][LVL2]
Query or assign button panel
destination/source offsets and levels to
control. seful for configuring multiple
panels to control different I/O regions of a
router.
PanelRate (2.1) [RATE] Set remote panel refresh rate in seconds.
PsetNames * [PRESET][LABEL] Query or assign preset names.
Reboot Reboot the system.
ReclkDis + (2.1) [0 | 1] Disable SDI reclockers (not all SDI router
systems are supported).
RemoteSync + (2.1) [0 | 1] Query or assign remote router syncing.
seful for creating a 3D system out of 2
routers.
Sierra + (2.4) [0 | 1] Query or assign Sierra Video Systems
protocol enable on serial port interface.
SrcNames * [SRC][LEVEL]
[LABEL]
Query or assign source names.
SysName [STR] Query or assign system name.
WebPass (STR) Assign web password.
* Router systems and MSC-GCP2U32 LCD panel only
+ Router systems only
3.9 B Command
The B command is used for rebooting the system into Bootloader for software updates. See the Software
pdate section for details.
3.10 C Command
Routers and MSC-GCP2U32 only
NOTE: Superseded by the MtxCfg Command.
Page 20 of 48 Copyright © 2013-2015 Matrix Switch Corporation www matrix-switch tv