gpsdrive

GPSDRIVE(1)                 General Commands Manual                GPSDRIVE(1)



NAME
       gpsdrive - zeigt die GPS Position auf einer Karte an

SYNTAX
       gpsdrive [Optionen]

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 (braucht USB zu seriell Unterstützung im Kernel)
       eMap
       GPSMAP 295
       GNS 530


       Haftungsausschluss: Verwenden sie das Programm nicht zur Navigation!


OPTIONEN
       -d     Zeigt einige debugging Informationen.

       -D     Zeigt ziemlich viele Debugging Informationen. Falls sie mit dem
              Programm Probleme haben, oder es abstürzt senden sie die
              Ausgabe an den Autor. Sie können es auch mit -d kombinieren.
              Siehe auch den BUGS Abschnitt weiter unten.

       -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 ). Sie können dies auch
              im Einstellungen Menü ändern.

       -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, Status und Karte.
              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.
              Sie können ihren eigenen Server mit dem Programm friendsd
              starten, welches inkludiert ist.

       -n Name
              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.

       -q     Schaltet SQL support ab. Nur verwendbar, wenn sie SQL
              Unterstützung einkompiliert haben.



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 gpsd von Gpsdrive aus starten,
       gelten die Einstellungen aus dem Einstellungen Menü.

       Wenn sie diese Einstellungen ändern wollen, rufen sie gpsd
       folgendermaÃen auf:
       gpsd -p /dev/ttyS1

       es ist jedoch einfacher, die Einstellungen in Gpsdrive selbst
       vorzunehmen.  Vergewissern sie sich, dass das NMEA Protocol und 4800
       Baud im GPS Gerät eingestellt sind.

       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
       GPGSV: Satellit Signal Pegel Anzeige
       GPGGA: Höhe (nicht auf allen Empfängern verfügbar) und Position
       falls kein GPRMC verfügbar ist. In diesem Fall wird die
       Geschwindigkeit und Richtung von GpsDrive errechnet.
       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.  Der GARMIN Modus wird
       nur von einigen GARMIN Empfängern unterstützt.

       GpsDrive erkennt automatisch GARMIN oder NMEA Modus falls dies im
       Einstellungen-Menü eingeschaltet ist.



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 und gpsfetchmap.pl 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
       Es existiert im Moment keine Routenplanung Funktion in GpsDrive.
       Routenplanung braucht Daten aus kommerziellen Karten, eine
       Datenbanklizenz kostet mehr als 10.000 Euro.


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. Sie können auch einfach die y Taste drücken.

       Im Popup Fenster geben sie den Wegpunkt Namen ein (Leerzeichen werden
       durch Unterstriche ersetzt) sowie den Wegpunkt Typ (siehe unten über
       vordefinierte Wegpunkt Typen). Sie können entweder einen neuen
       Wegpunkttyp erzeugen oder einen vorhandenen aus der Liste auswählen.
       Wichtig: Die Liste (nur im SQL Modus) zeigt die bereits verwendeten
       Wegpunkttypen, NICHT die Vordefinierten.


Icons für Wegpunkte
       Sie können die Wegpunkttypen frei definieren. Es gibt jedoch
       spezielle, vordefinierte Namen, welche ein spezielles Symbol im
       GpsDrive-Display erzeugen:


       WLAN   offener WLAN Accesspoint

       WLAN-WEP
              verschlüsselter WLAN Accesspoint

       Rest   ein Restaurant

       McDonalds
              eine "Art" Restaurant

       BurgerKing
              eine andere "Art" Restaurant

       Hotel  ein Hotel

       Shop   Einkaufsmöglichkeit

       Monu   Monument, hist. Gebäude, interessanter Tourismuspunkt

       Speedtrap
              Geschwindigkeitsmessung (Radar), warnt, wenn es sich in
              Fahrtrichtung befindet.

       Nightclub
              Pssst...

       Airport
              ein Flughafen

       Golf   Golfplatz

       Gasstation
              Tankstelle

       Cafe   Cafe

       Gross-/Kleinschreibung ist egal.

       Bitte lesen sie auch README.SQL , für eine aktuelle Liste der Wegpunkt
       Typen.


SQL Unterstützung
       Zur Verwaltung einer gröÃeren Anzahl von Wegpunkten sollte sie die SQL
       Unterstützung verwenden. Dazu muss ein SQL Server auf dem Rechner
       installiert sein. Momentan wird nur MySQL unterstützt.

       Haben sie keine Angst, MySQL braucht nicht viel Resourcen, ist sehr
       schnell und macht die Verwaltung der Wegpunkte einfacher (inklusive der
       Auswahl der Wegpunkttypen). Im SQL Modus können sie die anzuzeigenden
       Wegpunkte im Einstellungen Menü auswählen.

       Lesen sie bitte README.SQL für Informationen zum Aufsetzen der SQL
       Datenbank.



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.


Kommentare für Routen
       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. Es ist
       wichtig, dass die Zeile mit '$wegpunktname' beginnt und der Kommentar
       in der nächsten Zeile steht.


KISMET Unterstützung
       Gpsdrive unterstützt kismet.  Kismet ist ein 802.11b Funknetzwerk
       (WLAN) "Schnüffler". Wenn sie kismet laufen haben, wird GpsDrive das
       beim Programmstart entdecken und neue WLAN Accesspoints in Echtzeit auf
       der Karte anzeigen. Für den Kismet Modus ist der SQL Modus
       Voraussetzung. WLAN Accesspoints die bereits in der SQL Datenbank
       gespeichert sind werden ignoriert. Wenn sie die Sprachausgabe aktiviert
       haben, werden die Informationen über neue Accesspoints angesagt.

       Lesen sie bitte auch README.kismet



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.

       Falls ihre Sprache nicht verfügbar ist, kontaktieren sie mich wenn sie
       die Ãbersetzung machen wollen.


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


FRIENDSD Server
       Es gibt eine Server Software friendsd genannt, welche die Position
       ihrer Freunde verwaltet. Wenn sie zum Server mit gpsdrive -n Ihrname -f
       ihrserver.com verbinden, können sie die Position andere Leute sehen,
       falls diese sich mit diesem Server verbunden haben.  Stellen sie
       sicher, dass Ihrname nur aus einem Wort besteht und keine Leerzeichen
       enthält.

       Der Server benutzt den Port 50123 (TCP), dieser Port muss in der
       Firewall freigeschaltet sein. Der Server benötigt keine Root-Rechte
       und sollte als normaler User gestartet werden. Das Serverprogramm wurde
       NICHT auf Sicherheit überprüft!


FRIENDSD Daten Format (Version 1)
       Es gibt einen Datentyp: POS, mit folgendem Format:

       POS: Fritz  47.082181  15.402043 18:11:42 101 38

       mit der Bedeutung:

       Befehltyp Name Breite Länge Zeit(GMT) Geschwindigkeit(km/h)
       Richtung(Grad)



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://www.gpsdrive.de

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.





                                                                   GPSDRIVE(1)