Request AudioReQuest User manual

ReQuest Incorporated
ReQuest IncorporatedReQuest Incorporated
ReQuest Incorporated 100 Saratoga Village Blvd. #44 Ballston Spa, NY
Direct Line:518.899.1254 Support:800.236.2812 Facsimile:518.899.1251
AudioReQuest Crestron™ Interface Guide
Version
VersionVersion
Version 5.
5.5.
5.5
55
5.0
.0.0
.0
Control of 1 or more AudioReQuest™ devices from a Crestron control
system through RS232 or Ethernet

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
I -
Table of Contents
Revision History
Revision HistoryRevision History
Revision History................................
................................................................
................................................................
................................................................
................................................................
................................................................
.............................................
..........................
.............II
IIII
II
Crestron Install Checklist
Crestron Install ChecklistCrestron Install Checklist
Crestron Install Checklist................................
................................................................
................................................................
................................................................
...............................................................
..............................................................
...............................III
IIIIII
III
Introduction:
Introduction:Introduction:
Introduction:................................
................................................................
................................................................
................................................................
................................................................
................................................................
...................................................
......................................
...................1
11
1
Rear Serial Port Pinout (Male RS
Rear Serial Port Pinout (Male RSRear Serial Port Pinout (Male RS
Rear Serial Port Pinout (Male RS-
--
-232 Port)
232 Port)232 Port)
232 Port)................................
................................................................
................................................................
................................................................
..........................................................
....................................................
..........................1
11
1
Seria
SeriaSeria
Serial Cable Pinout (Female
l Cable Pinout (Femalel Cable Pinout (Female
l Cable Pinout (Female 

Female RS232 cable)
Female RS232 cable)Female RS232 cable)
Female RS232 cable)................................
................................................................
................................................................
................................................................
..........................................
....................
..........1
11
1
COM Settings
COM SettingsCOM Settings
COM Settings ................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
....................................
........
....1
11
1
Design Changes and New Features
Design Changes and New FeaturesDesign Changes and New Features
Design Changes and New Features................................
................................................................
................................................................
................................................................
................................................
................................
................3
33
3
Multiple Product Model Support
Multiple Product Model SupportMultiple Product Model Support
Multiple Product Model Support ................................
................................................................
................................................................
................................................................
.................................................
..................................
.................3
33
3
Single START
Single STARTSingle START
Single START-
--
-COMMUNICATIONS Signal
COMMUNICATIONS SignalCOMMUNICATIONS Signal
COMMUNICATIONS Signal ................................
................................................................
................................................................
................................................................
..................................
....
..3
33
3
Dual Module Design
Dual Module DesignDual Module Design
Dual Module Design ................................
................................................................
................................................................
................................................................
................................................................
................................................................
...................................
......
...3
33
3
Ethernet Control
Ethernet ControlEthernet Control
Ethernet Control................................
................................................................
................................................................
................................................................
................................................................
................................................................
.............................................
..........................
.............4
44
4
Customizing the Program
Customizing the ProgramCustomizing the Program
Customizing the Program................................
................................................................
................................................................
................................................................
...............................................................
..............................................................
...............................5
55
5
Adding Touch Panels
Adding Touch PanelsAdding Touch Panels
Adding Touch Panels ................................
................................................................
................................................................
................................................................
................................................................
................................................................
..................................
....
..5
55
5
Adding AudioReQuests
Adding AudioReQuestsAdding AudioReQuests
Adding AudioReQuests................................
................................................................
................................................................
................................................................
...............................................................
..............................................................
...............................7
77
7
Serial Control
Serial ControlSerial Control
Serial Control................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
......................................
............
......9
99
9
Ethernet Control
Ethernet ControlEthernet Control
Ethernet Control................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
.................................
..
.9
99
9
Complete List of Module Inputs and Outputs
Complete List of Module Inputs and OutputsComplete List of Module Inputs and Outputs
Complete List of Module Inputs and Outputs ................................
................................................................
...............................................................
..............................................................
...............................10
1010
10
Basic Module
Basic ModuleBasic Module
Basic Module –
––
– Inputs
InputsInputs
Inputs ................................
................................................................
................................................................
................................................................
..............................................................
............................................................
..............................10
1010
10
B
BB
Basic Module
asic Moduleasic Module
asic Module –
––
– Outputs
OutputsOutputs
Outputs................................
................................................................
................................................................
................................................................
............................................................
........................................................
............................12
1212
12
Advanced Module
Advanced ModuleAdvanced Module
Advanced Module –
––
– Inputs
InputsInputs
Inputs ................................
................................................................
................................................................
................................................................
.......................................................
..............................................
.......................14
1414
14
Advanced Module
Advanced ModuleAdvanced Module
Advanced Module –
––
– Outputs
OutputsOutputs
Outputs................................
................................................................
................................................................
................................................................
.....................................................
..........................................
.....................15
1515
15
Appendix A: Troubleshooting
Appendix A: TroubleshootingAppendix A: Troubleshooting
Appendix A: Troubleshooting................................
................................................................
................................................................
................................................................
........................................................
................................................
........................16
1616
16
A)
A)A)
A) Can’t establish 1
Can’t establish 1Can’t establish 1
Can’t establish 1-
--
-way serial communication:
way serial communication:way serial communication:
way serial communication: ................................
................................................................
......................................................
............................................
......................16
1616
16
B)
B)B)
B) I have one
I have oneI have one
I have one-
--
-way control but
way control butway control but
way control but I can’t get any feedback:
I can’t get any feedback:I can’t get any feedback:
I can’t get any feedback: ................................
................................................................
..........................................
....................
..........16
1616
16
C)
C)C)
C) Getting garbage text or lines not refreshing on Crestron Touch panels:
Getting garbage text or lines not refreshing on Crestron Touch panels:Getting garbage text or lines not refreshing on Crestron Touch panels:
Getting garbage text or lines not refreshing on Crestron Touch panels: ..............
............................
..............17
1717
17
D)
D)D)
D) The text is being
The text is beingThe text is being
The text is being drawn slowly on the touch screens:
drawn slowly on the touch screens:drawn slowly on the touch screens:
drawn slowly on the touch screens:................................
................................................................
.........................................
..................
.........17
1717
17
E)
E)E)
E) When I go into the ARQ pages on my touch panel nothing happens:
When I go into the ARQ pages on my touch panel nothing happens:When I go into the ARQ pages on my touch panel nothing happens:
When I go into the ARQ pages on my touch panel nothing happens:..................
....................................
..................17
1717
17
Appendix B: Using H
Appendix B: Using HAppendix B: Using H
Appendix B: Using Hyper Terminal:
yper Terminal:yper Terminal:
yper Terminal: ................................
................................................................
................................................................
................................................................
.............................................
..........................
.............18
1818
18

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
II -
Revision History
Revision Number Changes
4.0.2 Updated for 1.7.11, updated graphics
4.0.3 Updated for 1.7.5 (genre commands)
4.1.0 Updated for 1.8.1
4.1.5 Updated version number to match program version
number. No changes to document
4.5.0 Complete redesign
Added new 1.9.0 commands
4.5.1 Added POWER-ON and POWER-OFF to Basic
Module
4.5.5 Added info about single Start Comm signal
Minor formatting changes
5.0.0 Initial F-Series Version
5.5.0 Added support for cover art using Dynamic Graphics

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
III -
Crestron Install Checklist
Hardware Requirements
Hardware RequirementsHardware Requirements
Hardware Requirements
1) Crestron Processor and AudioReQuest Digital Music Server
2) If using an older (X Generation) processor, such as a CNMSX-Pro, it is HIGHLY recommended
that you install a COM card, such as a CNX COM-2. The internal COM ports on an XGen
processor do not have a large enough buffer to handle all of the data sent from an
AudioReQuest.
3) FemaleFemale NULL Modem serial cable if connecting serially (one ships with the ARQ). It
is HIGHLY recommended to use a cable that is no longer than 10ft to prevent ground
problems.
Hardware Configuration
Hardware ConfigurationHardware Configuration
Hardware Configuration
1) Install ARQ unit and Crestron processor in rack
2) Connect cables for control (NULL Modem Serial or Ethernet)
Software Requirements/Setup
Software Requirements/SetupSoftware Requirements/Setup
Software Requirements/Setup
1) Ensure that you have the all the latest SIMPL Windows and VTPro programs and components
installed. Don’t forget the SIMPL Windows Cross Compiler!
S
SS
Software Configuration
oftware Configurationoftware Configuration
oftware Configuration
1) Import the ReQuest demo program into SIMPL Windows using File
FileFile
File

