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 Who is a regular user? Background, follow the Installation; and if you are a developer, follow theInstallation

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, no development efforts were made to support Python 2.7.

Most of development and testing where made on Ubuntu 16.04 LTS Xenial Xerus 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).

Regular user installation process¶

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, no development efforts were made to support Python 2.7.

Most of development and testing where made on Ubuntu 16.04 LTS Xenial Xerus 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).

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.

We recommend the one-liner installation for Ubuntu users (if you are not an Ubuntu user, follow the 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:

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

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.

LAAS-Nephelae software¶

Make sure that redis is installed:

apt-get install redis-server

Make sure that curl is installed:

apt-get install curl

Install pip3 and update it:

apt-get install python3-pip
pip3 install --user --upgrade pip

If you want to update it for all users:

pip3 install --upgrade pip

For now the easiest way to install LAAS-Nephelae software is to clone the git repository of the graphical user interface and run its installation script.

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

To check the installation, launch the server:

make demo

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

You should be able connect to the graphical user interface here.

Developer installation process¶

Paparazzi framework¶

Make sure that curl is installed:

apt-get install curl

System dependencies (for Ubuntu 16.04)¶

add-apt-repository ppa:team-gcc-arm-embedded/ppa
apt-get update
apt-get install gcc-arm-linux-gnueabi gcc-arm-none-eabi

add-apt-repository ppa:paparazzi-uav/ppa
apt-get update
apt-get install paparazzi-dev paparazzi-jsbsim

System dependencies (for Ubuntu 18.04)¶

apt-get install gcc-arm-none-eabi

add-apt-repository ppa:paparazzi-uav/ppa
apt-get update
apt-get install paparazzi-dev paparazzi-jsbsim

Repository

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

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.

export PAPARAZZI_HOME="paparazzi_path" 
export PAPARAZZI_SRC="paparazzi_path" 

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.

LAAS-Nephelae software¶

Install pip3 and update it:

apt-get install python3-pip
pip3 install --user --upgrade pip

If you want to update it for all users:

pip3 install --upgrade pip

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

nephelae_base.

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_base.git nephelae_base
cd nephelae_base
pip3 install --user -e .

nephelae_mesonh.

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_mesonh.git nephelae_mesonh
cd nephelae_mesonh
pip3 install --user -e .

nephelae_paparazzi.

git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_paparazzi.git nephelae_paparazzi
cd nephelae_paparazzi
pip3 install --user -e .

Make sure that redis is installed:

apt-get install redis-server

Clone and install the nephelae_gui package in developer mode:

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

To check the installation, launch the server:

make demo

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

You should be able connect to the graphical user interface here.