How To Install

From GeoSharing

Jump to: navigation, search
 
Line 1: Line 1:
-
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.
+
This installation manual is divided into two parts. The first part presents preliminary configurations that must be done before starting any development on the [[FreeRunner|Opemoko Neo FreeRunner (GTA02)]]. The second part describes the technical steps to follow in order to install the GeoSharing project on the [[FreeRunner|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.
All those steps have been tested on a Neo FreeRunner and on a laptop running Ubuntu 10.10 with access to root privileges.
Line 22: Line 22:
The easiest way to set up the connection with the Openmoko is to create a new connection (called Openmoko here) in the wired networks tab of the computer network manager. For this new connection, choose a static (manual) IP address: '''192.168.0.200'''.
The easiest way to set up the connection with the Openmoko is to create a new connection (called Openmoko here) in the wired networks tab of the computer network manager. For this new connection, choose a static (manual) IP address: '''192.168.0.200'''.
 +
<div style="text-align: center;">
[[File:Screenshot-Editing Openmoko.png|350px]]
[[File:Screenshot-Editing Openmoko.png|350px]]
 +
</div>
==== Without the network manager ====
==== Without the network manager ====
Line 58: Line 60:
3) The application is now running and the interface looks like:
3) The application is now running and the interface looks like:
-
[[File:Neotool-1.png|150px]]
+
<div style="text-align: center;">
 +
[[File:Neotool-1.png|350px]]
 +
</div>
4) On the computer, download the latest version of the SHR operating system. The version of SHR used to realise this manual is the version SHR-testing 2.6.29-oe11. Images of the SHR operating system can be found at http://build.shr-project.org/shr-testing/images/om-gta02/. Two files are required:
4) On the computer, download the latest version of the SHR operating system. The version of SHR used to realise this manual is the version SHR-testing 2.6.29-oe11. Images of the SHR operating system can be found at http://build.shr-project.org/shr-testing/images/om-gta02/. Two files are required:
Line 66: Line 70:
5) In neoTool (which is running on the computer), select the second item '''Flash your Neo''' and click '''OK'''. The interface looks like:
5) In neoTool (which is running on the computer), select the second item '''Flash your Neo''' and click '''OK'''. The interface looks like:
-
[[File:Neotool-2.png|150px]]
+
<div style="text-align: center;">
 +
[[File:Neotool-2.png|170px]]
 +
</div>
On the next screen, don't change anything and click `OK'.
On the next screen, don't change anything and click `OK'.
Line 75: Line 81:
8) When the process is done, the Neo FreeRunner restarts automatically and the new operating system is ready to be used.
8) When the process is done, the Neo FreeRunner restarts automatically and the new operating system is ready to be used.
-
 
=== Internet connectivity ===
=== Internet connectivity ===
 +
[[File:Internet-on-your-neo-1.png|thumb|400px|Internet on FreeRunner via USB]]
When the operating system is installed and running, the configuration steps required in order to share the internet connectivity of the computer with the Neo FreeRunner via the USB cable are the followings. These steps must be done on the computer connected to the Neo FreeRunner.
When the operating system is installed and running, the configuration steps required in order to share the internet connectivity of the computer with the Neo FreeRunner via the USB cable are the followings. These steps must be done on the computer connected to the Neo FreeRunner.
-
\begin{enumerate}
 
-
\item On the computer, edit the file \texttt{/etc/sysctl.conf}
 
-
\begin{lstlisting}
 
-
$ gedit /etc/sysctl.conf
 
-
\end{lstlisting}
 
