Difference between revisions of "Installation/Linux"

From PaparazziUAV
Jump to navigation Jump to search
m (couple minor changes for linux only)
(got rid of more general installation things, available on normal Installation page)
Line 106: Line 106:


== Downloading the Source Code ==
== Downloading the Source Code ==
The complete source code should be downloaded from the paparazzi software repository on Github. Make sure you have installed the <tt>paparazzi-dev</tt> package as described above. Whithout these you will not be able to compile the sourcecode.
The complete source code should be downloaded from the paparazzi software repository on Github. Make sure you have installed the <tt>paparazzi-dev</tt> package as described above. Without these you will not be able to compile the sourcecode.


See the [https://github.com/paparazzi/paparazzi project page] at Github for more details. From the directory of your choice type:
Please see [[Installation#Downloading_the_Source_Code]] for details.
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 paparazzi sourcecode need for an autopilot to work into the directory <tt>paparazzi/</tt>
 
'''If this whole "Git" thing is new to you an you are curious, more options and information can be found on the [[git]] page.'''


== Launching the Software ==
== Launching the Software ==


The first step is to compile. From the <tt>paparazzi</tt> directory (<tt>cd paparazzi</tt>), run
Please see [[Installation#Launching_the_Software]] for details.
 
make
 
You will have to run this command after each update of the source (<tt>git pull</tt> command).
Launch the software from the <tt>paparazzi</tt> directory with
 
./paparazzi
 
From the [[Paparazzi_Center|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 ===
=== Quick Launch Icon ===
Line 145: Line 129:
=== Agents ===
=== Agents ===


If ('''and only if''') you want to directly launch some Paparazzi agents (the ''Tools'' of the [[Paparazzi_Center|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:
Please see [[Installation#Agents]] for details.
{{Box Code|~/.bashrc|
export PAPARAZZI_HOME<nowiki>=</nowiki>''your paparazzi software directory''
export PAPARAZZI_SRC<nowiki>=</nowiki>''your paparazzi software directory''
}}


=== env Variables ===
=== 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:
Please see [[Installation#env_Variables]] for details.
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<nowiki>=</nowiki>''your paparazzi software directory''
PAPARAZZI_SRC<nowiki>=</nowiki>''your paparazzi software directory''


== Setting access rights for USB download ==
== Setting access rights for USB download ==
Line 176: Line 150:


== Software Updates ==
== Software Updates ==
Paparazzi is a very rapidly evolving project and as such you might want to update your software regularly.
Any new files you created will not be lost/overwritten when updating (like your own airframe file). Nevertheless, as with all things, backups are advised.
If you modified source code, the best way is of course to use the version control system [[Git]] to commit your changes. Otherwise at least use the brute force method and save everything in another directory.
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. You might need to update your airframe file as well. The compiler will usually complain if there is a problem, at which point you can look at the [[Airframe_Configuration|Airframe Configuration wiki page]] again, look on the [[Contact#Mailing_List|mailing list]] or 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 fairly easy with Git.
To download and automatically merge any updated source files, run the following command from your Paparazzi directory
git pull
Please see the [[Git|Git wiki page]] for more details.
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.
== 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==


There are now 64bit packages available for Paparazzi, still in very rare occasions one needs to install the tools used, third-party libraries used by Paparazzi all from scratch. Sometimes 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 [[install_paparazzi_and_everything_from_scratch | 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.
Please see [[Installation#Software_Updates]] for details.


== Using 32Bit on 64Bit ==
== Using 32Bit on 64Bit ==

Revision as of 18:23, 8 March 2012

Installation
Installation
Installation/BeagleBoneBlack
Installation/FromScratch
Installation/Linux
Installation/MacOSX
Installation/Windows10

Introduction

Paparazzi is very easily installed on any laptop or workstation running the Ubuntu Linux OS or virtually any Debian based Linux.

The steps required to install the software needed to be able to let your UAS fly

  • Install a recent Ubuntu Linux operating system
  • The basic Paparazzi tools installed via Synaptic Package Manager.
  • Download the source code from the source repository.
  • Allow access to your PC hardware connection by copying the rules file
  • 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 it's dependencies. The repository hosted at ENAC holds their latest version.

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 virtual machines 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

For the impatient:

  • Add paparazzi the paparazzi-uav ppa for Ubuntu for Ubuntu: ppa:paparazzi-uav/ppa
    or for Debian: deb http://paparazzi.enac.fr/debian squezze main
  • Install: paparazzi-dev and paparazzi-arm-multilib

Adding the APT repository

For any Ubuntu version run from the command line: 

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

Alternate Ubuntu repository and Debian

The ubuntu repository at paparazzi.enac.fr/ubuntu contains some older packages and can be used instead of the ppa.

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. squeeze or natty):

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/debian squeeze main
# deb http://paparazzi.enac.fr/ubuntu lucid main
# deb http://paparazzi.enac.fr/ubuntu maverick main
# deb http://paparazzi.enac.fr/ubuntu natty main
# deb http://paparazzi.enac.fr/ubuntu oneiric main

Installing the packages

Update your sources and install the dependencies needed for recompiling from the source (dev), and the cross-compiler toolchain arm-multilib: 

sudo apt-get update
sudo apt-get install paparazzi-dev paparazzi-arm-multilib

The paparazzi-arm-multilib package provides support for both ARM7 (i.e. Tiny or TWOG boards) as well as STM32 (i.e. Lisa boards).

Using Ubuntu Software Center

For Ubuntu Oneiric (11.10)

  • Launch Software Sources (Red Wrench and gear icon -> System section)
  • Search for paparazzi-dev and paparazzi-arm-multilib packages and click on install.

Using Synaptic Package Manager

Note: The Synaptic Package Manager is not installed by default anymore under Ubuntu Oneiric (11.10). Either use the Software Center, command line or install Synaptic again.

  • Launch Synaptic Package Manager (Menu System/Administration)
  • Click Reload to update your sources.
  • Search for paparazzi-dev and paparazzi-arm-multilib packages (use the Search button)
  • Mark them for installation (right-click on package names)
  • Left-click on Apply

Optional Packages

sudo apt-get install lpc21isp openocd

The packages lpc21isp and openocd are normally automatically installed as they are recommended packages of paparazzi-dev, if not you can manually install them. lpc21isp is needed to serially flash the LPC2148 based autopilots (e.g. bootloader for tiny, twog, umarim), openocd is for flashing via JTAG (e.g. for Lisa boards) and debugging.

Obsolete Packages

These packages are in the paparazzi.enac.fr/ubuntu (or debian) repository and unmaintained, but still might be of some use...

  • paparazzi-avr Users of the older AVR based boards will need this.
  • paparazzi-arm7 To use the old gcc 3.4.4 for ARM7, superseded by paparazzi-arm-multilib. To use paparazzi-arm7 remove paparazzi-arm-multilib.
  • paparazzi-stm32 Can be used for the Lisa autopilots, superseded by paparazzi-arm-multilib. To use paparazzi-stm32 remove paparazzi-arm-multilib.

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 Debian and anyone needing manual control of each individual package can install them independently.

Downloading the Source Code

The complete source code should be downloaded from the paparazzi software repository on Github. Make sure you have installed the paparazzi-dev package as described above. Without these you will not be able to compile the sourcecode.

Please see Installation#Downloading_the_Source_Code for details.

Launching the Software

Please see Installation#Launching_the_Software for details.

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

Please see Installation#Agents for details.

env Variables

Please see Installation#env_Variables for details.

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 in fhe file 50-paparazzi.rules) to the USB handler. Simply copy as root conf/system/udev/rules/50-paparazzi.rules to /etc/udev/rules.d/, e.g in a terminal: 

cd <your paparazzi directory>
sudo cp conf/system/udev/rules/50-paparazzi.rules /etc/udev/rules.d/

Software Updates

Please see Installation#Software_Updates for details.

Using 32Bit on 64Bit

As there are now 64bit packages available this should not be needed anymore, nevertheless...

An temporary 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.

Retrieved from "http://wiki.paparazziuav.org/w/index.php?title=Installation/Linux&oldid=11928"