Installation¶

This is a quick tutorial on how to install CAMS on your computer. Instructions are different depending on your needs: If you are using ubuntu 20.04 proceed with the one-step install. If you are a developper that wants to control the setup process, follow the Advanced install instructions.

In any case, CAMS server requires a PC running a recent GNU/Linux operating system, preferably 20.04. Windows and MacOS are not supported. On the contrary, access to the graphical user interface is possible from any device running a modern web browser.

• Table of contents
• Installation
  • One-step install
  • Advanced install
    • System requirements
    • Paparazzi framework
      • System dependencies (for Ubuntu 16.04)
      • System dependencies (for Ubuntu 18.04)
    • CAMS

One-step install¶

Open a terminal and run:

cd ~ && mkdir cams
wget https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_utils/revisions/master/raw/cams_user_install.sh
chmod +x cams_user_install.sh
./cams_user_install.sh

Advanced install¶

System requirements¶

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).

Note: Check https://redmine.laas.fr/my/account to confirm that your ssh key is correctly set up ! *Otherwise you will need to replace all the git clone ssh://git@redmine.laas.fr/ . . . urls below by git://redmine.laas.fr/ . . . but you will not be able to make commits

Paparazzi framework¶

Make sure that curl is installed:

apt install curl

System dependencies (for Ubuntu 16.04)¶

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

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

System dependencies (for Ubuntu 18.04)¶

apt install gcc-arm-none-eabi

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

Repository

git clone -b laas_wip ssh://git@redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/paparazzi.git paparazzi
cd paparazzi
make

CAMS 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, replacing "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 aircraft you need to use by selecting an item in the A/C menu and then clicking on the build button.

CAMS¶

Install pip3 and update it:

apt 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 core packages (in developer mode with the -e pip3 option):

nephelae_base.

git clone ssh://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 ssh://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 ssh://git@redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_paparazzi.git nephelae_paparazzi
cd nephelae_paparazzi
pip3 install --user -e .

nephelae_planner.

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

Make sure that redis is installed:

apt install redis-server

Clone and install the nephelae_gui package in developer mode:

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

To check the installation, launch the server:

make demo

Warning: (16/11/2020) make demo does not work !

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

You should now be able connect to the graphical user interface with your web browser on http://0.0.0.0:8000/.