Import Archived Program
Import Archived ProgramImport Archived Program
Import Archived Program
(see page 2 below for more info)
2) Select a control method (Ethernet or Serial). The demo is setup for Serial. If using Ethernet,
comment out the COM port, uncomment the TCP/IP client, and configure it with your
AudioReQuest’s IP address.
3) If integrating the AudioReQuest into an existing Crestron program, copy the logic from the
demo program to your program. Be sure to copy Digital, Analog, and Serial joins for the touch
screens. Modify the joins as necessary to fit into your system.
4) If using the ReQuest demo touch screen interfaces, open those in VTPro and modify as
necessary. Copy our screens to yours if integrating with an existing system
Client Name:
Client Name:Client Name:
Client Name: ________________________________
________________________________________________________________
______________________________________
____________
______Date Installed:
Date Installed:Date Installed:
Date Installed: _________________________________
Module Version:
Module Version:Module Version:
Module Version: Processor Type:
Processor Type:Processor Type:
Processor Type:________________________
________________________________________________
________________________
Number of ReQuests:
Number of ReQuests:Number of ReQuests:
Number of ReQuests: _______________________________
_
_______________________________________________________________
_
___________________________________
_
_
______
_
_
___Connection to ARQ:
Connection to ARQ:Connection to ARQ:
Connection to ARQ: Ethernet Serial

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
1 -
Introduction:
This document explains how to interface all models of AudioReQuest Digital Music Servers with Crestron
control systems using the AudioReQuest Crestron Demo Program version 5.5.0. It will not give a detailed
explanation of the protocol used to communicate with the AudioReQuest via Ethernet, Serial, or IR. For
this information, please download the Communication Protocol Guide from www.request.com.
Rear Serial Port Pinout (Male RS-232 Port)
Pin
PinPin
Pin Purpose
PurposePurpose
Purpose
1 Not Used
2 Receive
3 Transmit
4 Not Used
5 Ground
6-9
Not Used
Serial Cable Pinout (Female  Female RS232 cable)
Pin
PinPin
Pin (ARQ Side)
(ARQ Side)(ARQ Side)
(ARQ Side) Pin (Control Side)
Pin (Control Side)Pin (Control Side)
Pin (Control Side)
2 (Rx) 3 (Tx)
3 (Tx) 2 (Rx)
5
(GND) 5 (GND)
COM Settings
The rear serial port
rear serial portrear serial port
rear serial port is used for integrating the AudioReQuest with a control system. Connection to the rear
rearrear
rear
serial port
serial portserial port
serial port requires a Female
FemaleFemale
Female