-
\item Look for the following line in this file:
+
1) On the computer, edit the file '''/etc/sysctl.conf'''
-
\begin{lstlisting}
+
-
#net.ipv4.conf.default.forwarding=1
+
-
\end{lstlisting}
+
-
and uncomment it (remove the \# character if not already done).% This change will be effective at the next reboot of the computer.
+
$ gedit /etc/sysctl.conf
-
%\item The following command can be use to make the previous change effective directly:
+
2) Look for the following line in this file:
-
%\begin{lstlisting}
+
-
%$ sudo sysctl -w net.ipv4.conf.default.forwarding = 1
+
-
%\end{lstlisting}
+
-
\item The iptables of the computer must be configured such that the computer behaves as a simple router for the Openmoko. The computer must forward packets coming from the Neo FreeRunner to the internet and the other way around. Edit the file \texttt{/etc/rc.local}:
+
#net.ipv4.conf.default.forwarding=1
-
\begin{lstlisting}
+
and uncomment it (remove the # character if not already done).
-
$ gedit /etc/rc.local
+
-
\end{lstlisting}
+
-
and add these lines at the end of the file:
+
3) The iptables of the computer must be configured such that the computer behaves as a simple router for the Openmoko. The computer must forward packets coming from the Neo FreeRunner to the internet and the other way around. Edit the file '''/etc/rc.local''':
-
\begin{lstlisting}
+
$ gedit /etc/rc.local
-
/sbin/iptables -P FORWARD ACCEPT
+
-
/sbin/iptables --table nat -A POSTROUTING -s 192.168.0.202/32 -o iface -j MASQUERADE
+
-
\end{lstlisting}
+
-
where iface corresponds to the interface of the computer connected to the internet (wlan0, eth0, eth1, ...). %These changes also take effect only after a reboot. To make them effective directly, type the same command in a terminal by replacing \textbf{/sbin/} by \textbf{sudo}.
+
and add these lines at the end of the file:
-
\item The computer have now to be rebooted.
+
-
\end{enumerate}
+
-
The internet connection of the computer is now shared with the Neo FreeRunner. In order to check if the sharing of the internet connection is well configured, from the Neo FreeRunner, perform a \texttt{ping} to \texttt{www.google.com} and the results should look like this:
+
/sbin/iptables -P FORWARD ACCEPT
 +
/sbin/iptables --table nat -A POSTROUTING -s 192.168.0.202/32 -o iface -j MASQUERADE
-
\begin{lstlisting}
+
where iface corresponds to the interface of the computer connected to the internet (wlan0, eth0, eth1, ...).  
-
root@om-gta02 ~ # ping www.google.com
+
-
PING www.google.com (66.102.13.103): 56 data bytes
+
-
64 bytes from 66.102.13.103: seq=0 ttl=55 time=19.548 ms
+
-
64 bytes from 66.102.13.103: seq=1 ttl=55 time=35.519 ms
+
-
(...)
+
-
\end{lstlisting}
+
 +
4) The computer have now to be rebooted.
-
%% ===================================================================
+
The internet connection of the computer is now shared with the Neo FreeRunner. In order to check if the sharing of the internet connection is well configured, from the Neo FreeRunner, perform a '''ping''' to '''www.google.com''' and the results should look like this:
-
\newpage
+
-
%% ===================================================================
+
-
\section{GeoSharing project installation}\label{app:geosharing+on+neo}
+
root@om-gta02 ~ # ping www.google.com
-
Since the GeoSharing project is based on the OLSRd Linux d\ae mon and on tangoGPS, it is mandatory to compile and install those two applications as well as the GeoSharing application.
+
PING www.google.com (66.102.13.103): 56 data bytes
 +
64 bytes from 66.102.13.103: seq=0 ttl=55 time=19.548 ms
 +
64 bytes from 66.102.13.103: seq=1 ttl=55 time=35.519 ms
 +
(...)
-
Before going any further, extra packages such as a C compiler (\texttt{gcc}) and libraries (\texttt{libglib}, \texttt{libconfig}, \texttt{libgps}, etc.) need to be installed on the Neo FreeRunner. In order to install these packages, an internet connection is required. The following commands must then be executed on the Neo FreeRunner.  
+
== GeoSharing project installation ==
 +
Since the GeoSharing project is based on the OLSRd Linux daemon and on tangoGPS, it is mandatory to compile and install those two applications as well as the GeoSharing application.
-
\begin{lstlisting}[label=packages,caption=Packages to install on the Neo FreeRunner.]
+
Before going any further, extra packages such as a C compiler ('''gcc''') and libraries ('''libglib''', '''libconfig''', '''libgps''', etc.) need to be installed on the Neo FreeRunner. In order to install these packages, an internet connection is required. The following commands must then be executed on the Neo FreeRunner.  
-
root@om-gta02 ~ # opkg update
+
-
root@om-gta02 ~ # opkg upgrade
+
root@om-gta02 ~ # opkg update
-
 
