Rivendellaudio/docs/SWITCHERS.txt
Fred Gleason 888711270d 2015-05-28 Fred Gleason <fredg@paravelsystems.com>
* Added an 'RDMatrix::RossNkScp' value to the 'RDMatrix::Type'
	enumeration in 'lib/rdmatrix.cpp' and 'lib/rdmatrix.h'.
	* Implemented a switcher driver for the Ross NK line of video
	switchers via the SCP/A serial interface in 'ripcd/rossnkscp.cpp'
	and 'riptcd/rossnkscp.h'.
2015-05-29 07:13:05 -04:00

738 lines
24 KiB
Plaintext

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
Ross NK Video Switchers (via SCP/A Serial Interface)
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.
----------------------------------------------------------------------------
Ross NK Video Switchers (via SCP/A Serial Interface)
Driver Name: Ross NK-SCP/A Interface
Supported RML Commands:
Switch Take ('ST')
GENERAL NOTES:
Control is done by means of an RS-232C connection to a NK-SCP/A serial
interface. Serial port parameters should be set to 9600 baud rate, no parity,
8 data bits, 1 stop bit, CR termination. The Breakaway to use is defined
by setting the 'Card' parameter in the driver configuration, with
Card 0 = Breakaway 1, Card 1 = Breakaway 2, etc.
----------------------------------------------------------------------------
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.
----------------------------------------------------------------------------