ClearOne StreamNet Integration - Manual (Page 17)

Chapter 3: ASCII Overview 11
Arguments have the following formats:
• meaningful Strings – These are labels which represent some value, case, or function. Examples of
meaningful strings are ON and OFF. Meaningful strings are not enclosed in quotation marks and must
begin with an alphabetic character – not a numeral.
• Character Literals – These character strings do not need any special delimiters if they contain
no blanks, spaces, commas, or other special characters. (A special character is other than alpha/
numeric).
NOTE f : If an argument contains any special characters or spaces, it must be enclosed
between double braces {{......}}. When in doubt, use the double braces.
• Numeric Scalars – These must be a decimal number.
• XmL or other Special Formats - These arguments are enclosed in double braces {{...}} and can
take any form depending on context.
/0 (
Null byte
)
All ASCII messages must end with a 0x00 byte (null).
UniqueID (UID)
The UID of a service is an unchangeable identifier for the service. It is based upon the device’s serial number.
The UID will be the service name if none has been specified during configuration. It will also be used as the
service’s room name if none has been specified. Normally, there is no reason for an integrator to use the UID.
All services should be assigned names and all of the user’s commands should be addressed to those service
names (or room/group names).
The structure of the UID is serialNumber_index where serialNumber is the Serial Number of the device and
index is an integer that identifies the specific Service on the device.
Example: #@mLA10105151001161008019_
4
serialNumber index
Summary
The 3rd Party Controller sends an ASCII message UDP to the IP address of any StreamNet device.
In the ASCII message, you should have the:
#@toAddress • - name of the service you are addressing.
: • fromAddress - your own IP Address with a Port number to receive responses.
The • :fromAddress - your IP Address/Port and all responses will be sent to this address.
#ASCII • command with appropriate arguments required by that command.