.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2015 Wookey <wookey@debian.org>,
.\"
.TH DXTOOL 1 "2015-07-08"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
dxtool \- DistoX download tool
.SH SYNOPSIS
.RI dxtool
[ -p \fI<port>\fP ]
[ -s \fI<start addr>\fP ]
[ -e \fI<end addr>\fP ]
[ -v ]
[ -m|-x|-d|-r ]
.br
.SH DESCRIPTION
This manual page documents the
.B dxtool
command.
.PP
.B dxtool
is a utility to download measurements from the DistoX cave surveying device
.SH OPTIONS
Details of options are included below.
.TP
.B \-h
Print usage help
.TP
.B \-p <port>
Bluetooth port (default: /dev/rfcomm0)
.TP
.B \-v
Verbose operation (dump every sent/received packet)
.TP
Operation Modes:
.TP
.B \-m
Dump all stored measurements (default mode)
.TP
.B \-r
Wait for DistoX-initiated transmissions (new measurements)
.TP
.B \-x
Dump memory in hex digits
.TP
.B \-d
Dump memory in decimal
.TP
In -m/-x/-d modes use -s/-e options to specify start and end addresses
(default: 0 ~ 0x7fff):
.TP
.B \-s <Hex-address>
Specify start address
.TP
.B \-e <Hex-address>
Specify end address
.SH 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.
.PP
Before using dxtool, you need to power on the device and estabilish a SPP
connection, for example using:
.PP
sudo rfcomm connect /dev/rfcomm0 10:00:e8:be:a5:18 1
.SH EXAMPLES
Often you can just use the command in its simplest form:
.br
.B dxtool
.br
downloads all stored data from /dev/rfcomm0
.br
.B dxtool -r
.br
waits for incoming data and downloads it
.br
.B dxtool -p /dev/rfcomm1 -x -s 0x300 -e 0x500
.br
dumps raw data in hex form from address 0x300 to 0x500, connecting via device /dev/rfcomm1