ClearOne StreamNet Integration - Manual (Page 16)

10 Technical Sales: 1.800.705.2103
Subnode
A subnode address is part of the ASCII command address. It can be part of the TO or FROM address. A
subnode address is a special address modifier which instructs the node where to forward the command once
it is received. Sometimes the subnode address indicates that the service should forward the command to a
non-StreamNet device.
Examples:
~IRmOD • : forwards the command to the device which is providing the IR I/O functions to the StreamNet
service.
~UDP192.168.5.3_5000
• : forwards the command using UDP to the specified IP address and port
5000. The subnode address may refer to a StreamNet device with an address unknown to the
sender.
StreamNet Subnode Addresses:
• ~CURSRC Route to renderers current audio source
• ~IRmOD Route to IR module on MediaLinX
• ~SERIAL_X Route to serial port number X
• ~KEyPAD Route to KeyLinX module
• ~ROOT Route to root service on device
• ~STATUS Not used to route to, but rather to indicate a status message
• ~SUbSCRIbER indicates the route to subscribers
:fromAddress
:fromAddress indicates which entity sent the message. This is used by the recipient to address any response
that may be generated by the message. If a response is expected, then the fromAddress should specify the
address the response should be sent to. The : symbol must precede all fromAddress fields. The fromAddress
may have a subnode address.
For 3rd Party Controllers using UDP, it is recommended that the fromAddress resemble the following format:
~UDP192.168.5.3_5000
This includes the IP address and port to which any response should be sent.
%modifier
Optional field. May be used for various context specific purposes. If the recipient does not support the particular
modifier, the field may be ignored. There may be any number of %modifier fields in a message. The % symbol
precedes all modifier fields.
NOTE f : This field is reserved for future use in StreamNet.
#keyword (aSCII C
ommaNd
)
Required field. This is the keyword that specifies the action to be executed. The # symbol precedes all keyword
fields (no intervening spaces). The keyword is one word and contains no spaces, commas, or other special
characters except the underscore “_”.
arg1, arg2, ..., arg#
Optional field (some keywords may require arguments). The keyword may be followed by arguments. There
are one or more spaces between the keyword and the first argument and a comma between each additional
argument. Arguments are separated by commas and any extra white space should be ignored.