maemo.org - Talk - Navit on N900

So a "test" tutorial... it's not complete, but many steps are about to be OK.

Steps and use to install correctly Navit:
1) Control your installed tools
- gainroot for the xterminal
- librsvg2-common

Install Rootsh
The gainroot command is under "rootsh" name in the classical repository... at this step, it's easy. Don't have? download and install it.
Then, reboot your terminal (by security)

The librsvg2-common libraries
Don't panic, it needs to tape few xterminal commands, but nothing hard!

- open Xterminal, then type (line by line)

Code:

sudo gainroot

apt-get install librsvg2-common

- you'll see many informations. To make it, you need to have a web connection (Wifi or network... no real importance).
- Wait... then close the x terminal.

2) Get the needed components
A this point, download
- Navit distribution
- Espeak system (for vocal informations)
- Maps you need
- Configuration XML files

3) Navit distribution
http://rapidshare.com/files/364969894/Navit-svn3048.zip
(last valid link 19-03-2010)

4) XML files
Download this file
http://talk.maemo.org/attachment.php...4&d=1264836319

5) Maps
Here is a little bit complicated reflexion:
witch one?
Look here and read it carefully:
http://wiki.navit-project.org/index.php/Main_Page#Maps
For me, i've take the map here ( Free openstreetmap)
http://maps.navit-project.org/download/
- How to?
Simply: zoom on your area, then click on "select" radio button, then push the "Get map!" button. You'll get à ***.bin file. Save it locally on your computer.
Don't forget: the bigger area you select, the bigger size the file is;)
Then, rename this file to something easy to remember.

Let's take an example: my file is renamed to france.navit.bin. This will be usefull on the next steps.

6) Espeak component
Espeak is needed for vocal routing. It's easy to install, because you've only to get this app on repositories (please check if you've added the extras and extras-devel repositories).
Then... Download, and wait for the installation!

7) The setup of Navit
So, you've the zip file of navit, and, hopefully, your map! unpack your zip into a folder, and get these files (it's an example, the names may changes between releases):
navit-data_0.2.0~svn3014maemo_all.deb
navit-graphics-gtk-drawing-area_0.2.0~svn3014maemo_armel.deb
navit-gui-gtk_0.2.0~svn3014maemo_armel.deb
navit-gui-internal_0.2.0~svn3014maemo_armel.deb
navit_0.2.0~svn3014maemo_armel.deb

Good!
Now... notice it carefully: the path on a windows is shown as (for example) C:\somewhere\subdirectory", instead of linux where it is like '/etc/navit/'
For now, it looks not useful, but... really...

8) Put the files...
Connect your phone like a mass storage volume. A the root of the new disk (on windows), you'll see many storage directories. Create two directories:
One named ".navit"
One named "navit_maps"
For the ".navit" folder, it's a little bit harder. Why? Because XP (and any other Win system) doesn't like folders with a point. To be honest, the problem is that the point and click system doesn't allow it, but the file system does!

So, two solutions:
1) Create it under the DOS mode.
Click on Start->Execute-> then, type

Code:

cmd

You'll get a windows with a Xterminal like (what a pitty... type commands on a "modern" system :D )
Identify which letter is associated to your device. In this small example, it is "J". I can be anything else! Watch carefully, and type the code below:

Code:

j:

mkdir ".navit"

2) Create the folder under Xterminal
Open the Xterminal
And type:

Code:

cd /home/user/

mkdir .navit

Be careful: DON'T type "sudo gainroot" before these lines, because the users folder is associated to each profile.
For example:
if you copy .xml file into /home/users/.navit without gainroot, when you'll launch Navit, the file will be read.
If you make theses commands under root profile, you'll be obliged to launch Navit with root autorisations... Not so easy as launch Navit from dashboard, not?;)

Done? GOOD! Put the files like this:
- europe.bin into "navit_maps"
- The navit files into the same directory

9) Install the program
Open a Xterminal, then tape these lines

Code:

sudo gainroot

dpkg -i /path/to/navit*.deb

In my example, i've putted the files into the "navit_maps" folder, (by copying these files when my device was connected in mass storage mode)
So the shell has to be like this:

Code:

sudo gainroot

dpkg -i /home/user/MyDocs/navit_maps/navit*.deb

A little detail: type it exactly! The "*" character is a wildcard symbol, so it's normal. The command line is to install the whole five .deb packages.

Then wait... a litte bit. If the soft ask something, let all by default and answer like the default value shown.

10) Why the files needs to be into a specific folder?
Because we have to parameter the XML files, to explain to navit where the soft will find the maps!
so: Assume this
/home/user/MyDocs is the path to the "root" of the mass storage datas.
Then

Code:

/home/user/MyDocs/navit_maps

will be the path to the maps
and

Code:

/home/user/.navit will be a path to specific parameters

understood? Well... We need it!

11) What about the configuration?
Well. You've got to know some little things
- The maps has to be configurated
- The path needs to be included into your configuration!

Easy or not? Good question...

12) How to configurate your XML system?
Accept one thing: each user on Linux has his own file architectory. For example: a path named /home/user/subdir will contains a file for the "user" profile, and the "same" path under root user will contains another files.

Got it? So:
Configure the XML : the maps
let's open the maps.xml (from the zip downloaded before), and look in it:

Code:

<map type="binfile" enabled="yes" data="/home/user/MyDocs/navit_maps/france.navit.bin"/>

My example shows a maps installed into the "navit_maps" (seen before as a folder when my device was plugged as mass storage)
Modify this line to put the name of the file you've got.
An example? Your file is 'IliveInAmerica.bin". Ok... let's modify the text!

Code:

<map type="binfile" enabled="yes" data="/home/user/MyDocs/navit_maps/IliveInAmerica.bin"/>

Warning
- Linux is case sensitive... be carefull when you're typing a text into these files!
- The files under Windows and under Linux are not written with same rules... so, Use Pspad, notepad++ (or any other file writer) to save the .XML files into "Linux/unix" standard.

The XML files: let's copy it!
Put your files into your device under the same directory where the maps are... It's not very clean, but it's easier for me.

Unplug your device. Wait a litte bit (the folders needs to be "reactivated" by the device).

This step is the "harder", because you should be patient, type correctly the shell commands, and use the small keyboard ^^

Then... Get ready!
- First: open the Xteminal app
Type theses commands one by one (at each end line, press Enter)

Code:

cp /home/user/MyDocs/navit_maps/*.xml /home/user/.navit

cd /home/user/.navit

ls

Can you see the files? Is it shown correctly? Yes? GOOD! The copy is done!
Type "navit" and press enter!

GOTCHA!