1nxtrc(1)                         USER COMMANDS                        nxtrc(1)
2
3
4

NAME

6       nxtrc - a program to interact with LEGO NXT via BlueTooth
7

SYNOPSIS

9       nxtrc [-s]
10
11       nxtrc [-a ADDR] [-v] command
12

DESCRIPTION

14       NXTRC (NXT Remote Command) is a small program that allows to send vari‐
15       ous commands to a LEGO Mindstorm NXT Brick. It uses the Bluetooth  pro‐
16       tocol through the Bluez libraries.
17
18       The  option -s starts a scan to find BlueTooth devices. If a BT address
19       is given in the command line or is in the Environment  Variable  BTADDR
20       it  connects  to  the NXT and performs the task specified in <command>.
21       The first time you connect with a device you need to exchange  a  pass‐
22       word,  this task is usually done by the Operative System BlueTooth Man‐
23       agement (as Kbluetooth under KDE).
24

COMMANDS and OPTIONS

26       -a     BlueTooth Address of the NXT,  required  if  BTADDR  Environment
27              Variable is not set to the address
28
29       -b     Get Battery Level
30
31       -d  FILE
32              Delete FILE frome NXT
33
34       -h     display a short help text
35
36       -i     Get info on NXT brick
37
38       -k     Stop a program running on NXT
39
40       -l[PATT]
41              List  files  on  NXT  brick  matching  PATTern  if present (e.g.
42              -l*.rxe) N.B. No spaces between -l and PATT! see at the end  the
43              patterns allowed
44
45       -m  FILE
46              Play sound file FILE once
47
48       -M  FILE
49              Play sound file FILE indefinitely
50
51       -n  NAME
52              Set NXT name to NAME
53
54       -p  FILE
55              Run Program FILE on NXT
56
57       -r  FILE
58              Read FILE frome NXT and save it in the working directory if FILE
59              is already present ask for permission to overwrite
60
61       -v     Be verbose. This is the only  option  that  can  be  given  with
62              another command.  It's not always very useful....
63
64       -w  FILE
65              Write FILE on NXT, If FILE is already present ask for permission
66              to overwrite
67
68       -W  FILE
69              Same as -w forcing overwrite if FILE exists
70
71       -z     Stop Sound Playback
72
73
74

File Names and Patterns

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

EXAMPLES

85       scan for devices
86           $ nxtrc -s
87            00:10:20:30:40:50  NXT1
88            00:01:01:02:03:04  NXT2
89
90       set up Environment Variable for connection with NXT1 and ask for info
91           $ export BTADDR=00:10:20:30:40:50
92           $ nxtrc -i
93
94       load program Prog.rxe on  NXT1 and run it
95           $ nxtrc -W Prog.rxe
96           $ nxtrc -p Prog.rxe
97
98

EXIT STATUS

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

AUTHOR

104       Gian Piero Puccioni (gianpiero.puccioni (at) isc.cnr.it)
105
106
107
108
109version 2.3                      July 27 2010                         nxtrc(1)