Rotel RA-11 / RA-12 V02 RS232 ASCII Controller Command List

Rotel RA-11 / RA-12 V02
RS232 ASCII Controller Command List
Date
June 12, 2014
September 16, 2016
Version
1.00
1.01
Update Description
Original Specification
Corrected volume scale from 1 - 86 to 1 - 96
The RA-11 and RA-12 V02 support 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 below protocol is effective starting with V02 units that have the rear panel RS232
connection. Earlier models with the rear panel mini USB connections do not support this
protocol.
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 “!”
character 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.
Note about Rotel Link RCD feature: The input that has been selected for the ROTEL LINK
RCD option in the setup menu of the RA-11/12 will affect the response string from the
unit for that input. If the input has been set as the Rotel Link RCD input, the response
string for that input will be the second string listed in the table (i.e. if COAX1 has been
set as the Rotel Link RCD input, the response string will be source=coax1_cd! rather than
the standard response string of source=coax1!).
Connection Settings
Baud Rate
115200
Parity
N
Valid Data Bits
8
Stop Bit Value
1
Handshaking
None
Data Type
String
Communication Protocol
Command and response messages are included on the following pages.
Automatic display update information can be enabled/disabled using the
“display_update_auto” and “display_update_manual” commands.
1
In automatic mode each time the display changes the new display line(s) will be sent.
In manual mode the display updates must be requested each time a refresh of the
display information is desired. This primarily applies to Front USB metadata information.
Basic status information such as volume, power or source changes will still be provided
automatically.
Section 1: Control Command List
RA-12 ASCII
Command Description
POWER & VOLUME COMMANDS
power_on!
Power On
power_off!
Power Off
power_toggle!
Power Toggle
volume_up!
Volume Up
volume_down!
Volume Down
volume_max!
Set Volume to Max
volume_min!
Set Volume to Min
volume_n!
Set Volume to level n (n = 1 - 96)
mute!
Mute Toggle
mute_on!
Mute On
mute_off!
Mute Off
SOURCE SELECTION COMMANDS
rcd!
Source Rotel CD
cd!
Source CD
coax1!
Source Coax 1
coax2!
Source Coax 2
opt1!
Source Optical 1
opt2!
Source Optical 2
aux1!
Source Aux 1
aux2!
Source Aux 2
tuner!
Source Tuner
phono!
Source Phono
usb!
Source Front USB
SOURCE CONTROL COMMANDS
play!
Play Source
stop!
Stop Source
pause!
Pause Source
track_fwd!
Track Forward/Tune Up
track_back!
Track Backward/Tune Down
fast_fwd!
Fast Forward/Search Forward
2
Unit Response
power=on!
power=standby!
power=on/standby!
volume=##!
volume=##!
volume=max!
volume=min!
volume=##!
mute=on/off!
mute=on!
mute=off!
source=analog_cd! /
source=coax1_cd! /
source=coax2_cd!
source=cd! /
source=analog_cd!
source=coax1! /
source=coax1_cd!
source=coax2! /
source=coax2_cd!
source=opt1!
source=opt2!
source=aux1!
source=aux2!
source=tuner!
source=phono!
source=usb!
play_status=play!
n/a
n/a
n/a
n/a
n/a
RA-12 ASCII
Command Description
fast_back!
Fast Backward/Search Backward
random!
Random Play Mode Toggle
repeat!
Repeat Play Mode Toggle
MENU CONTROL COMMANDS
menu!
Display the Menu
exit!
Exit Key
up!
Cursor Up
down!
Cursor Down
left!
Cursor Left
right!
Cursor Right
enter!
Enter Key
NUMERIC KEY COMMANDS
1!
Number Key 1
2!
Number Key 2
3!
Number Key 3
4!
Number Key 4
5!
Number Key 5
6!
Number Key 6
7!
Number Key 7
8!
Number Key 8
9!
Number Key 9
0!
Number Key 0
TONE CONTROL COMMANDS
tone_on!
Tone Controls On
tone_off!
Tone Controls Off
bass_up!
Bass Up
bass_down!
Bass Down
bass_-10!
Set Bass to -10
bass_000!
Set Bass to 0
bass_+10!
Set Bass to +10
treble_up!
Treble Up
treble_down!
Treble Down
treble_-10!
Set Treble to -10
treble_000!
Set Treble to 0
treble_+10!
Set Treble to +10
BALANCE CONTROL COMMANDS
balance_right!
Balance Right
balance_left!
Balance Left
balance_L15!
Set Balance to Max Left
balance_000!
Set Balance to 0
balance_R15!
Set Balance to Max Right
3
Unit Response
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
tone=on!
tone=off!
bass=000/+##/-##!
bass=000/+##/-##!
bass=-10!
bass=000!
bass=+10!
treble=000/+##/-##!
treble=000/+##/-##!
treble=-10!
treble=000!
treble=+10!
balance=000/L##/R##!
balance=000/L##/R##!
balance=L15!
balance=000!
balance=R15!
RA-12 ASCII
Command Description
OTHER COMMANDS
dimmer!
Toggle display dimmer
dimmer_0!
Set display to brightest setting
dimmer_1!
Set display to dimmer level 1
dimmer_2!
Set display to dimmer level 2
dimmer_3!
Set display to dimmer level 3
dimmer_4!
Set display to dimmer level 4
dimmer_5!
Set display to dimmer level 5
dimmer_6!
Set display to dimmest setting
DISPLAY REFRESH COMMANDS
display_update_auto!
Set Display Update to Auto
display_update_manual!
Set Display Update to Manual
Unit Response
dimmer_#!
n/a
n/a
n/a
n/a
n/a
n/a
n/a
display_update=auto!
display_update=manual!
Section 2: Feedback Request Command List
Command:
Description:
Return String:
Return Description:
Example:
Command:
Description:
Return String:
Return Description:
Example:
Command:
Description:
Return String:
Return Description:
Example:
Command:
Description:
Return String:
Return Description:
Example:
get_display!
Request the entire display to be sent
display=###,text
Current display data; must include 3 digit length of text string at beginning
followed by "," and text string (no terminating character)
display=040, Sample Text
get_display1!
Request display line #1 to be sent
display1=##,text
Current display line 1, must include 2 digit length of text string at beginning
followed by "," and text string (no terminating character)
display1=20, Sample Text
get_display2!
Request display line #2 to be sent
display2=##,text
Current display line 2, must include 2 digit length of text string at beginning
followed by "," and text string (no terminating character)
display2=20, Sample Text
get_product_type!
Request the product type
product_type=##,text
Rotel product type name, must include 2 digit length of text string at
beginning followed by "," and text string (no terminating character)
product_type=05,RA-12
4
Command:
Description:
Return String:
Return Description:
Example:
Command:
Description:
Return String(s):
Return Description:
Example:
get_product_version!
Request the main CPU software version
product_version=##,text
Rotel main CPU software version, must include 2 digit length of text string at
beginning followed by "," and text string (no terminating character)
product_version=06,V2.1.0
get_tc_version!
Request the front USB software version
tc_version=##,text
Rotel front USB software version, must include 2 digit length of text string at
beginning followed by "," and text string (no terminating character)
product_version=06,V500BT
Command:
Description:
Return String:
Return Description:
Example:
get_display_size!
Request display size
display_size=##,##!
Columns and rows on current display
display_size=20,02!
Command:
Description:
Return String(s):
Return Description:
Example:
get_display_update!
Request display update
display_update=auto! / display_update=manual!
Status of if the display refresh is automatic or manual
display_update=auto!
Command:
Description:
Return String(s):
Return Description:
Example:
get_current_power!
Request current power status
power=on! / power=standby!
Current power status
power=on!
Command:
Description:
Return Description:
Example:
get_current_source!
Request current source
source=analog_cd! / source=cd! / source=coax1! / source=coax1_cd! /
source=coax2! / source=coax2_cd! / source=opt1! / source=opt2! /
source=tuner! / source=phono! / source=usb! / source=aux1! / source=aux2!
Current source
source=usb!
Command:
Description:
Return String(s):
Return Description:
Example:
get_tone!
Request current tone control state
tone=on! / tone=off!
Current tone control state
tone=off!
Return String(s):
5
Command:
Description:
Return String(s):
Return Description:
Example:
get_bass!
Request current bass level
bass=###! (+01-10, -01-10, 000)
Current tone control bass level
bass=+02!
Command:
Description:
Return String(s):
Return Description:
Example:
get_treble!
Request current treble level
treble=###! (+01-10, -01-10, 000)
Current tone control treble level
treble=-01!
Command:
Description:
Return String(s):
Return Description:
Example:
get_balance!
Request current balance setting
balance=###! (L01-15, R01-15, 000)
Current balance setting
balance=L03!
Command:
Description:
Return Description:
Example:
get_current_freq!
Request current frequency for digital source input
freq=off! / freq=32! / freq=44.1! / freq=48! / freq=88.2! / freq=96! /
freq=176.4! / freq=192!
Current frequency for digital source input
freq=48!
Command:
Description:
Return String(s):
Return Description:
Example:
get_play_status!
Request play status (front USB source)
play_status=play! / play_status=stop! / play_status=pause!
Source play status
play_status=play!
Command:
Description:
Return String(s):
Return Description:
Example:
get_volume_max!
Request Max volume value
volume_max=##!
2 digit volume max level
volume_max=80!
Command:
Description:
Return String(s):
Return Description:
Example:
get_volume_min!
Request Min volume value
volume_min=0!
2 digit volume min level
volume_min=0!
Return String(s):
6
Command:
Description:
Return String(s):
Return Description:
Example:
get_volume!
Request current volume value
volume=##!
2 digit current volume level
volume=40!
Command:
Description:
Return String(s):
Return Description:
Example:
get_tone_max!
Request Max Tone value
tone_max=10!
2 digit tone max level
tone_max=10!
Section 3: Special Character Mapping
Certain characters on the RA-12 display may be represented by a combination of
2-3 hex bytes in the feedback string provided by the unit. Refer to the chart below for a
mapping of the different characters.
Symbol
Hex Value
Symbol
Hex Value
Symbol
Hex Value
A
EE 82 85
EE 82 8A
EE 82 99
C
EE 82 84
EE 82 8B
EE 82 9A
F
EE 82 92
EE 82 81
EE 82 88
G
EE 82 87
▶
EE 82 82
EE 82 95
I
EE 82 8E
■
EE 82 83
EE 82 96
L
EE 82 89
◄
EE 82 94
M
EE 82 93
►
EE 82 97
R
EE 82 8C
◄
EE 82 98
Z
S
EE 82 8F
T
EE 82 80
END
7
*
EE 82 90
EE 82 91
EE 82 8D
EE 80 80 EE 80 81 EE 80 82