ξ
ξξξξ°ξ»ξξξ΄ξξξξξ
ξξξξξξξξΆξξξξξξξξ HDMI20-OPTC series β User's Manual 44
ξξξξξξξSignature
DEFINITION: The signature is a four-digit-long hexadecimal value that can be optionally placed before
every command to keep a command and the corresponding responses together as a group.
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 intends to receive 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 response to that particular command will
also be preceded by the signature, and the corresponding lines will be between brackets:
Γ ξξξξξξ«ξ©ξΈξξξ©ξ¨ξξ¨ξξ
Γ {1700
Γ ξξξξξ©ξ¨ξξ¨ξξ©ξξξξ·ξξ
ξξξξ‘ξͺξξξξ©ξξξ¨ξξξ©ξξξ¨ξξξ©ξξξ¨ξξξ©ξξξͺξξξξ©ξ
Γ ξξξξξ©ξ¨ξξ¨ξξξξξ
Γ ξξξξξ©ξ¨ξξ¨ξξξξξξξ
Γ ξξξξξ©ξ¨ξξ¨ξξξξξξ
Γ ξξξξξ©ξ¨ξξ¨ξξξξξξξ
Γ ξξξξξ©ξ¨ξξ¨ξξξξξξξξ₯ξξ
Γ }
INFO: The lines of the signature are also Cr and Lf terminated.
ξξξξξξξSubscription
ξ¨ξ©ξͺξξ²ξξΈξξ³ξ²ξξξ·ξξξξξξξξξξξξξξξξ
ξξξξξξξξξ
ξξξξξξ
ξξξξξξξξξξξξξξξξξξξξξ
ξξξξξξ€ξξ
ξξξξξξξξξ
ξξξξξξξξξξξξξξξξξξξξξξ
changes.
ξ₯ξξξξξξξξ
ξξξξξξξξξξξξξξξξ
ξξξξξξξξξξΈξξξξξξξξξξ€ξξ
ξξξξξξξ
ξξξξ
ξξξξξξξξξξξξξξξξξ
ξξξξξ
ξξξξ
ξξξξξξξξξξξξξξξξξξ
the client application up to date, without having to periodically poll the node to detect a changed property.
ξ»ξξξξξξξξξξξξξξξξξξξξξξξξ
ξξξξξξξξξξξξξξξξξξξ
ξξξξξξξξξξξξ
ξξξξξξ
ξξξξξξξξξξξξξ
ξξξξξξξξξξξξξξξξξξξξξξξξξξ
the node.
ATTENTION! The subscriptions are handled separately for connections. Hence, if the connection is
terminated all registered subscriptions are deleted. After reopening a connection all subscribe commands
ξξ
ξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξ€ξξ
ξξξξξξξξξξξξξξξξ
ξξξξξξξξξξξ
ξξξξξξξξξξξξξ
Subscribe to a Node
Γ ξ³ξ΄ξ©ξ²ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³
Get the Active Subscriptions
Γ OPEN
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³
Γ ξξξξξ©ξ¨ξξ¨
Γ ξξξξξ¨ξξ·ξ§ξ³ξΊξ©ξΆξ½
Subscribe to Multiple Nodes
Γ ξ³ξ΄ξ©ξ²ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ
Unsubscribe from a Node
Γ ξ§ξ°ξ³ξ·ξ©ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³
Unsubscribe from Multiple Nodes
Γ ξ§ξ°ξ³ξ·ξ©ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ
ξξξξξξξξ²ξξξξ€ξξ
ξξξξξξξ
ξξξξξξξξξξ§ξξ
ξξξξξξξξξξξξξ΄ξξξξξξξξξ
ξ»ξξξξξξξξξξ
ξξξξξξξξ
ξξξξξξξξξξξξξξξξ
ξξξξξξ
ξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξ
ξξξξξ
ξξξ
ξξξξξξξξξξξξξξξξξ€ξξ
ξξξξξξξξξξξξξξ
ξξξξξξΈξξξξξξξξξξξξ€ξξ
ξξξξξξξξξξ
ξξξξξξ
ξξξξξξξ¬ξξξ
ξξξξξξξξξ
ξξξξξξΈξξξ
format of such a message is very similar to the response for the GET command:
Γ ξ§ξ¬ξ«ξξξ©ξ¨ξξ¨ξξ©ξξξξ·ξξ
ξξξξ‘ξͺξξξξ©ξ
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.
Γ ξ³ξ΄ξ©ξ²ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½
Γ ξ«ξ©ξΈξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξξ
ξξξξξξ΅ξξ
ξξξξξ±ξξξ
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½ξξ΅ξξ
ξξξξξ±ξξξξ‘ξξξ
ξξξξ
Γ ξ«ξ©ξΈξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξξ
ξξξξξξ΅ξξ
ξξξξξ±ξξξ
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½ξξ΅ξξ
ξξξξξ±ξξξξ‘ξξξ
ξξξξ
Γ ξ·ξ©ξΈξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξξ
ξξξξξξ΅ξξ
ξξξξξ±ξξξξ‘ξξξξξ
Γ ξξξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½ξξ΅ξξ
ξξξξξ±ξξξξ‘ξξξξξ
Γ ξ§ξ¬ξ«ξξξ±ξ©ξ¨ξξ₯ξξΊξξ¨ξ©ξ³ξξ΅ξΉξ₯ξ°ξξΈξ½ξξ΅ξξ
ξξξξξ±ξξξξ‘ξξξξξ
Explanation: ξΈξξξξ€ξξξξξξξξξξConnection #1) set a subscription to a node. Later the other user (Connection #2)
ξξ
ξξξξ
ξξξξ
ξξξξξξ
ξξξξξξ
ξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξξ€ξξξξξξξξξξξξξξ
ξξξξξξ€ξξ
ξξξξξξ
ξξξξξξξξξξξξ
ξξξξ
ξξξξξξξξLegend for the Control Commands
Format Description
ξ ξξξ’ Input port number
ξ ξξξξ’ Output port number
ξ ξξξξξ’ Input or output port number
ξ ξξξξ’ Location number
ξ ξξ
ξξ
ξξξξξξ’
ξΊξ
ξξξ
ξξξξξξξξξξξξξξξξξ€ξξξξξ
ξξξξξξξξξξξξξξξξξξξξ
command
ξ ξξξξξξξξξξξ’
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
}
}
ο
Έ