Description:

This driver controls the Xantech XDT dual tuner component. This unit is often installed with Xantech multi-zone audio controllers to provide AM/FM sources. Normally, the RS-232 interface is tied directly to the Xantech devices which allows for tuner specific feedback at the Xantech touch pads. However, by interfacing the unit directly to CQC the tuner can be polled for status and manipulated directly through the CQC interface. This precludes pushing data directly from the Xantech controller to keypads, however in situations where CQC interfaces are used in preference to (or exclusive of) the Xantech keypads the direct control by CQC is highly preferred.

Quirks and Limitations:

The driver currently only supports installations of a single MRC-88. The “expanded” mode where the controller supports 16 zones and 8 sources is not supported, although implementing this in the future should be straightforward.

Connection Details

The device uses an RS-232 serial connection running at 19200bps, 8 data bits, no parity, one stop bit. The device is hard wired to run at these settings and cannot be configured. The physical connection uses a standard DB-9, straight -hrough serial cable from the PC to the device. Only three wires (TX, RX and ground) are used for communication (no handshaking.)

Driver Fields

This section lists the fields that the driver makes available. In some instances, a portion of the name has been omitted and replaced by an ‘X’ signifying either a zone or partition number. In these instances the driver creates one or more fields as required.

Name	Type	R/W	Description/Limits
Power	Bool	R/W	Indicates whether the component is powered on or not, can be set to turn power on (from standby) or off (not actually “off”, but to a standby state).
PresetTuner1	Card4	R/W	Indicates the current preset, or allows the current frequency to be changed to a predefined preset, for the indicated tuner.
PresetTuner2	Card4	R/W	Indicates the current preset, or allows the current frequency to be changed to a predefined preset, for the indicated tuner.
FreqTuner1	String	R	Provides an string for displaying the current station frequency for the indicated tuner.
FreqTuner2	String	R	Provides an string for displaying the current station frequency for the indicated tuner.
BandTuner1	String	R/W	Values of “AM” or “FM” indicate the current band for the indicated tuner.
BandTuner2	String	R/W	Values of “AM” or “FM” indicate the current band for the indicated tuner.
LockTuner1	Bool	R	Indicates where the tuner has a lock acquired on the signal at the current frequency.
LockTuner2	Bool	R	Indicates where the tuner has a lock acquired on the signal at the current frequency.
StereoTuner1	Bool	R	Indicates where the tuner is receiving a stereo signal at the current frequency.
StereoTuner2	Bool	R	Indicates where the tuner is receiving a stereo signal at the current frequency.
CommandTuner1	String	W	Sends a command to the indicate tuner. See the command values listed in the table below.
CommandTuner2	String	W	Sends a command to the indicate tuner. See the command values listed in the table below.

 The following command values can be passed to the CommandTuner1 and CommandTuner2 fields to control the tuner.

Command	Function
ON	Bring the component out of standby state.
OFF	Set the component into standby.
AM	Change the indicated tuner to ‘AM’ mode.
FM	Change the indicated tuner to ‘FM’ mode.
TUNEUP	Manually tune the frequency up.
TUNEDOWN	Manually tune the frequency down.
SEEKUP	Seek up the frequency spectrum to the next station.
SEEKDOWN	Seek down the frequency spectrum to the next station.
PRESETUP	Tune to the next station preset.
PRESETDOWN	Tune to the previous station preset
MONO	Switch to mono mode for FM signals.
STEREO	Switch to stereo mode for FM signals