Overview Of Commands; About Commands - Roland REAC R-1000 Reference

Overview of commands

The R-1000 and the control computer communicate via commands. There are several types of commands, and you can control
the R-1000 by using the command that's appropriate for your purpose.

About commands

Single-byte alphanumeric characters are used for commands. In general, the command syntax is an ASCII string consisting of "stx"
and "three uppercase letters" followed by a ";" (semicolon). The three letters indicate the type of command. However, there are
other types depending on the command.
"Command syntax" (p. 5).
* "stx" : This is the control code in ASCII code (code number 02H in hexadecimal); it indicates the beginning of a command.
* ";" : This code lets the R-1000 detect the end of the command.
<Ex.> To transmit the ** command, transmit the ASCII string "stx**;"
Protocol
Depending on the command, there are two types of communication protocols between the control computer and the R-1000.
When specifying an operation or setting for the R-1000
This type corresponds to the "Control commands" (p. 6). These commands use the procedure shown in the following diagram.
fig.PrtConcept1.eps
COMPUTER
a. Transmit the command from the computer to the R-1000.
b. The R-1000 will output "ack" if the command was received correctly, or an ERR command in case of invalid reception.
* "ack" : This is the ASCII code name of the control code (06H in hexadecimal) acknowledging successful reception.
* Invalid reception corresponds to cases in which the syntax of the received command was incorrect.
* stxERR is the command used to transmit or receive an error indication.
To learn the settings of the R-1000
This type corresponds to the "Request commands" (p. 7). Commands used to check the status of a setting in the R-1000 use the
following procedure.
fig.PrtConcept2.eps
a. stx + command
COMPUTER
b. stx + command or stxERR command
c. ack or stxERR command
a. Transmit the command from the computer to the R-1000.
b. If the R-1000 receives the command correctly, it will send back a command containing the information that was requested. If
the command was not received correctly, an ERR command will be sent back.
c. If the output of the R-1000 was received correctly, an "ack" will be sent back. (* This "ack" can be omitted.)
* If the ERR command is sent to the R-1000, the R-1000 will re-transmit the command it sent in step "b." This command can also be omitted;
instead of returning anything, you can repeat the procedure from step "a."
* The R-1000 will not transmit anything when a setting is changed by a controller operation on the R-1000 itself.
4
a. stx + command
b. ack or stxERR command
R-1000
R-1000