Difference between revisions of "Basic configuration"

From Navit's Wiki
Jump to: navigation, search
(Created page with 'The main tasks for users at the moment are: * Installing Navit on different Operating Systems. * Configuring Navit (at the moment done by editing the <tt>navit.xml</tt> file. Thi...')
 
 
(19 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The main tasks for users at the moment are:
+
{{warning|1=The content of this page is now read only as we moved it to https://navit.readthedocs.io/en/latest/basic_configuration.html Please see that page for up to date content, and please submit updates there.}}
* Installing Navit on different Operating Systems.
+
 
* Configuring Navit (at the moment done by editing the <tt>navit.xml</tt> file. This will be possible even when the GUI takes over more and more tasks.
+
This page is dedicated to get a full working Navit installation for a first start and is required!<br>
* User Manuals for Navit
+
There are much more options, see [[configuration]].
** Set Destination
+
 
** Calculating the Route
+
==Preparations==
** Modify Display Settings
+
'''Get a supported map package'''<br>
** Modify properties of the vehicle
+
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).
** Add new Maps
+
 
 +
'''Install TTS'''<br>
 +
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'''<br>
 +
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==
 +
 
 +
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'''<br>
 +
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'''<br>
 +
Add the GPS connection
 +
 
 +
<source lang="xml"> <vehicle name="My" enabled="yes" source="file://dev/ttyS0"/ active="1"/></source>
 +
 
 +
See furthermore: [[Configuration]]
 +
 
 +
 
 +
'''Enable Map'''<br>
 +
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>
 +
 
 +
[[Category:Customizing]]
 +
[[Category:Support]]

Latest revision as of 18:12, 13 June 2019

This page is dedicated to get a full working Navit installation for a first start and is required!
There are much more options, see configuration.

Preparations

Get a supported map package
Navit can use different, 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
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.

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

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.

Configuring

Currently Navit doesn't provide an graphical tool to change settings, so you have to do the changes manually using an 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 longditude, which is conveniently covered by the sample map created on installation.

center="4808 N 1134 E"

See furthermore: Configuration


Setup GPS
Add the GPS connection

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

See furthermore: Configuration


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

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