The MuxLab HDMI 4x8 Matrix Switch, HDBT, PoE (500418-POE) allows 4 HDMI
sources to be switched/distributed to up to 8 remote displays via unshielded twisted
pair (UTP) or shielded twisted pair (STP) cables for cost-efficient connectivity.
Remote displays can be connected up to 230 feet (70 meters) @ 1080p Deep Color via
Cat 5e/6 UTP/STP cables. The Matrix Switch works in conjunction with MuxLab’s
HDMI Receiver (500454-RX or 500454-POE-RX).
Figure 1: System Overview
Applications include commercial and residential AV systems, classroom projector
systems, digital signage, boardroom systems, multi-room systems, classroom training,
retail systems, collaborative PC systems, and medical information systems.
Single modular RJ45 jacks
UTP/STP extension for 1080p Deep Color up to 230 feet (70 meters) via Cat 5e/6
UTP/STP cables
HDMI 3D support
Seamless integration with MuxLab’s HDMI Receiver (500454-RX or 500454-POE-
RX)
HDMI input supported with resolution up to 1080p
HDBaseT supported output
Configurable EDID settings
Web interface
RS232 and USB CDC control
Firmware is field upgradable
Touch pad on front panel for manual control
Device control over HTTP protocol
2U rackmount unit
The external connections and connection indicators of the HDMI 4x8 Matrix Switch,
HDBT, PoE are detailed in Figure 2 and Figure 3. Please familiarize yourself with
them before installing the unit.
Figure 2: Front Panel
A1 = Control Buttons
A2 = LED Display
A3 = Numeric Keypad
A4 = Navigational Arrows
The HDMI 4x8 Matrix Switch, HDBT, PoE provides a centralized HDMI switching
center via UTP/STP cables.
1. The Matrix Switch is used in conjunction with MuxLab’s UTP/STP HDMI
Receivers (500454-RX or 500454-POE-RX).
2. The Matrix Switch is typically installed in a remote telecom room and is connected
to multiple video sources and display devices via Cat 5e/6 UTP/STP or HDMI
cables. A MuxLab Receiver is installed at each display to support the connection
to the Matrix Switch via a Cat 5e/6 cable.
MuxLab’s HDMI 4x8 Matrix Switch, HDBT, PoE comes with mounting brackets for
standard 19” rack mounting. Select the final destination for the product and install the
unit using standard rack-mount screws (Figure 6).
Figure 6: Setup for Rackmount Installation
For set-top installation, the side mounting brackets may be removed, and the included
rubber feet placed on the bottom of the unit. When removing the mounting brackets,
be careful to keep and reinstall the screws on each side of the unit (Figure 7).
The HDMI 4x8 Matrix Switch, HDBT, PoE may be controlled manually by using the
controls located on the front panel.
Navigating the manual control menu is performed by using the ‘Info’, ‘Menu’, and
‘Switch’ buttons located on the front panel, just below the display, as well as the
numeric keypad and arrows located to the right of the display. (NOTE: The ‘Cancel’
button on the numeric keypad also returns the user to the previous screen.)
Figure 10 illustrates the navigational layout of the manual control menu. Specific
menu screens (depicted by boxes) are described on the following pages.
Startup
The Startup screen is the first screen to appear once the Multimedia 4x8 Matrix Switch
is powered up. It displays the MuxLab logo and product name.
Information
The information screen is reached by pressing the Info button. It displays the name of
the device at top, followed by the IP and Mac addresses, device status, and firmware
version.
Main Menu
The Main Menu screen is reached by pressing the Menu button. It contains four
options:
• Switch
• Presets
• Diagnostics
• Settings
By default, the Switch option is highlighted when the Main Menu screen first displays.
NOTE: If password protection is on, pressing the Menu button from the Startup or
Information screens will prompt the Password screen to appear. The user must then
enter the correct password in order to reach the Main Menu screen.
Switch
The Switch screen by either pressing the Switch button, or by highlighting the Switch
entry in the Main Menu screen and pressing the Enter/Save button on the numeric
keypad.
The Switch screen contains four options:
• Connect a source to a display by number
• Connect a source to a display by name
• Connect all displays to a source
• Disconnect all displays from a source
By default, the top-most option is highlighted when the Switch screen first displays.
NOTE: If password protection is on, pressing the Switch button from the Startup or
Information screens will prompt the Password screen to appear. The user must then
enter the correct password in order to reach the Switch screen.
The Presets screen allows the user to select and apply a pre-existing preset (specific
mapping of connections between sources and displays), or to save existing
connections as a preset.
Diagnostic
The Diagnostic screen displays four operating conditions:
• Internal device temperature
• Voltage status
• Fans status
• Existence of alerts
Settings
The Settings screen allows the user to choose which category of settings to change:
The Password screen allows the user to set password protection on the system to ON
or OFF, as well as to change the password (numeric characters only).
RS232
The RS232 screen allows the user to modify the baud rate, data bits, stop bit, and
parity settings of the device.
Connect Source to Displays
The Connect Source to Displays screen allows the user to select which source to
connect to which displays(s). The user selects the source and displays by their
designated number.
The Connect Source by Name screen allows the user to select which display(s) to
connect to which source(s). The user selects displays and sources by their designated
name.
Connect All Displays to…
The Connect All Displays to… screen allows the user to connect all displays to a
given source. The user simply selects the source, which is displayed both by number
and name.
Disconnect All Displays from…
The Disconnect All Displays from… screen allows the user to disconnect all displays
from a given source. The user simply selects the source, which is displayed both by
number and name
The Matrix Switch can be controlled by a remote (Figure 11). The remote is divided
into eight sections (1 through 8), each of which controls the corresponding display.
The ◄ and ► buttons associated with each section allow the user to control which
input (1 through 4) is fed to a given display.
The System Code Switch at the bottom of the remote allows the user to change the
system code. Pressing it three times in one second changes the system code from 0x00
to 0x4E, or from 0x4E to 0x00.
Figure 11: Remote
To use the remote, the user must physically aim it at the front panel of the Matrix
Switch, which contains an IR sensor to receive line-of-sight signals from the remote.
An optional IR extender cable (500999) can be connected to the IR Ext port on the rear
panel of the Matrix Switch. The free end of the IR extender cable contains an IR
sensor that can be placed up to 117 centimeters (46 inches) from the Matrix Switch,
offering greater flexibility in using the remote.
The remote can also control the Matrix Switch at display locations via MuxLab
receivers. To do this, the user aims the remote at the receiver’s IR sensor and sends
command signals to the Matrix Switch. The receiver then transmits these signals to the
Matrix Switch via the UTP/STP cables connecting the receiver to the Matrix Switch.
A source can also be selected directly by pressing the down arrow located at position
1, 2, 3, or 4.
Sources and displays do not have to be controlled at their physical location. Using
MuxLab receivers, each source and display can be controlled at different locations
using their respective remotes.
Using source remotes, sources can be controlled at display locations via receivers (see
Figure 8). To do so, make sure that the IR emitter cable leading from the IR Emitters
port 1 on the back of the Matrix Switch has its emitter end placed in front of IR sensor
on source 1. Do the same for all ports and all sources (see Table 3).
Table 3: Source Remote Control Configuration
Using display remotes, displays can be controlled at the Matrix Switch location via
receivers (see Figure 9). To do so, make sure that the remote of display 1 is directed at
the sensor end of the IR sensor cable leading from the IR Sensors port 1 on the back of
the Matrix Switch. Do the same for all ports and display remotes (see Table 4).
Variable EDID: Relays EDID of display to selected source1
OFF
OFF
ON
OFF
Fixed EDID: 1080p 3D stereo2
OFF
ON
OFF
OFF
Fixed EDID: 1080p stereo2
OFF
ON
ON
OFF
Fixed EDID: 1080i stereo2
ON
OFF
OFF
OFF
Fixed EDID: 1080p 5.12
ON
OFF
ON
OFF
Fixed EDID: 1080P 7.12
ON
ON
OFF
OFF
[Reserved]
ON
ON
ON
OFF
[Reserved]
EDID and DIP Switch Settings
Every digital display has extended display identification data (EDID) that describes its
capabilities to a video source. This enables the source to know which type of display is
connected to it, and to send compatible signals to that display.
The EDID settings of any display can be relayed to any source by means of a DIP
switch located on the back panel of the Matrix Switch (Figure 12). The DIP switch has
three contacts (1, 2, 3, 4), each of which can either be set up (OFF) or down (ON).
Various DIP switch settings enable the user to relay any display’s EDID to any source.
Table 5 shows 8 pre-defined DIP switch settings and the function of each.
Notes:
1. To relay the EDID of display x to source y, the user can use the console terminal or
Web Interface.
2. Selected fixed EDID will be active only after a power cycle of the Matrix Switch.
MuxLab’s HDMI 4x8 Matrix Switch, HDBT PoE may be controlled in any one of two
ways:
1. RS-232 Control
2. USB CDC Control
1. RS-232 Control
The HDMI 4x8 Matrix Switch, HDBT PoE features built-in firmware that allows
commands from an ASCII terminal to be sent directly to the device via an RS-232
connection. Ensure that the RS-232 cable has the straight-through configuration shown
in Figure 13.
Please note that the use of USB to RS232 converter cables may result in problems,
depending on the quality of the converters.
2. USB CDC Control
Commands from an ASCII terminal may also be sent directly to the device via a USB
connection. Maintenance can be performed with a terminal emulator, such as the one
available under windows with the ASCII Command set described in the Appendix of
this manual.
When interfacing a MuxLab device with the USB port on Windows XP, Windows 7,
or Windows 8 operating systems, a driver setup file will be required. For Linux and
Mac OS X operating systems, no driver is necessary.
To install the USB serial driver, download the SC-000032-A USB to serial driver file
from the MuxLab website and save it to the local hard drive. NOTE: If the
downloaded file is compressed, it will have to be uncompressed before using it.
Plug the USB cable between the device and the PC, and power up the device. The
Found New Hardware wizard will open (Figure 14). Select Locate and install
driver software (recommended).
A new dialog box will open (Figure 15). Select Browse my computer for driver
software (advanced).
Another dialog box will open (Figure 16). Click Browse and locate the SC-000032-A
USB to serial driver file downloaded earlier. Once found, click Next.
MuxLab offers users an Ethernet Web interface that provides the same functionality as
manual control, with speeds of 10 Mbps or 100 Mbps.
To use the Ethernet Web interface, the Matrix Switch must first be physically connected
to an Ethernet network. To do this, locate the RJ45 Ethernet jack on the back panel of the
Matrix Switch, then connect it to an Ethernet network using a straight UTP cable
(maximum length: 328 feet [100 meters]). There are two LEDs at the top of the RJ45
Ethernet jack: A green LED will go on if a link is detected, and a yellow LED will blink if
Ethernet activity is detected.
Once the Matrix Switch has been physically connected to an Ethernet network, go to
http://AAA.BBB.CCC.DDD, where AAA.BBB.CCC.DDD is the device IP address.
(NOTE: The device IP address can be obtained by pressing the Info button on the front
panel.)
The Login screen is the first screen to appear (Figure 19).
Figure 19: Ethernet Web Interface Login Screen
The default password for administrators is admin. The default password for regular
users is user.
NOTE: Users who have previously logged in and chosen a password, but have
subsequently forgotten it, may connect to the device using the RS232 or USB and
reset their password using a terminal emulator.
Three items are presented to the user at the top right of every Ethernet Web interface
screen:
The Logout hyperlink logs the user out of the system.
The Language drop-down list provides the user with three interface languages:
English, French, and Spanish. English is used by default.
The Product status indicator provides a quick indication of device status by means of
a colored box (green, orange, red) to indicate various product statuses:
• Green = Okay
• Orange = Warning
• Red = Error
The user can configure the Product status indicator to display different statuses
depending on various device conditions (internal temperature, fan speed, etc.). This
configuration is performed in the Alarm tab of the Setup submenu.
After logging in, the main screen appears (Figure 20). It contains three submenus:
(1) Port Management
(2) Setup
(3) Help
(1) Port Management
The Port Management submenu (Figure 20) appears after the user has successfully
logged in.
Figure 20: Port Management Submenu
The Port Management submenu manages the connection configurations of displays
and sources.
A connection configuration is a specific set of mapping instructions between all
displays and devices. A saved connection configuration is known as a preset.
The Port Management submenu allows the user to make individual connections
between specific displays and sources, or wholesale connections between all displays
and sources by means of presets. Sources and displays are presented to the user in any
one of four ways:
• By source name
• By source number
• By display name
• By display number
Figure 19 illustrates sources and displays presented by display number. The user can
make changes to the connection configuration of the device by selecting any option in
the drop-down boxes in the Source column. Once any change is made, the given row
will change color to indicate that a change has taken place. Once all selections have
been made, the user clicks on the Connect button to apply those selections.
Presets are pre-established connection configurations that are used to apply wholesale
mapping instructions between all displays and sources (see Figure 21). The user can
load any one of eight presets to the device. Once a preset is selected from the Preset
drop-down menu, the user clicks on Load Preset to show the connection
configuration of the given preset. To apply the preset, the user clicks on Make Connections.
To modify a given preset, its name must first appear in the Preset drop-down menu.
The user then makes changes to the connections between displays and sources (any
change will result in a highlighted row). Once all changes are made, the user clicks on
Save Preset. This effectively modifies the connection configuration of the given
preset.
The Setup submenu (Figure 22) is used to perform the following tasks:
• Modify port names
• Modify present names
• Modify network connections and passwords
• Modify RS232 connections
• Modify alarm settings
• Upgrade firmware
In the Port Names tab, the user can modify port names in the Display Names and
Source Names columns, and then click on Save to save these modifications. The user
can also modify the name of the entire device by changing the text that appears in the
Unit Name box and clicking on Save.
The length of all names is limited to 20 characters each.
In the Preset Names tab (Figure 23), the user can modify the names of presets.
Figure 23: Setup Submenu – Preset Names Tab
After preset names are modified, the user clicks on Save to save these modifications.
The length of preset names is limited to 20 characters each.
In the Network tab (Figure 24), the user can modify network settings and passwords
for users and (if applicable) administrators.
Figure 24: Setup Submenu – Network Tab
To implement network modifications, the user makes changes to the IP address,
Network mask, or Router fields and then clicks on Save. The user also has the option
To implement password modifications, an administrator makes changes to the
Administrator Password and/or the User Password, and then clicks on the
corresponding Save button. Regular users can only make changes to the User Password.
In the RS-232 tab (Figure 25), the user can modify RS-232 settings.
To implement RS-232 modifications, the user selects options in the drop-down boxes
for Baud rate, Data bits, Parity bits, or Stop bits and then clicks on Save.
In the Alarms tab (Figure 26), the user can modify the settings that dictate when an
alarm will be triggered.
Minimum and maximum temperatures are in degrees Celsius (°C).
Fan rotation is in revolutions per minute (RPMs).
Once all modifications have been made, the user clicks on Save.
In the Administration tab (Figure 27), the user can modify passwords for users and (if
applicable) administrators, select and install new firmware, restore or backup data and
reset the unit to factory settings.
Figure 27: Setup Submenu – Administration Tab
To implement password modifications, an administrator makes changes to the
Administrator Password and/or the User Password, and then clicks on the
corresponding Save button. Regular users can only make changes to the User Password.
The file for upgrading the firmware must be located on the PC. The user clicks on
Choose File to browse for the file, and then installs it by clicking on Upload.
It is recommended, before upgrading to a new firmware to do a Backup of all the data
configurations, such as port names, presets, alarms, network settings etc. And then
Restore these data after the firmware upgrade.
To do so, click on the “Backup” button and you will be asked to save the data
configuration file. Then perform the firmware upgrade. After the unit is upgraded, go
to the Administration tab, in the “Restore data” section, select the data configuration
file previously saved on you PC, then click on the “Restore” button.
Finally, you can reset the unit and apply all the factory settings by clicking on the
“Reset” button.
In the EDID tab (Figure 28), the user can apply pre-defined EDID settings to all input
sources or apply EDID setting from any display to a given source.
Figure 28: Setup Submenu – EDID Tab
(3) Help
The Help submenu (Figure 29) provides the user with contact and support
information.
Figure 29: Help Submenu
In addition to three submenu screens, the Ethernet web interface also provides the user
with a detailed Hardware Monitor screen (Figure 30).
Verify that the source resolution is 1080p or less.
No Image
Verify that the display supports HDCP.
White Dots in image
Flickering Image
Choppy Sound
If using an extender, verify that the distance is less than 230 feet
(70 meters) for UTP/STP.
Wrong Image Appears
Check matrix connection
Not All Display
Devices Work
Check that the display supports the source resolution.
Troubleshooting
Table 6 lists common problems that affect image quality, as well as their possible causes and
solutions. If the information below does not solve the problem, the technical support contact
information can be found at the end of this section.
Table 6: Troubleshooting
When contacting your nearest MuxLab dealer or MuxLab Technical Support at 877-689-5228
(toll free in North America) or (+1) 514-905-0588 (International), please have the following
information ready:
Unit model number.
Cabling layout. Please include the model of the HDMI source and receiver, cable length
and type.
Description of problem.
List of tests performed.
It should be noted that commands are case sensitive and arguments must be separated
by a single space. Commands must be entered in the following way and ended with a
carriage return:
Description: Display all the alarm settings
Arguments: <none>
Example: alarm
Response: Minimum Fan RPMs:
- Fan 1: 100
- Fan 2: 100
Device Temperatures (Celsius):
- Temp min: 0
- Temp max: 70
Notification Method:
- Beep: ON
- Serial Port: ON
- Email: OFF
(or an error message if the command failed)
alarm -f <fan # or all><RPM value>
Description: Set the minimum RPM value for a fan(s) before an alarm is raised
Arguments: <fan # or all>: 1, 2 or all
<RPM value>: 0 to 4999
Example: Set the minimum RPM to 150 for all fans before an alarm is raised
alarm –f all 150
Response: Minimum RPM value(s) for fan(s) applied successfully!
(or an error message if the command failed)
alarm -t <min value><max value>
Description: Set the minimum and maximum temperatures value before an alarm is raised
Arguments: <min vallue>: 0 to 150
<max value>: 0 to 150
Example:Set the minimum and maximum temperature to respectively 5 and 70 degree Celsius, before an
alarm is raised
alarm –t 5 70
Response: Minimum and Maximum temperatures applied successfully!
(or an error message if the command failed)
alarm -n <method id><state>
Description: Enable/disable a notification method.
Arguments: <method id>: b (beep), s (serial) or all
<state>: on or off
Example: Disable the beep notification method
alarm –n b off
Response: Alarm notifications applied successfully!
Description: Connect a specific input to all outputs
Arguments: <input port #>: 1 to 4
Example: Connect input 2 to all outputs
connect -i 2 -o all
Response: [2,2,2,2,2,2,2,2]
(or an error message if the command failed)
connect -i <input port #> -o <from output port #>..<to output port #>
Description: Connect a specific input to a consecutive range of outputs
Arguments: <input port #>: 1 to 4
<from output port #>: 1 to 8
<to output port #>: 1 to 8
<from output port #> shall be inferior or equal to <to output port #>
Example: Connect input 2 to outputs 1, 2, and 3
connect -i 2 -o 1..3
Response: [2,2,2,0,0,0,0,0]
(or an error message if the command failed)
connect -json “[<input port #1>,<input port #2>,…, <output port #8>]”
Description: Make 8 connections/disconnections in one command using json format
Arguments: <input port #>: 1 to 4 to specify the input port to connect to, or 0 to disconnect it
Example: Connect input 2 to outputs 1, 2, and connect input 3 to outputs 4 , and disconnect all other
Description: Copy EDID from the specified output port to all input ports
Arguments: <output port #>: 1 to 8
Example: Copy EDID from the output port # 2 to all input ports
edidcopy –o 2
Response: EDID:[“input all”,”output 2”]
5. Get
get -i <input port #>
Description: Get the connection state of a specific input port
Arguments: <input port #>: 1 to 4
Example: Get connection state of input port 2
get -i 2
Response: Input 02 connected to: 01
(or an error message if the command failed)
get -i
Description: Get the connection state of all input ports
Arguments: <none>
Example: Get connection state of all input ports
get -i
Response: Input 01 connected to: none Input 02 connected to: 01 Input 03 connected to: none …{and so on}
(or an error message if the command failed)
get -json
Description: Get all the output connection states in json format
Arguments: <none>
Example: Get all output connections states in json format.
get -json
Response: [3,7,0,0,0,0,0,0]
(or an error message if the command failed)
get -o <output port #>
Description: Get the connection state of a specific output port
Arguments: <output port #>: 1 to 8
Example: Get connection state of output port 4
get -o 4
Response: Output 04 connected to: 1
Description: Get the connection state of all output ports
Arguments: <none>
Example: Get connection state of all output ports
get -o
Response: Output 01 connected to: 03 Output 02 connected to: 04 Output 03 connected to: none …{and so on}
(or an error message if the command failed)
6. Help
help or ?
Description: Display all the command list definition available
Arguments: <none>
Example: Display all the command list
help ?
Response: connect
connect –i <input port #> -o <output port #> {Connect 1 input port to 1 output port}
connect -i <input port #> -o all {Connect 1 input port to all output port}
connect -i <input port #> -o <from output port #>..<to output port #> {Connect 1 input port
to a specific range of output port}
disconnect
disconnect -i <input port #> {Disconnect 1 input port}
disconnect -o <output port #> {Disconnect 1 output port}
disconnect -all {Disconnect all input/output port}
… {and so on}
version
version <no parameters> {Get the current firmware version}
Description: Set a name for the selected input port
Arguments: <input port #>: 1 to 4
<name>: up to 20 characters
Example: Set name “My DVD Player” for input port 4
name -i 4 “My DVD Player”
Response: Input Names:[“Input 1”,”Input 2”,”Input 3”,“My DVD Player”]
(or an error message if the command failed)
name -i
Description: Get a list of all the input port names
Arguments: <none>
Example: Get list of all input port names
name -i
Response: Input Names:[“Input 1”,”Input 2”,”Input 3”,“My DVD Player”]
(or an error message if the command failed)
name -o <output port #> “<name>”
Description: Set a name for the selected output port
Arguments: <output port #>: 1 to 8
<name>: up to 20 characters
Example: Set the name “Kitchen TV” for output port 4name -o 4 “Kitchen TV”
Response: Output Names:[“Output 1”,“Output 2”,“Output 3”,“Kitchen TV” ”,“Output 5”,
“Output 6”,“Output 7”,“Output 8”]
(or an error message if the command failed)
name -o
Description: Get a list of all the output port names
Arguments: <none>
Example: Get list of all output port names
name -o
Response: Output Names:[“Output 1”,“Output 2”,“Output 3”,“Kitchen TV” ”,“Output 5”,
“Output 6”,“Output 7”,“Output 8”]
(or an error message if the command failed)
name -preset <preset #> “<name>”
Description: Set a name for the selected preset number
Arguments: <preset #>: 1 to 8
<name>: up to 20 characters
Example: Set name “Week-end” for preset 7 name -preset 7 “Week-end”
Response: Preset Names:[“Preset 1”,“Preset 2”,“Preset 3”,“Preset 4”,“Preset 5”, “Preset 6”,“Week-end”,“Preset 8”]
Description: Enable/disable DHCP feature
Arguments: <dhcp state>: on or off
Example: Enable the DHCP feature
Network –dhcp on
Response: IP: 10.0.1.101
MASK: 255.255.0.0 GATEWAY: 10.101.1.5 DHCP: ON (or an error message if the command failed)
9. Password
password -wadmin <web admin password>
Description: Set the web server 'Admin' password
Arguments: <web admin password>: alphanumeric (max. length 20)
Example: Change the web admin password to new123
password -wadmin new123
Response: Web server Admin password set successfully
(or an error message if the command failed)
password -wuser <web user password>
Description: Set the web server 'User' password
Arguments: <web user password>: alphanumeric (max. length 20)
Example: Change the web user password to new123
password -wuser new123
Response: Web server User password set successfully
(or an error message if the command failed)
10. Preset
preset -s <preset #>
Description: Save the current connection in the selected preset
Arguments: <preset #>: 1 to 8
Example: Save current connection in preset 5
This section is provided for informational purposes only, and should only be used by
software developers with a thorough understanding of the HTTP and JSON
specifications.
2. Introduction
The Matrix Switch can be controlled using basic IP commands. These commands are
based on the JSON format and are sent and received in standard TCP/IP packets. To
learn more about JSON, visit http://www.json.org.
Only four types of JSON arrays are used to control the product:
Array of a single integer: [2]
Array of multiple integers: [1,2,3,4,5,6,7,8]
Array of a single string: [“A Name”]
Array of multiple strings: [“Name 1”, “Name 2”, “Name 3”, “Name 4”]
Any other notation is not permitted. Also, “null” values are not permitted. Use 0
instead.
3. Basic Usage
All read and write operations are performed via HTTP GET and HTTP POST
commands, respectively. While you can perform a GET at any time, a POST
command will require prior authentication.
4. Basic Authentication
Authentication is performed in two simple steps:
1. Obtain a Session ID
Perform a GET request on /var/session.json to obtain a new session ID. The return value
will be a JSON array of a single integer, for example [12345]. From then on, simply
append the session to any new IP requests to use this session, e.g., GET
/var/conn.json?sid=12345
2. Obtain Credentials for that Session ID
There are three permission levels that can be used to read/modify properties. These are:
0 – Guest: Can read all values. Cannot write or make changes.
1 – User: Same as Guest, but can change matrix video connections.
2 – Admin: Can perform any command without restriction.
To obtain credentials, you will need to POST an array of two strings to /var/auth.json: the
userlevel, and the password associated to that user. For example:
Array of 8 integers.
Contains 8 items for the 8 displays. Each number is the source connected to the associated display. 0 means a display
is disconnected. In the example below, Display 1 is disconnected, Display 2 is connected to Source 3, etc.
Example: [0,3,2,4,2,3,1,3]
Array of 8 integers.
Provide the connections state of the corresponding preset.
Contains 8 items for the 8 displays. Each number is the source connected to the associated display. 0 means a display
is disconnected. In the example below, Display 1 is disconnected; Display 2 is connected to Source 3, etc.
Example: [0,3,2,4,2,3,1,3]
/var/boxname.json
Array of a single string.
Contains the name of the box.
Example: [“Classroom B Matrix”]
/var/sources.json
Array of 4 strings.
Contains the names of all 4 input ports.
Example: [“Cable Box”, “Satellite Receiver”, “Demo Reel”, …]
/var/displays.json
Array of 8 strings.
Contains the names of all 4 output ports.
Example: [“Conference Room”, “Cafeteria”, …]
/var/presetnames.json
Array of 8 strings.
Contains the names of all 8 presets
Example: [“Preset 1”, “Preset 2”, “week end”, …]
/var/dhcp.json
Array of a single integer.
Indicate if dhcp is ON ([1]) or OFF ([0])
Example: [1]
/var/tempalarms.json
Array of 2 integers.
Contains the Min. and Max. temperature of the unit before an alarm is raised
Example: [5,70]
/var/auth.json
Array of a single integer.
Contains an integer representing the current user level, from 0 to 2.
Example: [2]
/var/session.json
Array of a single integer.
Represents a new session ID
Example: [3847534]
/var/logout.json
None.
Destroys current session.
/var/mon_temp.json
Array of a single integer.
Contains an integer representing the temperature inside the matrix, in degrees Celsius.
Example: [26]
/var/mon_status.json
Array of a single integer.
Represents the matrix status. 0 => Ok; 1 => fault; 2 => critical
Example: [1]
/var/mon_voltages.json
Array of a single integer.
Represents the voltage status. 1 => Ok; 0 => fault
Example: [1]
/var/serial.json
Array of 4 integers.
Contains the current serial port settings: baud rate, data bits(7 or 8), parity (0=>Even; 1=>Odd; 4=>None) ,stop bits
(0=>1 stop bit; 2=>2 stop bits)
Example: [9600,8,4,0]
/var/ip.json
Array of 4 integers.
Contains the saved IP address (Not the current IP address being used)
Example: [10,0,101,96]
/var/netmask.json
Array of 4 integers.
Contains the saved mask address (Not the current mask address being used)
Example: [255,255,0,0]
/var/router.json
Array of 4 integers.
Contains the saved gateway address (Not the current one being used)
Example: [10,0,1,1]
/var/alarmflags.json
Array of 8 integers.
Contains the alarm configuration: beep, email, serial feedback, (the last 5 integer are not used)
Example: [1,0,1,0,0,0,0,0]
/var/fwVersion.json
Array of 2 strings.
Contains master firmware version
Example: [“1.0.0”, “0”]
Array of connections for a preset
(Same as GET above)
Example: [0,1,2,3,2,1,3,4]
/var/boxname.json
Array of a single string.
Contains the name of the box, limited to 20 characters
Example: [“Classroom B Matrix”]
/var/sources.json
Array of 4 strings.
Contains the names of all 4 input ports.
Example: [“Cable Box”, “Satellite Receiver”, “Demo Reel”, …]
/var/displays.json
Array of 8 strings.
Contains the names of all 4 output ports.
Example: [“Conference Room”, “Cafeteria”, …]
/var/presetnames.json
Array of 8 strings.
Contains the names of all 8 presets to be set
Example: [“Preset 1”, “Preset 2”, “week end”, …]
/var/auth.json
Array of 2 strings.
Contains a single digit string representing the user level requested, and a second string representing the password.
Example: [“2”, “myAdminPassword”]
/var/serial.json
Array of 4 integers.
Set the following serial port settings: baud rate, data bits(7 or 8), parity (0=>Even; 1=>Odd; 4=>None) ,stop bits
(0=>1 stop bit; 2=>2 stop bits)
Example: [9600,8,4,0]
/var/ip.json
Array of 4 integers.
Set the IP address
Example: [10,0,101,96]
WARNING! This request will actually take effect after the DHCP request will be sent
/var/netmask.json
Array of 4 integers.
Set the mask address
Example: [255,255,0,0]
WARNING! This request will actually take effect after the DHCP request will be sent
/var/router.json
Array of 4 integers.
Set the gateway address
Example: [10,0,1,1]
WARNING! This request will actually take effect after the DHCP request will be sent
/var/dhcp.json
Array of a single integer.
Set the DHCP state ON ([1]) or OFF ([0])
Example: [1]
/var/tempalarms.json
Array of 2 integers.
Set the Min. and Max. temperature of the unit before an alarm is raised
Example: [5,70]
/var/alarmflags.json
Array of 8 integers.
Set the alarm configuration: beep, email, serial feedback, (the last 5 integer are not used)
Example: [1,0,1,0,0,0,0,0]
var/pass_admin.json
Array of 2 strings.
Set the web administrator password
Hexadecimal data string to send in the request formatted as follow:
Example: [“03060A010203040506070809A0”]
03 is the port number (here it is port # 3)
06 is the baud rate code:
For 9600 the code is 06
For 19200 the code is 08
For 38400 the code is 09
For 57600 the code is 0B
For 115200 the code is 0C
0A is the data length that follows (max value 0x28 bytes.)
01A203040506070809A0 is the data in hexadecimal (0x01, 0xA2, 0x03,…)
6. POST Commands
POST commands will always return 1 of 5 HTTP headers:
HTTP 201Created Command was successful
HTTP 400 Bad Request Received argument was malformed
HTTP 403 Forbidden User does not have sufficient privileges
HTTP 404 Not Found URL is incorrect
HTTP 501 Not Implemented URL does not support receiving POST data
The response will be the data (in hexadecimal) returned if any:
[“A105……450C”]
var/edidcopy_p.json
Array of a single integer.
Copy the specified predefined EDID values to all input ports.
The different code value are:
1 : 1080p3D
2 : 1080p
3 : 1080i
4 : 1080p 5.1
5 : 1080p 7.1
Example to apply the predefined EDID “1080i”: [3]
var/edidcopy_o.json
Array of 4 integers.
Contains 4 items for the 4 sources.
Each number is the output port (display) number that you want to copy the EDID from and copy it to the associated
source. 0 means do nothing. In the example below, the EDID from the Display 2 will be copied to the source 3 and he
EDID from the Display 4 will be copied to the source 1
Example: [4,0,2,0]
var/pass_user.json
Array of 2 strings.
Set the web user password
Example: [“old admin password”, “new user password”]
MuxLab guarantees its products to be free of defects in manufacturing and workmanship for the warranty period from the date of purchase. If this
product fails to give satisfactory performance during this warranty period, MuxLab will either repair or replace this product at no additional
charge, except as set forth below. Repair and replacement parts will be furnished on an exchange basis and will be either reconditioned or new.
All replaced parts and products become the property of MuxLab. This limited warranty does not include repair services for damage to the product
resulting from accident, disaster, misuse, abuse, or unauthorized modifications or normal decay of battery driven devices. Batteries, if included
with the product, are not covered under this warranty.
Limited warranty service can be obtained by delivering the product during the warranty period to the authorized MuxLab dealer from whom you
purchased the product, or by sending it to MuxLab. MuxLab will not accept any such product for repair without a Return Material Authorization
number (RMA#) issued by its Customer Service Department and a proof of purchase date. If this product is delivered to MuxLab by mail, you
agree to assume risk of loss or damage in transit, to prepay shipping charges to the warranty service location, and to use the original shipping
container or equivalent.
THE ABOVE LIMITED WARRANTY IS THE ONLY WARRANTY COVERING YOUR MUXLAB PRODUCT. THERE ARE NO OTHER
WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. SOME STATES DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES, SO THE ABOVE LIMITATION MAY NOT
APPLY TO YOU.
IF THIS PRODUCT IS NOT IN GOOD WORKING ORDER, YOUR SOLE REMEDY SHALL BE REPAIR OR REPLACEMENT AS
PROVIDED FOR ABOVE. IN NO EVENT SHALL MuxLab BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOSS OF
PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR
INABILITY TO USE THIS PRODUCT, EVEN IF MUXLAB OR AN AUTHORIZED MuxLab DEALER HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES; NOR WILL MUXLAB BE LIABLE FOR ANY CLAIM BY ANY OTHER PARTY. SOME STATES
DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR CONSUMER
PRODUCTS, SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU
SPECIFIC LEGAL RIGHTS. YOU MAY ALSO HAVE OTHER RIGHTS WHICH MAY VARY FROM STATE TO STATE.
Any product found to be defective within three (3) months of invoice, including one (1) month shelf life, may be returned for replacement by a
new unit or a satisfactory repair within one (1) month of receiving any returned product. The customer must provide MuxLab with the serial
number and proof of purchase of the defective unit being returned. All R.M.A.’s issued are subject to inspection by MuxLab, and will be returned
to customer if not properly package – units must be returned in original container or equivalent. MuxLab will not accept any such product for
repair without an authorization for its Technical Support department and without a return authorization number issued by MuxLab Customer
Service department. For credit & replace R.M.A., customer will be liable to pay replacement invoice if defective products are not returned.
Product more than six months old, including shelf life.
The defective unit must be returned prepaid to MuxLab and then the unit will be repaired or if repair is not possible, replaced by an equivalent
unit and returned to the customer within one (1) month of receiving any returned product. There is no charge for repair (parts and labor) during
the full warranty period.
Items Defective and not under Warranty
For products which are no longer under warranty the policy is repair and return. An amount of 25% of the products published list price at the
time of purchase will be charged. Customer must issue a purchase order to cover the cost of repair.
Each unit will be returned to the customer within one (1) month from receipt of the unit by MuxLab. The defective unit must be returned prepaid
to MuxLab. The repaired unit will be returned to the customer FOB MuxLab. The repaired unit has a 90 day warranty.
MuxLab Inc.
8495 Dalton Road
Mount Royal, Quebec
Canada H4T 1V5
Tel.: +1 (514) 905-0588 Fax: +1 (514) 905-0589
Toll Free (North America): 877 689-5228
URL: www.muxlab.com
E-mail: videoease@muxlab.com
Page 62
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.