Prefixsummary; Errormessages; Escaping; Subscription - Lightware HDMI-TPS-TX210 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.2.0 | LDCsoftware:v2.2.0
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/*
68