~ubuntu-branches/ubuntu/maverick/gpsdrive/maverick

« back to all changes in this revision

Viewing changes to man/gpsdrive.1

  • Committer: Bazaar Package Importer
  • Author(s): Frank Kirschner
  • Date: 2004-05-25 11:44:03 UTC
  • Revision ID: james.westby@ubuntu.com-20040525114403-j3rsu57cavfax6z8
Tags: upstream-2.09
ImportĀ upstreamĀ versionĀ 2.09

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH GPSDRIVE 1 
 
2
.SH NAME
 
3
gpsdrive v2.x - displays GPS position on a map
 
4
.SH SYNOPSIS
 
5
.B gpsdrive [options]
 
6
 
 
7
.SH About this manual page
 
8
 
 
9
This manual page explain the basic functions of GpsDrive and some
 
10
additional info.
 
11
 
 
12
In GpsDrive you find tooltips for nearly all buttons, there is also a
 
13
HELP button for usage of the keys and mouse buttons.
 
14
 
 
15
For special purposes read the README files, i.e. README.kismet,
 
16
README.SQL ...
 
17
 
 
18
.SH DESCRIPTION
 
19
 
 
20
.B Gpsdrive 
 
21
is a car (bike, ship, plane) navigation system.  Displaying your
 
22
position on a map and a lot of other functions are implemented.
 
23
 
 
24
.B This manual page describes GpsDrive version 2.x
 
25
 
 
26
GpsDrive displays your position provided from your NMEA capable GPS
 
27
receiver on a zoomable map . The maps are autoselected depending on
 
28
your position. You can set prefered scale, which the program tries to
 
29
get from available maps.
 
30
 
 
31
GpsDrive was tested with a GARMIN GPS III, a Crux II GPS PCMCIA
 
32
card and a Navilock USB receiver. All Garmin GPS reveivers with a serial output should be
 
33
usable. Other GPS reveivers that sends NMEA protocol over the
 
34
serial output should also work with GpsDrive.
 
35
 
 
36
These GPS receivers are reported to work with gpsdrive:
 
37
 
 
38
Magellan 310, 315, 320
 
39
.br
 
40
Garmin GPS III
 
41
.br
 
42
Garmin etrex
 
43
.br
 
44
GPS 45
 
45
.br
 
46
Crux II GPS PCMCIA card
 
47
.br
 
48
Holux GM-200 serial version
 
49
.br
 
50
Holux GM-200 USB (needs USB to serial support in kernel)
 
51
.br
 
52
eMap
 
53
.br
 
54
GPSMAP 295
 
55
.br
 
56
GNS 530
 
57
.br
 
58
Garmin GPS 12MAP
 
59
.br
 
60
EAGLE Expedition II
 
61
.br
 
62
DeLorme Earthmate
 
63
.br
 
64
Rayming TripNav, TN-200
 
65
.br
 
66
Haicom HI-203E
 
67
.br
 
68
GM-307 USB-Mouse
 
69
.br
 
70
Magellan Meridian Gold (works only with NMEA V2.1 GSA setting)
 
71
.br
 
