GPSDRIVE(1)

NAME
gpsdrive - zeigt die GPS Position auf einer Karte an

SYNTAX
gpsdrive [-v] [-d] [-h] [-t device] [-f server] [-n name] [-o file] [-l english|german|spanish] [-s heigth] [-r width] [-x] [-a] [-1]

BESCHREIBUNG
Gpsdrive ist ein Auto (Motorrad, Schiff, Flugzeug) Navigationssystem. GpsDrive zeigt die Position auf einer zoombaren Karte an, die von einem NMEA fähigen GPS Empfänger geliefert wird. Die Karten werden automatisch ausgewählt, abhängig von der Position. Man kann einen bevorzugten Massstab wählen, den das Programm aus dem vorhanden Kartenmaterial einzuhalten versucht. GpsDrive wurde mit einem GARMIN GPS III und einer Crux II GPS PCMCIA Karte getestet. Alle GARMIN GPS Empfänger mit einem seriellen Ausgang sollten verwendbar sein. Ebenso alle anderen GPS Empfänger die ein NMEA Protokoll über die serielle Schnittstelle senden sollten mit GpsDrive arbeiten können. Diese GPS Empfänger sind bereits bekannt, dass sie mit GpsDrive arbeiten können: Magellan 310, 315, 320
Garminn GPS III
Garmin etrex
GPS 45
Crux II GPS PCMCIA card
Holux GM-200 serial version
Holux GM-200 USB (needs USB to serial support in kernel)
eMap
GPSMAP 295
GNS 530
Haftungsausschluss: Verwenden sie das Programm nicht zur Navigation!

OPTIONEN

-d  Zeigt ziemlich viele Debugging Informationen. Falls sie mit dem Programm Probleme haben, oder es abstürzt senden sie die Ausgabe an den Autor.

-v  Zeigt die Programmversion zusammen mit der CVS Version der Hauptdatei gpsdrive.c. Falls sie einen Fehlerbericht schicken, schicken sie diese Ausgabe ebenso mit.

-h  Zeigt eine kurze Hilfe.

-o Ausgabedatei
    Mit dieser Option können die NMEA Daten als Ausgabe an einen PTY Master, eine Datei oder an ein serielles Gerät senden. Das ist nützlich, falls sie GpsDrive im Simulatormodus benutzen und andere Programme mit den Testdaten versorgen wollen.

-t Gerät
    Serieller Anschluss (z.B. /dev/ttyS0) für den GARMIN Modus.

-l Sprache
    Legt die Sprache für die Stimmenausgabe fest. Sie müssen selbst dafür Sorge tragen, die richtigen Sprachdateien für festival installiert zu haben. Momentan werden die Werte german , spanish und english unterstützt.

-x  Erzeugt eigenes Fenster für die Menüknöpfe. Das ist bei kleinen Displays wie beim Compaq iPaq nützlich oder wenn sie Head Mounted Displays verwenden, um das Menü zu verbergen.

-s Höhe
    Setzt die Bilschirmhöhe in Punkten, falls die automatische Einstellung sie nicht zufriedenstellt. Die Höhe ist z.B. 768,600,480,200 -r Breite Setzt die Breite falls die automatische Einstellung sie nicht zufriedenstellt, arbeitet nur zusammen mit -s.

-f Freundeserver
    Legt einen "Freundeserver" fest über den sie Positionsinformationen mit anderen Leuten austauschen können. Verwenden sie z.B. linux.quant-x.at. Sie können ihren eigenen Server mit dem Programm friendsd starten, welches inkludiert ist.

-n ihrname
    Setzt den Namen der im Freundeserver Modus angezeigt wird.

-1  Setzt einen speziellen Modus falls sie sie nur eine Maustaste haben, z.B. bei Touchpads.

-a  Verhindert die Anzeige des Batteriestatus. Verwenden sie diese Option, wenn sie eine kaputtes APM BIOS haben, da dieses GpsDrive abstürzen lassen kann.

-b Servername
    Verwende einen entfernten NMEA server. Sie können gpsd auf einem anderen Rechner starten, an dem ein GPS Empfänger angeschlossen ist. Sie zeigen dann die Position auf ihrem lokalen Rechner an.

-c Wegpunktname
    Startposition im Simulationsmodus. Geben sie einen Wegpunktnamen aus der verwendeten Wegpunktdatei an.