+
root@om-gta02 ~ # opkg upgrade
-
root@om-gta02 ~ # opkg install make gcc gcc-symlinks libc6 libc6-dev binutils binutils-symlinks coreutils kernel-module-tun kernel-module-tunnel4 mdbus libglib-2.0-dev libdbus-glib-1-dev gconf orbit2 libidl-2-0 policykit eggdbus libexif12 libgps gpsd-dev gtk+ gconf libxml2-dev libsoup-2.4-dev bluez4-dev curl curl-dev libexif-dev libconfig-dev
+
root@om-gta02 ~ # opkg install make gcc gcc-symlinks libc6 libc6-dev binutils binutils-symlinks coreutils kernel-module-tun kernel-module-tunnel4 mdbus libglib-2.0-dev
-
\end{lstlisting}
+
                  libdbus-glib-1-dev gconf orbit2 libidl-2-0 policykit eggdbus libexif12 libgps gpsd-dev gtk+ gconf libxml2-dev libsoup-2.4-dev bluez4-dev curl curl-dev
 +
                  libexif-dev libconfig-dev
Now that the needed packages are installed, OLSRd, tangoGPS and the GeoSharing application can be compiled and installed on the Neo FreeRunner.
Now that the needed packages are installed, OLSRd, tangoGPS and the GeoSharing application can be compiled and installed on the Neo FreeRunner.
-
\subsection{OLSRd Linux d\ae mon}\label{app:olsrd+on+neo}
+
=== OLSRd Linux daemon ===
-
As stated in Section \ref{sec:tech:olsrd}, the compilation process of OLSRd requires \texttt{bison}\index{Bison} and \texttt{flex}\index{Flex} packages to compile the syntactical analyser used inside OLSRd. Since the version of SHR proposed in this manual does not provide those packages (\texttt{bison} and \texttt{flex}) in the package repository, the compilation of the syntactical analyser have to be done on another version of the OS.
+
The compilation process of OLSRd requires '''bison''' and '''flex''' packages to compile the syntactical analyser used inside OLSRd. Since the version of SHR proposed in this manual does not provide those packages ('''bison''' and '''flex''') in the package repository, the compilation of the syntactical analyser have to be done on another version of the OS.
-
The entire compilation and installation process of OLSRd on the Neo FreeRunner is detailed in the following steps. Some steps are performed on a Neo FreeRunner running the SHR-unstable version of the operating system while some other steps are performed on the SHR-testing version. The SHR-unstable version provides much more packages in the package repository. \texttt{Bison} and \texttt{flex} are fortunately part of the list. On the Neo FreeRunner running the SHR-unstable version, all the packages listed in Listing~\ref{packages} have been installed. In addition to them, \texttt{bison} and \texttt{flex} have been installed as well.
+
The entire compilation and installation process of OLSRd on the Neo FreeRunner is detailed in the following steps. Some steps are performed on a Neo FreeRunner running the SHR-unstable version of the operating system while some other steps are performed on the SHR-testing version. The SHR-unstable version provides much more packages in the package repository. '''Bison''' and '''flex''' are fortunately part of the list. On the Neo FreeRunner running the SHR-unstable version, all the packages previously listed have been installed. In addition to them, '''bison''' and '''flex''' have been installed as well.
A computer is used to easily manage file transfers between the Neo FreeRunner devices.
A computer is used to easily manage file transfers between the Neo FreeRunner devices.
-
%% ===================================================================
+
1) On the computer, download the last stable release of OLSRd (*.tar.gz file) from http://www.olsrd.org. The version of OLSRd used to realise this manual is the version 0.6.
-
\newpage
+
-
%% ===================================================================
+
-
\begin{enumerate}
+
2) Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
-
\item On the computer, download the last stable release of OLSRd (*.tar.gz file) from \linebreak[4] \url{http://www.olsrd.org}. The version of OLSRd used to realise this manual is the version 0.6.
+
-
\item Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
+
3) At this time, only the Neo FreeRunner running SHR-unstable must be connected to the computer. From the computer, copy the entire olsrd folder to the Neo FreeRunner running SHR-unstable.
-
\item At this time, only the Neo FreeRunner running SHR-unstable must be connected to the computer. From the computer, copy the entire olsrd folder to the Neo FreeRunner running SHR-unstable.
+
$ scp -r olsrd-0.6.0 root@openmoko:/home/root/
-
\begin{lstlisting}
+
4) On the Neo FreeRunner running SHR-unstable, open a terminal, go in the olsrd folder and compile the project. This process may take a while.
-
$ scp -r olsrd-0.6.0 root@openmoko:/home/root/
+
-
\end{lstlisting}
+
-
\item On the Neo FreeRunner running SHR-unstable, open a terminal, go in the olsrd folder and compile the project. This process may take a while.
+
root@om-gta02 ~ # cd olsrd-0.6.0
 +
