dxtool(1)
DistoX download tool
Description
DXTOOL
NAME
dxtool - DistoX download tool
SYNOPSIS
dxtool [ -p <port> ] [ -s <start addr> ] [ -e <end addr> ] [ -v ] [ -m|-x|-d|-r ]
DESCRIPTION
This manual page documents the dxtool command.
dxtool is a utility to download measurements from the DistoX cave surveying device
OPTIONS
Details of options are included below.
|
-h |
Print usage help |
-p <port>
Bluetooth port (default: /dev/rfcomm0)
|
-v |
Verbose operation (dump every sent/received packet) |
Operation Modes:
|
-m |
Dump all stored measurements (default mode) |
|||
|
-r |
Wait for DistoX-initiated transmissions (new measurements) |
|||
|
-x |
Dump memory in hex digits |
|||
|
-d |
Dump memory in decimal |
In -m/-x/-d modes use -s/-e options to specify start and end addresses
(default: 0 ˜ 0x7fff):
-s <Hex-address>
Specify start address
-e <Hex-address>
Specify end address
USAGE
During dxtool operation, it is neccessary to keep the device powered on (ie. prevent the power-off timeout). For example, by pressing random keys other than the measurement key.
Before using dxtool, you need to power on the device and estabilish a SPP connection, for example using:
sudo rfcomm connect /dev/rfcomm0 10:00:e8:be:a5:18 1
EXAMPLES
Often you can
just use the command in its simplest form:
dxtool
downloads all stored data from /dev/rfcomm0
dxtool -r
waits for incoming data and downloads it
dxtool -p /dev/rfcomm1 -x -s 0x300 -e 0x500
dumps raw data in hex form from address 0x300 to 0x500,
connecting via device /dev/rfcomm1