nxtrc man page

nxtrc — a program to interact with LEGO NXT via BlueTooth

Synopsis

nxtrc [-s]

nxtrc [-a ADDR] [-v] command

Description

NXTRC (NXT Remote Command) is a small program that allows to send various commands to a LEGO Mindstorm NXT Brick. It uses the Bluetooth protocol through the Bluez libraries.

The option -s starts a scan to find BlueTooth devices. If a BT address is given in the command line or is in the Environment Variable BTADDR it connects to the NXT and performs the task specified in <command>. The first time you connect with a device you need to exchange a password, this task is usually done by the Operative System BlueTooth Management (as Kbluetooth under KDE).

COMMANDS and OPTIONS

-a
BlueTooth Address of the NXT, required if BTADDR Environment Variable is not set to the address
-b
Get Battery Level
-d FILE
Delete FILE frome NXT
-h
display a short help text
-i
Get info on NXT brick
-k
Stop a program running on NXT
-l[PATT]
List files on NXT brick matching PATTern if present (e.g. -l*.rxe) N.B. No spaces between -l and PATT! see at the end the patterns allowed
-m FILE
Play sound file FILE once
-M FILE
Play sound file FILE indefinitely
-n NAME
Set NXT name to NAME
-p FILE
Run Program FILE on NXT
-r FILE
Read FILE frome NXT and save it in the working directory if FILE is already present ask for permission to overwrite
-v
Be verbose. This is the only option that can be given with another command. It's not always very useful....
-w FILE
Write FILE on NXT, If FILE is already present ask for permission to overwrite
-W FILE
Same as -w forcing overwrite if FILE exists
-z
Stop Sound Playback

File Names and Patterns

On the NXT File names are of the form "Name.Ext" with max 15 characters for the Name and 3 for the Extension. When asking a listing with the -l command you can give a specific file name to see if it's on the NXT and list its size, or a Pattern using widlcards. Due to the limitation of the NXT API patterns are limited to the form "*.ext", "Name.*" or "*.*" this last one is the default and can be omitted.

Examples

scan for devices
$ nxtrc -s
00:10:20:30:40:50 NXT1
00:01:01:02:03:04 NXT2

set up Environment Variable for connection with NXT1 and ask for info
$ export BTADDR=00:10:20:30:40:50
$ nxtrc -i

load program Prog.rxe on NXT1 and run it
$ nxtrc -W Prog.rxe
$ nxtrc -p Prog.rxe

Exit Status

nxtrc returns a zero exit status if it succeeds. Non zero is returned in case of failure.

Author

Gian Piero Puccioni (gianpiero.puccioni (at) isc.cnr.it)

Info

July 27 2010 version 2.3 USER COMMANDS