summaryrefslogtreecommitdiff
path: root/docs/basic_configuration.rst
blob: 5fa20f6e3db5b8b0ba4f346b4bb19a4c458822ff (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
There are much more options, see [[configuration]].

***********
Preparation
***********
Get a supported map package
---------------------------
Navit can use different :doc:`maps` formats, including free `OpenStreetMap` data. In order to use one of these maps, download a map of your desired area and store it into a local folder (such as navit/maps or /usr/share/navit/maps).

Install TTS
-----------
To get speech support, you need to install a text-to-speech tool such as **espeak**, **mbrola** or **festival**. These tools can be invoked from the command line. Test your setup by invoking the tools manually e.g.

.. code-block:: bash

  espeak "This is a text!"

On some systems Navit comes with integrated espeak support, so you don't need to download it separately.

Connect GPS
-----------
Now connect your GPS. The exact procedure for this varies depending on the type of GPS device you are using and how you connect it to your computer. On Linux / Unix systems, your GPS should typically show up as a character device, i.e., you will find an entry in the /dev folder corresponding to your GPS device. Again, the file name depends on the type and connection method of your GPS receiver. See [[Connecting a GPS receiver]] for details.

Most GPS receiver will output the position in [[NMEA]] format, which can be used directly in Navit or using a GPS daemon program such as **gpsd**. A simple way to test whether your GPS receiver works and outputs NMEA data is to dump its output to a console. For example, if your GPS receiver can be found at **/dev/rfcomm0**, you can dump its output using

.. code-block:: bash

   cat /dev/rfcomm0

The output should give you steady NMEA position updates. You can feed this information into **gpsd** / **xgps** or **QLandkarte** to see a graphical representation of your position and to check whether the output corresponds to your current position.

***************
Getting started
***************

Currently Navit doesn't provide a graphical tool to change settings, so you have to do the changes manually using a texteditor.
Please open your current **navit.xml** file and do the following steps:


Setup proper startup-position
-----------------------------
On Navit's very first startup, it needs a **center** to look at on the map. By default this is set to Munich in Germany (at latitude 48.08 and longitude, which is conveniently covered by the sample map created on installation).

.. code-block:: xml

   <navit center="4808 N 1134 E" />

See furthermore: :doc:`configuration/index`


Setup GPS
---------
Add the GPS connection

.. code-block:: xml

   <vehicle name="My" enabled="yes" source="file://dev/ttyS0" active="1"/>

See furthermore: :doc:`configuration/index`


Enable Map
----------
Just change the map entry corresponding to your local folders

.. code-block:: xml

  <map type="binfile" enabled="yes" data="/var/navit/maps/uk.bin" />