Overview; Instructions For The Terminal Application Usage; Protocol Rules; Lw3 Tree Structure And Command Structure (Examples) - Lightware MX2-8x8-DH-4DPio-A User Manual

   
9. LW3 Programmers' Reference
9.1. Overview
The Lightware Protocol #3 (LW3) is implemented in almost all new Lightware devices (matrix switchers,
signal extenders and distribution amplifiers) since 2012. The protocol is ASCII-based and all commands
are terminated with a carriage return (Cr, '\r') and line feed (Lf, '\n') pair. It is organized as a tree structure
that provides outstanding flexibility and user-friendly handling with 'nodes', 'properties' and 'methods'. The
Advanced View of the Lightware Device Controller software is the perfect tool for browsing and learning how
the LW3 protocol can be used in practice.
9.2. Instructions for the Terminal Application Usage
Terminal Application
The LW3 protocol commands can be applied to the
switcher using a terminal application. You need to
install one of them to your control device, for example
Putty or CLI. #terminal
Establishing Connection
Follow the steps for establishing connection to the
receiver:
Step 1. Connect the receiver to a LAN over Ethernet.
Step 2. Open the terminal application (e.g. Putty).
Step 3. Add the IP address of the device (default:
DHCP) and the port number (6107).
Step 4. Select the Raw connection type, and open the
connection.
Once the terminal window is opened, you can enter
the LW3 protocol commands, which are listed in the
following sections.
LW3 protocol command communication in a terminal window
MX2 Standalone Matrix Switcher series – User's Manual
9.3. Protocol Rules
9.3.1. LW3 Tree Structure and Command Structure (examples)
9.3.2. General Rules
/
▪
▪
▪
▪
▪
▪
▪
▪
▪
Applied firmware package: v1.9.0 | LDC software: v2.6.2b3
MEDIA
Command type
XP
(GET/SET/CALL/MAN)
NAMES
SETTINGS
PRESET
SALVO
Command
PORTS
Response
VIDEO
I1
I2
I3
Prefix of the response
I4
I5
I6
I7
I8
[...]
EDID
MANAGEMENT
SYS
All names and parameters are case-sensitive.
The nodes are separated by a slash ('/') character.
The node name can contain the elements of the English alphabet and numbers.
Use the TCP port no. 6107 when using LW3 protocol over Ethernet.
When a command is issued by the device, the received response cannot be processed by the CPU.
The node paths describe the exact location of the node, listing each parent node up to the root.
The length of a line (command/response, command type / prefix, path, method/property and
parameters together) can be max. 800 bytes.
The command lines have to be closed by Carriage return and Line Feed (CrLf)
77
Path of the method/property
Method/property
Parameters
CALL /MEDIA/XP/VIDEO:switch(I1:O1;I2:O2)
mO /MEDIA/XP/VIDEO:switch
Method/property
Path of the method/property