ANSCHLUSS EINES GPS EMPFÄNGERS
Zuerst müssen sie zwischen GARMIN und NMEA Modus wählen. NMEA Modus.
Das ist der gebräuchliste Modus. Dieses Protokoll verwenden die meisten GPS Empfänger. Um den NMEA Modus zu benutzen, müssen sie das Programm gpsd gestartet haben. Der einfachste Weg ist, den "Starte GPSD" Knopf im Programm zu drücken. Das Programm läuft im Hintergrund und stellt einen Server dar, welcher die GPS Daten auf Port 2947 ausgibt. Die Einstellungen /dev/gps und 4800 Baud sind voreingestellt. Wenn sie diese Einstellungen ändern wollen, rufen sie gpsd folgendermaßen auf:
gpsd -p /dev/ttyS1 Vergewissern sie sich, dass das NMEA Protocol und 4800 Baud im GPS Gerät eingestellt sind. Einfacher ist es die Einstellungen in GpsDrive zu ändern und das Programm von dort zu starten. Seit GpsDrive Version 1.16 wird das gpsd von Remco Treffkorn mit GpsDrive mitgeliefert, welches den Port 2947 benutzt. Um die Ausgabe des GPS zu sehen, machen sie einfach telnet localhost 2947 and nach der Verbindung drücken sie die R Taste, um die NMEA Daten zu sehen. Verwendete NMEA Daten
Folgende NMEA Daten werden verwendet: GPRMC: Position, Geschwindigkeit, Heading (GpsDrive ist ohne GPRMC unbrauchbar)
GPGSV: Satellit Signal Pegel Anzeige
GPGGA: Höhe (nicht auf allen Empfängern verfügbar)
PGRME: Anzeige des EPE (erwarteter Positions Fehler), ev. nur auf GARMIN Empfängern verfügbar GARMIN Modus
In diesem Modus erhält das Programm lediglich die Werte für Länge und Breite, alles anderen Werte werden vom Programm selbst gerechnet. Weiters wird im GARMIN Modus keine Satellitensignalstärke angezeigt (dies wird vom GARMIN Protokoll nicht unterstützt). Der GARMIN Modus überträgt die Daten öfter (GARMIN: einige Male pro Sekunde, NMEA ca. 1 mal in 2 Sekunden). Wenn sie den Garmin Modus verwenden wollen, schliessen sie einfach den GPS Empfänger an die serielle Schnittstelle an. Machen sie am besten einen Link /dev/gps auf ihr serielles Gerät. Falls sie das nicht machen, müssen sie Gpsdrive mit dem Parameter -t gefolgt vom Gerätenamen, z.B.:
gpsdrive -t /dev/ttyS0
aufrufen. Der GARMIN Modus wird nur von einigen GARMIN Empfängern unterstützt.
GpsDrive erkennt automatisch GARMIN oder NMEA Modus.

Kompilieren ohne GARMIN Protokoll Unterstützung
Wenn sie kein GARMIN Protokoll benötigen (z.B. wenn sie nur NMEA benutzen), können sie GpsDrive ohne GARMIN-Protokoll Unterstützung kompilieren:
 ./configure --disable-garmin
 make clean
 make
 su
 make install Dies hat den Vorteil, dass sie ein kleineres und schnelleres Programm erhalten.

VERWENDUNG
Sie können GpsDrive ohne ein angeschlossenes GPS verwenden. Dann startet GpsDrive automatisch im Simulator Betrieb, bei welchem sie sich auf der Karte bewegen können. Stellen sie sicher, dass kein gpsd läuft damit der Simulator Betrieb starten kann.

KARTEN DOWNLOAD
Sie können ihre Karte vom Internet mit dem Knopf Karten downloaden laden. Sie können zwischen dem Mapblast Server (www.mapblast.com) und dem Expedia server (www.expedia.com) wählen. Verwenden sie das Programm gpsfetchmap um mehrere Karten für einen grösseren Bereich herunterzuladen. Bitte beachten sie die Copyright Informationen auf www.mapblast.com und www.expedia.com wenn sie diese Karten verwenden wollen.

Routen Planung
Verwenden sie das mitgelieferte perl script mb2gpsdrive.pl um eine Route zu ihrem Ziel zu erzeugen, die vom Mapblast.com Routenplaner berechnet wird. Bitte lesen sie README.mb2gpsdrive für die Programmverwendung.

PROXY SERVER
Falls sie auf das Internet über eine Proxyserver zugreifen wollen oder müssen, dann setzen sie bitte die Umgebungsvariable HTTP_PROXY oder http_proxy auf eine Wert wie z.B. http://proxy.provider.de:3128 wobei 3128 in diesem Beispiel die Portnummer des Proxyservers ist.

MAUS STEUERUNG
Sie können mit der Taste "P" auf den Positionsmodus schalten, bzw. diese Option im Menü auswählen. Wenn sie dann mit der linken Maustaste auf die Karte klicken, sind sie im "Postions Modus" wobei ein Quadrat den Cursor darstellt, jedoch keine Position angezeigt wird. Falls sie zoomen oder einen anderen Maßstab wählen, verhält sich das Programm so, als wäre der Cursor auf der aktuellen Position. Wenn sie mit der linken Maustaste nahe dem Rand klicken, scrollt die Karte weiter, bzw. wird eine neue passende Karte gelanden falls sie sich schon am Rand der Karte befinden. Die mittlere Maustaste schalten in den normalen Modus zurück. Ebenso, wenn sie mit der rechten Maustaste ein Ziel wählen. Auch die "P" Taste ist möglich. Die Linke- bzw. Rechte Maustaste zusammen mit Shift gedrückt, ändert den Maßstab der Karte. Werfen sie auch eine Blick in das Hilfe Menü von GpsDrive um über die aktuelle Mausbelegung und die Tastenkürzel informiert zu sein.

