External Control Protocol; General Protocol Behavior - Shure DDS 5900 User Manual

External Control Protocol

The DIS-CCU features an Ethernet connection for the
purpose of providing an interface to control and monitor
the system. By setting up a simple (raw) TCP/IP socket
connection to the DIS-CCU Central Unit, control options are
available.
This section describes the TCP/IP raw socket protocol for
communicating with the DDS 5900 Discussion System.
This protocol provides a short set of commands, enabling
a third-party control application to monitor and/or control
system status of a DDS 5900 Discussion System.
Some examples of functionality available using the
protocol:

General Protocol Behavior

TCP/IP socket connection
A TCP/IP socket connection to the DIS-CCU must be
established for the External Control protocol to become
available. Configuration of the DIS-CCU connection to the
Ethernet must be defined from the CCU interactive front
plate control/Browser interface and an IP address for the
DIS-CCU must be assigned in the network.
Choose either a static IP address or an IP address
assigned through DHCP. It is convenient to ensure, that the
DIS-CCU ends up with the same IP address at each start
up.
Knowing the IP address, the only additional information
required for setting up a TCP/IP connection is the Port
Number:
Port Number = 3142
Example: Test connection to CCU via Putty
DIS-CCU is assigned IP address 192.168.1.100, the
external application must connect the TCP/IP socket
to the address 192.168.1.100:3142.
Knowing the IP address of the DIS-CCU a connection can
be set up using a simple terminal program like Putty.
1. Download at www.putty.org
2. Start Putty.
3. Insert IP address and Port Number.
4. Select 'Raw' for the Connection Type.
• Setting a microphone in speak or in request
• Retrieving a list of seats available in the system.
This interface supports applications developed by
customers, so the protocol is deliberately kept simple. The
External Control protocol offers a means for supplementing
the control functionality available through the DDS 5900
Browser interface and the DIS-CCU interactive display,
however some commands and settings available in the
browser interface and on the DIS-CCU interactive display
are not available using the 'External Control Protocol'
Customer applications can include but are not limited to
AMX or Crestron
®
controller based applications, e.g., for button mimics and
camera control applications.
5. Press 'Open' to establish connection to the CU. Control
is now possible.
6. Type 'help' to see a list of commands available.
Command Structure (from External
Control to DIS-CCU)
To control the CCU an External Control sends commands
to DIS-CCU included in command lines. Command lines
are build up in a very simple manner:
<command><SP><data><CR>
<command><SP><data><LF>
<SP>
<CR>
<LF>
Command lines are terminated by a Carriage Return
<CR> or Line Feed <LF> or both. In order to be able
: If the
®
to communicate with Windows systems, Linux systems
or other systems, the CCU understands both types of
command line terminations.
Notice also, there is a space between the command and
data. If a command does not carry any data, space is
possible but not required.
The CCU is not sensitive to upper/lower case.
Example:
mic_on 212<CR>
Turn on microphone at seat 212. Command = mic_on,
data = 212. The 'mic_on' command carries a seat number
as data.
72
room control systems, PC or micro
®
Space - 0x20 = 32
Carriage return - 0x0D = 13
Line Feed - 0x0A = 10
External Control Protocol