                  Switcher Application Notes for Rivendell

The following devices are supported as switchers under Rivendell:

360 Systems AM-16/B Audio Crosspoint Switcher
Broadcast Tools 10x1 Audio Switcher
Broadcast Tools 16x1 Audio Switcher
Broadcast Tools 16x2 Audio Switcher
Broadcast Tools 8x2 Audio Switcher
Broadcast Tools GPI-16 General Purpose Input Module
Broadcast Tools Sentinel 4 Web AES Switcher
Broadcast Tools SS 12.4 Audio Switcher
Broadcast Tools SS 16.4 Audio Switcher
Broadcast Tools SS 4.2 Audio Switcher
Broadcast Tools SS 4.4 Audio Switcher
Broadcast Tools ACS 8.2 Audio Control Switcher
Broadcast Tools SS 8.2 Audio Switcher
Harlond Virtual Mixer
LiveWire LWRP Audio
LiveWire LWRP GPIO
LiveWire Multicast GPIO
Local Audio Adapter
Logitek vGuest
Quartz Electronics Type 1 Routing Protocol
Serial Port Modem Control Lines
Sierra Automated Systems 16000(D) Audio Router
Sierra Automated Systems 32000 Audio Router
Sierra Automated Systems 64000 Audio Router
Sierra Automated Systems User Serial Interface (USI)
Sine Systems ACU-1 (Prophet version)
Software Authority Protocol
StarGuide III Satellite Receiver
Wegener Unity4000 DVB Satellite Receiver

See the sections below for notes on each specific model.

----------------------------------------------------------------------------
360 SYSTEMS AM-16/B AUDIO CROSSPOINT SWITCHER

Driver Name: 360 Systems AM-16/B

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of MIDI connections to the 'MIDI IN' and
'MIDI OUT' ports on the back of the unit, with the appropriate MIDI device
specified in the 'Device:' field in RDAdmin->ManageHosts->Switchers/GPIO.
The following settings should be configured on the AM-16/B:

       Control Port Type: MIDI (jumper JMP1)
       Program Send: OFF
       Receive Channel: o (Omni mode)
       Memory Protect: OFF

The driver uses MIDI programs '0' and '1' on the AM-16/B when processing
crosspoint changes; anything previously saved in those programs will
be overwritten!


----------------------------------------------------------------------------
BROADCAST TOOLS 10x1

Driver Name: BroadcastTools 10x1

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 2400 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.


----------------------------------------------------------------------------
BROADCAST TOOLS 16x1

Driver Name: BroadcastTools 16x1

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 9600 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.


Driver Name: BroadcastTools 16x2

Supported RML Commands:
  Switch Take ('ST')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 9600 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.

Operation in 'multidrop' mode is not supported.


----------------------------------------------------------------------------
BROADCAST TOOLS 8x2

Driver Name: BroadcastTools 8x2

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 2400 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.

The 8x2 should be configured to use 'Mix' mode.  This can be done by holding
down the F1 button on the switcher while powering up.

Operation in 'multidrop' mode is not supported.


----------------------------------------------------------------------------
BROADCAST TOOLS GPI-16 General Purpose Input Module

Driver Name: BroadcastTools GPI-16

Supported RML Commands:
  GPI Enable ('GE')
  GPI Set ('GI')

GENERAL NOTES:
Control is done by means of a serial connection to the unit's integrated
serial port.  There is also a 'plus' version that features an integrated
type B USB interface that simulates a serial port.

The unit should work correctly with factory default settings.  The Rivendell
serial interface should be set to use 9600 bits/sec, 8 bits, 1 stop bit and
no flow control.


----------------------------------------------------------------------------
BROADCAST TOOLS SENTINEL 4 WEB AES SWITCHER

Driver Name: BroadcastTools Sentinel 4 Web

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of a TCP/IP connection to the unit's integrated
Ethernet port.

On the 'Email/Network Setup' page of the unit, be sure that the 'TCP Enabled'
box is checked and that 'TCP Listen Port' is set to the same number as is
used in the 'IP Port' setting in Rivendell's driver configuration
('56' by default).