Female NULL MODEM
Female NULL MODEMFemale NULL MODEM
Female NULL MODEM serial cable. The front serial port
front serial portfront serial port
front serial port is used ONLY
ONLYONLY
ONLY for
configuring certain settings on the AudioReQuest, such as the IP Address. You CANNO
CANNOCANNO
CANNOT
TT
T use the front
frontfront
front
serial port
serial portserial port
serial port to control the ARQ.
The Baud Rate depends on the model of AudioReQuest unit. The table below shows the breakdown.
Rear Serial Port
Rear Serial PortRear Serial Port
Rear Serial Port
(Single Zone Units)
(Single Zone Units)(Single Zone Units)
(Single Zone Units) Rear Serial Port
Rear Serial PortRear Serial Port
Rear Serial Port
(Multi Zone Units)
(Multi Zone Units)(Multi Zone Units)
(Multi Zone Units)
Parameter
ParameterParameter
Parameter Value
ValueValue
Value Parameter
ParameterParameter
Parameter Value
ValueValue
Value
Baud 9600 Baud 57600
Data Bits 8 Data Bits 8
Stop Bits 1 Stop Bits 1
Parity None Parity None
Flow Control None Flow Control None

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
2 -
W HAT T O D O F IRST :
Do Not Unzip The Demo Program You Download!!!
Do Not Unzip The Demo Program You Download!!!Do Not Unzip The Demo Program You Download!!!
Do Not Unzip The Demo Program You Download!!!
1. Download ARQConnect_Crestron_Demo_v5_5_0.zip from www.request.com.
2. Open SIMPL Windows.
3. Select Import Archived Program
Import Archived ProgramImport Archived Program
Import Archived Program from the File
FileFile
File pull-down menu
4. Click Browse
BrowseBrowse
Browse and find the zipped file you downloaded in step 1 above.
5. Click Start
StartStart
Start to import the file.
Following the above steps is CRITICAL to the success of your project. Although it is typically sufficient to
simply copy the files to the appropriate place on your hard drive, SIMPL Windows performs better when
the file is imported.
Importing the file will unzip the project, placing the .smw, .umc and .usp files in the appropriate places, and
open our demo program in SIMPL Windows. This program works as a complete solution with our touch
panel designs, which are also available on our website. If you choose to use our module in another
program, but you plan to use our panel designs, you MUST copy over the Subpage Logic subsystem in
order for the panels to work correctly. If you have any questions or problems, call [phone] for
further assistance.

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
3 -
Design Changes and New Features
In an effort to simplify integration between Crestron and AudioReQuest, ReQuest has made a number of
changes to the demo program, the ARQConnect module, and the demo touch screens. This section
describes the changes that have been made.
Multiple Product Model Support
ReQuest now has 3 main types of AudioReQuest unit: Single Zone (N.Series), 2 Output Multizone
(F2.Series), and 4 Output Multizone (F4.Series and S.Series). Using the ARQConnect Demo Program, you
can interface to any number of units of any type simply by changing the zone number on the module (more
on that later).
Single START-COMMUNICATIONS Signal
Previous versions of the demo program and touch screen interfaces contained 2 separate Start-
Communications signals: One for Ethernet (join 771) and one for Serial (join 772). These 2 signals have
been combined into 1 signal named ARQ-CONNECT (join 771). This allows you to switch between
Ethernet and Serial communications by simply moving the ARQ-CONNECT signal from the [START-
SERIAL-COMMUNICATIONS] input to the [START-ETHERNET-COMMUNICATIONS] input on the module.
For more information on using Ethernet, see the Ethernet Control
Ethernet ControlEthernet Control
Ethernet Control section on the next page.
Dual Module Design
From feedback received over the years, the realization is that integration with AudioReQuest can be quite
complicated, mainly because the module is large. Therefore, the module has been stripped of many of the
more advanced, less commonly used features. These features have been moved to a separate module.
For most installations, you will not need the advanced module, making integration much less confusing.
The advanced module “piggy-backs” on the basic module, utilizing it to communicate with the
AudioReQuest. Because of this design, the advanced module can not be used stand-alone without the
Basic Module. Both modules are included in the demo program to show how they are interconnected.
The picture below shows how the modules connect together.
Input/Output on Basic Module
Input/Output on Basic ModuleInput/Output on Basic Module
Input/Output on Basic Module Input/Output on Advanced Module
Input/Output on Advanced ModuleInput/Output on Advanced Module
Input/Output on Advanced Module
[ADVANCED-CMD-IN$] [REQUEST-ADVANCED-TX$]
[ADVANCED-CMD-OUT$] [REQUEST-ADVANCED-RX$]
Figure 1

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
4 -
Ethernet Control
The demo program provided by ReQuest includes a commented out TCP/IP client that is ready to use.
In order to control AudioReQuest with Ethernet:
1. Uncomment the TCP/IP client that is already in our demo program
(Slot
SlotSlot
Slot-
--
-08
0808
08, IP
, IP, IP
, IP-
--
-ID
IDID
ID-
--
-0
00
04
44
4).
2. Verify that the TCP/IP client is configured as shown in the figure below.
3. Switch to Configure view and set the IP address of the TCP/IP client to the IP address of your
AudioReQuest. You can find the IP by going to Menu
MenuMenu
Menu