root@om-gta02 ~ # make
-
\begin{lstlisting}
+
5) From the computer, it is now necessary to collect the generated files from the SHR-unstable device.
-
root@om-gta02 ~ # cd olsrd-0.6.0
+
-
root@om-gta02 ~ # make
+
-
\end{lstlisting}
+
-
\item From the computer, it is now necessary to collect the generated files from the SHR-unstable device.
+
$ scp -r root@openmoko:/home/root/olsrd-0.6.0 /home/user/
-
\begin{lstlisting}
+
6) The Neo FreeRunner running SHR-unstable must be disconnected from the computer and may be shut down. This device is never used anymore.
-
$ scp -r root@openmoko:/home/root/olsrd-0.6.0 /home/user/
+
-
\end{lstlisting}
+
-
\item The Neo FreeRunner running SHR-unstable must be disconnected from the computer and may be shut down. This device is never used anymore.
+
7) The Neo FreeRunner running SHR-testing has to be connected to the computer.
-
\item The Neo FreeRunner running SHR-testing has to be connected to the computer.
+
8) From the computer, copy the entire olsrd folder to the Neo FreeRunner running SHR-testing.
-
\item From the computer, copy the entire olsrd folder to the Neo FreeRunner running SHR-testing.
+
$ scp -r olsrd-0.6.0 root@openmoko:/home/root/
-
\begin{lstlisting}
+
9) On the Neo FreeRunner running SHR-testing, open a terminal, go in the olsrd folder and install the compiled OLSRd d\ae mon.
-
$ scp -r olsrd-0.6.0 root@openmoko:/home/root/
+
-
\end{lstlisting}
+
-
\item On the Neo FreeRunner running SHR-testing, open a terminal, go in the olsrd folder and install the compiled OLSRd d\ae mon.
+
root@om-gta02 ~ # cd olsrd-0.6.0
 +
