5. Programmers' Reference
VINX-1x0-HDMI Extenders – User's Manual
27
Example
: (for a property)
˃
MAN /MEDIA/VIDEO/I1.ForceHdcpVersion
˂
pm /MEDIA/VIDEO/I1.ForceHdcpVersion 0:All | 1:HDCP1.x | 2:HDCP2.2
Example
: (for a method)
˃
MAN /SYS:reset
˂
mm /SYS:reset Restart the device
5.5.5. Signature
For some command, the response can contain multiple lines. Each line is terminated with a carriage return
(Cr, ‘\r’) and line feed (Lf, ‘\n’) characters. In several cases the number of the lines in the response cannot
be determined in advance, e.g. the client is intended waiting for the whole response and also wants to be
sure, that the received lines belong together and to the same command. In these cases, a special feature the
‘signature’ can be used.
The signature is a four digit long hexadecimal value that can be optionally placed before every command.
In that case, the response to that particular command will also be preceded by the signature, and the
corresponding lines will be between brackets.
Command format
:
XXXX#[command]
Legend
:
xxxx: 4-digit long hexadecimal value.
Response format
:
{XXXX
[command lines]
}
Example:
˃
1103#GET /MEDIA/VIDEO.*
˂
{1103
˂
pr /MEDIA/VIDEO.I1=I1
˂
pr /MEDIA/VIDEO.O1=O1
˂
pr /MEDIA/VIDEO.PortCount=2
˂
}
INFO: The lines of the signature are also Cr and Lf terminated.
5.5.6. Subscription
A user can subscribe to any node. Subscribe to a node means that the user will get a notification if any of
the properties of the node is changed. These notifications are asynchronous messages - such as the ones
described above - and hence, they are useful to keep the client application up-to-date, without receiving any
unwanted information. When the user does not want to be informed about the changes anymore, he can
simply unsubscribe from the node.
ATTENTION!
The subscriptions are handled separately for connections. Hence, if the connection is
terminated all registered subscriptions are deleted. After closing a connection the subscribe command
has to be sent in order to get the notifications of the changes on that connection.
Subscribe to a Node
Command format
:
OPEN
●
[nodePath]
Response format
:
o-
●
[nodePath]
Example
:
˃
OPEN /MEDIA/VIDEO
˂
o- /MEDIA/VIDEO
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
