Notifications About The Changes Of The Properties; Formal Definitions - Lightware MMX8x8-HDMI-4K-A User Manual


  
7. LW3 Programmers' Reference
Subscribe to Multiple Nodes
In order to subscribe to multiple nodes, the asterisk wild card can be used.
Command format: OPEN●[nodePath]/*
Response format: o-●[nodePath]/*
Example:
˃ OPEN /MEDIA/VIDEO/*
˂ o- /MEDIA/VIDEO/*
Get the Active Subscriptions for the Current Connection
Command format: OPEN
Response format: o-●[nodePath]
Example:
˃ OPEN
˂ o- /MEDIA/VIDEO
˂ o- /EDID
˂ o- /DISCOVERY
Unsubscribe from a Node
Command format: CLOSE●[nodePath]
Response format: c-●[nodePath]
Example:
˃ CLOSE /MEDIA/VIDEO
˂ c- /MEDIA/VIDEO
Unsubscribe from Multiple Nodes
Command format: CLOSE●[nodePath]/*
Response format: c-●[nodePath]/*
Example:
˃ CLOSE /MEDIA/VIDEO/*
˂ c- /MEDIA/VIDEO/*
MMX8x4-HT series – User's Manual
7.5.7. Notifications about the Changes of the Properties
When the value of a property is changed and the user is subscribed to the node, which the property belongs
to, an asynchronous notification is generated. This is notification is called as the 'change message'. The
format of such a message is very similar to the response for the 'GET' command.
Format: CHG●[nodePath].[propertyName]=[newPropertyValue]
Example:
˂ CHG /EDID.EdidStatus=F48:E1
A Short Example of How to Use the Subscription
In the following, an example is presented, how the subscriptions are working and how to use them. In the
example, there are two independent users controlling the device through two independent connections
('Connection #1' and 'Connection #2'). The events in the rows occur after each other.
˃ OPEN /MEDIA/VIDEO/XP
˂ o- /MEDIA/VIDEO/XP
Connection #1
˃ GET /MEDIA/VIDEO/XP.DestinationConnectionList
˂ pm /MEDIA/VIDEO/DestinationConnectionList=I4;I2;I4;I4;I4
˃ GET /MEDIA/VIDEO/XP.DestinationConnectionList
˂ pm /MEDIA/VIDEO/DestinationConnectionList=I4;I2;I4;I4;I4
Connection #2
˃ CALL /MEDIA/VIDEO/XP:switch(I1:O1)
˂ mO /MEDIA/VIDEO/XP:switch
Connection #1
˂ CHG /MEDIA/VIDEO/XP.DestinationConnectionList=I1;I2;I4;I4;I4
Explanation: The first user (Connection #1) set a subscription to a node. Later the other user (Connection
#2) made a change, and thanks for the subscription, the first user got a notification about the change.
7.6. Formal Definitions
Method parameters and property values are specified in a modified version of Backus-Naur Form (BNF). The
syntax is the following:
"literal"
<expression1>|<expression2>
[<expression>]
<number>*[<expression>]
*[<expression>]
<number>*{<expression>}
literals are quoted
vertical bars denote alternatives
expressions in square brackets are optional
expression is repeated at least <number> times
<number> may be omitted, in this case number defaults to 0
expressions in curly brackets are repeated exactly <number> times
In
Input port number
On
Output port number
67