root@om-gta02 ~ # make install
-
\begin{lstlisting}
+
The OLSRd daemon is now installed on the Neo FreeRunner.
-
root@om-gta02 ~ # cd olsrd-0.6.0
+
-
root@om-gta02 ~ # make install
+
-
\end{lstlisting}
+
-
\end{enumerate}
+
-
The OLSRd d\ae mon is now installed on the Neo FreeRunner.
+
In the scope of the GeoSharing project, the BMF plugin (always provided in the OLSRd archive file) is required. Its compilation and its installation are quite easier than for the OLSRd daemon. On the Neo FreeRunner, open a terminal, go in the folder located at '''/home/root/olsrd-0.6.0/lib/bmf''', compile and install the plugin.
-
%% ===================================================================
+
root@om-gta02 ~ # cd /home/root/olsrd-0.6.0/lib/bmf
-
\newpage
+
root@om-gta02 ~ # make
-
%% ===================================================================
+
root@om-gta02 ~ # make install
-
In the scope of the GeoSharing project, the BMF plugin (always provided in the OLSRd archive file) is required. Its compilation and its installation are quite easier than for the OLSRd d\ae mon. On the Neo FreeRunner, open a terminal, go in the folder located at \texttt{/home/root/olsrd-0.6.0/lib/bmf}, compile and install the plugin.
+
The final configuration required for the daemon to be fully effective is a configuration file. This file is located at '''/etc/olsrd.conf'''. There are two things to adapt for the GeoSharing project:
-
\begin{lstlisting}
+
1) At the end of the file, the OLSRd interface must be specified. Since OLSRd must be running on the Wi-Fi interface of the Neo FreeRunner, the OLSRd interface should be '''eth0'''. On the Neo FreeRunner, the '''VI''' editor can be used to edit this file accordingly.
-
root@om-gta02 ~ # cd /home/root/olsrd-0.6.0/lib/bmf
+
-
root@om-gta02 ~ # make
+
-
root@om-gta02 ~ # make install
+
-
\end{lstlisting}
+
-
The final configuration required for the d\ae mon to be fully effective is a configuration file. This file is located at \texttt{/etc/olsrd.conf}. There are two things to adapt for the GeoSharing project:
+
Interface "eth0"
-
\begin{enumerate}
+
{
-
\item At the end of the file, the OLSRd interface must be specified. Since OLSRd must be running on the Wi-Fi interface of the Neo FreeRunner, the OLSRd interface should be \texttt{eth0}. On the Neo FreeRunner, the \texttt{VI} editor can be used to edit this file accordingly.
+
Mode "mesh"
-
\begin{lstlisting}
+
}
-
Interface "eth0"
+
-
{
+
-
Mode "mesh"
+
-
}
+
-
\end{lstlisting}
+
-
\item In the plugin section of the file, an entry must be added to load the BMF plugin when the d\ae mon is launched. On the Neo FreeRunner, the \texttt{VI} editor can be used to edit this file accordingly.
+
-
\begin{lstlisting}
+
-
LoadPlugin "olsrd_bmf.so.1.7.0"
+
-
{
+
-
# no option
+
-
}
+
-
\end{lstlisting}
+
-
\end{enumerate}
+
-
The OLSRd Linux d\ae mon is now ready to serve the GeoSharing objectives in terms of network topology management.  
+
2) In the plugin section of the file, an entry must be added to load the BMF plugin when the d\ae mon is launched. On the Neo FreeRunner, the '''VI''' editor can be used to edit this file accordingly.
-
\subsection{TangoGPS application}\label{app:tango}
+
LoadPlugin "olsrd_bmf.so.1.7.0"
-
TangoGPS is provided in some editions of the SHR-testing version. But, as stated in Section~\ref{sec:choice+gui}, a modified version of tangoGPS has been developed in the scope of the GeoSharing project. This new version adds a plugins interface allowing plugins to easily interact with tangoGPS. The compilation and the installation of the modified version of tangoGPS is described in the following steps.
+
{
 +
# no option
 +
}
-
%% ===================================================================
+
The OLSRd Linux daemon is now ready to serve the GeoSharing objectives in terms of network topology management.
-
\newpage
+
-
%% ===================================================================
+
-
\begin{enumerate}
+
=== TangoGPS application ===
-
\item Before going any further, make sure that the Neo FreeRunner is free of any version of tangoGPS. On the Neo FreeRunner, open a terminal and execute the following command:
+
TangoGPS is provided in some editions of the SHR-testing version. But a modified version of tangoGPS has been developed in the scope of the GeoSharing project. This new version adds a plugins interface allowing plugins to easily interact with tangoGPS. The compilation and the installation of the modified version of tangoGPS is described in the following steps.
-
\begin{lstlisting}
+
-
root@om-gta02 ~ # opkg remove tangogps
+
-
\end{lstlisting}
+
-
\item On the computer, download the latest version of tangoGPS-modified from \linebreak[4 ] \url{http://download.geosharing-project.org}.
+
1) Before going any further, make sure that the Neo FreeRunner is free of any version of tangoGPS. On the Neo FreeRunner, open a terminal and execute the following command:
-
\item Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
+
root@om-gta02 ~ # opkg remove tangogps
-
\item From the computer, copy the entire tangogps folder to the Neo FreeRunner.
+
2) On the computer, download the latest version of tangoGPS-modified from http://download.geosharing-project.org.
-
\begin{lstlisting}
+
3) Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
-
$ scp -r tangogps root@openmoko:/home/root/
+
-
\end{lstlisting}
+
-
\item On the Neo FreeRunner, open a terminal, go in the tangogps folder, compile and install the project. Pay attention to the third, fourth and fifth commands. They are really important to avoid compilation issues. This process may take a while.
+
4) From the computer, copy the entire tangogps folder to the Neo FreeRunner.
-
\begin{lstlisting}
+
$ scp -r tangogps root@openmoko:/home/root/
-
root@om-gta02 ~ # cd tangogps
+
 
