Lw3 Programmers' Reference; Overview; Protocol Rules; Lw3 Tree Structure And Command Structure (Examples) - Lightware MX2-8x8-HDMI20-L User Manual


  

7. LW3 Programmers' Reference

8
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

Ý

Protocol Rules

Ý
System Commands
Ý
Switching and Crosspoint Settings
Ý
Video Input Port Settings (HDMI and DisplayPort)
Ý
DisplayPort Input Settings
Ý
Audio Input Port Settings
Ý
Video Output Port Settings
Ý
Audio Output Port Settings
Ý
Preset Handling
Ý
RS-232 Port Settings
Ý
Network Settings
Ý
EDID Management
Ý
LW3 Commands – Quick Summary
Ý
MX2-HDMI20 series – User's Manual
8.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.
8.2. Protocol Rules
8.2.1. LW3 Tree Structure and Command Structure (examples)
 /
 MEDIA
 XP
 NAMES
 SETTINGS
 PRESET
 SALVO
 PORTS
 VIDEO
 I1
 I2
 I3
 I4
 I5
 I6
 I7
 I8
[...]
 EDID
 MANAGEMENT
 SYS
8.2.2. General Rules
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 path of a node has to contain all parent nodes from the root node.
Path of the method/property
Command type Method/property
(GET/SET/CALL/MAN)
Command Ý CALL /MEDIA/VIDEO/XP:switch(I1:O1;I2:O2)
Response
Ü mO /MEDIA/VIDEO/XP:switch
Prefix of the response Method/property
Path of the method/property
52
Parameters