Difference between revisions of "Installation/Linux"

From PaparazziUAV
Jump to: navigation, search
(From Scratch)
(Operating System)
Line 19: Line 19:
 
Paparazzi is very easily installed on any laptop or workstation running the [http://www.ubuntu.com/ Ubuntu Linux OS] or virtually any [http://www.debian.org/ Debian] based [http://en.wikipedia.org/wiki/Linux Linux]. Paparazzi is packaged for Debian as well as all of its dependencies. The [http://paparazzi.enac.fr/debian repository] hosted at ENAC holds their latest version.
 
Paparazzi is very easily installed on any laptop or workstation running the [http://www.ubuntu.com/ Ubuntu Linux OS] or virtually any [http://www.debian.org/ Debian] based [http://en.wikipedia.org/wiki/Linux Linux]. Paparazzi is packaged for Debian as well as all of its dependencies. The [http://paparazzi.enac.fr/debian repository] hosted at ENAC holds their latest version.
  
It is also possible to have your Debian/Ubuntu running in a virtual machine, for instance with [http://www.virtualbox.org/ VirtualBox]. This requires minimal changes to your computer setup, as you can run the VM from all common platforms (Windows, Mac OS X, Linux). The virtual machine image can easily be transferred between different laptops, giving greater flexibility. Unfortunately, the Open-Source Edition of VirtualBox doesn't include the necessary USB support, so you'll need to get the regular version from the website.
+
It is also possible to have your Debian/Ubuntu running in a virtual machine, for instance with [http://www.virtualbox.org/ VirtualBox]. This requires minimal changes to your computer setup, as you can run the VM from all common platforms (Windows, [http://paparazzi.enac.fr/wiki/InstallationMacOSX OS X], Linux). The virtual machine image can easily be transferred between different laptops, giving greater flexibility. Unfortunately, the Open-Source Edition of VirtualBox doesn't include the necessary USB support, so you'll need to get the regular version from the website.
  
 
If you are new and this is your first time installing it is suggested you keep it simple. Select a system you can dedicate to the Linux installation. No VMs or dual boot configurations. The idea is do a very simple generic installation that is certain to have no issues. This reassures you that the installation process works and you can see and use a working Paparazzi install for some time before you try a more complicated install. The install is well documented below and certain to succeed if followed exactly. Most issues arise when someone unfamiliar with Linux tries a non-standard install that requires special steps not documented here.
 
If you are new and this is your first time installing it is suggested you keep it simple. Select a system you can dedicate to the Linux installation. No VMs or dual boot configurations. The idea is do a very simple generic installation that is certain to have no issues. This reassures you that the installation process works and you can see and use a working Paparazzi install for some time before you try a more complicated install. The install is well documented below and certain to succeed if followed exactly. Most issues arise when someone unfamiliar with Linux tries a non-standard install that requires special steps not documented here.

Revision as of 20:46, 17 February 2011

Introduction

Paparazzi is very easily installed on any laptop or workstation running the Ubuntu Linux OS or virtually any Debian based Linux or even Apple Macintosh running Mac OS X.

At a high-level here are the steps required to install Paparazzi:

  • Install a current Linux distribution (Ubuntu Maverick is recommended at the moment).
  • The Paparazzi packages are installed using Synaptic Package Manager.
  • Install git. Don't worry if it's already installed.
  • Download the sources from the git repository.
  • Allow access to the ports by copying the rules file: (export PAPARAZZI_HOME=~/paparazzi; export PAPARAZZI_SRC=~/paparazzi; sudo cp $PAPARAZZI_HOME/conf/system/udev/rules/10-paparazzi.rules /etc/udev/rules.d/)
  • Compile the binaries from the sources (cd paparazzi && make)

That's all.

Operating System

Paparazzi is very easily installed on any laptop or workstation running the Ubuntu Linux OS or virtually any Debian based Linux. Paparazzi is packaged for Debian as well as all of its dependencies. The repository hosted at ENAC holds their latest version.

It is also possible to have your Debian/Ubuntu running in a virtual machine, for instance with VirtualBox. This requires minimal changes to your computer setup, as you can run the VM from all common platforms (Windows, OS X, Linux). The virtual machine image can easily be transferred between different laptops, giving greater flexibility. Unfortunately, the Open-Source Edition of VirtualBox doesn't include the necessary USB support, so you'll need to get the regular version from the website.

If you are new and this is your first time installing it is suggested you keep it simple. Select a system you can dedicate to the Linux installation. No VMs or dual boot configurations. The idea is do a very simple generic installation that is certain to have no issues. This reassures you that the installation process works and you can see and use a working Paparazzi install for some time before you try a more complicated install. The install is well documented below and certain to succeed if followed exactly. Most issues arise when someone unfamiliar with Linux tries a non-standard install that requires special steps not documented here.

Compilers and Handlers

The typical installation contains all of the necessary C and OCaml compilers as well as some XML and Ivy handlers. These tools are provided by the paparazzi-dev package. Have no fear, this is all taken care of for you so all you must do is type a few simple commands. Below are those commands and helpful information. Commands can be copied and pasted from these pages to make it as easy as possible.

Source Code

The Paparazzi source code is hosted by Github. It is downloaded using git.

Installation of Compilers and Handlers

Using Synaptic Package Manager

  • Launch Synaptic Package Manager (Menu System/Administration)
  • In Settings/Repositories, add a new repository (Software Source) in the tab Other Software:
    APT line: deb http://paparazzi.enac.fr/ubuntu maverick main
    This APT line works for Ubuntu Maverick/10.10. For other Ubuntu versions adapt as described below in the command line section.
  • Search for paparazzi-dev, and paparazzi-arm7 packages (use the Search button)
  • Mark them for installation (right-click on package names)
  • Left-click on Apply

From the Command Line

If the Synaptic Package Manager doesn't work for you, you can alternatively use the command line:

For the sources file (sources.list) you only add the line required for your version. Linux names their versions.

Just add the following lines to your repository list (/etc/apt/sources.list) and then uncomment the line relevant to your operating system (e.g. one of etch, gutsy or hardy):

Note: Because of the sources.list file permissions maybe you will need to edit it with root access. In Terminal write this:

gksudo gedit /etc/apt/sources.list


File: /etc/apt/sources.list
# Uncomment just _one_ of the following lines - depending on your OS version
# deb http://paparazzi.enac.fr/debian etch main
# deb http://paparazzi.enac.fr/debian lenny main
# deb http://paparazzi.enac.fr/ubuntu gutsy main
# deb http://paparazzi.enac.fr/ubuntu hardy main
# deb http://paparazzi.enac.fr/ubuntu intrepid main
# deb http://paparazzi.enac.fr/ubuntu jaunty main
# deb http://paparazzi.enac.fr/ubuntu karmic main
# deb http://paparazzi.enac.fr/ubuntu lucid main
# deb http://paparazzi.enac.fr/ubuntu maverick main

Then, update your sources and install the dependencies needed for recompiling from the source (dev), and the cross-compilers (arm7 or stm32) :

For ARM7 (i.e. Tiny or TWOG boards) :

sudo apt-get update
sudo apt-get install paparazzi-dev paparazzi-arm7

For STM32 (i.e. Lisa boards) :

sudo apt-get update
sudo apt-get install paparazzi-dev paparazzi-stm32

Note: The ivy-python package now among the dependencies of paparazzi-dev is also available in the normal paparazzi repository. Allen Ibara might have some newer versions in his PPA but you should not need them.

Optional/Obsolete Packages

Users of the newer Lisa/L or Lisa/S boards will need the paparazzi-stm32 package.

Users of older AVR based boards will also need the paparazzi-avr package.

Older Ubuntu Versions

On older Linux distributions (not needed for lucid and later), the Braille TTY driver interferes with FTDI USB Serial adapters. If somehow your FTDI serial adapter does not work, remove the package via:

sudo apt-get remove brltty

Manual Installation of Individual Packages

Users of other Linux flavors than a recent Ubuntu or anyone needing manual control of each individual package can install them independently.

Downloading the Source Code from Github

If you have not installed git yet, use the Synaptic Package Manager or the command line:

sudo apt-get install git

The complete source code should be downloaded from the paparazzi software repository on github (first make sure you have installed the paparazzi-dev package as described above).

See the project page at Github for more details. From the directory of your choice type:

git clone git://github.com/paparazzi/paparazzi.git

or if you are behind a firewall with an http proxy available:

git clone https://github.com/paparazzi/paparazzi.git

This will download all of the code and install it into paparazzi/

For more options and info see the git page.

Launching the Software

The first step is to compile. From the paparazzi directory (cd paparazzi), run

make

You will have to run this command after each update of the source (git pull command). Launch the software from the paparazzi directory with

./paparazzi

From the Paparazzi Center interface, select the Microjet aircraft, select the sim target and Build it. Then Execute the Simulation session. The procedure is detailed in the Simulation page.

Quick Launch Icon

To create an icon on the desktop so you don’t have to manually type codes into the Terminal each time you want to start the Paparazzi Center follow these steps:

  1. Save this image file to your /paparazzi folder
  2. Right click anywhere on the Ubuntu desktop and click Create Launcher.
  3. Enter the following in the fields provided:
    • Name: Paparazzi Center
    • Command: /home/YOUR_USER_NAME/paparazzi/paparazzi
    • Comment: Runs the Paparazzi Center
    • Then click the icon image in the top left on the dialog box and select the Paparazzi logo you just downloaded.
  4. Click the OK button and that’s it! Your icon should appear on the desktop and you are ready to go.

Agents

If (and only if) you want to directly launch some Paparazzi agents (the Tools of the Paparazzi Center), without using the Paparazzi Center, you must have the Paparazzi source and home environment variables set correctly in your shell. These variables can be automatically set in your shell by adding the following lines to your .bashrc file:

File: ~/.bashrc
export PAPARAZZI_HOME=your paparazzi software directory
export PAPARAZZI_SRC=your paparazzi software directory

env Variables

If you wish to manually set the env variables (i.e. when compiling a backup copy of your code in a different folder) execute the following command from the folder you wish to set as your active paparazzi folder:

export PAPARAZZI_HOME=`pwd`;export PAPARAZZI_SRC=`pwd`

Verify that your variables are set correctly with the following command:

env | grep PAPARAZZI

which should return the following:

PAPARAZZI_HOME=your paparazzi software directory
PAPARAZZI_SRC=your paparazzi software directory

Setting access rights for USB download

This may be required to flash the Paparazzi-boards directly thru USB. For flashing details, see Compiling.

Default linux rights may not allow standard (non root) users to directly access the USB bus. You will need to make yourself a member of the plugdev "group" and then create a "rule", associated with that "group".
Make yourself a member of the plugdev group:

sudo adduser <your login> plugdev

Logout and login again. Then add the appropriate rule (available ine fhe file 10-paparazzi.rules) to the USB handler. Simply copy as root $PAPARAZZI_HOME/conf/system/udev/rules/10-paparazzi.rules to /etc/udev/rules.d/

sudo cp $PAPARAZZI_HOME/conf/system/udev/rules/10-paparazzi.rules /etc/udev/rules.d/

Software Updates

Paparazzi is a very rapidly evolving project and as such, you will find that variables and functions are frequently added, changed, or removed. Update your software with care and caution, and always test the functionality on the ground and in the air as some updates will affect tuning parameters. Your airframe file will not be updated by the Git system and therefore any new or modified variable names will need to be added manually. The compiler will usually identify the problem variables at which point you can look at some of the most recent airframe files on git to find the proper syntax. See the Compiling page for more help if needed.
That said, keeping your software up to date is easy with the git system. The system will compare all source code files with the server and update any that are needed, automatically merging any minor changes that you have incorporated along the way.

To download and automatically merge any updated source files, run the following command from your Paparazzi directory

git pull

After any git update or source code modification the code can be recompiled from your paparazzi software directory with the following command:

make

The make command will only recompile portions of the software where changed have been detected. If it does not behave as expected you can deleted all compiled files and recompile from scratch with the following commands:

make clean
make

See the Compiling page for more info.

To update your Linux distribution as well as any dependencies of Paparazzi (seldom necessary), run the following:

sudo apt-get update
sudo apt-get upgrade

Using the Live CD

There is a LiveCD available, but it dates back to 2008. It is still an easy way to get a first glimpse on Paparazzi.

From Scratch

In very rare occasions one needs to install the tools used, third-party libraries used by Paparazzi all from scratch. Currently there are no 64 bit Linux repositories, that is a very good reason to install from scratch. Sometime one just wants to be able to use all the latest and greatest compilers, or source code of everything to improve something. Then there is no other way than to install from scratch. To help you out getting it all smoothly working a special page is created just click here. If you do not understand what that all means, do not panic, then the information on that page is not important to you. Just pretend you never read this part of the Wiki. You are advised just to follow the regular step as described on the install page.

64 Bit

If you don't know what 64 bit (x86_64) means, then don't worry about this! As previously discussed, there are currently no 64 bit paparazzi versions available. The easy solution is to use an i386 installation instead. In rare circumstances however, this may be problematic (certain engineering software for example requires 64 bit kernels). In these cases, a chroot is a good compromise, while avoiding the overhead of a virtual machine (and USB device problems which may occur). Initial instructions are here for now: https://help.ubuntu.com/community/DebootstrapChroot The command you use for the bootstrap needs to reflect your architecture - I used

 sudo debootstrap --variant=buildd --arch i386 lucid /var/chroot/lucid http://gb.archive.ubuntu.com/ubuntu/

The format for schroot config files has changed as of lucid however - here is mine:

 $ cat /etc/schroot/chroot.d/lucid-i386 
 [lucid]
 description=Ubuntu 10.04 Lucid for i386
 directory=/var/chroot/lucid
 personality=linux32
 root-users=my_user
 type=directory
 users=my_user

Once you've installed the ubuntu minimal package, make sure you also enable the uni- and multiverse repos (the easiest way for me is to simply copy my host's /etc/apt/sources.lst to /var/chroot/lucid/etc/apt/sources.lst). Then follow the standard instructions above. You may need to manually set the PAPARAZZI_HOME and PAPARAZZI_SRC environment variables. You will also have to set the DISPLAY environment variable to :0.0 like so:

 export DISPLAY=:0.0

Please note, this is more advanced than the standard paparazzi installation and therefore you may encounter strange problems.