-
root@om-gta02 ~ # sh configure
+
5) On the Neo FreeRunner, open a terminal, go in the tangogps folder, compile and install the project. Pay attention to the third, fourth and fifth commands. They are really important to avoid compilation issues. This process may take a while.
-
root@om-gta02 ~ # CFLAGS="-march=armv4t"
+
 
-
root@om-gta02 ~ # PACKAGE_CFLAGS="-lconfig"
+
root@om-gta02 ~ # cd tangogps
-
root@om-gta02 ~ # PACKAGE_LIBS="-lconfig"
+
root@om-gta02 ~ # sh configure
-
root@om-gta02 ~ # make
+
root@om-gta02 ~ # CFLAGS="-march=armv4t"
-
root@om-gta02 ~ # make install
+
root@om-gta02 ~ # PACKAGE_CFLAGS="-lconfig"
-
\end{lstlisting}
+
root@om-gta02 ~ # PACKAGE_LIBS="-lconfig"
-
\end{enumerate}
+
root@om-gta02 ~ # make
 +
root@om-gta02 ~ # make install
TangoGPS is now ready to serve the GeoSharing objectives in terms of graphical display.
TangoGPS is now ready to serve the GeoSharing objectives in terms of graphical display.
-
\subsection{WEP security}\label{app:wep}
+
=== WEP security ===
-
On the Neo FreeRunner, the wireless interface is denoted as \texttt{eth0}. The following lines need to be added in the configuration file of the device interfaces in order to set the wireless network in ad hoc mode with the WEP security enabled. On the Neo FreeRunner, the \texttt{VI} editor can be used to edit the file located at \texttt{/etc/network/interfaces} accordingly.
+
On the Neo FreeRunner, the wireless interface is denoted as '''eth0'''. The following lines need to be added in the configuration file of the device interfaces in order to set the wireless network in ad hoc mode with the WEP security enabled. On the Neo FreeRunner, the '''VI''' editor can be used to edit the file located at '''/etc/network/interfaces''' accordingly.
-
\begin{lstlisting}
+
auto eth0
-
auto eth0
+
iface eth0 inet static
-
iface eth0 inet static
+
address 10.0.0.1
-
address 10.0.0.1
+
netmask 255.0.0.0
-
netmask 255.0.0.0
+
network 10.0.0.0
-
network 10.0.0.0
+
wireless-mode ad-hoc
-
wireless-mode ad-hoc
+
wireless-essid GeoSharing
-
wireless-essid GeoSharing
+
wireless-key F4C3DEB3BE  
-
wireless-key F4C3DEB3BE
+
-
\end{lstlisting}
+
Once the configuration file has been modified, the network interfaces have to be restarted. The simplest solutions are to restart the device or execute the following command in a terminal of the device:
Once the configuration file has been modified, the network interfaces have to be restarted. The simplest solutions are to restart the device or execute the following command in a terminal of the device:
-
\begin{lstlisting}
+
root@om-gta02 ~ # /etc/init.d/networking restart
-
root@om-gta02 ~ # /etc/init.d/networking restart
+
-
\end{lstlisting}
+
-
\subsection{GeoSharing}\label{app:geosharing+on+neo}
+
=== GeoSharing ===
-
Now that OLSRd Linux d\ae mon and tangoGPS are correctly installed, the main module of the GoeSharing project must be installed as well. This installation is detailed in the following steps.
+
Now that OLSRd Linux daemon and tangoGPS are correctly installed, the main module of the GoeSharing project must be installed as well. This installation is detailed in the following steps.
-
\begin{enumerate}
+
1) On the computer, download the latest version of the GeoSharing application from http://download.geosharing-project.org.
-
\item On the computer, download the latest version of the GeoSharing application from \linebreak[4] \url{http://download.geosharing-project.org}.
+
-
\item Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
+
2) Extract the archive content on the computer filesystem and open a terminal pointing to the folder that has just been extracted.
-
\item From the computer, copy the entire geo\_sharing folder to the Neo FreeRunner.
+
3) From the computer, copy the entire geo_sharing folder to the Neo FreeRunner.
-
\begin{lstlisting}
+
$ scp -r geo_sharing root@openmoko:/home/root/
-
$ scp -r geo_sharing root@openmoko:/home/root/
+
-
\end{lstlisting}
+
-
\item On the computer, download the latest version of the run\_geosharing.sh script from \linebreak[4] \url{http://download.geosharing-project.org}.
+
4) On the computer, download the latest version of the run_geosharing.sh script from http://download.geosharing-project.org.
-
\item From the computer, copy the run\_geosharing.sh script to the Neo FreeRunner.
+
5) From the computer, copy the run_geosharing.sh script to the Neo FreeRunner.
-
\begin{lstlisting}
+
$ scp run_geosharing.sh root@openmoko:/home/root/
-
$ scp run_geosharing.sh root@openmoko:/home/root/
+
-
\end{lstlisting}
+
-
\end{enumerate}
+
-
This script (shown in Listing~\ref{list:run}) is the entry point of the GeoSharing application. It first configures the wireless network interface. Then, it launches the OLSRd d\ae mon. Finally, it compiles the GeoSharing application if it is not already done and launches it.  
+
This script (shown in Listing~\ref{list:run}) is the entry point of the GeoSharing application. It first configures the wireless network interface. Then, it launches the OLSRd d\ae mon. Finally, it compiles the GeoSharing application if it is not already done and launches it.
-
As explained in Chapter~\ref{chap:GPS}, two methods for GPS data retrieval have been implemented. By default, the D-Bus method is used to retrieve GPS data. To use the TCP method instead, on the Neo FreeRunner, using \texttt{VI}, edit the script \texttt{run\_geosharing.sh} and replace the last line:
+
#!/bin/sh
-
\begin{lstlisting}
+
cd /home/root/
-
./geo_sharing -m dbus
+
CURRENT_STATE=`mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.GetResourceState WiFi`
-
\end{lstlisting}
+
 +
