7.LW3Programmer'sReference
HDMI-TPS-TX200series–User'sManual
82
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
7.3.6.
Error Messages
ThereareseveralerrormessagesdefinedintheLW3protocol,allofthemhaveauniqueerrornumber.
ç
SET/MEDIA/UART/P1.Baudrate=9
æ
pE/MEDIA/UART/P1.Baudrate%E004:Invalidvalue
7.3.7.
Escaping
DEFINITION:
An escape sequence is a sequence of characters that does not represent itself when used
insideacharacterorstringliteral,butistranslatedintoanothercharacterorasequenceofcharacters.
Propertyvaluesandmethodparameterscancontaincharacterswhichareusedascontrolcharactersinthe
protocol.Theymustbeescaped.Theescapecharacteristhebackslash(‘\’)andescapingmeansinjecting
abackslashbeforethecharacterthatshouldbeescaped(likeinClanguage).
Controlcharactersarethefollowings:\{}#%()\r\n\t
The
original
message:
CALL /MEDIA/UART/P1:sendMessage(Set(01))
The
escaped
message:
CALL /MEDIA/UART/P1:sendMessage(Set\(01\))
7.3.8. Notifications about the Changes of the Properties
Whenthevalueofapropertyischangedandtheuserissubscribedtothenode,whichthepropertybelongs
to,anasynchronousnotificationisgenerated.Thisisnotificationiscalledasthe‘changemessage’.The
formatofsuchamessageisverysimilartotheresponseforthe
GET
command:
æ
CHG/EDID.EdidStatus=F48:E1
A Short Example of How to Use the Subscription
Therearetwoindependentuserscontrollingthedevicethroughtwoindependentconnections(
Connection #1
and
Connection #2
). The events in the rows occur after each other.
ç
OPEN/MEDIA/VIDEO/I2
æ
o-/MEDIA/VIDEO/I2
ç
GET/MEDIA/VIDEO/I2.HdcpEnable
æ
pw/MEDIA/VIDEO/I2.HdcpEnable=true
ç
GET/MEDIA/VIDEO/I2.HdcpEnable
æ
pw/MEDIA/VIDEO/I2.HdcpEnable=true
ç
SET/MEDIA/VIDEO/I2.HdcpEnable=false
æ
pw/MEDIA/VIDEO/I2.HdcpEnable=false
æ
CHG/MEDIA/VIDEO/I2.HdcpEnable=true
Thefirstuser(
Connection #1
)setasubscriptiontoanode.Latertheotheruser(
Connection #2
)madeachange,
andthanksforthesubscription,thefirstusergotanotificationaboutthechange.
Connection #1
Connection #2
Connection #1
}
}
7.3.9.
Subscription
DEFINITION:
Subscribetoanodemeansthattheuserwillgetanotificationifanyofthepropertiesofthe
nodeischanged.
Ausercansubscribetoanynode.Thesenotificationsareasynchronousmessagesandtheyareusefulto
keeptheclientapplicationuptodate,withoutreceivinganyunwantedinformation.Whentheuserdoesnot
wanttobeinformedaboutthechangesanymore,hecansimplyunsubscribefromthenode.
ATTENTION!
The subscriptions are handled separately for connections. Hence, if the connection is
terminatedallregisteredsubscriptionsaredeleted.Afterclosingaconnectionthesubscribecommand
hastobesentinordertogetthenotificationsofthechangesonthatconnection.
Subscribe to a Node
ç
OPEN/MEDIA/VIDEO
æ
o-/MEDIA/VIDEO
Get the Active Subscriptions
ç
OPEN
æ
o-/MEDIA/VIDEO
æ
o-/EDID
æ
o-/DISCOVERY
Subscribe to Multiple Nodes
ç
OPEN/MEDIA/VIDEO/*
æ
o-/MEDIA/VIDEO/*
Unsubscribe from a Node
ç
CLOSE/MEDIA/VIDEO
æ
c-/MEDIA/VIDEO
Unsubscribe from Multiple Nodes
ç
CLOSE/MEDIA/VIDEO/*
æ
c-/MEDIA/VIDEO/*