Installation/Linux

LiveCd

The LiveCD is the easiest way to start with Paparazzi: no installation is required and no changes are made to your computer. Simply burn the image as a boot CD and reboot! The LiveCD includes the complete paparazzi binary package (code source, tools and cross compilers). Usage is described in the next section.

The CD image is available from the Downloads page.

The Paparazzi demo is launchable on the Live CD from the Paparazzi icon.

Knoppix allows for all the user data to be saved on a hard disk partition (most file systems are supported) or on a removable device (typically a USB pendrive). Note that this action is not destructive: the user data tree is compressed and stored on your file system as a single file (knoppix.img).

• From the Knoppix menu (second from bottom left), choose Configure, Create a persistent KNOPPIX disk image
• Choose your media (be sure to connect your USB pendrive before booting!)
• Choose if you want an encrypted filesystem (to protect your flight plan designed for the next MAV competition :-) )
• Choose the size of your home directory (100Mb is recommended)

On the next reboot, this saved state will be automatically located and loaded.

Using this persistent feature, the Paparazzix Live CD can really be used to configure, simulate and fly an aircraft with the Paparazzi system.

The Live CD can also be used to install a Debian system on the hard disk, using the knoppix-installer command. Be sure to backup the hard disk before trying ...

Installation on Debian

Paparazzi is packaged for debian as well as all of its dependencies. The repository hosted at ENAC holds their latest version.

Manual package installation

Just add the following line(s) to your repository list (/etc/apt/sources.list). Note: etch users must include both sarge and etch lines.

File: /etc/apt/sources.list

deb http://www.recherche.enac.fr/paparazzi/debian sarge main #if needed deb http://www.recherche.enac.fr/paparazzi/debian etch main

Then, update and install the package you are interested in:

apt-get update
apt-get install paparazzi-bin

GUI package installation

• Launch Synaptic Package Manager (Applications/System Tools Menu)
• In Settings/Repositories, add a new repository on URI = http://www.recherche.enac.fr/paparazzi/debian, Distribution = sarge, Section = main
• Search for paparazzi-bin package (To find it easily, use Search Button)
• Mark it for installation (Right-click on package name)
• Left-click on Apply

System wide install

The paparazzi-bin package contains the airborne source code and the tools you need to configure and control the UAV. It provides 3 main commands:

• paparazzi-make to compile the aircraft (and run the demo);
• paparazzi to run the ground control station supervision;
• paparazzi-gcs to run the flight plan editor.

Start with paparazzi-make init to initialize your configuration directory (~/paparazzi) and paparazzi-make demo to run the demo.

You will have to also install the paparazzi-avr or paparazzi-arm7 packages which contain the cross compiler and architecture dependent tools needed to produce and upload the airborne programs on avr or arm7 architectures.

Source code install

Users who want to look at and modify the source code can install the required dependencies and download the code independently.

Installation of the meta-package paparazzi-dev will pull along all required dependencies.

After the packages is installed the paparazzi source code needs to be downloaded. This can be done using CVS. See the project page at savannah for details:

cvs -z3 -d:pserver:anonymous@cvs.savannah.nongnu.org:/sources/paparazzi co paparazzi3

A nightly tarball can also be fetched from the Downloads page.

After extraction, go to the root of the source code and comile it:

make

now that it is compiled you can run a demo with:

make demo

When you are running your own simulations and aircraft you will compile first

make AIRCRAFT=aircraft_name sim

then start the ground station with

/paparazzi_folder/sw/supervision/paparazzi.pl

If you receive a message similar to this:

Directory /home/mcurrie/paparazzi doesn't exist
This directory is needed to store user configuration and data
Shall I create it and populate it with examples? (Y/n)

you can either rename your paparazzi folder to paparazzi and move it to /home/your_user or add the following lines to your .bashrc file in /home/your_user

export PAPARAZZI_HOME=/home/your_user/paparazzi_folder
export PAPARAZZI_SRC=/home/your_user/paparazzi_folder

Installation on Debian/Ubuntu "feisty fawn"

  In a terminal window enter the following
wget http://www.recherche.enac.fr/paparazzi/debian/dists/sarge/main/binary-i386/libsubject-perl_2.00_all.deb
wget http://www.recherche.enac.fr/paparazzi/debian/dists/etch/main/binary-i386/xml-light-ocaml_2.1-2_i386.deb
wget http://www.tls.cena.fr/products/ivy/download/packages/ivy-perl_4.21_all.deb
wget http://www.recherche.enac.fr/paparazzi/debian/dists/etch/main/binary-i386/ivy-ocaml_1.1-2_i386.deb
wget http://www.recherche.enac.fr/paparazzi/debian/dists/etch/main/binary-i386/paparazzi-base_3.1-2_i386.deb
wget http://www.recherche.enac.fr/paparazzi/debian/dists/etch/main/binary-i386/paparazzi-bin_3.1-2_i386.deb 
wget http://www.recherche.enac.fr/paparazzi/debian/dists/etch/main/binary-i386/paparazzi-dev_3.1-2_i386.deb
sudo dpkg -i libsubject-perl_2.00_all.deb
sudo dpkg -i xml-light-ocaml_2.1-2_i386.deb
sudo dpkg -i ivy-ocaml_1.1-2_i386.deb
sudo dpkg -i ivy-perl_4.21_all.deb
sudo apt-get install perl-tk
sudo apt-get -f install
sudo dpkg -i paparazzi-base_3.1-2_i386.deb
sudo dpkg -i paparazzi-bin_3.1-2_i386.deb
sudo dpkg -i paparazzi-dev_3.1-2_i386.deb
mkdir -p $USER/paparazzi/conf/
paparazzi
#paparazzi  simulation goodness if above sucessful
#follow the source install installation instructions above with cvs and then after building the cvs paparazzi then
#execute the ./paparazzi in the cvs distribution to get paparazzi-center as above
#compiling and loading the AP will fail on ubuntu unless you have installed an arm-elf-gcc cross tool chain
#To NEW paparazzi users who are also new to debian, allow me to recommend the ubuntu distribution(its based on debian)
#it allows an easier entry to paparazzi goodness then a "pure" debian distribution for the novice to both
#while allowing access to all of debians wizardry as you get more experienced with it

Installation on non Debian GNU/Linux

You will have to compile and install the paparazzi package from the sources. Unfortunately no configure facilities is included in the package: you will have to figure out what is needed. The list of dependencies of the Debian package (listed in the debian/control) file is the best start.

Software Updates

Keeping your software up to date is easy with the Debian package and the CVS systems.

To download any updated package, be sure to have the Paparazzi repository mentionned in your /etc/apt/sources.list:

deb http://www.recherche.enac.fr/paparazzi/debian sarge main
deb http://www.recherche.enac.fr/paparazzi/debian etch main

and run the following command (as root):

apt-get update

To download any updated source file, run the following command from your Paparazzi directory

cvs update -d

where the -d is needed to get any new directory.