if [ $CURRENT_STATE = "False" ]; then
 +
echo WiFi is currently down ... Setting it up now ...
 +
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy WiFi enabled
 +
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.RequestResource WiFi
 +
ifconfig eth0 up
 +
/etc/init.d/networking restart
 +
else
 +
echo WiFi is already up !
 +
fi
 +
 +
echo "0" > /proc/sys/net/ipv4/icmp_echo_ignore_broadcasts
 +
 +
mkdir -p /dev/net
 +
mknod /dev/net/tun c 10 200
 +
chmod 0700 /dev/net/tun
 +
olsrd
 +
 +
cd /home/root/geo_sharing/
 +
make
 +
clear
 +
./geo_sharing -m dbus
-
by
+
Two methods for GPS data retrieval have been implemented. By default, the D-Bus method is used to retrieve GPS data. To use the TCP method instead, on the Neo FreeRunner, using '''VI''', edit the script '''run_geosharing.sh''' and replace the last line:
-
\begin{lstlisting}
+
./geo_sharing -m dbus
-
./geo_sharing -m tcp
+
-
\end{lstlisting}
+
-
%% ===================================================================
+
by
-
\newpage
+
-
%% ===================================================================
+
-
\begin{lstlisting}[label=list:run,caption=The run\_geosharing.sh script is the entry point of the GeoSharing application.]
+
./geo_sharing -m tcp
-
#!/bin/sh
+
-
cd /home/root/
+
-
CURRENT_STATE=`mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.GetResourceState WiFi`
+
-
if [ $CURRENT_STATE = "False" ]; then
+
This script eases the launch of the GeoSharing application. Besides, it can be executed for two different purposes.  
-
echo WiFi is currently down ... Setting it up now ...
+
-
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy WiFi enabled
+
-
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.RequestResource WiFi
+
-
ifconfig eth0 up
+
-
/etc/init.d/networking restart
+
-
else
+
-
echo WiFi is already up !
+
-
fi
+
-
echo "0" > /proc/sys/net/ipv4/icmp_echo_ignore_broadcasts
+
* The GeoSharing application can be launched by tangoGPS when an end-user clicks on the GeoSharing entry of the plugins menu. The interactions with the end-user takes place through the graphical interface provided by tangoGPS. In order to provide to tangoGPS the path to the run_geosharing.sh script, the tangoGPS configuration file (located at '''/etc/tangogps_plugins.conf''') has to be filled accordingly.
-
 
