R2d7 protocol, Command strings, Operating strings – Vutec SIK232 Interface - Instructions User Manual
Page 6
6 / 13
3
3
.
.
R
R
2
2
D
D
7
7
P
P
r
r
o
o
t
t
o
o
c
c
o
o
l
l
Communication with the R2D7 is defined in two parts: command strings and response
strings.
3.1.
Command Strings
Strings are not cases sensitive to the R2D7, but for our purposes, we will use lower
case for operating strings and upper case for configuration strings.
3.1.1.
Operating Strings
Operating strings for the R2D7 are segmented into 5 or 6 parts:
* 1
o
04 020 ;
Each command must begin with a “header” character. This character is always the
asterisk: “*”
The next segment is either one or two characters. This represents the system
address, or the physical port we are addressing on the R2D7 device. If the R2D7 is in
radio mode (default), then this number may be anything from 1 through 99. When in
bus mode, however, this number may only be 1 though 7. To send the “ALL”
command, use 0 (zero) for the system.
Next, we need to give the R2D7 an instruction as a single character. In our example
above, we have issued the ‘Open’ command. The following table defines the
commands available:
o
Open (sends the open command to the system for the specified unit address)
c
Close (sends the close command to the system for the specified unit address)
s
Stop (sends the stop command to the system – unit address is ignored)
w
Wind (sends the wind command to the system – unit address is ignored)
p
Program a Motor Control (puts the RP60 in programming mode)
a
Program an Accessory (puts the accessory in programming mode)
q
Quit Sending Current Command (only applicable when sending a “forever” command)
Now we need to indicate which unit the command is intended for. This is an address
from our pool of 01 through 60, or 00 to represent “ALL.” The address here is the
same as if the command were issued from a remote control; the R2D7 is simply
another command source. The address may control a group of shades, single shade,
and even all shades. Perhaps the address for certain controls indicates running to an
intermediate stop.
The next three digits are an optional timing instruction for the R2D7. The value
represents the duration of the command in 20
th
’s of a second. For example, 010 would
be half a second. If this information is not specified, then the R2D7 will send the
command for 2 seconds. If 000 is specified, then the command will be sent forever.
Finally, the terminator must be sent. This can be either the semi-colon (as in our
example) or “CR” (the “Enter” key).