File: mtkbabel.1

package info (click to toggle)
mtkbabel 0.7-1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 156 kB
  • ctags: 43
  • sloc: perl: 1,205; makefile: 5
file content (139 lines) | stat: -rw-r--r-- 4,155 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.TH MTKBABEL 1 "June 12, 2008"
.SH NAME
mtkbabel \- Tool for managing GPS data loggers based on the MTK chip
.SH SYNOPSIS
.B mtkbabel \fR[\fB\-abdEfhlmopRrstvw\fR]
.SH DESCRIPTION
.B mtkbabel
is a command line program to operate GPS data loggers based on the MediaTek MTK chip.
It was tested on the i-Blue 747 and on the Holux M-241, it should work also with other
GPS devices based on the same chip.
.sp
The main features are:
 - Command line interface
 - Save data log in GPX and raw binary format
 - If required retrieve all the data, also the old one being overlapped
 - Change logging criteria: time, distance, speed
 - Change log format
 - START/STOP logging
 - Set OVERLAP or STOP method on memory full
 - Erase the internal memory
.SH USAGE
In order to use mtkbabel, please follow these instructions:
.sp
1. Attach the GPS data logger device to your computer
.BR "via USB" .
.sp
2. Now you have to switch the GPS device (at least the i-Blue 747) into
.BR "LOG or NAV mode" ,
otherwise the device will not be powered on, and no connection will
be possible. Beware that in NAV mode the device goes into sleep mode if
not connected to any Bluetooth device.
.sp
3. In order to use mtkbabel you have to either be root (not recommended)
and/or you must have read/write permissions for the USB device file, usually
.BR /dev/ttyUSB0 .
This device usually has permissions
.BR "'crw-rw---- 1 root dialout'" ,
so you can either add your user to the
.B dialout
group (in this example) by doing
.sp
.B "   $ adduser USERNAME dialout"
.sp
or (not recommended) make the device world-readable/-writable by doing:
.sp
.B "   $ chmod 666 /dev/ttyUSB0"
.sp
Another option is to write a udev rules file to change the owner and
permissions of /dev/ttyUSB0 according to your requirements.
.sp
4. You can now run mtkbabel. For example, if you want to download the
track log and the list of waypoints you captured on the device, run:
.sp
.B "   $ mtkbabel -s 115200 -l off -f foo -w -t"
.sp
The default speed of
.B 115200
baud should work in most cases and you can omit it, for the Holux M-241 you
must use
.B 38400
instead.
This will turn off the autolog function, which is always turned on when you
switch on the device. The track log will be in the file
.BR foo_trk.gpx ,
the waypoints in the file
.B foo_wpt.gpx
(both in GPX format). The file
.B foo.bin
will contain the binary log file. Downloading the data from the GPS device
can take several minutes, depending on how much data has to be transferred.
.sp
In order to delete all data from the GPS device, run:
.sp
.B "   $ mtkbabel -s 115200 -E"
.SH OPTIONS
.TP
.B "\-a"
Read all the log memory (overlapped data).
.TP
.BR "\-b" " filename.bin"
Do not read device, read a previously saved .bin file.
.TP
.BR "\-d" " debug_level"
Debug level: 0..7.
.TP
.B "\-E"
Erase data log memory.
.TP
.B "\-f"
Base name for saved files (.bin and .gpx).
.TP
.B "\-h"
Show a help text and exit.
.TP
.BR "\-l" " {on|off}"
Turn loggin ON/OFF.
.TP
.BR "\-m" " {stop|overlap}"
Set STOP/OVERLAP recording method on memory full.
.TP
.BR "\-o" " log_format"
Enable or disable log fields (FIELD1,\-FIELD2,...), available fields:
UTC, VALID, LATITUDE, LONGITUDE, HEIGHT, SPEED, HEADING, DSTA, DAGE, PDOP,
HDOP, VDOP, NSAT, SID, ELEVATION, AZIMUTH, SNR, RCR, MILLISECOND, DISTANCE.
.TP
.BR "\-p" " port"
Communication port, default:
.BR /dev/ttyUSB0 "."
.TP
.B "\-R"
Recover from disabled log: erase data and reset recording criteria.
.TP
.BR "\-r" " time:distance:speed"
Set logging criteria (zero to disable): every 1-999 seconds, every 10-9999
meters, over 10-999 km/h.
.TP
.BR "\-s" " speed"
Serial port speed, default
.BR 115200 " baud."
.TP
.B "\-t"
Create a gpx file with tracks.
.TP
.B "\-v"
Show version information and exit.
.TP
.B "\-w"
Create a gpx file with waypoints.
.SH BUGS
Please report any bugs to
Niccolo Rigacci <niccolo@rigacci.org>.
.SH LICENCE
.B mtkbabel
is covered by the GNU General Public License (GPL), version 2 or later.
.SH AUTHORS
Niccolo Rigacci <niccolo@rigacci.org>
.PP
This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
It is licensed under the terms of the GNU GPL (version 2 or later).