

Home Documentation Download ZIP file
Startup Properties
This section shows the name of each property (italic) that can be set during startup, the default value (bold), and the acceptable range of input values (within parentheses).
Joystick Properties
The joystick properties control how the data from that device is collected and interpreted. See the developer reference for more details.
- btcontrol.joystick.poll
100 (10 - 1000)
The data from the joystick is "polled" in regular intervals. This property sets that interval, and is measured in milliseconds.
- btcontrol.joystick.ignore.band
0.05 (0.01 - 0.99)
BTControl applies a "dead band" around the 0 (neutral) joystick position to protect agains unintended movements. Since the axis range of the joystick is bounded by 0.0 and 1.0, the value is interpreted on that scale.
- btcontrol.joystick.ignore.z
true (false/true)
This flag includes or excludes the "z" axis from the above deadband calculation, as well as ignores non-zero values during the decision, whether to send an update to the NXT brick (see developer reference).
- btcontrol.joystick.direction
unity (unity/xflip/yflip/xyflip)
Maps the axis values of x and y to a different orientation, if needed. For example if pushing the joystick forward creates negative y values, you can "flip" the y axis to generate positive values that are sent to the NXT brick.
- btcontrol.joystick.direction.z
unity (unity/flip)
Maps the z axis values to a different orientation, if needed.
NXT Mailbox Properties
- btcontrol.robot.statusid
0 (0 - 9)
Sets the mailbox number to which "state" messages are sent (see developer reference).
- btcontrol.robot.motorid
1 (0 - 9)
Sets the mailbox number to which "joystick" messages are sent (see developer reference).
Connection Properties
- btcontrol.connection.usecache
false (false/true)
A bluetooth connection does not have a mechanism to "close" it after use. Instead, a timeout on the NXT side will close it, when no messages are received. To avoid complications when trying to reconnect to a NXT brick, use a BTControl side connection cache. That cache is en/disabled with this flag.
Font Properties
- btcontrol.font.size
18 (valid platform values)
The pt (point) size of the font used for all text.
- btcontrol.button.font
Courier (valid platform fonts)
The font used for all buttons.
- btcontrol.text.font
TimesRoman (valid platform fonts)
The font used for all text messages;
- btcontrol.list.font
Courier (valid platform fonts)
The font used for the NXT brick device list.
Last modified: Sat Dec 19 14:56:12 Eastern Standard Time 2009