GPSDRIVE (c) 2001,2002 Fritz Ganter <ganter@ganter.at>
-------------------------------------------------

Website: www.kraftvoll.at/software

Disclaimer: Please do not use for navigation. 

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    *********************************************************************



********************************************************************
Please read the gpsdrive man page. To do so, install the program and
type 

man gpsdrive

into a terminal window. With KDE Konqueror you can also see it with
the URL: 

man:gpsdrive

Most information is now in the man page!

Have also a look at the Changelog file at 
http://www.kraftvoll.at/software/Changelog.gpsdrive

********************************************************************




How to install the program:
----------------------

Source File:

Extract it with tar -xvzf gpsdrive*tar.gz
cd gpsdrive
./configure 
make

If you don't need the support of the GARMIN protocol (you are using
only NMEA protocol) you should configure GpsDrive with:

./configure --disable-garmin

You can also add --with-pentiumpro, if you have a CPU > PII.


As root you should do a 
make install

to install the program, the gpsd daemon and the language files.

After compiling and installing (install is needed for localisation)
read the manpage of gpsdrive or start the program if you are to lazy
to read manuals. ;-)

You can also download the RPM file and install it:

rpm -Uvh gpsdrive*.rpm

Uninstall:
---------

If you installed using the tarball:

cd into the gpsdrive directory (not the src), then

make uninstall

If you used the rpm package:

rpm -e gpsdrive


If there is no directory ".gpsdrive" in your home directory, GpsDrive
will creates it for you. In this directory a file map_koord.txt is
created which holds the maps list. 

You can let the program download the maps. There is also a script
"gpsfetchmap" to download the maps.


For GARMIN mode you must not start gpsd.

If you don't have a link /dev/gps to your serial device, or you use
another port than ttyS0 start
GpsDrive with

./gpsdrive  -t /dev/ttyS1 

for your second serial port.

You can change this setting in the "Settings" menu.

Click on the "Start GPSD" button to start the gpsd daemon for NMEA
support.

You see your position on the map and some infos in the statusline. You
can zoom in and out. If you are moving outside your map, the next map
is selected if one is available for your position.

The first time you should download a map with the "Download" button.

Help is provided with "gpsdrive -h".

Comqaq iPaq users:
-----------------
Gpsdrive will detect the smaller display and make smaller menues.

It is also recommend to use the language xx, that means to start GpsDrive with:

LANGUAGE=xx gpsdrive



If you have no GPS receiver connected:
-------------------------------------
There is a build in simulator. It is automatically used if no GPS
receiver is found.

If you have created a waypoint file and have the right maps, you can
click on "Select target" to select a waypoint. The marker will move to
this waypoint.  In this menu you can also create a route.


I'm to lazy to go out of my bed, how can I test with my GARMIN GPS III?
----------------------------------------------------------------------

Your GARMIN has a built in simulator. Start it on the "satellite
screen", then go to setup and enter a speed in the simulator menu. Then
"goto" a stored waypoint and look how fine GpsDrive work.
Don't forget to download your maps first.



************************************************************************

How to get own maps?
-------------------

EASY USE:
You can do it with the "Download map" button in the program.
 
Below is the background of the file organization.

There is a file called "map_koord.txt" in your ~/.gpsdrive
directory. Here is a sample:

map_stmk.gif          47.08    15.45    300000
map_austria.gif       48.0     14.0    1000000
map_bruck-m-umgeb.gif 47.44    15.29    100000

The first row is the filename, then comes the latitude, the longitude
and the scale of the map. The scale of 10000000 is good for Europe,
and 100000 is for a town like Vienna.

GpsDrive selects the map with the best scale for your position. So get
a map i.e for Europe, Austria and Vienna if you want to drive in
Vienna.


For easy use, I provide the script "gpsfetchmap" to get the map from
the internet and make the entry in the map_koord.txt file.
Usage: 

gpsfetchmap filename latitude longitude scale

The filename should have the extension .gif.

ATTENTION: Mapblast.com maps with a scale greater than 1:2 millions
seems to be have another projection system, GpsDrive shows here a
INCORRECT position! Has anyone information about this?

*****************************************************
Please read the copyright notice of www.mapblast.com!
*****************************************************

File formats:

The decimal points in way.txt must always be a dot ('.'), in
map_koord.txt '.' or ',' are possible. If you download maps from
within the program, GpsDrive writes the map_koord.txt respecting your
LC_NUMERIC setting.

Can I use other maps?
--------------------

You can also use your own (self drawn, scanned...) maps. The maps must
be gif, jpeg, png or other common file formats (the format must be
recognized by the gdk-pixbuf library).  The lat/long coordinates you
write into the "map_koord.txt" file must be the center of the map. The
map must have a size of 1280x1024 pixels! 

Important! The maps must now be named map_* for streetmaps
and top_* for topographical maps. If not, gpsdrive won't
display the maps.

There is an "import assistant" build in. Use this to import your maps.

Importing waypoints:
-------------------

The easiest way is to use the script "wpget" which does all for you if
you use a GARMIN receiver.
You can use the program "garble" (included in the package) to read
out your waypoints from the Garmin GPS (Transfer mode must be set to
GARMIN here, while GpsDrive needs NMEA!).

"wpget" is a script which calls "garble" in the proper way.

Be sure to have "wpget", "wpcvt" and "garble" in your path. This is
fullfilled, if you did install the program as root and /usr/local/bin
is in your path.

The manual way:

You may create a file "way.txt" in your ~/.gpsdrive directory
which looks like:

DEFAULT  47.0792  15.4524
KLGNFR   46.6315  14.3152
MCDONA   47.0555  15.4488


The rows are: label latitude longitude.

There is no need to create the way.txt file yourself, you can add the
waypoints with GpsDrive using the "x" key. See help menu.

Some comments on fonts:
----------------------

GpsDrive uses the font 
"-monotype-arial-bold-r-normal-*-*-360-*-*-p-*-iso8859-15"
for the big letters. If this font is not found, it uses 
"-adobe-helvetica-bold-r-normal-*-*-240-*-*-p-*-iso8859-15"
which should be available on a XFree86 installation.

If you want to change the font, find the define "FONT1" in the source
code and replace the font string. 


Mailing list:

The address for the mailing list is gpsdrive@warbase.selwerd.nl

Subscribing can be done by sending a mail containing "subscribe
gpsdrive" to majordomo@warbase.selwerd.nl


=======================================================================

Suggestions and bug reports welcome!


Have a lot of fun!

Fritz Ganter <ganter@ganter.at>
http://www.kraftvoll.at