System Information
System InformationSystem Information
System Information on the AudioReQuest.
4. Switch back to Program View and delete the AUDIO
AUDIOAUDIO
AUDIO-
--
-REQUEST
REQUESTREQUEST
REQUEST-
--
-RX$
RX$RX$
RX$ and AUDIO
AUDIOAUDIO
AUDIO-
--
-REQUEST
REQUESTREQUEST
REQUEST-
--
-TX$
TX$TX$
TX$
signals going to the COMM Port (Slot
SlotSlot
Slot-
--
-04, Port
04, Port04, Port
04, Port-
--
-A
AA
A).
Cover Art on Supported Panels
With the addition of Dynamic Graphics on newer Crestron panels, you can now get cover art images on
your touch panel without the need for a video input.
1. Open the Advanced Module into detail view
2. At the bottom of the module, set the IP_ADDRESS
IP_ADDRESSIP_ADDRESS
IP_ADDRESS and WEB
WEBWEB
WEB-
--
-PORT
PORTPORT
PORT parameters to the ip address
and web port of your AudioReQuest
3. Set the cover art modes for the size of image you wish to receive
1d
1d1d
1d: Large Image (170 x 170 pixels)
default
defaultdefault
default
2d
2d2d
2d: Small Image (75 x 75 pixels)
4. Connect the serial outputs from the module to the appropriate serial joins on the panels that will
display the images (see image below for more info)
Figure 2

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
5 -
Figure 4
Customizing the Program
Adding Touch Panels
To simplify customization of the program, we have added templates for the Touch Screens and Panel
Specific Logic folders. The demo program has eight
eighteight
eight 2-way panels already in it. If you wish to add more
panels, you can use the templates to make it easier.
NOTE: You may find it easier to delete all but one AudioReQuest Zone subsystem, add the new panel
logic, then add back in the ARQ Zone logic folders.
To add another touch screen:
To add another touch screen:To add another touch screen:
To add another touch screen:
1. Add your new touch screen to the system in Configure
View.
2. Under Program View, locate ID
IDID
ID-
--
-FE : TPS Touch panel. :
FE : TPS Touch panel. :FE : TPS Touch panel. :
FE : TPS Touch panel. :
{Panel_TEMP}
{Panel_TEMP}{Panel_TEMP}
{Panel_TEMP} (Figure 3
Figure 3Figure 3
Figure 3).
3. Right-Click AND HOLD
AND HOLDAND HOLD
AND HOLD on the TEMPLATE
TEMPLATETEMPLATE
TEMPLATE.
4. Move the mouse over top of the new touch panel
5. Release the mouse button.
6. Select Copy all signals and parameters
Copy all signals and parametersCopy all signals and parameters
Copy all signals and parameters from the menu
that pops up (Figure 4
Figure 4Figure 4
Figure 4). This will copy all the Digital,
Analog, and Serial signals from the template to your
new touch screen.
All of the signals for the touch screens have a suffix that
distinguishes that screen from the others. This is used
to isolate one panel from another. The template has the
suffix
{
{{
{Panel_
Panel_Panel_
Panel_TEMP
TEMPTEMP
TEMP}
}}
} on all signals. The next steps will
walk you through changing this. You will need to use a
unique suffix for each new touch screen you add. In the
demo, we use
{Panel_A}
{Panel_A}{Panel_A}
{Panel_A} through {Panel_
{Panel_{Panel_
{Panel_H
HH
H}
}}
} . If you add
panels, you could start with
{Panel_
{Panel_{Panel_
{Panel_I
II
I}
}}
} and continue
alphabetically from there (Panel_
Panel_Panel_
Panel_J
JJ
J, Panel_
Panel_Panel_
Panel_K
KK
K, etc.).
7. Select the new touch screen in Program View and press F9
F9F9
F9 on your
keyboard to begin a Search and Replace
Search and ReplaceSearch and Replace
Search and Replace.
8. Search for Panel_TEMP
Panel_TEMPPanel_TEMP
Panel_TEMP and replace it with the suffix you decided to
use above.
Figure 3

