How To Install

This installation manual is divided into two parts. The first part presents preliminary configurations that must be done before starting any development on the Opemoko Neo FreeRunner (GTA02). The second part describes the technical steps to follow in order to install the GeoSharing project on the Neo FreeRunner.

All those steps have been tested on a Neo FreeRunner and on a laptop running Ubuntu 10.10 with access to root privileges.

==Preliminary configurations==
This section consists in three parts. The first thing to do is to configure a connection between the Neo FreeRunner and a computer via a USB cable. Most of the operations that must be executed on the Neo FreeRunner are easily performed on a computer disposing of a keyboard and a larger screen than the GTA02. A SSH connection should thus be established from the computer to the Neo FreeRunner in order to have access to it.

The second part details the installation steps of an operating system (OS) on the Neo FreeRunner. This operation is made possible thanks to the communication channel created before via the USB cable. The operating system called SHR was chosen to be used in the scope of the GeoSharing project.

The third part shows how it is possible to share the internet connection of a computer with the Neo FreeRunner via the USB cable.

===USB interface configuration===
An important thing to notice is that the USB connectivity is considered as an ethernet connection by both the Neo FreeRunner and the computer. This implies the use of IP addresses to identify both ends of the connection. By default, the Neo FreeRunner has a static IP address: '''192.168.0.202''' and nothing must be done to change that. The goal is then to configure the computer to have an IP address in the same sub-network than the Neo FreeRunner to be able to communicate with it.

1) The first thing to do on the computer is to create an alias for the IP address of the Neo FreeRunner. Edit the file '''/etc/hosts''' by adding the line:

 192.168.0.202 openmoko

2) There exists two possible methods to set up an ethernet connection between both devices via the USB cable. On the computer, it is possible to choose:
	
	



* http://itouchmap.com/latlong.html