This page has moved to

Click here if you are not redirected.

Ubuntu LTS/Debian Linux上开发环境的搭建

The supported/tested Linux OS versions for PX4 development are Ubuntu Linux LTS 18.04 (Bionic Beaver) and 20.04 (Focal Fossa). These allow you to build for the most PX4 targets (NuttX based hardware, Qualcomm Snapdragon Flight hardware, Linux-based hardware, Simulation).


The scripts have been tested on clean Ubuntu 18.04 LTS and Ubuntu 20.04 LTS installations. They may not work as expected if installed "on top" of an existing system, or on a different Ubuntu release.


Gazebo, JMAVSim and NuttX (Pixhawk) Targets

Use the script to set up a development environment that includes Gazebo 9 and jMAVSim simulators, and/or the NuttX/Pixhawk toolchain.

To install the toolchain:

  1. 下载 PX4 源代码

     git clone --recursive
  2. 在bash shell中不带参数地运行ubuntu.sh来安装所有的依赖工具:

     bash ./Tools/setup/
    • 在安装过程中确认并通过所有的提示。
    • 你可以通过传输参数--no-nuttx--no-sim-tools 来跳过 nuttx 和/或 仿真器工具的安装。
  3. 完成后重新启动计算机。

You can alternatively download and requirements.txt from the PX4 source repository (/Tools/setup/) and run in place:


  • PX4需要跟Gazebo 7, 8, 或者 9一起工作, 该脚本使用 instructions来安装Gazebo9。
  • 如果你正在使用ROS工作,那么请遵循ROS/Gazebo的介绍来安装(它是自动转安装的,作为ROS安装的一部分)。
  • 你可以通过确认gcc的版本来验证Nuttx的安装:

      $arm-none-eabi-gcc --version
      arm-none-eabi-gcc (GNU Tools for Arm Embedded Processors 7-2017-q4-major) 7.2.1 20170904 (release) [ARM/embedded-7-branch revision 255204]
      Copyright (C) 2017 Free Software Foundation, Inc.
      This is free software; see the source for copying conditions.  There is NO

Raspberry Pi

The following instructions explain how to set up a build toolchain for RasPi on Ubuntu 18.04.

To build for Ubuntu 20.04 (focal) you must use docker (the GCC toolchain on Ubuntu 20.04 can build PX4, but the generated binary files are too new to run on actual Pi). For more information see [PilotPi with Raspberry Pi OS

Developer Quick Start > Alternative build method using docker](

To get the common dependencies for Raspberry Pi:

  1. Download and requirements.txt from the PX4 source repository (/Tools/setup/):
  2. 在终端中运行,获取一般的依赖模块:

     bash --no-nuttx --no-sim-tools
  3. Then setup an cross-compiler (either GCC or clang) as described in the following sections.

GCC (armhf)

Ubuntu software repository provides a set of pre-compiled toolchains. Note that Ubuntu Focal comes up with gcc-9-arm-linux-gnueabihf as its default installation which is not fully supported, so we must manually install gcc-8-arm-linux-gnueabihf and set it as the default toolchain. This guide also applies to earlier Ubuntu releases (Bionic). The following instruction assumes you haven't installed any version of arm-linux-gnueabihf, and will set up the default executable with update-alternatives. Install them with the terminal command:

sudo apt-get install -y gcc-8-arm-linux-gnueabihf g++-8-arm-linux-gnueabihf

Set them as default:

sudo update-alternatives --install /usr/bin/arm-linux-gnueabihf-gcc arm-linux-gnueabihf-gcc /usr/bin/arm-linux-gnueabihf-8 100 --slave /usr/bin/arm-linux-gnueabihf-g++ arm-linux-gnueabihf-g++ /usr/bin/arm-linux-gnueabihf-g++-8
sudo update-alternatives --config arm-linux-gnueabihf-gcc

GCC (aarch64)

If you want to build PX4 for ARM64 devices, this section is required.

sudo apt-get install -y gcc-8-aarch64-linux-gnu g++-8-aarch64-linux-gnu
sudo update-alternatives --install /usr/bin/aarch64-linux-gnu-gcc aarch64-linux-gnu-gcc /usr/bin/aarch64-linux-gnu-gcc-8 100 --slave /usr/bin/aarch64-linux-gnu-g++ aarch64-linux-gnu-g++ /usr/bin/aarch64-linux-gnu-g++-8
sudo update-alternatives --config aarch64-linux-gnu-gcc

Clang (optional)

First install GCC (needed to use clang).

We recommend you to get clang from the Ubuntu software repository, as shown below:

sudo apt-get install clang

Example below for building PX4 firmware out of tree, using CMake.

mkdir build/px4_raspberrypi_default_clang
cd build/px4_raspberrypi_default_clang
cmake \
-G"Unix Makefiles" \
-DCONFIG=px4_raspberrypi_default \

Detailed Information

Additional developer information for using PX4 on Raspberry Pi (including building PX4 natively) can be found here:


This section explains how to install ROS/Gazebo ("Melodic") for use with PX4.

To install the development toolchain:

  1. 在bash shell中下载脚本:
  2. 运行脚本:
     bash 随着脚本的运行,可能需要根据提示进行确认。


  • ROS Melodic is installed with Gazebo9 by default.
  • Your catkin (ROS build system) workspace is created at ~/catkin_ws/.
  • The script uses instructions from the ROS Wiki "Melodic" Ubuntu page.

高通骁龙飞控(Snapdragon Flight)

Setup instructions for Snapdragon Flight are provided in the PX4 User Guide:

Fast RTPS installation

eProsima Fast RTPS is a C++ implementation of the RTPS (Real Time Publish Subscribe) protocol. FastRTPS is used, via the RTPS/ROS2 Interface: PX4-FastRTPS Bridge, to allow PX4 uORB topics to be shared with offboard components.

Follow the instructions in Fast RTPS Installation to install it.


After setting up the build/simulation toolchain, see Additional Tools for information about other useful tools.


Once you have finished setting up the environment, continue to the build instructions.

results matching ""

    No results matching ""