Rotel RA-1572, RA-1572MKII Controller Command List

Rotel RA-1572 /RA-1572MKII
Baud Rate
Parity
Valid Data Bits
Stop Bit Value
Handshaking
Data Type
115200
N 8 1
None
String
Date
Version
Update Description
August 27, 2018
1.00
Original Specification
January 2, 2019
2.00
Add V2.0 specification and details on change
RS232 / IP ASCII Controller Command List
The RA-1572 and RA-1572MKII supports an ASCII based RS232 protocol. The RS232 hardware does not support flow control so care needs to be take when sending and receiving data to avoid packet loss. The unit will also support IP control using the same command formats.
All commands sent to the attached Rotel device must have a terminating “!” character.
Note: Do not include any spaces in the command, and do not include a carriage return
or line feed after the command, only the “!” terminating character.
Status information from the attached Rotel product with either have a terminating “!” or “$” character, depending on the protocol revision (see update below), or a byte count for variable length text data that may include a “!” in the returned message. It is up to
the sending/receiving control application to properly parse and process the packets.
Note: The byte count only includes the text data and not the length or “,” character.
Important Protocol Revision
As of software V2.65, the RS232 and IP protocol was updated with changes to some commands as well as all feedback strings. This change will impact existing control
systems so any connected control systems should be updated to utilize the new protocol before updating the software in the RA-1572.
The current commands and feedback strings are documented in Sections 1 & 2, while the legacy commands for older software is documented in Sections 3 & 4. A summary and list of specific changes is also provided in Appendix A.
The RS232 connection settings and IP control port remain unchanged with the 2.0 specification.
Connection Settings
1
IP Control Settings
Command Description
Unit Response
POWER & VOLUME COMMANDS
power_on!
Power On
power=on$
power_off!
Power Off
power=standby$
power_toggle!
Power Toggle
power=on/standby$
vol_up!
Volume Up
volume=##$
vol_dwn!
Volume Down
volume=##$
vol_min!
Set Volume to Min
volume=00$
vol_nn!
Set Volume to level n (01 - 96)
volume=##$
mute!
Mute Toggle
mute=on/off$
mute_on!
Mute On
mute=on$
mute_off!
Mute Off
mute=off$
SOURCE SELECTION COMMANDS
cd!
Source CD
source=cd$
coax1!
Source Coax 1
source=coax1$
coax2!
Source Coax 2
source=coax2$
opt1!
Source Optical 1
source=opt1$
opt2!
Source Optical 2
source=opt2$
aux!
Source Aux
source=aux$
tuner!
Source Tuner
source=tuner$
phono!
Source Phono
source=phono$
usb!
Source Front USB
source=usb$
bluetooth!
Source Bluetooth
source=bluetooth$
bal_xlr!
Source XLR
source=bal_xlr$
pcusb!
Source PC-USB
source=pc_usb$
The RA-1572 will only accept and respond to IP control commands if the product is connected to a local network and has a valid IP address.
Commands will be accepted via TCP port 9590, and the unit will send responses back via the same port. The command and response format is identical to the serial commands.
Communication Protocol
Command and response messages are included on the following pages. Automatic status update information can be enabled/disabled using the
rs232_update_on” and “rs232_update_offcommands (V2.0) or “display_refresh_auto” and “display_refresh_manual” commands (V1.0).
With RS232 update set to ON, any status changes to the unit will be transmitted via RS232. With RS232 update set to OFF, the unit will not send any feedback unless polled by the controller.
Section 1: Control Command List V2.0
Applies to RA-1572 V2.65 and newer , RA-1572MKII
RA-1572 /RA-1572MKIIASCII
2
RA-1572 /RA-1572MKIIASCII
Command Description
Unit Response
SOURCE CONTROL COMMANDS
play!
Play Source
n/a
stop!
Stop Source
n/a
pause!
Pause Source
n/a
trkf!
Track Forward/Tune Up
n/a
trkb!
Track Backward/Tune Down
n/a
TONE CONTROL COMMANDS
bypass_on!
Tone Bypass On
bypass=on$
bypass_off!
Tone Bypass Off
bypass=off$
bass_up!
Bass Up
bass=000/+##/-##$
bass_down!
Bass Down
bass=000/+##/-##$
bass_-10!
Set Bass to -10
bass=-10$
bass_000!
Set Bass to 0
bass=000$
bass_+10!
Set Bass to +10
bass=+10$
treble_up!
Treble Up
treble=000/+##/-##$
treble_down!
Treble Down
treble=000/+##/-##$
treble_-10!
Set Treble to -10
treble=-10$
treble_000!
Set Treble to 0
treble=000$
treble_+10!
Set Treble to +10
treble=+10$
BALANCE CONTROL COMMANDS
balance_r!
Balance Right
balance=000/L##/R##$
balance_l!
Balance Left
balance=000/L##/R##$
balance_l15!
Set Balance to Max Left
balance=L15$
balance_000!
Set Balance to 0
balance=000$
balance_r15!
Set Balance to Max Right
balance=R15$
SPEAKER OUTPUT COMMANDS
speaker_a!
Toggle Speaker A Output
speaker=a/a_b/off$
speaker_b!
Toggle Speaker B Output
speaker=b/a_b/off$
speaker_a_on!
Speaker A Output On
speaker=a/a_b$
speaker_a_off!
Speaker A Output Off
speaker=b/off$
speaker_b_on!
Speaker B Output On
speaker=b/a_b$
speaker_b_off!
Speakler B Output Off
speaker=a/off$
OTHER COMMANDS
dimmer!
Toggle display dimmer
dimmer=#$
dimmer_0!
Set display to brightest setting
dimmer=0$
dimmer_1!
Set display to dimmer level 1
dimmer=1$
dimmer_2!
Set display to dimmer level 2
dimmer=2$
dimmer_3!
Set display to dimmer level 3
dimmer=3$
dimmer_4!
Set display to dimmer level 4
dimmer=4$
dimmer_5!
Set display to dimmer level 5
dimmer=5$
dimmer_6!
Set display to dimmest setting
dimmer=6$
pcusb_class_1!
Set PC-USB Audio Class to 1.0
pcusb_class=1$
3
RA-1572 /RA-1572MKIIASCII
Command Description
Unit Response
pcusb_class_2!
Set PC-USB Audio Class to 2.0
pcusb_class=2$
factory_default_on!
Reset unit to factory defaults
n/a
RS232 FEEDBACK COMMANDS
rs232_update_on!
Set RS232 Update to Auto (On)
update_mode=auto$
rs232_update_off!
Set RS232 Update to Manual (Off)
update_mode=manual$
Command:
power?
Description:
Request current power status
Return String(s):
power=on$ / power=standby$
Return Description:
Current power status
Example:
power=on$
Command:
source?
Description:
Request current source
Return String(s):
source=cd$ / source=coax1$ / source=coax2$ / source=opt1$ / source=opt2$ / source=tuner$ / source=phono$ / source=usb$ / source=aux$ / source=pc_usb$ / source=bal_xlr$ / source=bluetooth$
Return Description:
Current source
Example:
source=usb$
Command:
volume?
Description:
Request current volume value
Return String(s):
volume=##$
Return Description:
2 digit current volume level
Example:
volume=40$
Command:
mute?
Description:
Request current mute status
Return String(s):
mute=on$ / mute=off$
Return Description:
Current mute status
Example:
mute=off$
Command:
bypass?
Description:
Request current tone bypass state
Return String(s):
bypass=on$ / bypass=off$
Return Description:
Current tone bypass state
Example:
bypass=off$
Section 2: Feedback Request Command List V2.0
Applies to RA-1572 V2.65 and newer , RA-1572MKII
4
5
Command:
bass?
Description:
Request current bass level
Return String(s):
bass=###$ (+01-10, -01-10, 000)
Return Description:
Current tone control bass level
Example:
bass=+02$
Command:
treble?
Description:
Request current treble level
Return String(s):
treble=###$ (+01-10, -01-10, 000)
Return Description:
Current tone control treble level
Example:
treble=-01$
Command:
balance?
Description:
Request current balance setting
Return String(s):
balance=###$ (L01-15, R01-15, 000)
Return Description:
Current balance setting
Example:
balance=L03$
Command:
freq?
Description:
Request current frequency for digital source input
Return String(s):
freq=off$ / freq=32$ / freq=44.1$ / freq=48$ / freq=88.2$ / freq=96$ / freq=176.4$ / freq=192$ / freq=384$
Return Description:
Current frequency for digital source input
Example:
freq=48$
Command:
speaker?
Description:
Request current active speaker outputs
Return String(s):
speaker=a$ / speaker=b$ / speaker=a_b$ / speaker=off$
Return Description:
Current active speaker outputs
Example:
speaker=a$
Command:
dimmer?
Description:
Request current front display dimmer level
Return String(s):
dimmer=0$ / dimmer=1$ / dimmer=2$ / dimmer=3$ / dimmer=4$ / dimmer=5$ / dimmer=6$
Return Description:
Current front display dimmer level
Example:
dimmer=3$
Command:
pcusb?
Description:
Request current PC-USB class
Return String(s):
pcusb_class=1$ / pcusb_class=2$
Return Description:
Current PC-USB class
Example:
pcusb_class=1$
Loading...
+ 9 hidden pages