Notifications About The Changes Of The Properties - Lightware VINX-120-HDMI-ENC User Manual


  
5. Programmers' Reference
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/*

5.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/QUALITY
˂ o- /MEDIA/VIDEO/QUALITY
Connection #1
˃ GET /MEDIA/VIDEO/Quality.QualityMode
˂ pm /MEDIA/VIDEO/QUALITY.QualityMode=graphic
˃ GET /MEDIA/VIDEO/Quality.QualityMode
˂ pm /MEDIA/VIDEO/QUALITY.QualityMode=graphic
Connection #2
˃ SET /MEDIA/VIDEO/Quality.QualityMode=video
˂ pw /MEDIA/VIDEO/QUALITY.QualityMode=video
Connection #1 ˂ CHG /MEDIA/VIDEO/QUALITY.QualityMode=video
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.
VINX-1x0-HDMI Extenders – User's Manual
GENERAL WARNING! Please take care when modifying the parameters by the commands
listed in the following sections. Wrong settings may render the device unusable.
5.6. System Commands
5.6.1. Querying the Product Name
The name of the product is a read-only parameter and cannot be modified.
Command format: GET●/.ProductName
Response format: pr●/.ProductName=<Product_name>
Example:
˃ GET /.ProductName
˂ pr /.ProductName=VINX-120-HDMI-ENC
5.6.2. Setting the Device Label
ATTENTION! This property is a writable parameter and not the same as the ProductName.
Command format: SET●/SYS/MB.DeviceLabel=<Custom_name>
Response format: pw●/SYS/MB.DeviceLabel=<Custom_name>
The <Custom_name> may consist of ASCII characters and can be 32 characters length. Longer names are
truncated.
Example:
˃ SET /SYS/MB.DeviceLabel=Enc_80
˂ pw /SYS/MB.DeviceLabel=Enc_80
5.6.3. Querying the Serial Number
Command format: GET●/.SerialNumber
Response format: pr●/.SerialNumber=<serial_nr>
Example:
˃ GET /.SerialNumber
˂ pr /.SerialNumber=87654321
5.6.4. Querying the Firmware Version
Command format: GET●/SYS/MB.FirmwareVersion
Response format: pr●/SYS/MB.FirmwareVersion=<firmware_version>
˃ GET /SYS/MB.FirmwareVersion
˂ pr /SYS/MB.FirmwareVersion=6.4.17.3
28