Errormessages; Escaping; Notificationsaboutthechangesoftheproperties; Subscription - Lightware HDMI-TPS-TX226 User Manual

   
7.LW3Programmer'sReference
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 originalmessage:
CALL /MEDIA/UART/P1:sendMessage(Set(01))
The escapedmessage:
CALL /MEDIA/UART/P1:sendMessage(Set\(01\))
7.3.8. Notifications about the Changes of the Properties
Whenthevalueofapropertyischangedandtheuserissubscribedtothenode,whichthepropertybelongs
to,anasynchronousnotificationisgenerated.Thisisnotificationiscalledasthe'changemessage'.The
formatofsuchamessageisverysimilartotheresponsefortheGETcommand:
æ 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.
HDMI-TPS-TX200series–User'sManual
}
Connection #1
}
Connection #2

Connection #1
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
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/*
82