8. LW3 Programmers' Reference
MMX8x4-HT series – User's Manual
98
Applied firmware package: v1.2.2b5 | LDC software: v2.2.1
8.2.9. 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:
Ü
CHG /EDID.EdidStatus=F48:E1
A Short Example of How to Use the Subscription
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
Ý
GET /MEDIA/VIDEO/Quality.QualityMode
Ü
pm /MEDIA/VIDEO/QUALITY.QualityMode=graphic
Ý
GET /MEDIA/VIDEO/Quality.QualityMode
Ü
pm /MEDIA/VIDEO/QUALITY.QualityMode=graphic
Ý
SET /MEDIA/VIDEO/Quality.QualityMode=video
Ü
pw /MEDIA/VIDEO/QUALITY.QualityMode=video
Ü
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.
8.2.10.
Legend for the Control Commands
Format
Description
<in>
Input port number
<out>
Output port number
<port>
Input or output port number
<loc>
Location number
<parameter>
Variable, which is defined and described in the
command
<expression>
Batched parameters: the underline means that
more expressions or parameters can be placed by
using a semicolon, e.g.
I2;I4;I5
or
F27:E1;F47:E2
Ý
Sent command
Ü
Received response
•
Space character
Connection #1
Connection #2
Connection #1
}
}
8.3.
System Commands
8.3.1. Query the Product Name
The name of the product is a read-only parameter and cannot be modified.
Command and Response
Ý
GET•
/.ProductName
Ü
pr•/.ProductName=
<product_name>
Example
Ý
GET
/.ProductName
Ü
pr /.ProductName=MMX8x4-HT420M
8.3.2. Query the Device Label
Command and Response
Ý
SET•/MANAGEMENT/UID/DeviceLabel=
<custom_name>
Ü
pw•/MANAGEMENT/UID/DeviceLabel=
<custom_name>
Parameters
<custom_name>
The Device Label can be 39 character long and ASCII characters are allowed. Longer
names will be truncated.
Example
Ý
SET
/MANAGEMENT/UID.DeviceLabel=MMX_Control_room
Ü
pw /MANAGEMENT/UID.DeviceLabel=MMX_Control_room
8.3.3.
Set the Device Label
ATTENTION!
The device label can be changed to a custom text which is displayed in many windows of
the LDC. This writable parameter is not the same as the ProductName parameter.
Command and Response
#devicelabel
Ý
SET•/MANAGEMENT/UID/DeviceLabel=
<custom_name>
Ü
pw•/MANAGEMENT/UID/DeviceLabel=
<custom_name>
Parameters
<custom_name>
The Device Label can be 39 character long and ASCII characters are allowed. Longer
names will be truncated.
Example
Ý
SET
/MANAGEMENT/UID.DeviceLabel=MMX_Control_room
Ü
pw /MANAGEMENT/UID.DeviceLabel=MMX_Control_room