72
NAVILock GPS Receiver (http://www.navilock.de)
 
73
.br
 
74
Haicom GPS HI204e
 
75
.br
 
76
Magellan Nav 6500 
 
77
.br
 
78
BendixKing KLX 100
 
79
.br
 
80
Motorola i58sr Cellular Phone w/built-in NMEA-compatible GPS
 
81
.br
 
82
.br
 
83
 
 
84
Disclaimer:
 
85
.B Do not use for navigation!
 
86
 
 
87
.SH OPTIONS
 
88
.TP
 
89
.B \-d
 
90
Shows some debugging information.
 
91
.TP
 
92
.B \-D
 
93
Shows a lot of debugging information. If you have problems or program
 
94
crashes, send this output to the author. You should also combine this
 
95
with -d. See also the section 
 
96
.I BUGS
 
97
.TP
 
98
.B \-v
 
99
Shows program version together with the CVS version of the mainfile
 
100
gpsdrive.c. If you send a bug report, also include this output.
 
101
.TP
 
102
.B \-h
 
103
Displays a short help message.
 
104
.TP
 
105
.BI \-o "\| outputfile\^"
 
106
With this option, you can
 
107
.IR write
 
108
the NMEA sentences to a PTY master, file or serial device. This is
 
109
useful if you use GpsDrive in simulation mode to provide other GPS
 
110
applications with test data.
 
111
.TP
 
112
.BI \-t "\| device\^"
 
113
Serial port device (e.g. 
 
114
.IR /dev/ttyS0
 
115
). You can also set it in the 
 
116
.IR setup
 
117
menu.
 
118
.TP
 
119
.BI \-l "\| language\^"
 
120
Sets the language for the speech output. You have to provide the voice
 
121
files in festival yourself (see below). At the moment
 
122
.IR german
 
123
,
 
124
.IR spanish
 
125
and
 
126
.IR english
 
127
are provided.
 
128
.TP
 
129
.B \-x
 
130
Creates own window for the menu buttons, status and map. This is
 
131
helpful on small displays as the Compaq iPaq or on Head Mounted
 
132
Displays, where the menu should be hidden.
 
133
.TP
 
134
.BI \-s "\| height\^"
 
135
Set the height of the screen, if autodetection don't satisfy you, 
 
136
.IR height
 
137
is i.e. 768,600,480,200
 
138
.TP
 
139
.BI \-r "\| width\^"
 
140
Set the 
 
141
.IR width
 
142
of the screen, if autodetection don't satisfy you. Works
 
143
only in combination with
 
144
.IR -s
 
145
.TP
 
146
.BI \-f "\| friendsserver\^"
 
147
Define a friendsserver to exchange position information with other
 
148
people. You can also set it in the Settings/Friends menu. You can start your own friendsserver with the program
 
149
.B friendsd
 
150
, which is included. More details are in section 
 
151
.I FRIENDSD server
 
152
 
 
153
.TP
 
154
.B \-1
 
155
Set special mode if you only have 1 mouse button, i.e. on touchpads.
 
156
.TP
 
157
.B \-a
 
158
Disable display of battery status. Some implementations of the APM-BIOS
 
159
are broken, so use this option if gpsdrive crashes.
 
160
.TP
 
161
.BI \-b "\| servername\^"
 
162
Use a remote NMEA server. You can start gpsd on another
 
163
.IR host
 
164
, which has the GPS receiver connected and display the position on
 
165
your local machine.
 
166
.TP
 
167
.BI \-c "\| waypointname\^"
 
168
Initial position for simulation mode. Specify a
 
169
.IR "waypoint name"
 
170
from your currently used waypoint list.
 
171
.TP
 
172
.B \-q 
 
173
Disables SQL support. Only usefull if you have SQL support compiled in.
 
174
.TP
 
175
.B \-z
 
176
Don't show zoom and scaling on the map.
 
177
.TP
 
178
.BI \-n 
 
179
Disables the direct serial connection. You have to use Garmin mode
 
180
or start gpsd
 
181
.br
 
182
 
 
183
 
 
184
Use gpsdrive -h to see the actual command line help.
 
185
 
 
186
 
 
187
.SH CONNECTING A GPS RECEIVER
 
188
First you have to choose if you want use the GARMIN or NMEA mode.
 
189
 
 
190
.B NMEA mode.
 
191
.br
 
192
This is the most used mode. This mode is provided by most GPS
 
193
receivers. 
 
194
 
 
195
.B New!!!
 
196
 
 
197
Since 
 
198
.I Version 2.08
 
199
GpsDrive is now able to handle the serial
 
200
connection itself, so you don't need to start (and use) gpsd anymore.
 
201
.br
 
202
To enable this feature go into the settings menu, switch to settings 2
 
203
and select 
 
204
.I Use serial connection.
 
205
.br
 
206
Make sure that your GPS receiver is connected and running before you
 
207
start GpsDrive, so the program is able to detect the GPS device.
 
208
 
 
209
You can also use gpsd, i.e. if you want to share the GPS data over the
 
210
network or if you need additional features.
 
211
.br
 
212
You can force the use of gpsd by adding the
 
213
.B \-n
 
214
commandline parameter, even if you enabled the direct serial connection
 
215
in the settings menu.
 
216
 
 
217
.br
 
218
To use NMEA mode with gpsd, you have to start the provided program
 
219
.B gpsd
 
220
first or do this by pressing the 
 
221
.B Start GPSD
 
222
button in the GpsDrive menu after setting the parameters in the settings
 
223
menu.
 
224
This program runs as daemon in background and provides a server,
 
225
which sends the GPS data on port number 2947. 
 
226
The settings /dev/gps and 4800 BPS are precompiled if you start
 
227
gpsd by yourself. If you start it from GpsDrive, the settings defined
 
228
in the 
 
229
.B Settings
 
230
menu are used.
 
231
 
 
232
You can also change the gpsd settings i.e. to ttyS1 call it with:
 
233
.br
 
234
.B gpsd -p /dev/ttyS1
 
235
 
 
236
but as mentioned, it's easier to do this in GpsDrive.
 
237
.br
 
238
If you are using a GPS receiver with an USB connection, your port may
 
239
be
 
240
.B /dev/ttyUSB0
 
241
for the first device.
 
242
 
 
243
Be sure to select NMEA protocol and a baudrate of 4800 BPS in your
 
244
GPS receiver.
 
245
 
 
246
To see the output of you GPS do 
 
247
.B telnet localhost 2947
 
248
and after the connect hit the 
 
249
.B R
 
250
key to see the NMEA sentences.
 
251
 
 
252
.B NMEA sentences used
 
253
.br
 
254
Following NMEA sentences are used for specified informations:
 
255
 
 
256
.I GPRMC: 
 
257
Position, Speed, Heading 
 
258
.br
 
259
.I GPGSV: 
 
260
Satellite signal level display
 
261
.br
 
262
.I GPGGA: 
 
263
Altitude (not available on all receivers) and position if no GPRMC is
 
264
available. In this case, speed and heading are calculated by GpsDrive.
 
265
.br
 
266
.I PGRME: 
 
267
Display EPE (estimated position error), perhaps only available on
 
268
GARMIN receivers
 
269
 
 
270
At least you need GPRMC or GPGGA for using GpsDrive. If you can turn
 
271
on GPRMC, please do so.
 
272
 
 
273
.B GARMIN mode
 
274
.br
 
275
In this mode, the program only gets lat/long data, the speed and
 
276
direction it calculates itself. There is also no display of the
 
277
satellite signal level (this data is not supported by GARMIN
 
278
protocol).
 
279
 
 
280
GARMIN mode is faster (more data packets per second, in NMEA mode there are
 
281
only 1-2 packets every 2 seconds), but the calculations the program
 
282
makes may not be as accurate.
 
283
 
 
284
If you want to use Garmin mode, simply connect the GPS receiver to your
 
285
serial port. 
 
286
Garmin mode is only provided by some GARMIN receivers.
 
287
.br
 
288
 
 
289
GpsDrive autodetects GARMIN or NMEA mode if enabled in settings
 
290
menu. I would recommend to use NMEA mode.
 
291
 
 
292
.SH Compilation without GARMIN protocol
 
293
 
 
294
If you don't need the GARMIN protocol (i.e if you use only NMEA), you
 
295
can compile GpsDrive yourself to not include the GARMIN protocol
 
296
support. Do this with:
 
297
 
 
298
.br
 
299
 ./configure --disable-garmin
 
300
.br
 
301
 make clean
 
302
.br
 
303
 make
 
304
.br
 
305
 su
 
306
.br
 
307
 make install
 
308
 
 
309
This has the advantage to produce a smaller and faster executable.
 
310
 
 
311
.SH USAGE
 
312
 
 
313
Start GpsDrive as normal user with:
 
314
.B gpsdrive
 
315
from your shell, if you want another language see section 
 
316
.I LOCALISATION
 
317
 
 
318
On some distribution you may find a "GpsDrive" entry in your Gnome or
 
319
KDE menu.
 
320
 
 
321
It is important that you have installed GpsDrive as root, so it can
 
322
find the necessary files. 
 
323
.B Don't start GpsDrive as root!
 
324
 
 
325
You can use GpsDrive without a GPS device connected. If you do so,
 
326
GpsDrive will automatically start in
 
327
.B Simulator mode 
 
328
if no working GPS receiver is connected and no gpsd
 
329
is running. This mode is shown by a rotating globe.
 
330
 
 
331
In simulator mode the pointer can move on the map (if enabled in settings
 
332
menu). You can also stop gpsd if it is already running with the "Stop GPSD" Button.
 
333
 
 
334
If you have connected a GPS-Receiver, you see in the 
 
335
.I GPS Info
 
336
window how much satellites are in view. You can click on this image to switch to the 
 
337
.I Satellite position view.
 
338
.br
 
339
You must have at least 3 satellites in view. If you want to see your
 
340
altitude, you need at least 4 satellites.  The antenna of your GPS
 
341
receiver must have free sight to the sky, so you cannot use it
 
342
indoor. More satellites gives you a better accuracy.
 
343
 
 
344
If your receiver have not enough satellites with usable signal, the
 
345
GPS Info window is red. If your signal is ok and gives a valid
 
346
position, the GPS Info window is green.
 
347
 
 
348
There are 3 modes in which GpsDrive is operating:
 
349
 
 
350
.B Normal mode:
 
351
 
 
352
This mode is entered if you have a GPS receiver connected. The cursor is at the position your receiver sends.
 
353
 
 
354
The black and a red arrow shows your position on the map. The 
 
355
.B black arrow
 
356
is pointing to your selected target, the 
 
357
.B red arrow
 
358
shows the direction in which you are moving.
 
359
.br
 
360
If you have no valid position the arrows are blinking.
 
361
 
 
362
.B Simulation
 
363
 
 
364
If GpsDrive finds no GPS-receiver at program start, it
 
365
shows the last position and the cursor will move to the targets you
 
366
set. You can set your target by right-mouse click on the map or by
 
367
selecting a waypoint from the FIND menu.
 
368
 
 
369
.B Position mode
 
370
 
 
371
This mode is activated by clicking on the "Pos. mode" button or if you
 
372
"Jump" to a target in the FIND menu.
 
373
 
 
374
At this mode, you can temporary change the position for looking around and
 
375
jump to another positions (i.e. for downloading maps). In this mode this
 
376
is 
 
377
.B not your real position
 
378
and is marked as an rectangle.
 
379
 
 
380
You can set the position by simple left-mouse click on the map.
 
381
 
 
382
You can leave the position mode by by clicking on the "Pos. mode"
 
383
button or middle-mouse click or right-mouse click (which also sets
 
384
your target).
 
385
 
 
386
 
 
387
 
 
388
.SH MAP DOWNLOAD
 
389
 
 
390
You can easily download maps from internet with the
 
391
.B Download
 
392
button. GpsDrive stores an index of your maps in the file
 
393
map_koord.txt in your  ~/.gpsdrive directory. You can also use any
 
394
directory for your maps, but you have set the directory in the
 
395
settings menu.
 
396
 
 
397
.SH About maps
 
398
 
 
399
There is a file called "map_koord.txt" in your ~/.gpsdrive
 
400
directory. Here is a sample:
 
401
 
 
402
top_WORLD.jpg 0,00000 0,00000 88226037
 
403
.br
 
404
map_file0000.gif 53,60751 10,01145 3160000
 
405
.br
 
406
map_file0001.gif 43,08210 12,24552 3160000
 
407
.br
 
408
map_file0002.gif 49,81574 9,71454 7900000
 
409
.br
 
410
map_file0003.gif 47,72837 14,46487 592500
 
411
.br
 
412
 
 
413
 
 
414
The first row is the filename, then comes the latitude, the longitude
 
415
and the scale of the map. The scale of 10000000 is good for Europe,
 
416
and 100000 is for a town. To see detailed streets in a city, choose a
 
417
scale like 10000 or 5000.
 
418
 
 
419
GpsDrive selects the map with the best scale for your position. So get
 
420
a map i.e for Europe, Austria and Vienna if you want to drive in
 
421
Vienna.
 
422
 
 
423
 
 
424
There is also the programs
 
425
.IR gpsfetchmap.pl
 
426
provided to download multiple maps for a bigger area.
 
427
.br
 
428
.B Please consider the copyright information 
 
429
www.expedia.com if you want to use their maps!
 
430
.br
 
431
.B Don't missuse this service by downloading more maps as you need! 
 
432
You will risc that you will be blocked by this servers.
 
433
 
 
434
File formats:
 
435
 
 
436
The decimal points in way.txt must always be a dot ('.'), in
 
437
map_koord.txt '.' or ',' are possible. If you download maps from
 
438
within the program, GpsDrive writes the map_koord.txt respecting your
 
439
LC_NUMERIC setting.
 
440
 
 
441
 
 
442
.SH Can I use other maps?
 
443
 
 
444
You can also use your own (self drawn, scanned...) maps. The maps must
 
445
be gif, jpeg, png or other common file formats (the format must be
 
446
recognized by the gdk-pixbuf library).  The lat/long coordinates you
 
447
write into the "map_koord.txt" file must be the center of the map. The
 
448
map must have a size of 1280x1024 pixels! 
 
449
 
 
450
Important! The maps must now be named map_* for streetmaps
 
451
and top_* for topographical maps. If not, gpsdrive won't
 
452
display the maps.
 
453
 
 
454
There is an "import assistant" build in. Use this to import your maps.
 
455
 
 
456
.SH Importing waypoints:
 
457
 
 
458
 
 
459
The easiest way is to use the script "wpget" which does all for you if
 
460
you use a GARMIN receiver.
 
461
You can use the program "garble" (included in the package) to read
 
462
out your waypoints from the Garmin GPS (Transfer mode must be set to
 
463
GARMIN here, while GpsDrive needs NMEA!).
 
464
 
 
465
Scripts: "wpget" is a script which calls "garble" in the proper way.
 
466
 
 
467
Be sure to have "wpget", "wpcvt" and "garble" in your path. This is
 
468
fullfilled, if you did install the program as root and /usr/local/bin
 
469
is in your path.
 
470
 
 
471
The manual way:
 
472
 
 
473
You may create a file "way.txt" in your ~/.gpsdrive directory
 
474
which looks like:
 
475
 
 
476
DFN-Cert                53.577694    9.991263 FRITZ
 
477
.br
 
478
Finkenwerder            53.541765    9.842541 AIRPORT
 
479
.br
 
480
Fritz_Wohnung           53.582700    9.971390 FRITZ
 
481
 
 
482
The rows are: label latitude longitude waypoint-type. You may omit the
 
483
waypoint type.
 
484
 
 
485
There is no need to create the way.txt file yourself, you can add the
 
486
waypoints with GpsDrive using the "x" key. See help menu.
 
487
 
 
488
 
 
489
 
 
490
.SH Route planing
 
491
There is no route planing feature at the moment. Route planing would
 
492
need the use of commercial maps and a database license which costs
 
493
more than EUR 10.000. 
 
494
 
 
495
.SH PROXY SERVER
 
496
If you must access the internet via a proxy server, you have to set the
 
497
enviroment variable
 
498
.B HTTP_PROXY
 
499
or
 
500
.B http_proxy
 
501
to a value like
 
502
.I http://proxy.provider.com:3128
 
503
where 3128 in this example is the proxy port.
 
504
 
 
505
.SH MOUSE CONTROL
 
506
You can switch on the
 
507
.B Position mode
 
508
by selecting this option in the menu.
 
509
 
 
510
If you switched to "position mode" there a rectangle is the
 
511
cursor and no position is shown. If you zoom or select another map
 
512
scale with the slider, this is done for the position of the
 
513
rectangle-cursor in the same manner as it would be your actual
 
514
position. If you click with the left button near the border, GpsDrive will
 
515
scroll the map or load the next map if you are on the margin of the map.
 
516
 
 
517
The middle mouse button switches back to normal mode, or select the
 
518
"Pos. mode" menu entry. The same if you select a target with the right
 
519
mouse button.  Shift-left-mouse-button and shift-right-mouse-button
 
520
changes the map scale.
 
521
 
 
522
Please have also a look into the
 
523
.B Help
 
524
menu in GpsDrive to be informed about the actual mouse functions and key
 
525
shortcuts.
 
526
 
 
527
.SH Add new waypoints
 
528
You can simply add new waypoints in two ways:
 
529
 
 
530
o To add a waypoint at the
 
531
.B current (GPS) position, 
 
532
simply press CTRL and RIGHT-mouse-click. You can also press the
 
533
.B x
 
534
key.
 
535
 
 
536
o To add a waypoint at the
 
537
.B mouse position,
 
538
simply press CTRL and LEFT-mouse-click. You can also press the
 
539
.B y
 
540
key.
 
541
 
 
542
In the popup window add the waypoint name (spaces will be converted to
 
543
underscores) and a waypoint type (see below for predefined
 
544
waypoint types). You can create a new waypoint type by typing it into
 
545
the text field or choose a existing waypoint type from the list.
 
546
.B Important:
 
547
The list (in SQL mode only) shows already used waypoint types, NOT the
 
548
predefined. 
 
549
.SH Icons for waypoints
 
550
You can define freely your waypoint type names. But there are special
 
551
names, which results in special icons display in GpsDrive:
 
552
.TP
 
553
.B WLAN
 
554
open WLAN accesspoint
 
555
.TP
 
556
.B WLAN-WEP
 
557
crypted WLAN accesspoint
 
558
.TP
 
559
.B Rest
 
560
a restaurant
 
561
.TP
 
562
.B McDonalds
 
563
a kind of restaurant
 
564
.TP
 
565
.B BurgerKing
 
566
another kind of restaurant
 
567
.TP
 
568
.B Hotel
 
569
A hotel
 
570
.TP
 
571
.B Shop
 
572
Shop
 
573
.TP
 
574
.B Monu
 
575
Monument, touristic attraction
 
576
.TP
 
577
.B Speedtrap
 
578
Speedtrap (Radar), gives warning if this is in front of you
 
579
.TP
 
580
.B Nightclub
 
581
Pssst...
 
582
.TP
 
583
.B Airport
 
584
a Airport
 
585
.TP
 
586
.B Golf
 
587
Golf course
 
588
.TP
 
589
.B Gasstation
 
590
a gas station
 
591
.TP
 
592
.B Cafe
 
593
coffee bar
 
594
.TP
 
595
.B Geocache
 
596
Geocache point
 
597
 
 
598
.PD
 
599
.LP
 
600
The names are case insensitive.
 
601
 
 
602
Please have also a look on
 
603
.IR README.SQL
 
604
, for a actual list of waypoint types.
 
605
 
 
606
.SH User defined waypoint icons
 
607
 
 
608
If you are using SQL (see below) for your waypoints, you can define your own
 
609
waypoint icons.
 
610
.br
 
611
Do the following steps:
 
612
.br
 
613
Create the directory: $HOME/.gpsdrive/icons and 
 
614
place your icons (image type must be PNG) into this directory, with the name of
 
615
the waypoint type (the filename must be lowercase). 
 
616
In example for waypoint type "HOTEL" the file must have the name "hotel.png".
 
617
.br
 
618
The PNG image can have transparency, and should have a size around
 
619
16x16 until 32x32, bigger icons may result in a performance hit.
 
620
 
 
621
Your user defined waypoints override the built-in waypoint icons.
 
622
 
 
623
.SH SQL support
 
624
 
 
625
For managing a larger number of waypoints you should use SQL
 
626
support. This needs to install a SQL server on your machine. At the
 
627
moment, only MySQL is supported.
 
628
 
 
629
Don't be afraid, MySQL don't need much resources, is very fast, but makes the
 
630
management (including selection of waypoint types) of the waypoints
 
631
much easier. In SQL mode you can select the shown waypoints in the
 
632
.B setup
 
633
menu.
 
634
 
 
635
GpsDrive use MySQL automatically if it finds the shared library 
 
636
.I libmysqlclient.so.10 
 
637
and the MySQL Server is running and a connection to the database is possible. For first use you have to run 
 
638
.B create.sql
 
639
once.
 
640
 
 
641
.B Please read README.SQL for information how to setup the SQL database.
 
642
 
 
643
 
 
644
 
 
645
.SH Routes
 
646
A route is a list of waypoints. GpsDrive guides you from one waypoint
 
647
to the next on the route. 
 
648
You can add waypoints to a route using
 
649
the waypoint (select target) window. You can also add comments to a
 
650
waypoint which will be spoken by the speech system and also be shown
 
651
in the map window as scrolling text.
 
652
 
 
653
.SH Comments for routes
 
654
To add comments create a file with the same name as the waypoint file,
 
655
but change the suffix to .dsc, i.e way-trip.txt and way-trip.dsc, then
 
656
enter the comments in the way*.dsc file in the kind of:
 
657
 
 
658
$waypointname
 
659
Text which is displayed and spoken
 
660
 
 
661
$nextwaypointname
 
662
another text
 
663
 
 
664
Example:
 
665
 
 
666
$Fritz_Wohnung
 
667
Hier wohnt Fritz, der Autor von diesem Programm. Er freut sich auf Besuch und eine Einladung zu einem saftigen Steak.
 
668
                                                                                
 
669
$Hubertus
 
670
Hier wohnt Hubertus, ein Freund von Fritz.
 
671
 
 
672
There is no limit of the length of the comment. Important is to start
 
673
the line with '$name' and the comment in the next lines.
 
674
 
 
675
.SH KISMET support
 
676
Gpsdrive supports
 
677
.IR kismet.
 
678
Kismet is a 802.11b wireless network (WLAN) sniffer. If you have
 
679
kismet running, gpsdrive will detect it and program start and shows
 
680
new WLAN accesspoints in realtime on the map. SQL mode is necessary to
 
681
run Gpsdrive in Kismet mode. WLAN accesspoints which are already
 
682
stored in the SQL database from prior wardrivings are ignored. If you
 
683
have voice output in gpsdrive, you hear information about the new
 
684
found accesspoint.
 
685
 
 
686
Please see also the file
 
687
.IR README.kismet
 
688
 
 
689
.SH LOCALISATION
 
690
 
 
691
If you installed the program it will display messages in english,
 
692
german, french, italian, dutch, dansk, hungarian, slovak, swedish, turkish or
 
693
spanish if your language is set either with LANG or LANGUAGE. LANGUAGE
 
694
overrides all other settings. Call "locale" to see the settings and
 
695
call "set" if LANG or LANGUAGE is set. For german do:
 
696
 
 
697
.B export LANGUAGE=de
 
698
 
 
699
and then call gpsdrive in this shell.
 
700
 
 
701
You can also start it with the line 
 
702
.B LANGUAGE=de gpsdrive
 
703
without setting the language for the shell.
 
704
 
 
705
Sometimes you have to do use LANG instead of LANGUAGE.
 
706
 
 
707
If your own language isn't available, please contact me if you want to
 
708
make the translations.
 
709
 
 
710
.SH SPEECH OUTPUT
 
711
 
 
712
If you want speech output you have to install the festival speech output
 
713
system.
 
714
See 
 
715
.I http://fife.speech.cs.cmu.edu/festival
 
716
for information.
 
717
 
 
718
For german output you have to get the german festival from
 
719
.I www.ims.uni-stuttgart.de/phonetik/synthesis/index.html
 
720
 
 
721
If you have a functional festival software call it as server with:
 
722
 
 
723
festival --server
 
724
 
 
725
When you start GpsDrive it will detect the server on port 1314 and
 
726
puts out some status information as speech. You also have an
 
727
additonal button (Mute) to switch off sound output.
 
728
 
 
729
GpsDrive tries to select the correct language for your locale.
 
730
The -l option can force the languages for speech
 
731
output. At the moment english, spanish, and german are supported. GpsDrive
 
732
sets festival into the proper language. If the initialisation is not
 
733
correct, have a look into 
 
734
.I gpsdrive.c
 
735
and edit following defines do your needs:
 
736
 
 
737
#define FESTIVAL_ENGLISH_INIT "(voice_ked_diphone)"
 
738
 
 
739
#define FESTIVAL_GERMAN_INIT "(voice_german_de3_os)"
 
740
 
 
741
#define FESTIVAL_SPANISH_INIT "(voice_el_diphone)"
 
742
 
 
743
For this, you need the voices ked_diphone for english, german_de3_os
 
744
for german (this is a MBROLA voice) and el_diphone for spanish.
 
745
 
 
746
There is now an unsupported build of festival including english, german
 
747
and spanish support.
 
748
.B Download 
 
749
it from GpsDrive homepage 
 
750
.B mirrors
 
751
and extract
 
752
the tar file in the directory /usr/local as root:
 
753
 
 
754
.br 
 
755
cd /usr/local
 
756
.br
 
757
tar -xvzf festivalbuild.tar.gz
 
758
 
 
759
Start the server with
 
760
.B /usr/local/festival/bin/festival --server
 
761
 
 
762
 
 
763
.SH FRIENDSD server
 
764
 
 
765
There is a server program, called
 
766
.B friendsd
 
767
which acts as server for the position of your friends. If you enable
 
768
it in the settings menu, 
 
769
then you can see the position of all gpsdrive connected with this
 
770
server. 
 
771
 
 
772
You see the position of your friends as a car symbol on the map, including the name, time, day of week
 
773
and the speed of his last connection. The blue arrow shows the last reported direction of your friend.
 
774
 
 
775
The time is transmitted as UTC, but shown on the display as your local time, 
 
776
so it is also correct if your friend lives in another time zone.
 
777
 
 
778
The server uses port 50123 (UDP), so be sure that you open the port in
 
779
your firewall. The server needs no root privileges and should run as
 
780
normal user or a special user with no privileges. The server was NOT
 
781
tested for security.
 
782
 
 
783
There is a friends server running on www.gpsdrive.cc, you can try it
 
784
if you enable it in the settings menu.
 
785
 
 
786
You can also send messages to other mobile targets (Misc. Menu/Messages)
 
787
 
 
788
 
 
789
.SH MAILING LIST
 
790
The address for the mailing list is 
 
791
.B gpsdrive@warbase.selwerd.nl
 
792
 
 
793
Subscribing can be done by sending a mail containing 
 
794
.B subscribe gpsdrive 
 
795
 
 
796
to majordomo@warbase.selwerd.nl
 
797
 
 
798
.SH BUGS
 
799
Please send bug reports to the author. Report version (gpsdrive -v),
 
800
screen size and info how to reproduce the bug. It is also a big help
 
801
to run gpsdrive for a minute with the -d option and send me the output.
 
802
 
 
803
If gpsdrive crashes with a segfault, I need a backtrace of the program
 
804
in addition. To create a backtrace do following:
 
805
 
 
806
Extract the tar file, change to gpsdrive directory and do
 
807
.br
 
808
 ./configure \-\-with\-debug
 
809
.br
 
810
 make clean
 
811
.br
 
812
 make
 
813
.br
 
814
 cd src
 
815
.br
 
816
 gdb ./gpsdrive
 
817
 
 
818
Inside the debugger do:
 
819
 
 
820
run (if you use arguments write it after run)
 
821
 
 
822
When you get the segfault type in:
 
823
 
 
824
bt
 
825
 
 
826
and send me this output.
 
827
 
 
828
.SH AUTHOR
 
829
Fritz Ganter
 
830
.br
 
831
E-Mail: ganter@ganter.at
 
832
.br
 
833
http://www.gpsdrive.cc
 
834
.SH WARRANTY
 
835
This program is distributed in the hope that it will be useful,
 
836
but WITHOUT ANY WARRANTY; without even the implied warranty of
 
837
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
838
GNU General Public License for more details.
 
839
 
 
840
.SH COPYRIGHT
 
841
Copyright (c) 2001-2004 by Fritz Ganter
 
842
.br
 
843
This program is free software; you can redistribute it and/or modify
 
844
it under the terms of the GNU General Public License as published by
 
845
the Free Software Foundation; either version 2 of the License, or
 
846
(at your option) any later version.
 
847
 
 
848