+
-
mkdir -p /dev/net
+
-
mknod /dev/net/tun c 10 200
+
-
chmod 0700 /dev/net/tun
+
-
olsrd
+
-
 
+
-
cd /home/root/geo_sharing/
+
-
make
+
-
clear
+
-
./geo_sharing -m dbus
+
-
\end{lstlisting}
+
-
 
+
-
This script eases the launch of the GeoSharing application. Besides, it can be executed for two different purposes.
+
-
\begin{itemize}
+
-
\item The GeoSharing application can be launched by tangoGPS when an end-user clicks on the GeoSharing entry of the plugins menu. The interactions with the end-user takes place through the graphical interface provided by tangoGPS. In order to provide to tangoGPS the path to the run\_geosharing.sh script, the tangoGPS configuration file (located at \texttt{/etc/tangogps\_plugins.conf}) has to be filled accordingly.
+
-
\begin{lstlisting}
+
# TangoGPS Plugins Interface
-
# TangoGPS Plugins Interface
+
nbr_plugins = 1;
-
nbr_plugins = 1;
+
-
 
+
Plugin1 = {
-
Plugin1 = {
+
name = "GeoSharing";
-
name = "GeoSharing";
+
path = "sh /home/root/run_geosharing.sh";
-
path = "sh /home/root/run_geosharing.sh";
+
options = "";
-
options = "";
+
running = "/tmp/geosharing.run";
-
running = "/tmp/geosharing.run";
+
};
-
};
+
-
\end{lstlisting}
+
-
 
+
-
 
+
-
\item The GeoSharing application can also be launched alone in a terminal. The interactions with the end-user takes place through messages displayed in the terminal.
+
-
\end{itemize}
+
-
 
+
-
%% ===================================================================
+
-
%% ===================================================================
+
-
 
+
-
\chapter{Licence}\label{app:sec:licence}\index{Licence}
+
-
GeoSharing is distributed under the ``Creative Commons BY SA''\footnote{~\url{http://creativecommons.org/licenses/by-sa/3.0/legalcode}}\index{Creative Commons}.
+
-
 
+
-
\begin{itemize}
+
-
\item You are free:
+
-
 
+
-
\begin{itemize}
+
-
\item to \textbf{Share} --- to copy, distribute and transmit the work
+
-
\item to \textbf{Remix} --- to adapt the work
+
-
\end{itemize}
+
-
 
+
-
\item Under the following conditions:
+
-
 
+
-
\begin{itemize}
+
-
\item \textbf{Attribution} --- You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work).
+
-
\item \textbf{Share Alike} --- If you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one.
+
-
\end{itemize}
+
-
 
+
-
\end{itemize}
+
-
 
+
 +
* The GeoSharing application can also be launched alone in a terminal. The interactions with the end-user takes place through messages displayed in the terminal.
-
* http://itouchmap.com/latlong.html
+
Information about using the application can be found [[Run_GeoSharing|here]].

Latest revision as of 13:11, 13 June 2011

Retrieved from "http://www.geosharing-project.org/wiki/index.php?title=How_To_Install"
Personal tools
Namespaces
Variants
Actions
Navigation
GeoSharing
Misc
Toolbox