Difference between revisions of "Installation/Linux"
| Line 80: | Line 80: | ||
If you can not access your toolchain with PATH working, look a the [[Installation/Linux#Troubleshooting]]. | If you can not access your toolchain with PATH working, look a the [[Installation/Linux#Troubleshooting]]. | ||
=== gcc-arm-none-eabi as Ubuntu package === | === gcc-arm-none-eabi as Debian/Ubuntu package === | ||
Note that there are actually two '''different''' toolchains available that unfortunately have the same name! | |||
* [https://launchpad.net/gcc-arm-embedded/ ARM gcc-arm-embedded toolchain] | |||
** includes libstdc++ and newlib-nano | |||
* [https://packages.debian.org/jessie/gcc-arm-none-eabi Debian gcc-arm-none-eabi toolchain] | |||
** does not include libstdc++ | |||
** does not include newlib-nano | |||
Both toolchains ''should'' work for most use-cases (if you don't need C++ or nano specs), although the [https://launchpad.net/gcc-arm-embedded/ ARM gcc-arm-embedded toolchain] is better tested. | |||
==== gcc-arm-embedded toolchain ==== | |||
On '' | On ''most'' Ubuntu versions (currently lucid, precise, raring, saucy and trusty) the [https://launchpad.net/gcc-arm-embedded/ gcc-arm-embedded toolchain] can be installed as a debian package from the [https://launchpad.net/~terry.guo/+archive/gcc-arm-embedded ppa]: | ||
sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded | sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded | ||
sudo apt-get update | sudo apt-get update | ||
sudo apt-get install gcc-arm-none-eabi | sudo apt-get install gcc-arm-none-eabi | ||
Note [https://bugs.launchpad.net/gcc-arm-embedded/+bug/1309060 bug1309060] on Ubuntu 14.04 you have to explicitly install the gcc-arm-embedded version: | |||
sudo apt-get remove binutils-arm-none-eabi gcc-arm-none-eabi | |||
sudo apt-get install gcc-arm-none-eabi=4-8-2014q1-0trusty8 | |||
==== gcc-arm-none-eabi Debian toolchain ==== | |||
Debian testing ('''jessie''') and Ubuntu 14.04 ('''trusty''') have the gcc-arm-none-eabi package in the official repositories ('''universe'''), and can be installed with: | |||
sudo apt-get update | |||
sudo apt-get install gcc-arm-none-eabi | |||
=== Old toolchain for Paparazzi v4.x and earlier === | === Old toolchain for Paparazzi v4.x and earlier === | ||
Revision as of 08:46, 28 May 2014
This page only describes the installation of the prerequisite tools and dependencies on Debian/Ubuntu needed for Paparazzi.
See the general Installation page for how to download Paparazzi and launching it after you followed the instructions here.
Introduction
Paparazzi is very easily installed on any laptop or workstation running Ubuntu, Debian (or any of their derivatives).
The steps required to install the software needed to be able to let your UAS fly
- Install the basic Paparazzi dependencies and the ARM cross compiling toolchain.
- Download the source code from the source repository.
- Allow access to your PC hardware connection by adding appropriate Udev rules.
- Compile the binaries from the sources and launch the software.
Users of other Linux flavors than a recent Ubuntu or Debian and anyone needing manual control of each individual package can install them independently.
For the impatient
For Ubuntu add the paparazzi-uav ppa sudo add-apt-repository ppa:paparazzi-uav/ppa and install the paparazzi-dev package.
Since Paparazzi v5.0 the gcc-arm-embedded toolchain is recommended. Available as of Ubuntu 14.04, on older versions it can be installed via tarball.
Or just use the Quickstart for Ubuntu 12.04 LTS.
Installation video Tutorials
Installation of dependencies
Ubuntu
Add the installation sources for the Paparazzi software packages. Run from a terminal:
sudo add-apt-repository ppa:paparazzi-uav/ppa
Then update the systems package inventory and install the main Paparazzi software dependencies. This will take some time.
sudo apt-get update sudo apt-get install paparazzi-dev
Debian
For Debian Squeeze (6.0) and Wheezy (7.0) packages are built using the Open Build Service (OBS) on OpenSUSE Build Service project home:flixr:paparazzi-uav
First add the key:
wget -q "http://download.opensuse.org/repositories/home:/flixr:/paparazzi-uav/Debian_7.0/Release.key" -O- | apt-key add -
Add the appropriate repo, depending on your Debian version to sources.list
echo "deb http://download.opensuse.org/repositories/home:/flixr:/paparazzi-uav/Debian_6.0/ ./" | tee -a /etc/apt/sources.list echo "deb http://download.opensuse.org/repositories/home:/flixr:/paparazzi-uav/Debian_7.0/ ./" | tee -a /etc/apt/sources.list
Update the systems package inventory and install the main Paparazzi software dependencies.
sudo apt-get update sudo apt-get install paparazzi-dev
ARM embedded toolchain
For current Paparazzi versions (v5.0 and above) the gcc-arm-embedded toolchain is recommended, which also supports the STM32F4 with FPU (hardware floating point).
The most common way is to download and unpack the tarball and add it to your PATH:
cd ~ wget https://launchpad.net/gcc-arm-embedded/4.8/4.8-2013-q4-major/+download/gcc-arm-none-eabi-4_8-2013q4-20131204-linux.tar.bz2 tar -vjxf gcc-arm-none-eabi-4_8-2013q4-20131204-linux.tar.bz2 rm -rf gcc-arm-none-eabi-4_8-2013q4-20131204-linux.tar.bz2 sudo mv gcc-arm-none-eabi-4_8-2013q4 /opt exportline="PATH=$PATH:/opt/gcc-arm-none-eabi-4_8-2013q4/bin" if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi source ~/.profile
The file .profile will be sourced in every bash after logging out and in again. Until then,
source ~/.profile
can be used for every bash individually.
If you can not access your toolchain with PATH working, look a the Installation/Linux#Troubleshooting.
gcc-arm-none-eabi as Debian/Ubuntu package
Note that there are actually two different toolchains available that unfortunately have the same name!
- ARM gcc-arm-embedded toolchain
- includes libstdc++ and newlib-nano
- Debian gcc-arm-none-eabi toolchain
- does not include libstdc++
- does not include newlib-nano
Both toolchains should work for most use-cases (if you don't need C++ or nano specs), although the ARM gcc-arm-embedded toolchain is better tested.
gcc-arm-embedded toolchain
On most Ubuntu versions (currently lucid, precise, raring, saucy and trusty) the gcc-arm-embedded toolchain can be installed as a debian package from the ppa:
sudo add-apt-repository ppa:terry.guo/gcc-arm-embedded sudo apt-get update sudo apt-get install gcc-arm-none-eabi
Note bug1309060 on Ubuntu 14.04 you have to explicitly install the gcc-arm-embedded version:
sudo apt-get remove binutils-arm-none-eabi gcc-arm-none-eabi sudo apt-get install gcc-arm-none-eabi=4-8-2014q1-0trusty8
gcc-arm-none-eabi Debian toolchain
Debian testing (jessie) and Ubuntu 14.04 (trusty) have the gcc-arm-none-eabi package in the official repositories (universe), and can be installed with:
sudo apt-get update sudo apt-get install gcc-arm-none-eabi
Old toolchain for Paparazzi v4.x and earlier
For Paparazzi v4.x and earlier you need to install the paparazzi-arm-multilib package. It has support for both ARM7 (i.e. Tiny,TWOG,YAPA autopilot boards) as well as STM32F1 (i.e. LISA boards).
This toolchain does not properly support STM32F4 based autopilots!!
You can install it explicitly with:
sudo apt-get install paparazzi-arm-multilib
Optional Packages
The packages lpc21isp and openocd are normally automatically installed as they are recommended packages of paparazzi-dev, if not you can manually install them via:
sudo apt-get install lpc21isp openocd
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.
Installing and running Paparazzi
Please see Getting the Source Code on the general Installation page for details on downloading the Paparazzi source code, compiling and running it.
Udev rules
Add the appropriate Udev 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/
See the Udev page for more details.
Troubleshooting
No access rights for USB devices
Some Linux distributions, don't allow standard (non admin) users to directly access the USB bus by default. On recent Ubuntu/Debian versions the first/main user is already a member of the plugdev group which should be sufficient for most cases.
If you have problems, make yourself a member of the plugdev and dialout groups:
sudo adduser <your login> plugdev sudo adduser <your login> dialout
Logout and login again.
arm-none-eabi-gcc: Command not found
Appeared on Debian Wheezy 7 (gcc-arm-none-eabi-4_8-2013q4 installed via tarball)
If this error occurs, maybe the ia32-libs are missing.
Enable multiarch and install ia32-libs:
dpkg --add-architecture i386 apt-get update apt-get install ia32-libs
FTDI serial adapter not working on old Ubuntu version
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
Code not starting on autopilot after changing gcc
If you changed the toolchain (e.g. installed a new one for having FPU-Support for the F4), you need to run
make clean && make
in sw/ext in order to rebuild the libs. Otherwise the embedded code can behave strange (most likely not start)