2-46
INSTALLATION
ORBAN MODEL 1100
Optimod-PC System/Mixer Control API
The OPTIMOD-PC Service application hosts a TCP/IP terminal server to allow external
control of the OPTIMOD-PC cards from either a Telnet/SSH client or a custom third
party application. All OPTIMOD-PC Mixer and System Controls are accessible and all
commands are simple text strings. Upon receiving valid commands, OPTIMOD-PC will
confirm by returning a simple text string status message. By implementing external
control this way, multiple OPTIMOD-PC cards can be controlled using standards-
based network protocols (that are not Microsoft Windows-specific) anywhere that
network connectivity is available.
To protect the Terminal Server from unauthorized remote access, the default setting
for the control “Use localhost only for Terminal Access” is enabled. In this case, only
Telnet/SSH connections from the local host address 127.0.0.1 on the default port
11101 are accepted. Disabling this will allow Telnet/SSH connections from other
computers, using the IP address of the host computer. This control is located in the
OPTIMOD-PC remote application in the
T
OOLS
>S
ERVICE
S
ETUP
dialog box and is ac-
cessible only when the application is disconnected from a Local card. The default
port can be changed here too.
Command
Function
enum
Retrieves serial numbers for each card installed in
the computer.
list
Retrieves control mnemonics and a verbose name
for each control.
header
Retrieves a C format header file for program
integration.
<serial> <[password]> <control>??
Retrieves all valid values for specified control.
<serial> <[password]> <control> ?
Retrieves current value for control on specified
card.
<serial> <[password]> <control> <value>
Sets new current value for control on specified
card.
<serial> <[password]> <preset> ??
Retrieves all available Presets.
<serial> <[password]> <preset> ?
Retrieves Active Preset.
<serial> <[password]> <preset> <name>
Sets Processing Preset.
disconnect
Disconnects Telnet/SSH connection.
Table 2-1: Telnet/SSH Command List
To control OPTIMOD-PC externally, establish a Telnet/SSH connection and issue
commands and parameters, either by typing them directly into a Telnet/SSH client or
by placing them within batch files. Then process them with a scriptable Telnet/SSH
client that supports this operation, such as PuTTY, along with its companion com-
mand-line interpreter, Plink. Both of these applications are available for free
download from the following web site:
http://www.chiark.greenend.org.uk/~sgtatham/putty/
Automating control changes is possible using the Windows Task Scheduler to launch
batch files at the desired time.