AudioReQuest Crestron Interface Guide v5.5.0
Phone [phone] •Fax [phone] •www.request.com
-
6 -
The next step is to create the Panel
PanelPanel
Panel Logic
LogicLogic
Logic folder for the new panel.
9. Select the S
SS
S-
--
-1.
1.1.
1.3
33
3.10 : {Panel_TEMP}
.10 : {Panel_TEMP}.10 : {Panel_TEMP}
.10 : {Panel_TEMP} subsystem and press Ctrl
CtrlCtrl
Ctrl-
--
-C
CC
C on your keyboard.
10. Select the S
SS
S-
--
-1.
1.1.
1.3
33
3 :
::
: Panel Logic
Panel LogicPanel Logic
Panel Logic subsystem and press Ctrl
CtrlCtrl
Ctrl-
--
-V
VV
V.
11. Uncomment the newly copied subsystem.
12. Select the newly copied subsystem and press F9
F9F9
F9 on your keyboard.
13. Search for Panel_TEMP
Panel_TEMPPanel_TEMP
Panel_TEMP and replace it with the same as in Step 8 on the previous page.
You must also create the Panel Specific Logic
Panel Specific LogicPanel Specific Logic
Panel Specific Logic in each zone
each zoneeach zone
each zone for the new panel.
14. Select S
SS
S-
--
-1.
1.1.
1.4.
4.4.
4.2.
2.2.
2.2.
2.2.
2.10
1010
10 :
::
: {
{{
{Panel_
Panel_Panel_
Panel_TEMP}
TEMP}TEMP}
TEMP} subsystem and press Ctrl
CtrlCtrl
Ctrl-
--
-C
CC
C on your keyboard.
15. Select S
SS
S-
--
-1.
1.1.
1.4
44
4.2
.2.2
.2.2
.2.2
.2 :
::
: Panel Specific Logic f
Panel Specific Logic fPanel Specific Logic f
Panel Specific Logic for This Zone
or This Zoneor This Zone
or This Zone subsystem and press Ctrl
CtrlCtrl
Ctrl-
--
-V
VV
V. This will create
S
SS
S-
--
-1.
1.1.
1.4.2
4.24.2
4.2.2
.2.2
.2.11 : {Panel_TEMP}
.11 : {Panel_TEMP}.11 : {Panel_TEMP}
.11 : {Panel_TEMP}.
16. Uncomment the newly copied subsystem.
17. Select the newly copied subsystem and press F9
F9F9
F9 on your keyboard.
18. Search for Panel_T
Panel_TPanel_T
Panel_TEMP
EMPEMP
EMP and replace it with the same as in Step 8 on the previous page.
19. Repeat steps 14-18 above for ALL remaining {ZONE_XX}
{ZONE_XX}{ZONE_XX}
{ZONE_XX} subsystems.
Figure 5
Figure 6