← Back to branch summary

~ubuntu-branches/ubuntu/raring/mtkbabel/raring

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Uwe Hermann
  • Date: 2008-02-08 21:52:33 UTC
  • Revision ID: james.westby@ubuntu.com-20080208215233-5hto58no3w1vx7uk
Tags: upstream-0.6
Import upstream version 0.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
 
1
---------------------------------------------------------------------------
 
2
README file for the MTKBabel program
 
3
---------------------------------------------------------------------------
 
4
Copyright 2007 Niccolo Rigacci <niccolo@rigacci.org>
 
5
Get latest version and other info at:
 
6
http://www.rigacci.org/wiki/doku.php/doc/appunti/hardware/gps_logger_i_blue_747
 
7
 
 
8
MTKBabel is a Perl program to operate the i-Blue 747 GPS data logger.
 
9
It should work also with other GPS devices based on the MediaTek MTK
 
10
chipset. It is free software released under the GPL license.
 
11
 
 
12
The main capabilities are:
 
13
 
 
14
  * Command line interface
 
15
  * Save data log in GPX and raw binary format
 
16
  * If required retrieve all the data, also the old one being overlapped
 
17
  * Change logging criteria: time, distance, speed
 
18
  * Change log format
 
19
  * START/STOP logging
 
20
  * Set OVERLAP or STOP method on memory full
 
21
  * Erase the internal memory
 
22
 
 
23
The progam is written in Perl, and it was tested on Linux via USB
 
24
connection. One goal is easy portability to C and small RAM footprint.
 
25
 
 
26
Run mtkbabel -h for a brief help screen.
 
27
 
 
28
In order to run the mtkbabel program you should have installed a
 
29
standard Perl distribution, plus the following libraries:
 
30
 
 
31
  * Device::SerialPort
 
32
  * Date::Format
 
33
 
 
34
Check if your operating system provides a package for them, or refer
 
35
to the cpan(1) manual page.
 
36
 
 
37
 
 
38
---------------------------------------------------------------------------
 
39
KNOWN BUGS
 
40
---------------------------------------------------------------------------
 
41
 
 
42
* Floating point numbers and non-i386 architectures
 
43
 
 
44
Convesion of floating point numbers (64 bit doubles and 32 bit
 
45
floats) from MTK binary format to GPX text is done with the Perl
 
46
unpack() function.
 
47
 
 
48
This seems to work properly on the GNU/Linux i386 architecture,
 
49
(I think both uses IEEE 754 encoding). It fails - at least - on my
 
50
Arm box, with an XScale processor.
 
51
 
 
52
The functions mtk2double() mtk2float() should be rewritten using
 
53
some math library or in pure Perl.