Rotel RA-1572 /RA-1572MKII
RS232 / IP ASCII Controller Command List
Date |
Version |
Update Description |
August 27, 2018 |
1.00 |
Original Specification |
January 2, 2019 |
2.00 |
Add V2.0 specification and details on change |
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.
Example Command: power_on!
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 |
|
|
|
|
|
|
|
|
Baud Rate |
|
|
Parity |
|
|
|
|
|
|
Handshaking |
|
|
Data Type |
|
||
|
|
|
|
|
Valid Data Bits |
|
|
Stop Bit Value |
|
|
|
|
|
||||
115200 |
|
|
N |
8 |
|
1 |
|
|
None |
|
String |
1
IP Control Settings
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_off” commands (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 |
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$ |
|
|
|
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$ |
Section 2: Feedback Request Command List V2.0
Applies to RA-1572 V2.65 and newer , RA-1572MKII
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
source=cd$ / source=coax1$ / source=coax2$ / source=opt1$ / Return String(s): 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$
4
|
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$ |
|
|
|
|
5