7.LW3Programmer'sReference
HDMI-TPS-TX200series–User'sManual
80
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
7.1.
Overview
TheLightwareProtocol#3(LW3)isimplementedinalmostallnewLightwaredevices(matrixswitchers,
signalextendersanddistributionamplifiers)since2012.TheprotocolisASCII-basedandallcommands
areterminatedwithacarriagereturn(Cr,‘\r’)andlinefeed(Lf,‘\n’)pair.Itisorganizedasatreestructure
thatprovidesoutstandingflexibilityanduser-friendlyhandlingwith‘nodes’,‘properties’and‘methods’.The
Advanced View
oftheLightwareDeviceControllersoftwareistheperfecttoolforbrowsingandlearninghow
theLW3protocolcanbeusedinpractice.
7.2.
Instructions for the Terminal Application Usage
Terminal Application
TheLW3protocolcommandscanbeappliedtothe
receiver 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.
ConnectthereceivertoaLANoverEthernet.
Step 2.
Opentheterminalapplication(e.g.Putty).
Step 3.
Add the
IP address
of the device (default:
192.168.0.100)andthe
port number (6107)
.
Step 4.
Selectthe
Raw
connection type, and open the
connection.
Once the terminal window is opened, you can enter
theLW3protocolcommandswhicharelistedinthe
followingsections.
LW3 protocol command communication in a terminal window
7.3.
Protocol Rules
7.3.1.
LW3 Tree Structure and Command Structure (examples)
7.3.2.
General Rules
▪
All names and parameters are
case-sensitive
.
▪
Thenodesareseparatedbyaslash(‘/’)character.
▪
ThenodenamecancontaintheelementsoftheEnglishalphabetandnumbers.
▪
The length of a line (command/response, command type / prefix, path, method/property and
parameterstogether)canbe
max. 800 byte
.
▪
ThecommandlineshavetobeclosedbyCarriagereturnandLineFeed(
CrLf
)
▪
Usethe
TCP
port no. 6107
whenusingLW3protocoloverEthernet.
▪
Whenacommandisissuedbythedevice,thereceivedresponsecannotbeprocessedbytheCPU.
▪
Thenodepathsdescribetheexactlocationofthenode,listingeachparentnodeuptotheroot.
ç
CALL /MEDIA/VIDEO/XP:switch(I1:O2)
æ
mO /MEDIA/VIDEO/XP:switch
Command type
(GET/SET/CALL/MAN)
Prefixoftheresponse
Pathofthemethod/property
Pathofthemethod/property
Method/property
Method/property
Parameters
Command
Response
/
MEDIA
VIDEO
XP
SourcePortCount
SourcePortStatus
DestinationPortCount
DestinationPortStatus
[...]
I1
I2
O1
O2
AUDIO
UART
IR
ETHERNET
CEC
EDID
EVENTS
PRESETS
SYS
MANAGEMENT
REMOTE
[...]