How To Install

From GeoSharing

Jump to: navigation, search
Line 13: Line 13:
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.
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.
-
# 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:
+
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
  192.168.0.202 openmoko
-
# 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:
+
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:
-
\begin{enumerate}
+
==== Via the network manager ====
-
\item \textbf{Via the network manager:} As shown on Figure \ref{fig:network+manager}, 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: \texttt{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'''.
-
\begin{newfig}
+
-
\includegraphics[width=0.44\linewidth]{img/app-network-manager.png}
+
-
\caption{\label{fig:network+manager}A static IP address is chosen for the connection with the Neo FreeRunner.}
+
-
\end{newfig}
+
-
\item \textbf{Without the network manager:}
+
-
\begin{enumerate}
+
-
\item On the computer, open the file located at the following location: \texttt{/etc/network/interfaces} and add the following lines at the end of the file:
+
-
\begin{lstlisting}
+
-
# The Openmoko network interface
+
-
auto eth1
+
-
iface eth1 inet static
+
-
address 192.168.0.200
+
-
netmask 255.255.255.0
+
-
\end{lstlisting}
+
-
+
-
%% ===================================================================
+
-
\newpage
+
-
%% ===================================================================
+
-
+
-
\item On the computer, restart the network service by running the following command as root:
+
-
\begin{lstlisting}
+
-
# /etc/init.d/networking restart
+
-
\end{lstlisting}
+
-
\end{enumerate}
+
[[File:Screenshot-Editing Openmoko.png|350px]]
-
+
-
\end{enumerate}
+
-
\item If an operational OS is running a SSH d\ae mon on the Neo FreeRunner, it is possible to establish an SSH connection from the computer to the root session of the Neo FreeRunner.
+
==== Without the network manager ====
-
\begin{lstlisting}
+
- On the computer, open the file located at the following location: '''/etc/network/interfaces''' and add the following lines at the end of the file:
-
$ ssh root@openmoko
+
-
root@om-gta02 ~ #
+
-
\end{lstlisting}
+
-
If it is not the case (i.e. there is no SSH d\ae mon or no operating system at all), the Neo FreeRunner can be flashed with, for example, the operating system used in the scope of the GeoSharing project: SHR.
+
-
\end{enumerate}
+
# The Openmoko network interface
 +
auto eth1
 +
iface eth1 inet static
 +
address 192.168.0.200
 +
netmask 255.255.255.0
-
\subsection{Flashing the SHR operating system on the Neo FreeRunner}\label{app:flashing+neo}
+
- On the computer, restart the network service by running the following command as root:
-
The easiest way to flash the Neo FreeRunner is to use \texttt{neoTool} on the computer. It is mandatory to install \texttt{dfu-utils} via the Synaptic Package Manager of the computer before running \texttt{neoTool}. The version of \texttt{neoTool} that have been used to realise this manual is the version $1.3$.
+
# /etc/init.d/networking restart
-
Before going any further, the Neo FreeRunner must be connected to the computer with the USB cable, the IP address of each device must have been previously configured (See Appendix~\ref{app:usb}) and the Neo FreeRunner must be booted on the NOR memory as explained in Section \ref{sec:os+generals} of this document (POWER + AUX buttons).
+
3) If an operational OS is running a SSH daemon on the Neo FreeRunner, it is possible to establish an SSH connection from the computer to the root session of the Neo FreeRunner.
-
\begin{enumerate}
+
$ ssh root@openmoko
-
\item The first step is to copy the bash script that can be found at \linebreak[4] \url{http://users.on.net/~antisol/neotool} into an empty file on the computer. Rename this file \texttt{neoTool} and give it the execution rights.
+
root@om-gta02 ~ #
-
\begin{lstlisting}
+
If it is not the case (i.e. there is no SSH d\ae mon or no operating system at all), the Neo FreeRunner can be flashed with, for example, the operating system used in the scope of the GeoSharing project: SHR.
-
$ chmod u+x neoTool
+
-
\end{lstlisting}
+
-
\item The second step is to run neoTool on the computer with root privileges.
+
=== Flashing the SHR operating system on the Neo FreeRunner ===
 +
The easiest way to flash the Neo FreeRunner is to use '''neoTool''' on the computer. It is mandatory to install '''dfu-utils''' via the Synaptic Package Manager of the computer before running '''neoTool'''. The version of neoTool that have been used to realise this manual is the version 1.3.
-
\begin{lstlisting}
+
Before going any further, the Neo FreeRunner must be connected to the computer with the USB cable, the IP address of each device must have been previously configured and the Neo FreeRunner must be booted on the NOR memory (POWER + AUX buttons).
-
$ sudo ./neoTool
+
-
\end{lstlisting}
+
-
%% ===================================================================
+
1) The first step is to copy the bash script that can be found at http://users.on.net/~antisol/neotool into an empty file on the computer. Rename this file '''neoTool''' and give it the execution rights.
-
\newpage
+
-
%% ===================================================================
+
-
\item The application is now running and the interface looks like Figure \ref{fig:neotool1}.
+
$ chmod u+x neoTool
-
\begin{figure}[!ht]
+
2) The second step is to run neoTool on the computer with root privileges.
-
\begin{center}
+
-
  \subfigure[\label{fig:neotool1}\textit{}]{\includegraphics[width=0.47\linewidth]{img/neotool-1.png}}
+
-
  %\hspace*{2.5cm}
+
-
  \subfigure[\label{fig:neotool2}\textit{}]{\includegraphics[width=0.24\linewidth]{img/neotool-2.png}}
+
-
\end{center}
+
-
\caption{\label{fig:netTool}(a)~Different actions are possible to be performed with the \texttt{neoTool} application. (b)~The Root-Filesystem, the kernel, the bootloader and the splash can be flashed separately.}
+
-
\end{figure}
+
-
\item 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 \url{http://build.shr-project.org/shr-testing/images/om-gta02/}. Two files are required:
+
$ sudo ./neoTool
-
\begin{itemize}
+
 
-
\item lite-om-gta02.jffs2
+
3) The application is now running and the interface looks like:
-
\item uImage-*.bin
+
 
-
\end{itemize}
+
[[File:Neotool-1.png|150px]]
 +
 
 +
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:
 +
* lite-om-gta02.jffs2
 +
* uImage-*.bin
-
\item In neoTool (which is running on the computer), select the second item `Flash~your~Neo' and click `OK'. The interface looks like Figure \ref{fig:neotool2}. On the next screen, don't change anything and click `OK'.
+
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]]
 +
 
 +
On the next screen, don't change anything and click `OK'.
-
\item The path to the *.jffs2 and the *.bin files are respectively asked.
+
6) The path to the *.jffs2 and the *.bin files are respectively asked.
-
\item Click on the OK button of \texttt{neoTool} to launch the flashing process.
+
7) Click on the OK button of neoTool to launch the flashing process.
-
\item 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.
-
\end{enumerate}
+
-
%% ===================================================================
 
-
\newpage
 
-
%% ===================================================================
 
-
\subsection{Internet connectivity}\label{app:internet+connection}
+
=== Internet connectivity ===
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.

Revision as of 12:23, 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