Skip to content

Commit

Permalink
Testing RST
Browse files Browse the repository at this point in the history
  • Loading branch information
pgrandin committed Oct 2, 2017
1 parent efaed86 commit 61efb2f
Showing 1 changed file with 16 additions and 8 deletions.
24 changes: 16 additions & 8 deletions docs/basic_configuration.rst
Original file line number Diff line number Diff line change
@@ -1,44 +1,52 @@
There are much more options, see [[configuration]].

==Preparations==
'''Get a supported map package'''
Preparations
============
Get a supported map package
---------------------------
Navit can use different [[Category:Maps|map 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 (as. navit/maps or /usr/share/navit/maps).

'''Install TTS'''
Install TTS
-----------
To get speech support, you need to install a text-to-speech tool, such as '''espeak''', '''mbrola''' of '''festival'''. These tools can be invoked from the command line. Test your setup by invoking the tools manually e.g.
<source lang="bash">espeak "This is a text!"</source>
On some systems Navit comes with integrated espeak support, so you don't need to download it separately.

'''Connect GPS'''
Connect GPS
-----------
Now please 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
<source lang="bash">cat /dev/rfcomm0</source>
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.

==Configuring==
Configuring
===========

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


'''Setup proper startup-position'''
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 longditude, which is conveniently covered by the sample map created on installation.

<source lang="xml">center="4808 N 1134 E"</source>

See furthermore: [[Configuration]]


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

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

See furthermore: [[Configuration]]


'''Enable Map'''
Enable Map
----------
Just change the map entry corresponding to your local folders
<source lang="xml"> <map type="binfile" enabled="yes" data="/var/navit/maps/uk.bin" /></source>

Expand Down

0 comments on commit 61efb2f

Please sign in to comment.