NeXTTool Documentation
NeXTTool - USB & Bluetooth NXT communication utility
C:\winapps\projects\BricxCC>nexttool -help
NeXTTool version 1.2 (1.2.1.3, built Fri Mar 2 23:56:38 CST 2012)
Copyright (c) 2006-2012 John Hansen
Usage: NeXTTool [options] [actions]
Options:
/COM=port: specify port name (usb, resource string, or alias)
/BluetoothSearchTimeout=<n>: Set Bluetooth search timeout
/HEX: use hexadecimal for numeric output
/Duration=<n>: specify the tone duration for the playtone action
/Inbox=<n>: use inbox number n when sending a message
/Loop: loop when playing sound files
/Relative: reset output position relative
/KeepMsg: do not empty mailbox when reading
/Bin[=filename]: dump data output as binary to a file (nxt.bin)
/Power=<n>: output power level (-100..100)
/Mode=<n>: output mode (COAST=0, MOTORON=1, BRAKE=2, REGULATED=4)
/RegMode=<n>: output regulation mode (IDLE=0, SPEED=1, SYNC=2)
/RunState=<n>: output run state (IDLE=0, RAMPUP=16, RUNNING=32, RAMPDOWN=64)
/TurnRatio=<n>: output turn ratio (-100..100)
/TachoLimit=<n>: output tachometer limit (0..MaxInt)
/SensorType=<n>: sensor type (0..17)
/SensorMode=<n>: sensor mode (0, 32, 64, 96, 128, 160, 192, 224)
/Iterations=<n>: repeat a command <n> times (1)
/RefreshRate=<ms>: delay <ms> milliseconds between iterations (1000)
Actions:
-init[=0] : initialize nxt.dat (optionally turn off Bluetooth search)
-update[=0] : update the nxt.dat file (ditto)
-listbricks[=0] : list resource names of all found NXT bricks (ditto)
-clear : erase all items on the brick
-battery : return the battery level
-input=<N> : read input N (0-3)
-output=<N> : read the status of output N (0-2)
-setinput=<N> : configure input N (0-3)
-setoutput=<N> : configure output N (0-2)
-mute : stop playing sounds
-playtone=<frequency> : play a tone for the specified duration
-run=<filename> : run the specified program
-runningprogram : return the name of the currently running program
-stop : stop the currently running program
-playfile=<filename> : play the specified sound file
-firmware=<filename> : download firmware
-download=<filename> : download the specified file to the NXT
-upload[=<pattern>] : upload the specified file(s) from the NXT (or *.*)
-listfiles[=<pattern>] : list the files matching the pattern (or *.*)
-listmodules[=<pattern>] : list the modules matching the pattern (or *.*)
-delete=<filename> : delete the specified file from the NXT
-memory=<n> | -memory_full: upload 128 bytes of memory (_full == all memory)
-map: upload memory map
-keepalive : return the current sleep time limit
-sleep=<timeout> : set NXT sleep timeout (in minutes)
-msg=<string> : send the specified message to the NXT
-readmsg=<box> : read the message from the specified box
-resetoutputposition=<port> : reset the position for the specified port
-resetinputsv=<port> : reset the input scaled value for the specified port
-setname=<new_name> : set the name of the NXT
-getname : return the name of the NXT
-versions : return the NXT firmware and protocol versions
-deviceinfo : return all NXT device information
-freemem : return the amount of free memory
-i2cbytes=<data> : send/receive I2C data
-lsstatus=<port> : return the low speed status for the specified port
-sendraw=<cmd> : send a direct or system command (comma-separated hex bytes)
-resetbtnstate=<btn> : reset the button state for the specified button
-boot : reset the NXT into SAMBA mode
-btreset : reset the NXT bluetooth to factory settings (usb only)
-defrag : defragment the NXT filesystem
-shutdown : turn off the NXT
-motorson=<motorlist> : Turn on the specified motors
-motorsoff=<motorlist> : Turn off the specified motors
-motorsfloat=<motorlist> : Float the specified motors
-setfwd=<motorlist> : Set the motor direction to forward
-setrwd=<motorlist> : Set the motor direction to reverse
-switchdir=<motorlist> : Switch the motor direction
-setmotorpower=<motorlist,pwr> : Set the motor power
-poll=<src,num> : Poll the specified src and number
-getoutputstatus=<out> : Get the output status
-getvariablevalue=<var> : Get the variable value
-getinputvalue=<input> : Get the input value
-gettimervalue=<num> : Get the timer value
-polleeprom=<block> : Poll eeprom block
-setvmstate=<state> : Set the VM state (enhanced firmware only)
-getvmstate : Get the VM state (enhanced firmware only)
-btdevcnt : Get the bluetooth device count
-btnamecnt : Get the bluetooth device name count
-btdevice=<idx> : Get the specified bluetooth device
-btconnection=<idx> : Get the specified bluetooth connection
General:
-help : display command line options