Table of Contents

Advertisement

Quick Links

User's Manual
MMX2-4x3-H20
MMX2-4x1-H20
Multimedia Matrix Switcher
v1.0
23-02-2022

Advertisement

Table of Contents

Troubleshooting

loading

Summary of Contents for Lightware MMX2 Series

  • Page 1 User’s Manual MMX2-4x3-H20 MMX2-4x1-H20 Multimedia Matrix Switcher   v1.0 23-02-2022...
  • Page 2     MMX2 series – User's Manual Important Safety Instructions Waste Electrical & Electronic Equipment Common Safety Symbols WEEE Class II apparatus construction. Symbol Description This marking shown on the product or its literature, The equipment should be operated only from the power source indicates that it should not be disposed with other indicated on the product.
  • Page 3 The following symbols and markings are used in the document: All presented functions refer to the indicated products. The descriptions Lightware Visual Engineering supports green technologies and eco- have been made while testing these functions in accordance with the friendly mentality. Thus, this document is made for primarily digital...
  • Page 4: Table Of Contents

    4.8.1. Serial Port Diagram ................. 25 6.3.3. Legend for the Control Commands ..........47 1.3. Features of the Device ..............9 4.9. GPIO Interface ................26 6.3.4. Lightware REST API vs. LW3 Protocol ........... 47 1.4. Model Comparison ................9 4.10. OCS Interface ................26 6.3.5. Method Types .................. 48 1.5. Typical Application ..............10 4.11. Further Built-in Features ............26...
  • Page 5     MMX2 series – User's Manual 6.7. Audio Port Settings..............56 6.11.5. Querying the Serial over IP Port Number ........67 7.6.5. Setting the Autoselect Policy ............82 6.7.1. Switching Audio Input ..............56 6.11.6. Enabling the Serial over IP Port ............ 67 7.6.6. Changing the Autoselect Included Input Ports ......
  • Page 6     MMX2 series – User's Manual 7.9.4. Changing the Gateway Address (Static) ........91 8.6.4. Device Info ..................106 7.9.5. Applying Network Settings ............. 91 8.6.5. Update .................... 107 7.9.6. Setting the Hostname ..............91 8.6.6. Package Options ................107 7.10. Network Security ..............92 8.6.7. Complex Example ................
  • Page 7: Introduction

    1. Introduction MMX2 series – User's Manual I ntroduction Thank you for choosing Lightware’s MMX2-series devices. In the first chapter we would like to introduce the device, highlighting the most important features in the sections listed below: ç Description ç Box Contents ç...
  • Page 8: Description

    MMX2 series – User's Manual 1.1. Description 1.2. Box Contents MMX2 series devices is a uniquely mini size matrix switcher. It has four HDMI inputs and HDMI output(s). MMX2- MMX2- Audio can be de-embedded from the HDMI signal to a balanced 5-pole Phoenix (Euroblock) port. The volume...
  • Page 9: Features Of The Device

     4x1-H20 Basic IT-security* These entry-level network security improvements help prevent unauthorized access to the Lightware device; HTTPS/WSS support, basic network authentication. Bi-directional RS-232* RS-232 AV systems can also contain serial port controllers and controlled devices. Serial transmission supports any unit that works with standard RS-232.
  • Page 10: Typical Application

        1. Introduction MMX2 series – User's Manual 1.5. Typical Application MMX2-4x3-HC20 Applied firmware package: v1.3.3b3 | LDC software: v2.5.14b5...
  • Page 11: Product Overview

        2. Product Overview MMX2 series – User's Manual P roduct Overview The following sections are about the physical structure of the device, input/ output ports and connectors: ç Front View ç Rear View ç Button Functionality ç...
  • Page 12: Front View

        2. Product Overview MMX2 series – User's Manual 2.1. Front View 2.2. Rear View MMX2-4x3-H20 MMX2-4x3-H20 7 6 5 4 3 2 MMX2-4x1-H20 MMX2-4x1-H20 7 6 5 4 3 2 DC Input 5V DC input for local power supply. Connect the adaptor to the 2-pole Phoenix connector.
  • Page 13: Button Functionality

        2. Product Overview MMX2 series – User's Manual 2.3. Button Functionality 2.3.4. Control Lock Press the first and fourth buttons together (within 100 ms) to disable/enable front panel buttons: INFO: If the control lock is enabled and a button is pressed, front panel LEDs blink 3 times quickly.
  • Page 14: Installation

        3. Installation MMX2 series – User's Manual Installation This chapter is about the installation of the device and connecting to other appliances, presenting also the mounting options and further assembly steps. ç Mounting Options ç Electrical Connections ç...
  • Page 15: Mounting Options

    The below example demonstrates the application of UD Kit double accessory: To mount the switcher, Lightware supplies optional accessories for different usage. There are two kinds of mounting kits with a similar fixing method. The switcher has two mounting holes with inner thread on the bottom side;...
  • Page 16: Electrical Connections

    (straight or cross) are supported and handled by the device, the pin assignment below is recommended. Pin nr. Signal Wiring of LAN Cables Ground Lightware recommends the termination of LAN cables on the basis of TIA/EIA T 568 A or TIA/EIA T 568 B TX data standards. RX data RS-232 connector pin assignments...
  • Page 17: Ocs Connector

        3. Installation MMX2 series – User's Manual 3.2.6. OCS Connector 3.2.7. GPIO - General Purpose Input/Output Ports The switcher is supplied with a 3.81mm 3-pole 90° Reversed Gender Plug Phoenix connector, which is used The switcher is supplied with an 8-pole Phoenix connector with six GPIO pins, which operates at TTL digital ®...
  • Page 18: Connecting Steps

        3. Installation MMX2 series – User's Manual 3.3. Connecting Steps HDMI Connect an HDMI source (e.g. BYOD laptop or room PC) to the HDMI input port. CATx Connect the Ethernet port to a Local Network Switch to provide Ethernet connection for device configuration and/or for a source device (only on MMX2-4x3-H20).
  • Page 19: Device Concept

        4. Device Concept MMX2 series – User's Manual Device Concept The following chapter describes the features of the device with a few real-life examples. ç Universal Switcher Concept ç Video Interface ç The Autoselect Feature ç Audio Interface ç...
  • Page 20: Universal Switcher Concept

    4.1. Universal Switcher Concept 4.3. The Autoselect Feature MMX2 series device is a multi-functional audio/video HDMI 2.0 matrix switcher with four inputs and one or Aside from manually selecting crosspoints, you can choose the Autoselect option both in case of audio and three outputs designed into a compact size frame.
  • Page 21: Audio Interface

    HDMI output as it has the highest priority – independently of the presence of the other video signals. ▪ Configuration of the device with Lightware Device Controller. For more information about the LDC, see Settings Software Control - Lightware Device Controller section.
  • Page 22: Basic Network Security

    4.6. Basic Network Security 4.6.2. HTTP/HTTPS MMX2 series switcher provides HTTP/HTTPS server services on its 80 (for HTTP) and 443 (for HTTPS) These basic network security improvements help to prevent unauthorized access to the MMX2 series ports. The following services can be used via HTTP/HTTPS: switchers: ▪...
  • Page 23: Encryption (Https, Wss)

    ▪ The MMX2 switcher generates a self-signed certificate, so the user does not have to deal with the Step 2. Enable the authentication on the chosen port (HTTP: 80 or HTTPS: 443) with Lightware Device configuration. Controller software (Network) or LW3 protocol command (Enabling Authentication).
  • Page 24: Websocket Service (Ws, Wss)

    Enabling Authentication sections). Step 3. Disable 6107 port, use Lightware REST API HTTPS (443 port) or WSS for LW3 protocol to control the device. ATTENTION! Lightware Device Controller software operates on 6107 port. In this case, the switcher can be controlled only with protocol commands.
  • Page 25: Serial Interface

    The MP1 (CPU) is available over REST API interface. The MP1 (CPU) sends the message via the serial port to a third-party (or a Lightware) device. This is a one-way communication, the response will not be interpreted Serial data communication can be established via the local RS-232 port (Phoenix connector).
  • Page 26: Gpio Interface

    4.11.1. Device Cloning – Configuration Backup and Restore The device (configuration) cloning of MMX2 series switcher is a simple method that eliminates the need to When the PC starts to play the video presentation, the signal is received over the HDMI input, so the GPIO repeatedly configure certain devices to have identical (non-factory) settings.
  • Page 27: Software Control - Lightware Device Controller

    S oftware Control - Lightware Device Controller The device can be controlled by a computer through Ethernet via the Lightware Device Controller (LDC). The software can be installed on a Windows PC or macOS. The application and the User’s Manual can be downloaded from www.lightware.com.
  • Page 28: Install And Update

    The Device Discovery window appears automatically, and the program checks the available updates on The window can be zoomed to a specific value to fit to the resolution of the desktop (higher/lower). '1' is the Lightware’s website and opens the update window if LDC updates are found. default value (100%).
  • Page 29: Establishing The Connection

    (in the 255.255.0.0 subnet). However, there is no need to browse all the available devices Identifying the Device  as you can expand the list of Favorite devices with any Lightware device that is connected via Ethernet by any DIFFERENCE: This feature is available only from 1.2.0 firmware version.
  • Page 30: Crosspoints

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.4. Crosspoints #crosspoint #switch Main menu The available menu items are displayed. The active one is highlighted. Information ribbon The label shows the device label, which can be edited in the...
  • Page 31: Port Tiles

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.4.1. Port Tiles The colors of the port tiles and the displayed icons represent different states and information: Port name Port icon Port number Signal present indicator...
  • Page 32: Port Properties Window

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.5. Port Properties Window Available settings and tools Port name Clicking on the port tile opens the Port properties window. This section shows the available settings and status information by port types.
  • Page 33: Hdmi Video Output

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.5.2. HDMI Video Output Available settings and tools General Port name The name of a port can be changed by typing the new name and clicking on the Set button. The following characters are allowed when naming: Letters (A-Z) and (a-z), hyphen (-), underscore (_), numbers (0-9), and dot (.).
  • Page 34: Embedded Audio Input

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.5.3. Embedded Audio Input Autoselect Autoselect feature makes the switching of an input to an output without human intervention possible. The crosspoint state changes based on the active input signals.
  • Page 35: Analog Audio Output

    When the video crosspoint changes, audio crosspoint follows it. Lightware’s Frame Detector function works like a signal analyzer and makes it possible to determine the ▪ Volume: from 100 to 0%, in step 1% (0 dB to -95.625 dB, in step 0.375 dB (default is 0 dB));...
  • Page 36: Edid Management

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.6. EDID Management 5.6.1. EDID Operations Advanced EDID Management can be accessed by selecting the EDID menu. There are two panels: left one Changing Emulated EDID contains Source EDIDs, right one contains Destination places where the EDIDs can be emulated or copied.
  • Page 37: Edid Summary Window

    The software resolves the raw EDID and displays it as readable information to the user. All descriptors can be edited, and saved in an EDID file, or uploaded to the User memory. For more details about EDID Editor please visit our website (www.lightware.com) and download the EDID Editor Application note.
  • Page 38: Creating An Edid - Easy Edid Creator

    Since the Advanced EDID Editor mentioned above needs more complex knowledge about 5.7.1. Ethernet EDID, Lightware introduced a wizard-like interface for fast and easy EDID creation. With Easy EDID Creator, it is possible to create custom EDIDs in four simple steps. By clicking on the Create button below the Source panel, Easy EDID Creator is opened in a new window.
  • Page 39: Gpio

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.7.2. GPIO 5.7.3. OCS - Occupancy Sensor The GPIO port has 6 pins, which operate at TTL digital signal levels and can be controlled by LDC or protocol The OCS sensor has 3 pins, where the first pin is a 24V logic input.
  • Page 40: Settings Menu

    Parity: None, Odd, or Even; #rs232 Send Message Section The serial message sending is achieved by Lightware REST Status tab in Settings menu API, and it can be in text or hexadecimal format. The CR/LF (Carriage Return/Line Feed) can be enabled optionally.
  • Page 41: Network

    Network Services HTTP/HTTPS MMX2 series switcher provides HTTP/HTTPS server services on its 80 and 443 port to make it accessible over WebSocket (WS), LW3 protocol, using Lightware Device Controller and REST API for device control (see the detailed list about the additional available features in the summary table of the Basic Network Security section).
  • Page 42: System

    5.8.3. System Script management This interface is for running custom zipped file which is made by Lightware for special request. Add a tick to enable the Run script. It means that the script runs until another script is uploaded or this function is disabled.
  • Page 43: Advanced View Window

        5. Software Control - Lightware Device Controller MMX2 series – User's Manual 5.9. Advanced View Window LW3 protocol help Pushing the button results in a help window opening, which describes the most important information about LW3 protocol commands in HTML format.
  • Page 44: Lightware Rest Api Reference

        7. Lightware REST API Reference MMX2 series – User's Manual L ightware REST API Reference The device can be controlled through standard HTTP(S) requests to ensure the control functions from web browsers or terminal program. ç Overview ç...
  • Page 45: Overview

    Node.js, terminal programs. Curl The MMX2 series device provides a REST API server where most of the LW3 commands are available (for Curl is a command line tool that can also connect to the MMX2 REST SERVER and display communication more details, see the Lightware REST API vs.
  • Page 46     7. Lightware REST API Reference MMX2 series – User's Manual POST Command with Basic Authentication Example GET Command Example Switch video crosspoint Query the Signal Presence curl --user <username>:<password> -X POST -i <ip>/api/<NodePath>/<PropertyName> --data <value> curl -i -X GET <ip>/api/<NodePath>/<PropertyName>...
  • Page 47: Protocol Rules

        7. Lightware REST API Reference MMX2 series – User's Manual 6.3. Protocol Rules 6.3.3. Legend for the Control Commands Command and Response – Example 6.3.1. Command Structure Example header: GET·<ip>/api/V1/MEDIA/VIDEO/<in>/SignalPresent·HTTP/1.1 ɯ IP address or hostname of Supported HTTP Part of the HTTP structure...
  • Page 48: Method Types

        7. Lightware REST API Reference MMX2 series – User's Manual 6.3.5. Method Types 6.3.7. Not Supported Commands GET method Querying node (GET) Protocol Command Note GET method can be used to get the value of a property. It works the same way as the LW3 GET command.
  • Page 49: Rest Api Security

       7. Lightware REST API Reference MMX2 series – User's Manual 6.4. REST API Security The REST API is designed with two security features: Authentication and Encryption. Both of them are optional and can be used independently of each other.
  • Page 50: System Commands

        7. Lightware REST API Reference MMX2 series – User's Manual 6.5. System Commands 6.5.4. Querying the Firmware Package Version Request and Response #firmwareversion 6.5.1. Setting the Device Label header: GET·http://<ip>/api/V1/MANAGEMENT/UID/PACKAGE/Version·HTTP/1.1 ɯ INFO: The device label can be changed to a custom text in the Status tab of the LDC software.
  • Page 51: Setting The Current Time

        7. Lightware REST API Reference MMX2 series – User's Manual 6.5.6. Setting the Current Time Example header: POST http://192.168.0.50/api/V1/MANAGEMENT/UI/DARKMODE/Enable HTTP/1.1 Request and Response #time ɯ body: true ɯ header: POST·http://<ip>/api/V1/MANAGEMENT/DATETIME/setTime·HTTP/1.1 ɯ header: 200 OK body: <current_time> ɮ...
  • Page 52: Video Port Settings - General

        7. Lightware REST API Reference MMX2 series – User's Manual 6.6. Video Port Settings - General 6.6.3. Locking the Video Port Request and Response 6.6.1. Switching Video Input header: POST·http://<ip>/api/V1/MEDIA/VIDEO/XP/<port>/Lock·HTTP/1.1 ɯ Request and Response body: <locked_state> ɯ header: POST·http://<ip>/api/V1/MEDIA/VIDEO/XP/switch·HTTP/1.1 ɯ...
  • Page 53: Setting The Autoselect Policy

        7. Lightware REST API Reference MMX2 series – User's Manual 6.6.5. Setting the Autoselect Policy 6.6.7. Changing the Input Port Priority Request and Response Request and Response header: POST·http://<ip>/api/V1/MEDIA/VIDEO/AUTOSELECT/<out>/Policy·HTTP/1.1 header: POST·http://<ip>/api/V1/MEDIA/VIDEO/AUTOSELECT/<out>/<in>/Priority·HTTP/1.1 ɯ ɯ body: <autoselect_mode> body: <prio_num> ɯ...
  • Page 54: Querying The Input Switching Capability

       7. Lightware REST API Reference MMX2 series – User's Manual 6.6.10. Querying the Input Switching Capability 6.6.12. HDCP Setting (Input Port) Video crosspoint has a limitation: I1 or I5 ports can not be selected to any output at the same time. Busy HDCP capability can be set on the input ports thus, non-encrypted content can be seen on a non-HDCP value of the switchable property refers to the limitation.
  • Page 55: Hdcpmode

        7. Lightware REST API Reference MMX2 series – User's Manual 6.6.13. HdcpMode 6.6.15. Muting Embedded Audio HDCP capability can be set to Auto/Always on the output ports thus, non-encrypted content can be header: POST·http://<ip>/api/V1/MEDIA/VIDEO/<port>/EmbeddedAudioMute·HTTP/1.1 ɯ transmitted to a non-HDCP compliant display. See more information in the HDCP Management section.
  • Page 56: Turning On Output 5V

        7. Lightware REST API Reference MMX2 series – User's Manual 6.6.17. Turning on Output 5V 6.7. Audio Port Settings The 5V power towards the sink can be enabled or disabled as follows: 6.7.1. Switching Audio Input Request and Response...
  • Page 57: Querying The Connected Destinations

        7. Lightware REST API Reference MMX2 series – User's Manual 6.7.3. Querying the Connected Destinations 6.7.5. Setting the Followed Video Port to Autoselect Request and Response Request and Response header: GET·http://<ip>/api/V1/MEDIA/AUDIO/XP/<audio_in>/ConnectedDestinations·HTTP/1.1 header: POST·http://<ip>/api/V1/MEDIA/AUDIO/AUTOSELECT/O3/VideoFollowPort·HTTP/1.1 ɯ ɯ body: <out> ɯ...
  • Page 58: Muting The Audio Port 1

        7. Lightware REST API Reference MMX2 series – User's Manual 6.7.7. Muting the Audio Port 1 Example header: POST http://192.168.0.50/api/V1/MEDIA/AUDIO/O4/Mute HTTP/1.1 INFO: Suspends the connection of the chosen port (no signal is forwarded). ɯ body: false ɯ...
  • Page 59: Analog Audio Output Volume Percent Setting

        7. Lightware REST API Reference MMX2 series – User's Manual 6.7.11. Analog Audio Output Volume Percent Setting 6.7.13. Analog Audio Output Level Setting by Steps (dB) Request and Response Request and Response #analogaudio #volume header: POST·http://<ip>/api/V1/MEDIA/AUDIO/O4/VolumePercent·HTTP/1.1 header: POST·http://<ip>/api/V1/MEDIA/AUDIO/O4/stepVolumedB·HTTP/1.1 ɯ...
  • Page 60: Analog Audio Output Balance Setting By Steps

        7. Lightware REST API Reference MMX2 series – User's Manual 6.7.15. Analog Audio Output Balance Setting by Steps 6.8. EDID Management Request and Response 6.8.1. Querying the Emulated EDIDs header: POST·http://<ip>/api/V1/MEDIA/AUDIO/O4/stepBalance·HTTP/1.1 ɯ Request and Response #edid body: <step> ɯ...
  • Page 61: Query The Preferred Resolution Of A User Edid

        7. Lightware REST API Reference MMX2 series – User's Manual 6.8.3. Query the Preferred Resolution of a User EDID 6.8.5. Emulating an EDID to All Input Ports Request and Response Request and Response header: GET·http://<ip>/api/V1/EDID/U/<user_edid>/PreferredResolution·HTTP/1.1 header: POST·http://<ip>/api/V1/EDID/switchAll·HTTP/1.1 ɯ...
  • Page 62: Deleting An Edid From User Memory

        7. Lightware REST API Reference MMX2 series – User's Manual 6.8.7. Deleting an EDID from User Memory 6.9. Ethernet Port Configuration Request and Response 6.9.1. Setting the DHCP State header: POST·http://<ip>/api/V1/EDID/delete·HTTP/1.1 ɯ ATTENTION! When you change a network property, the new value is stored, but the applySettings method body: <user_edid>...
  • Page 63: Changing The Ip Address (Static)

        7. Lightware REST API Reference MMX2 series – User's Manual 6.9.2. Changing the IP Address (Static) 6.9.4. Changing the Gateway Address (Static) Request and Response Request and Response header: POST·http://<ip>/api/V1/MANAGEMENT/NETWORK/StaticIpAddress·HTTP/1.1 header: POST·http://<ip>/api/V1/MANAGEMENT/NETWORK/StaticGatewayAddress·HTTP/1.1 ɯ ɯ body: <IP_address> body: <gw_address>...
  • Page 64: Setting The Hostname

       7. Lightware REST API Reference MMX2 series – User's Manual 6.9.6. Setting the Hostname 6.10. Network Security The host name is a property that can be used instead of the IP address when connecting to the device. It is 6.10.1. Enabling/Disabling Ethernet Port...
  • Page 65: Querying Network Service Port Number

    ɮ body: <port_num> ɮ 6.10.4. Querying the Username for Authentication Parameters INFO: MMX2 series deal with one user for authentication and the username (admin) can not be changed. Identifier Parameter description Parameter values Request and Response HTTP header: GET·http://<ip>/api/V1/MANAGEMENT/NETWORK/AUTH/USER1/Name·HTTP/1.1 ɯ...
  • Page 66: Enabling Authentication

        7. Lightware REST API Reference MMX2 series – User's Manual 6.10.6. Enabling Authentication 6.11. Serial Port Configuration INFO: Set the password before enabling the authentication, because no password is set by default. Restart INFO: Port numbering can be found in the Port Numbering section.
  • Page 67: Querying Data Bits

        7. Lightware REST API Reference MMX2 series – User's Manual 6.11.3. Querying Data Bits 6.11.5. Querying the Serial over IP Port Number Request and Response Request and Response header: GET·http://<ip>/api/V1/MEDIA/SERIAL/<serial_port>/DataBits·HTTP/1.1 header: GET·http://<ip>/api/V1/MEDIA/SERIAL/<serial_port>/SERIALOVERIP/Port·HTTP/1.1 ɯ ɯ header: 200·OK header: 200·OK ɮ...
  • Page 68: Serial Port Messaging

    6.13. GPIO Port Configuration 6.13.1. Setting the Direction of a GPIO Pin 6.12.1. Sending a Message via RS-232 Request and Response ATTENTION! Serial message sending is implemented only via Lightware REST API. This function is not available with LW3 protocol command. #message header: POST·http://<ip>/api/V1/MEDIA/GPIO/<pin>/Direction·HTTP/1.1 ɯ...
  • Page 69: Setting The Output Level For A Specified Time

        7. Lightware REST API Reference MMX2 series – User's Manual 6.13.3. Setting the Output Level for a Specified Time 6.14. OCS Port Configuration Request and Response 6.14.1. Querying the Input Level of an OCS Pin header: POST·http://<ip>/api/V1/MEDIA/GPIO/<pin>/interval·HTTP/1.1 ɯ Request and Response...
  • Page 70: Querying The Reported Ocs State

        7. Lightware REST API Reference MMX2 series – User's Manual 6.14.3. Querying the Reported OCS State Request and Response header: GET·http://<ip>/api/V1/MEDIA/OCS/P1/State·HTTP/1.1 ɯ header: 200·OK ɮ body: <status> ɮ Parameters Parameter Parameter description Value Value description <status> It reports the occupancy...
  • Page 71: Lightware Rest Api Quick Summary

        7. Lightware REST API Reference MMX2 series – User's Manual 6.15. Lightware REST API Quick Summary System Commands Muting the Video Port Setting the Device Label header: POST·http://<ip>/api/V1/MEDIA/VIDEO/XP/<port>/Mute·HTTP/1.1 ɯ header: POST·http://<ip>/api/V1/MANAGEMENT/LABEL/DeviceLabel·HTTP/1.1 ɯ body: <muted_state> ɯ body: <custom_name>...
  • Page 72     7. Lightware REST API Reference MMX2 series – User's Manual Setting Output Signal Type Analog Audio Output Volume (dB) Setting header: POST·http://<ip>/api/V1/MEDIA/VIDEO/<out>/OutputSignalType·HTTP/1.1 header: POST·http://<ip>/api/V1/MEDIA/AUDIO/O4/VolumedB·HTTP/1.1 ɯ ɯ body: <signal_type> body: <level> ɯ ɯ Turning on Output 5V...
  • Page 73     7. Lightware REST API Reference MMX2 series – User's Manual Deleting an EDID from User Memory Querying the Username for Authentication header: POST·http://<ip>/api/V1/EDID/delete·HTTP/1.1 header: GET·http://<ip>/api/V1/MANAGEMENT/NETWORK/AUTH/USER1/Name·HTTP/1.1 ɯ ɯ body: <user_edid> ɯ Setting Password for Authentication Resetting the Emulated EDIDs header: POST·http://<ip>/api/V1/MANAGEMENT/NETWORK/AUTH/USER1/setPassword·HTTP/1.1...
  • Page 74     7. Lightware REST API Reference MMX2 series – User's Manual Setting the Output Level of a GPIO Pin header: POST·http://<ip>/api/V1/MEDIA/GPIO/<pin>/Output·HTTP/1.1 ɯ body: <state> ɯ Setting the Output Level for a Specified Time header: POST·http://<ip>/api/V1/MEDIA/GPIO/<pin>/interval·HTTP/1.1 ɯ body: <value>;<time>...
  • Page 75: Lw3 Programmers' Reference

    7. LW3 Programmers’ Reference MMX2 series – User's Manual L W3 Programmers’ Reference The device can be controlled through Lightware 3 (LW3) protocol commands to ensure the compatibility with other Lightware products. The supported LW3 commands are described in this chapter. ç Overview ç...
  • Page 76: Overview

    The Lightware Protocol #3 (LW3) is implemented in almost all new Lightware devices (matrix switchers, MMX2 series switcher provides WS/WSS services on its 80 (for WS) and 443 (for WSS) ports to control the signal extenders and distribution amplifiers) since 2012. The protocol is ASCII-based and all commands device with LW3 protocol commands.
  • Page 77: Protocol Rules

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.4. Protocol Rules 7.4.3. Legend for the Control Commands Command and Response – Example 7.4.1. LW3 Tree Structure and Command Structure (examples) ç GET·/V1/MEDIA/VIDEO/I2.SignalPresent  / pr·/V1/MEDIA/VIDEO/I2.SignalPresent=<signal_present> æ  V1 ...
  • Page 78: Command Types

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.4.4. Command Types 7.4.5. Prefix Summary DEFINITION: The prefix is a 2-character-long code that describes the type of the response. GET command The following prefixes are defined in the LW3 protocol: The GET command can be used to get the child nodes, properties and methods of a specific node.
  • Page 79: Signature

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.4.8. Signature 7.4.10. Notifications about the Changes of the Properties DEFINITION: The signature is a four-digit-long hexadecimal value that can be optionally placed before When the value of a property is changed, and the user is subscribed to the node that the property belongs to, every command to keep a command and the corresponding responses together as a group.
  • Page 80: System Commands

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.5. System Commands 7.5.4. Querying the Firmware Package Version Command and Response #firmwareversion 7.5.1. Setting the Device Label ç GET·/V1/MANAGEMENT/UID/PACKAGE.Version INFO: The device label can be changed to a custom text in the Status tab of the LDC software.
  • Page 81: Identifying The Device

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.5.7. Identifying the Device 7.6. Video Port Settings - General Calling the method makes the status LEDs blink for 10 seconds. The feature helps to find the device physically.
  • Page 82: Muting The Video Port

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.6.4. Muting the Video Port 7.6.6. Changing the Autoselect Included Input Ports Command and Response Command and Response SET·/V1/MEDIA/VIDEO/XP/<port>.Mute=<muted_state> SET·/V1/MEDIA/VIDEO/AUTOSELECT/<out>/<in>.Included=<state> ç ç pw·/V1/MEDIA/VIDEO/XP/<port>.Mute=<muted_state> pw·/V1/MEDIA/VIDEO/AUTOSELECT/<out>/<in>.Included=<state> æ æ Parameters Parameters Parameter...
  • Page 83: Querying The Input Switching Capability

       7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.6.9. Querying the Input Switching Capability 7.6.12. HDCP Setting (Input Port) Video crosspoint has a limitation: I1 or I5 ports can not be selected to any output at the same time. Busy HDCP capability can be set on the input ports, thus non-encrypted content can be seen on a non-HDCP value of the switchable property refers to the limitation.
  • Page 84: Outputsignaltype

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.6.14. OutputSignalType 7.6.17. Output5VMode Command and Response #signaltype The 5V power towards the sink can be enabled or disabled as follows: SET·/V1/MEDIA/VIDEO/<out>.OutputSignalType=<signal_type> Command and Response ç pw·/V1/MEDIA/VIDEO/<out>.OutputSignalType=<signal_type> æ SET·/V1/MEDIA/VIDEO/<out>.Output5VMode=<5V_pwr>...
  • Page 85: Hdcp Setting (Output Port)

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.6.19. HDCP Setting (Output Port) 7.7. Audio Port Settings The maximum allowed HDCP encryption can be queried at each output ports. See more information in the 7.7.1. Switching Audio Input HDCP Management section.
  • Page 86: Querying The Connected Destinations

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.7.3. Querying the Connected Destinations 7.7.6. Locking the Audio Port Command and Response Command and Response ç GET·/V1/MEDIA/AUDIO/XP/<audio_in>.ConnectedDestinations SET·/V1/MEDIA/AUDIO/XP/<audio_port>.Lock=<locked_state> ç æ pr·/V1/MEDIA/AUDIO/XP/<audio_in>.ConnectedDestinations= pw·/V1/MEDIA/AUDIO/XP/<audio_port>.Lock=<locked_state> æ Parameters Parameters Parameter Parameter description...
  • Page 87: Muting The Audio Port 2

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.7.8. Muting the Audio Port 2. 7.7.10. Analog Audio Output Volume (dB) Setting INFO: The volume of the analog audio output is set to low. Command and Response #analogaudio...
  • Page 88: Analog Audio Output Level Setting By Steps (Db)

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.7.13. Analog Audio Output Level Setting by Steps (dB) 7.8. EDID Management Command and Response #analogaudio #volume 7.8.1. Querying the Emulated EDIDs CALL·/V1/MEDIA/AUDIO/O4:stepVolumedB(<step>) ç Command and Response #edid æ m0·/V1/MEDIA/AUDIO/O4:stepVolumedB= ç...
  • Page 89: Emulating An Edid To An Input Port

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.8.4. Emulating an EDID to an Input Port 7.8.6. Copying an EDID to User Memory Command and Response Command and Response ç CALL·/V1/EDID:switch(<source>:<destination>) ç CALL·/V1/EDID:copy(<source>:<destination>) æ mO·/V1/EDID:switch æ mO·/V1/EDID:copy...
  • Page 90: Resetting The Emulated Edids

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.8.8. Resetting the Emulated EDIDs 7.9. Ethernet Port Configuration Command and Response 7.9.1. Setting the DHCP State ç CALL·/V1/EDID:reset() ATTENTION! When you change a network property, the new value is stored, but the applySettings method æ...
  • Page 91: Changing The Subnet Mask (Static)

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.9.3. Changing the Subnet Mask (Static) 7.9.6. Setting the Hostname Command and Response #ipaddress The host name is a property that can be used instead of the IP address when connecting to the device. It is also suitable for finding the device in the Device Discovery window of the LDC, see more details in the SET·/V1/MANAGEMENT/NETWORK.StaticNetworkMask=<netmask>...
  • Page 92: Network Security

    æ pw /V1/MEDIA/ETHERNET/P4.Enabled=true 7.10.4. Querying the Username for Authentication 7.10.2. Querying the Service Port Number INFO: MMX2 series deal with one user for authentication and the username (admin) can not be changed. Command and Response Command and Response ç GET·/V1/MANAGEMENT/NETWORK/SERVICES/<port>.Port ç GET·/V1/MANAGEMENT/NETWORK/AUTH/USER1.Name pw·/V1/MANAGEMENT/NETWORK/SERVICES/<port>.Port=<port_num>...
  • Page 93: Setting A Password For Authentication

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.10.5. Setting a Password for Authentication 7.10.7. Restarting Network Services INFO: Due to security reasons, the password is not stored in any property, so it can not be queried. No...
  • Page 94: Serial Port Configuration

    *The MMX2-2x1-HC30 model has one serial port (P1). 7.12. Sending a Message via RS-232 Example ATTENTION! Serial message sending is implemented only via Lightware REST API. This function is not ç SET /V1/MEDIA/SERIAL/P1.StopBits=1 available with LW3 protocol command. For more details, see Serial Port Messaging.
  • Page 95: Gpio Port Configuration

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.13. GPIO Port Configuration 7.13.4. Setting the Output Level of a GPIO Pin Command and Response 7.13.1. Querying the Direction of a GPIO Pin Command and Response #gpio ç SET·/V1/MEDIA/GPIO/<pin>.Output(<value>) æ...
  • Page 96: Ocs Port Configuration

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.14. OCS Port Configuration 7.14.3. Querying the Reported OCS State Command and Response DIFFERENCE: Occupancy sensor-related commands are available only from FW package 1.1.0b7. ç GET·/V1/MEDIA/OCS/P1.State 7.14.1. Querying the Input Level of an OCS Pin pr·/V1/MEDIA/OCS/P1.State=<status>...
  • Page 97: Lw3 Commands - Quick Summary

        7. LW3 Programmers’ Reference MMX2 series – User's Manual 7.15. LW3 Commands - Quick Summary System Commands Changing the Autoselect Included Input Ports SET·/V1/MEDIA/VIDEO/AUTOSELECT/<out>/<in>.Included=<state> Setting the Device Label ç Changing the Input Port Priority SET·/V1/MANAGEMENT/LABEL.DeviceLabel=<custom_name> ç SET·/V1/MEDIA/VIDEO/AUTOSELECT/<out>/<in>.Priority=<prio_num>...
  • Page 98     7. LW3 Programmers’ Reference MMX2 series – User's Manual Audio Port Settings EDID Management Switching Audio Input Querying the Emulated EDIDs ç CALL·/V1/MEDIA/AUDIO/XP:switch(<audio_in>:O3) ç GET·/V1/EDID.EdidStatus Querying the Connected Source Querying the Validity of a Dynamic EDID ç...
  • Page 99     7. LW3 Programmers’ Reference MMX2 series – User's Manual Network Security GPIO Port Configuration Enabling/Disabling Ethernet Port Querying the Direction of a GPIO Pin SET·/V1/MEDIA/ETHERNET/<ethernet_port>.Enabled=<status> ç GET·/V1/MEDIA/GPIO/<pin>.Direction ç Querying the Service Port Number Setting the Direction of a GPIO Pin ç...
  • Page 100: Firmware Update

    This chapter is meant to help customers perform firmware updates on our products by giving a few tips on how to start and by explaining the features of the Lightware Device Updater v2 (LDU2) software. The latest software and firmware pack can be downloaded from www.lightware.com.
  • Page 101: Introduction

    If any problem occurs, reboot the device and restart the process. Available for Windows, 8.1. Introduction Available for Windows macOS and Linux Lightware Device Updater v2 (LDU2) software is the second generation of the LFP-based The installer can update Cannot be updated (Lightware Firmware Package) firmware update process. only this instance...
  • Page 102: Running The Software

    Main Screen When the software is started by the shortcut, the device discovery screen DISCOVER DEVICES appears. Press the Discover devices button to start finding the Lightware devices: Legend of the Icons IP address editor The IP address of the device can be changed in the pop-up window.
  • Page 103: Updating Via Gui

       8. Firmware Update MMX2 series – User's Manual 8.4. Updating Via GUI After the package file is loaded, the list is filtered to show the compatible devices only. The current firmware version of the device is highlighted in orange if it is different from the version of the package loaded.
  • Page 104    8. Firmware Update MMX2 series – User's Manual Step 2. Select the desired devices for updating. LDU2 uploads the firmware package into the device and the update will be executed internally. After that, LDU2 will disconnect from the device; you can close LDU2.
  • Page 105: Command Line Interface (Cli)

    C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd help Running under Linux C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar help Command line usage: The Command Line Interface under Linux Operating Systems can be run by the following: Win: LightwareDeviceUpdaterV2_CLI.cmd [command] [options]...
  • Page 106: Ldu2 Version

    C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd deviceInfo --ip 192.168.0.100 c:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd checkForUpdates C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar deviceInfo --ip c:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar checkForUpdates 192.168.0.100 Current LDU2 version: 2.10.0b6...
  • Page 107: Update

    C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd update --ip Command 192.168.1.19 --package C:\Firmwares\taurus_v1.3.3b3.lfp2 --reportProgress LightwareDeviceUpdaterV2_CLI.cmd packageOptions [options] C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar update --ip 192.168.1.19 --package C:\Firmwares\taurus_v1.3.3b3.lfp2 --reportProgress Options [2022-02-11 11:22:52.820] [ INFO] [ main] - Device IPs: [192.168.1.19] [2022-02-11 11:22:58.317] [ INFO] [...
  • Page 108: Complex Example

    If an update is not successful, the Export log button becomes red. If you press the button, you can download [2022-02-11 11:33:59.154] [ INFO] [ProgressReporter] - Progress: 64% the log file as a ZIP package, which can be sent to Lightware Support if needed. The log files contain useful [2022-02-11 11:34:04.168] [ INFO] [ProgressReporter] - Progress: 67% information about the circumstances to find the root cause.
  • Page 109: Troubleshooting

       9. Troubleshooting MMX2 series – User's Manual T roubleshooting Usually, if the system seems not to transport the signal as expected, the best strategy for troubleshooting is to check signal integrity through the whole signal chain starting from source side and moving forward to receiver end.
  • Page 110: Use Cases

    EDID is software. is high, HDMI2.0 not supported this The more of the above information you can give us, the better. Please send this information to the Lightware scrambling is resolution. 7.8.4 Support Team (support@lightware.com) to speed up the troubleshooting process.
  • Page 111: Technologies

       10. Technologies MMX2 series – User's Manual Technologies The following sections contain descriptions and useful technical information how the devices work in the background. The content is based on experiences and cases we met in the practice. These sections help to understand features and technical standards like the following: ç...
  • Page 112: Edid Management

    (static EDID emulation), or from the last attached monitor’s memory (dynamic EDID emulation). For example, the Lightware device can be set up to emulate a sink device, which is connected to one of the outputs. In this case, the EDID automatically changes, if the monitor is replaced with another display device (as long as it has a valid EDID).
  • Page 113: Hdcp Management

    To avoid unnecessary HDCP encryption, Lightware introduced the HDCP enabling/disabling function: the Not HDCP-compliant Sink 2. HDCP capability can be disabled in the Lightware device. If HDCP is disabled, the connected source will The layout is the same as in the previous case: non-HDCP compliant display device is connected to the detect that the sink is not HDCP capable, and turn off authentication.
  • Page 114: Hdcp V2.2

    Output Lightware device. A lower level of encryption may be applied only if the source device/content allows it - according to the HDCP standard. In this case the HDCP setting on the input port has to be set to HDCP 1.4 HDCP v1.4...
  • Page 115: Pixel Accurate Reclocking

    Without reclocking, sparkles, noise, and jaggies appear on the image. Lightware’s sophisticated Pixel Accurate Reclocking technology fixes more problems than general TMDS reclocking. It removes not only intra-pair skew, but inter-pair skew as well. The Pixel Accurate Reclocking...
  • Page 116: Appendix

        11. Appendix MMX2 series – User's Manual Appendix Tables, drawings, guides, technical details and hashtag keyword list as follows: ç Specifications ç Port Numbering ç Applied Ports (Network Settings) ç Factory EDID List ç Cable Wiring Guide ç...
  • Page 117: Specifications

        11. Appendix MMX2 series – User's Manual 11.1. Specifications Video Inputs HDMI input General Connector type ....................19-pole HDMI Type A receptacle Compliance ................................. CE ............................ (with screw locking option) Electrical safety ....................IEC 61000-3-3:2013+AMD1:2017 A/V standard ......................DVI 1.0, HDMI 1.4, HDMI 2.0 EMC (emission)........................
  • Page 118     11. Appendix MMX2 series – User's Manual Audio formats ....................... 8 channel PCM, Dolby TrueHD Parity ............................None / Odd / Even ............................DTS-HD Master Audio 7.1 Stop bits ................................1 / 2 * All standard VESA and CEA resolutions up to 300MHz (HDMI1.4) and other custom resolutions up to Output voltage: Low level ..........................3 - 15V...
  • Page 119: Port Numbering

        11. Appendix MMX2 series – User's Manual 11.2. Port Numbering RS-232 Ports Audio/Video Ports Port nr. Serial over IP Port name (LW3) port nr. Video port nr. Audio port nr. Port name (LW3) (LW3) RS-232 1 8001...
  • Page 120: Factory Edid List

        11. Appendix MMX2 series – User's Manual 11.4. Factory EDID List Resolution Type EDID features 1280 x 720p @ 50.00 HDMI; YUV444; YUV422; 2CH_AUD Resolution Type EDID features 1280 x 720p @ 60.00 HDMI; YUV444; YUV422; 2CH_AUD 640 x 480p @ 60.00...
  • Page 121     11. Appendix MMX2 series – User's Manual Resolution Type EDID features Resolution Type EDID features F118 3840 x 2160p @ 30.00 HDMI; YUV444; YUV422; 2CH_AUD F148 3840 x 2160p @ 60.00 HDMI; HDMI2; YUV444; YUV422; 8CH_AUD HDMI;...
  • Page 122: Cable Wiring Guide

    Symmetric audio is most often referred to as balanced audio, as opposed to asymmetric, which is referred to as unbalanced audio. Lightware products are usually built with 5-pole Phoenix connectors, so we 11.5.3. OCS Sensor would like to help users assembling their own audio cables.
  • Page 123: Mechanical Drawings

        11. Appendix MMX2 series – User's Manual 11.6. Mechanical Drawings INFO: MMX2-4x3-H20 model can be seen in the pictures, but the dimensions are the same for both models. Dimensions are in mm. Applied firmware package: v1.3.3b3 | LDC software: v2.5.14b5...
  • Page 124: Factory Default Settings

        11. Appendix MMX2 series – User's Manual 11.7. Factory Default Settings Parameter MMX2-4x3-H20 MMX2-4x1-H20 Video port settings Connected source (O1/O2/O3) I1/I2/I3 I1/-/- Allowed HDCP Version (I1/I2/I3/I4) 2.2/2.2/1.4/1.4 Hotplug detect mode (HPD) at input ports auto auto Output 5V mode / signal type...
  • Page 125: Hashtag Keyword List

    Restarting the device #dhcp #restart Restarting the device This keyword is placed at the DHCP (dynamic IP address) setting in the front panel operation, the Lightware Device Controller (LDC) and the LW3 programmer's reference section. #rs232 RS-232 related settings #rs-232...
  • Page 126: Further Information

    1.1. 25G and MODEX product series will be subject to a seven (7) year warranty period under the same terms as outlined in this document. 1.2. If during the first three (3) months of purchase, the customer is unhappy with any aspect of a Lightware product, Lightware will accept a return for full credit.

This manual is also suitable for:

Mmx2-4x3-h20Mmx2-4x1-h20

Table of Contents