CAMS

h1. Installation

This is a quick tutorial on how to install CAMS on your computer. Instructions are different depending on your needs: If a you are a regular user %{background:yellow}Who is a regular user? Background%, follow the [[Installation#Regular user installation process]]; and if you are a developer, follow the[[Installation#Developer installation process]]

h2. System requirements

CAMS has been developed and tested in Ubuntu 16.04, 18.

The main programming language is **Python 3.5**. "Official support for Python 2.7 ending by the beginning of 2020":https://pythonclock.org/, no development efforts were made to support Python 2.7.

Most of development and testing where made on "Ubuntu 16.04 LTS Xenial Xerus":http://releases.ubuntu.com/16.04/ on which Python 3.5 is the default Python version.

All server side applications should work on a Unix-based system provided it supports Python 3.5 or later. Compatibility with Microsoft Windows has not been tested.

The client side application is web-based and should work on a modern web browser. (Only tested with Mozilla Firefox and Safari).

h2. Regular user installation process

h3. System requirements

CAMS has been developed and tested in Ubuntu 16.04, 18.

The main programming language is **Python 3.5**. "Official support for Python 2.7 ending by the beginning of 2020":https://pythonclock.org/, no development efforts were made to support Python 2.7.

Most of development and testing where made on "Ubuntu 16.04 LTS Xenial Xerus":http://releases.ubuntu.com/16.04/ on which Python 3.5 is the default Python version.

All server side applications should work on a Unix-based system provided it supports Python 3.5 or later. Compatibility with Microsoft Windows has not been tested.

The client side application is web-based and should work on a modern web browser. (Only tested with Mozilla Firefox and Safari).

h3. Paparazzi framework

Right-now the LAAS-Nephelae software is strongly tied to ENAC's Paparazzi framework and won't work at all without it being installed. Installation instructions be found "here":https://wiki.paparazziuav.org/wiki/Installation#Quickstart_for_Ubuntu_users.

We recommend the one-liner installation for Ubuntu users (if you are not an Ubuntu user, follow the "OS specific instructions":https://wiki.paparazziuav.org/wiki/Installation#OS_Specific_Instructions).

LAAS-Nephelae software needs the environment variable PAPARAZZI_HOME and PAPARAZZI_SRC to be set. Executing this line should work for most users **if you used the one-liner installation**:

<pre><code class="shell">

echo "export PAPARAZZI_HOME=~/paparazzi" >> ~/.bashrc

echo "export PAPARAZZI_SRC=~/paparazzi" >> ~/.bashrc

</code></pre>

If you don't trust any line of code you find on the internet (if you do you probably shouldn't) you can find more information "here":https://wiki.paparazziuav.org/wiki/Installation#Environment_Variables.

h3. LAAS-Nephelae software

Make sure that redis is installed:

<pre><code class="shell">

apt-get install redis-server

</code></pre>

Make sure that curl is installed:

<pre><code class="shell">

apt-get install curl

</code></pre>

Install pip3 and update it:

<pre><code class="shell">

apt-get install python3-pip

pip3 install --user --upgrade pip

</code></pre>

If you want to update it for all users:

<pre><code class="shell">

pip3 install --upgrade pip

</code></pre>

For now the easiest way to install LAAS-Nephelae software is to clone the "git repository of the graphical user interface":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_gui and run its installation script.

<pre><code class="shell">

git clone ssh://git@redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_gui.git nephelae_gui

cd nephelae_gui

make install pip_options=--user

</code></pre>

To check the installation, launch the server:

<pre><code class="shell">

make demo

</code></pre>

This will (hopefully) start the replay of a UAV flight.

You should be able connect to the graphical user interface "here":http://0.0.0.0:8000/.

h1. Developer installation process

h3. Paparazzi framework

Make sure that curl is installed:

<pre><code class="shell">

apt-get install curl

</code></pre>

h4. System dependencies (for Ubuntu 16.04)

<pre><code class="shell">

add-apt-repository ppa:team-gcc-arm-embedded/ppa

apt-get update

apt-get install gcc-arm-linux-gnueabi gcc-arm-none-eabi

</code></pre>

<pre><code class="shell">

add-apt-repository ppa:paparazzi-uav/ppa

apt-get update

apt-get install paparazzi-dev paparazzi-jsbsim

</code></pre>

h4. System dependencies (for Ubuntu 18.04)

<pre><code class="shell">

apt-get install gcc-arm-none-eabi

</code></pre>

<pre><code class="shell">

add-apt-repository ppa:paparazzi-uav/ppa

apt-get update

apt-get install paparazzi-dev paparazzi-jsbsim

</code></pre>

h4. Repository

<pre><code class="shell">

git clone -b laas_master https://github.com/pnarvor/paparazzi.git paparazzi

cd paparazzi

make

</code></pre>

LAAS-Nephelae software needs the environment variables PAPARAZZI_HOME and PAPARAZZI_SRC to be set to the root paparazzi folder (where you cloned it). Add these lines to your .bashrc, relacing "paparazzi_path" to where you cloned paparazzi repository.

<pre><code class="shell">

export PAPARAZZI_HOME="paparazzi_path"

export PAPARAZZI_SRC="paparazzi_path"

</code></pre>

Once Paparazzi installed, launch ./paparazzi. In the paparazzi center, build every aircrafts you need to use by selecting an item in the A/C menu and then clicking on the build button.

h3. LAAS-Nephelae software

Install pip3 and update it:

<pre><code class="shell">

apt-get install python3-pip

pip3 install --user --upgrade pip

</code></pre>

If you want to update it for all users:

<pre><code class="shell">

pip3 install --upgrade pip

</code></pre>

Clone and install the 3 core packages (in developer mode with the -e pip3 option):

"nephelae_base":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_base.

<pre><code class="shell">

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_base.git nephelae_base

cd nephelae_base

pip3 install --user -e .

</code></pre>

"nephelae_mesonh":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_mesonh.

<pre><code class="shell">

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_mesonh.git nephelae_mesonh

cd nephelae_mesonh

pip3 install --user -e .

</code></pre>

"nephelae_paparazzi":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_paparazzi.

<pre><code class="shell">

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_paparazzi.git nephelae_paparazzi

cd nephelae_paparazzi

pip3 install --user -e .

</code></pre>

Make sure that redis is installed:

<pre><code class="shell">

apt-get install redis-server

</code></pre>

Clone and install the "nephelae_gui":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_gui package in developer mode:

<pre><code class="shell">

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_gui.git nephelae_gui

cd nephelae_gui

make install pip_options=--user install_mode=dev

</code></pre>

To check the installation, launch the server:

<pre><code class="shell">

make demo

</code></pre>

This will (hopefully) start the replay of a UAV flight.

You should be able connect to the graphical user interface "here":http://0.0.0.0:8000/.