----------------------------------------------------------------------------
BROADCAST TOOLS SS 12.4

Driver Name: BroadcastTools SS 12.4

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 9600 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.

The SS 12.4 should be configured to use 'Mix' mode.  This can be done 
by setting DIP switches SW1-7 and SW-1-3 to OFF.

Operation in 'multidrop' mode is not supported.


----------------------------------------------------------------------------
Driver Name: BroadcastTools SS 16.4

Supported RML Commands:
  GPO Set ('GO')
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
parameters should be set to 9600 baud rate, no parity, 8 data bits, 1
stop bit, CR/LF termination.

A total of 24 GPO outputs are supported, with the relays appearing as
GPO lines 1-8 and the open collector outputs as lines 9-24.  All 24
'PIP' inputs are supported as GPI devices.

The SS 16.4 should be configured to use 'Mix' mode and to have 'PIP'
mode enabled.  This can be done by setting DIP switches SW24-5, SW24-6 
and SW24-8 to ON.

Operation in 'multidrop' mode is not supported.


----------------------------------------------------------------------------
BROADCAST TOOLS SS 4.2

Driver Name: BroadcastTools SS4.2

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
speed on the SS 4.2 should be set to 9600 (DIP switches SW13-3 and
SW13-4 set to 'off').  Serial port parameters in RDAdmin should be set
to 9600 baud rate, no parity, 8 data bits, 1 stop bit, CR/LF termination.

The SS 4.2 should be configured to use 'Mix' mode --i.e. DIP switches
SW13-5 and SW13-6 should both be 'on', and the unit ID should be set to
'0', with DIP switches SW13-1 and SW13-2 both 'off'.

Operation in 'multidrop' mode is not supported.  If you wish to use
GPI (referred to as 'PIP', for 'Parallel Input Port' in the Broadcast 
Tools documentation), then you will also need to be sure that DIP
switch SW13-7 is ON.


----------------------------------------------------------------------------
BROADCAST TOOLS SS 4.4

Driver Name: BroadcastTools SS4.4

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
speed on the SS 4.4 should be set to 9600 (DIP switch SW3 set to 'off').
Serial port parameters in RDAdmin should be set to 9600 baud rate, no parity,
8 data bits, 1 stop bit, CR/LF termination.

The SS 4.4 should be configured to use 'Mix' mode --i.e. DIP switches
SW4 and SW5 should both be 'on', and the unit ID should be set to
'0', with DIP switches SW1 and SW2 both 'off'.

Operation in 'multidrop' mode is not supported.  If you wish to use
GPI (referred to as 'PIP', for 'Parallel Input Port' in the Broadcast 
Tools documentation), then you will also need to be sure that DIP
switch SW8 is 'on'.  If you wish to use the open collector and relay outputs
as GPO, then you will also need to be sure that DIP switch SW6 is 'off'.


----------------------------------------------------------------------------
BROADCAST TOOLS ACS 8.2