Neue Wegpunkte erzeugen
Sie können neu Wegpunkte einfach auf zwei Arten erzeugen: o Um einen Wegpunkt an der aktuellen (GPS) Position zu erzeugen, drücken sie einfach STRG und klicken sie mit der rechten Maustaste. Sie können auch einfach die x Taste drücken. o Um einen Wegpunkt an der Maus Position, zu setzen, klicken sie STRG und die LINKE Maustaste.

Routen
Eine Route ist eine Liste von Wegpunkten. GpsDrive führt sie von einem Wegpunkt zum Nächsten. Sie können Wegpunkte zu einer Route im "Wähle Ziel" Fenster hinzufügen. Sie können auch Kommentare zu Routen hinzufügen, welche dann durch die Sprachausgabe gesprochen und durch eine Laufschrift in der Karte angezeigt werden. Um Kommentare hinzuzufügen, erzeugen sie eine Datei mit dem selben Namen wie die Wegpunktdatei, jedoch mit der Erweiterung .dsc, z.B. way-reise.txt und way-reise.dsc. Geben sie dann wie unten angeführt die Kommentare in die .dsc Datei ein: $Wegpunktname Gehen sie nach rechts, dort sehen sie ein Wirtshaus. $Nächsterwegpunktname anderer Kommentar... Es gibt keine Beschränkung für die Länge des Kommentars.

LOKALISIERUNG
Wenn sie das Programm installiert haben, erscheint das Programm in englisch, deutsch, französisch, italienisch, holländisch, dänisch, türkisch, slowakisch, schwedisch, ungarisch oder spanisch falls eine dieser Sprachen eingestellt ist. Die entsprechenden Umgebungsvariablen sind LANG, LC_ALL oder LANGUAGE. Letztere überstimmt die anderen. Rufen sie "locale" bzw. "set" auf um ihre Einstellungen zu sehen. Um z.B. Deutsch zu erzwingen geben sie ein: export LANGUAGE=de und starten dann gpsdrive in dieser Shell. Sie könnes gpsdrive aber auch so starten: LANGUAGE=de gpsdrive womit die Einstellung nur für gpsdrive gilt.

SPRACHAUSGABE
Wenn sie eine Sprachausgabe wünschen, müssen sie die Software "festival" installieren. Siehe http://fife.speech.cs.cmu.edu/festival für mehr Informationen. Für deutsche Sprache müssen sie sich die deutsche Festival Version von www.ims.uni-stuttgart.de/phonetik/synthesis/index.html besorgen. Wenn sie ein funktionierendes festival haben, starten sie es als Server mit: festival --server Wenn sie dann GpsDrive starten, wird es den Server automatisch auf Port 1314 erkennen und Informationen als Sprache ausgeben. In diesem Fall erscheint auch ein Schalter um stumm zu schalten. GpsDrive versucht, automatisch die richtige Sprache entsprechend der Lokale zu verwenden. Es gibt eine Option -l um die Spracheinstellung zu forcieren. Zur Zeit werden englisch, spanisch und deutsch unterstützt. GpsDrive stellt festival auf die korrekte Sprache ein. Sollte dies nicht richtig funktionieren, editiern sie die Datei gpsdrive.c und korrigieren sie gegebenenfalls folgende Zeilen: #define FESTIVAL_ENGLISH_INIT "(voice_ked_diphone)" #define FESTIVAL_GERMAN_INIT "(voice_german_de3_os)" #define FESTIVAL_SPANISH_INIT "(voice_el_diphone)" GpsDrive braucht die Sprachdateien ked_diphone für Englisch, german_de3_os für Deutsch (Das ist eine MBROLA voice) und el_diphone für Spanisch. Es gibt eine tar-Datei für Festival mit deutscher, englischer und spanischer Sprache. Downloaden sie es von einem GpsDrive homepage Spiegel und entpacken sie die tar-Datei als root in /usr/local
cd /usr/local
tar -xvzf festivalbuild.tar.gz Starten sie den Server mit /usr/local/festival/bin/festival --server

MAILING LISTE
Die Adresse für die Mailingliste ist gpsdrive@warbase.selwerd.nl Eintragen können sie sich mit einer EMail mit dem Inhalt "subscribe gpsdrive" an majordomo@warbase.selwerd.nl

AUTOR
Fritz Ganter
E-Mail: ganter@ganter.at
http://gpsdrive.kraftvoll.at

GARANTIE
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.

COPYRIGHT
Copyright (c) 2001,2002 by Fritz Ganter
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.