Driver Name: BroadcastTools ACS8.2

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  Switch Level ('SL') [Output #1 only]
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
speed on the ACS 8.2 should be set to 9600.  Serial port parameters 
should be set to 9600 baud rate, no parity, 8 data bits, 1 stop bit, 
no termination.

The ACS 8.2 should be configured to use 'Mix' mode --i.e. DIP switches
SW17-5 and SW17-6 should both be 'on', and the unit ID should be
'0', with DIP switches SW17-1 and SW17-2 both 'off'.

Operation in 'multidrop' mode is not supported.  If you wish to use
GPI (referred to as 'PIP', for 'Parallel Input Port' in the Broadcast 
Tools documentation), then you will also need to be sure that DIP
switch SW17-10 is ON.

The ACS 8.2 supports the Switch Level [SL] RML for connections to
Output 1.  Six different gain levels are supported:  0 dB, -3 dB, 
-6 dB, -10 dB, -15 dB and -20 dB.  For for a specified gain level of
greater than or equal to -20, the applied gain will be rounded down 
to the next supported level.  For gain levels of less than -20 dB, the
minimum supported gain (-20 dB) will be applied.


----------------------------------------------------------------------------
BROADCAST TOOLS SS 8.2

Driver Name: BroadcastTools SS8.2

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to a four pin RJ11
modular jack on the back of the unit (an adapter to a standard DB9
connector is supplied by Broadcast Tools with the unit).  Serial port
speed on the SS 8.2 should be set to 19200 (some have found 9600 to work
instead).  Do *not* use 38400, as there are known bugs within the SS 8.2
when used with this speed!  Serial port parameters should be set to
19200 baud rate (or 9600 if that worked instead), No parity, 8 data
bits, 1 stop bit, CR/LF termination (or potentially no termination).

The SS 8.2 should be configured to use 'Mix' mode --i.e. DIP switches
SW-14-4 and SW-14-5 should both be 'on', and the unit ID should be
'0', with DIP switches SW-14-1, SW-14-2 and SW-14-3 all 'off'.

Operation in 'multidrop' mode is not supported.  If you wish to use
GPI (referred to as 'PIP', for 'Parallel Input Port' in the Broadcast 
Tools documentation), then you will also need to be sure that DIP
switch SW-14-10 is ON.


----------------------------------------------------------------------------
Harlond Virtual Mixer

Driver Name: Harlond Virtual Mixer

Supported RML Commands:
  Fire Salvo ('FS')
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')
  Switch Add ('SA')
  Switch Level ('SL')
  Switch Remove ('SR')
  Switch Take ('ST')

GENERAL NOTES:
Control is by means of a TCP/IP connection to port 5002.  Output busses are
mapped as follows:

OUTPUT  BUSS
------  ----
   1    PGM
   2    AUD
   3    UTL
   4    CUE

Input channel ON/OFF is sensed/controlled by means of the respective GPIO
number using GE/GI/GO RMLs.


----------------------------------------------------------------------------
LiveWire LWRP Audio

Driver Name: LiveWire LWRP Audio

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
LiveWire is a distributed audio router and control system, with the 
components (called 'nodes') configured and controled via TCP/IP.  More
information can be found at http://www.axiaaudio.com/.

This driver can be used to create and remove connections between audio
sources and destinations via LiveWire Routing Protocol (LWRP).

Configuration is a matter of entering the IP address, password and base
output number for each node in 
RDAdmin->ManageHosts->Switcher/GPIO->LiveWire Nodes.  The driver
will autodetect all other parameters from the nodes themselves.  The
resulting constellation of nodes can be controled with the 'Switch Take'
['ST'] RML by specifying the LiveWire source stream number as the <input>
parameter and the the base output number+the slot number-1 for the <output>
parameter.


----------------------------------------------------------------------------
LiveWire LWRP GPIO

Driver Name: LiveWire LWRP GPIO

Supported RML Commands:
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
LiveWire is a distributed audio router and control system, with the 
components (called 'nodes') configured and controled via TCP/IP.  More
information can be found at http://www.axiaaudio.com/.

This driver can be used to control LiveWire's GPIO subsystem by means of
the LiveWire Routing Protocol (LWRP) with both physical as well as 'virtual'
GPIO devices.

Only two items need to be specified in the configuration: the IP address
of the device to control and the 'Layer', with 'V' specifying a virtual
GPIO device and 'D' specifying an actual physical one.  The driver
will autodetect all other parameters (e.g. the number of input and output
lines) from the device itself.


----------------------------------------------------------------------------
LiveWire Multicast GPIO

Driver Name: LiveWire Multicast GPIO

Supported RML Commands:
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')

GENERAL NOTES:
LiveWire is a distributed audio router and control system, with the 
components (called 'nodes') configured and controled via TCP/IP.  More
information can be found at http://www.axiaaudio.com/.

This driver provides the ability to access GPIO functions from LiveWire-
enabled control surfaces for setups that lack a virtual GPIO device --e.g.
when interfacing audio directly to a LiveWire node without using a native
LiveWire software audio driver or audio adapter.

When configuring it, the 'IP Address' field should contain the address
of the local interface to which the LiveWire network is attached, while
the 'LiveWire GPIOs' list should be populated with the stream number - GPIO
line associations to be used.


----------------------------------------------------------------------------
Driver Name: Local Audio Adapter

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  Switch Add with Gain ('SX')

GENERAL NOTES:
It's possible to use one or more of the actual audio adapters as a
switcher device using this driver.  Doing so makes it possible to
route audio directly from the adapter inputs to outputs, while at the
same time using it for audio capture/playout in the usual manner.


Driver Name: Logitek vGuest

Supported RML Commands:
  GPI Enable ('GE')
  GPI Set ('GI')
  GPO Set ('GO')
  Set Display ('SD')
  Switch Take ('ST')

GENERAL NOTES:
Before using the driver, the resources within the Logitek Audio Engine
system that you wish to control must be made available in a 'vGuest'
account within the Logitek 'Supervisor' system.  Then, those same
resources must be mapped within the Rivendell driver.  For the 'ST'
RML, the Logitek Engine Numbers and Device Numbers are mapped to 
logical Rivendell 'Inputs' and 'Outputs' within the 'Configure Inputs' 
and 'Configure Outputs' dialogs.  For the GPO RMLs, various Logitek
'switches' (by which we mean anything that can be turned on and off,
such as faders feeds, not just GPIO) are mapped to logical Rivendell
GPIO lines by means of their Logitek Engine, Device and Buss numbers.


----------------------------------------------------------------------------
Quartz Electronics Type 1 Routing Protocol

Driver Name: Quartz Type 1

Supported RML Commands:
  Switch Take ('ST')
  Fire Salvo ('FS')

GENERAL NOTES:
Control can done either by means of an RS-232C connection or by means of
TCP/IP to TCP port 23.


----------------------------------------------------------------------------
SERIAL PORT MODEM CONTROL LINES

Driver Name: Serial Port Modem Control Lines

Supported RML Commands:
  GPO Set ('GO')

GENERAL NOTES:
This driver enables GPIO via the modem control lines on an RS-232C serial
device.  The lines map as follows:

 GPI  SIGNAL
 -------------------------------
  1   Data Set Ready      (DSR)
  2   Clear To Send       (CTS)
  3   Carrier Detect      (CI)
  4   Ring Indicator      (RI)

 GPO  SIGNAL
 -------------------------------
  1   Data Terminal Ready (DTR)
  2   Ready To Send       (RTS)


----------------------------------------------------------------------------
SIERRA AUTOMATED SYSTEMS 16000(D) AUDIO ROUTER

Driver Name: SAS 16000(D)

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Both analog and AES3 digital (D) variants are supported.  Control can done
by means of an RS-232C connection to the 'User Serial Interface' port on
the unit.  Serial port parameters should be:

Baud Rate: 9600
Parity: None
Data Bits: 8
Stop Bits: 1
Terminator: None


----------------------------------------------------------------------------
SIERRA AUTOMATED SYSTEMS 32000 AUDIO ROUTER

Driver Name: SAS 32000

Supported RML Commands:
  Switch Take ('ST')
  Switch Add ('SA')
  Switch Remove ('SR')
  Switch Level ('SL')  [requires appropriate SAS hardware support]

GENERAL NOTES:
Control is done by means of an RS-232C connection to the 'Computer
RS-232' port on the AXC-8 System Controller.  Serial port parameters
should be set to 9600 baud rate, no parity, 8 data bits, 1 stop bit
and no terminator.  The AXC-8 must be equipped with firmware built to
use the 'conventional' command protocol -- the 'enhanced' version will
not work!


----------------------------------------------------------------------------
SIERRA AUTOMATED SYSTEMS 64000 AUDIO ROUTER

Rivendell contains two drivers that support this switcher, depending
upon how the physical connection is made.  If possible, use the 'SAS
64000-GPI' driver, as it is better tested and provides superior
performance.

Driver Name: SAS 64000

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to the 'Computer
RS-232' port on the AXC-8 System Controller.  Serial port parameters
should be set to 9600 baud rate, no parity, 8 data bits, 1 stop bit
and no terminator.  The AXC-8 must be equipped with firmware built to
use the 'conventional' command protocol -- the 'enhanced' version will
not work!

Driver Name: SAS 64000-GPI

Supported RML Commands:
  Switch Take ('ST')
  GPO Set ('GO')

GENERAL NOTES:
Control is done by means of an RS-232C connection to the 'Computer
RS-232' port on a GPI-1600 GPIO interface.  Serial port parameters
should be set to 19200 baud rate, no parity, 8 data bits, 1 stop bit
and no terminator.  This driver allows control of the system's GPO
outputs as well as audio crosspoints.


----------------------------------------------------------------------------
SIERRA AUTOMATED SYSTEMS User Serial Interface (USI)

Driver Name: SAS USI

Supported RML Commands:
  Switch Take ('ST')
  Switch Take With Gain ('SG')
  Switch Add ('SA')
  Switch Remove ('SR')
  Switch Level ('SL')
  Switch Crosspoint Gain ('SX')
  GPO Set ('GO')
  Fire Salvo ('FS')
  Console Label ('CL')

GENERAL NOTES:
Control can done either by means of an RS-232C connection to one of
the serial ports on a DRC-16E card or by means of TCP/IP to a PC
running SAS's Server Module software.  TCP connections are normally made
to port 1350 on the Server Module system.


----------------------------------------------------------------------------
SINE SYSTEMS ACU-1 (PROPHET VERSION)

Driver Name: Since ACU-1 (Prophet)

Supported RML Commands:
  Switch Add ('SA')
  Switch Remove ('SR')
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to the  RS-232 port on
the unit.  Serial port parameters in RDAdmin should be set to 57600 baud
rate, even parity, 8 data bits, 1 stop bit and no terminator.

The ACU-1 should be set to use factory default settings.  This can be done
by simultaneously pressing buttons 1 and 8 on the front panel of the unit
for at least one second.


----------------------------------------------------------------------------
SOFTWARE AUTHORITY PROTOCOL

Driver Name: Software Authority Protocol

Supported RML Commands:
  Switch Take ('ST')
  GPO Set ('GO')

GENERAL NOTES:
Used to control devices (such as the Axia 'PathFinder' system) by means of
the 'Software Authority' protocol.  Control is by means of a
TCP/IP connection (typically to port 9500) on the controled system.  The 'Card'
parameter should be set to the 'Router Number' of the router to be controlled.

Most parameters, including the number of inputs and outputs as well as the
endpoint names, are autodetected by the driver.


----------------------------------------------------------------------------
STARGUIDE III Satellite Receiver

Driver Name: StarGuide III

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to the
RS-232 port on the unit.  The port should be configured on the
receiver to use a speed of 9600.  Serial port parameters in RDAdmin
should be set to 9600 baud rate, no parity, 8 data bits, 1 stop bit
and no terminator.  Once configured, use RDAdmin to create inputs that
correspond to the StarGuide Provider and Source IDs available on the 
selected DVB carrier.  Provider and Source ID data is available from
the provider network.


----------------------------------------------------------------------------
WEGENER UNITY4000 DVB SATELLITE RECEIVER

Driver Name: Wegener Unity 4000

Supported RML Commands:
  Switch Take ('ST')

GENERAL NOTES:
Control is done by means of an RS-232C connection to one of the two
RS-232 ports on the unit.  If possible, use serial port number one,
as the reciever uses a larger data buffer with that port.  The
selected port should be configured in the reciever to be of type
"Terminal" with a speed of 19200.  Serial port parameters should be
set to 19200 baud rate, no parity, 8 data bits, 1 stop bit
and no terminator.  Once configured, use RDAdmin to create inputs that
correspond to the DVB stream names available on the selected DVB
carrier.

Caution is needed when scheduling record events from the Unity4000, as
the unit is capable of outputting a given DVB stream to only a single 
output at a time.  Commanding a stream to an output will cause that 
stream to be silently deselected from a previously selected output.


----------------------------------------------------------------------------
