!REDIRECT “https://docs.px4.io/master/ko/dev_setup/dev_env_linux_ubuntu.html“

우분투 LTS / 데비안 리눅스 개발 환경

PX4 개발용 지원/시험 리눅스 운영체제 버전은 우분투 리눅스 장기 지원 버전 18.04 (Bionic Beaver)와 20.04(Focal Fossa)입니다. 두 버전에서는 대부분의 PX4 대상(NuttX 기반 하드웨어, 퀄컴 스냅드래곤 플라이트 하드웨어, 리눅스 기반 하드웨어, 모의시험 환경)을 빌드할 수 있습니다.

제각기 다른 대상 플랫폼에 대해 개발 환경 설치를 용이하게 하는 배시 스크립트를 제공해드립니다:

Tip 스크립트를 초기 상태의 18.04 LTS 및 20.04 LTS 설치 기반에서 테스트했습니다. 기존 시스템에 “얹어 설치”하거나, 다른 우분투 출시판을 기반으로 설치할 경우 동작을 하지 않을수 있습니다.

아래 설명을 통해 스크립트 다운로드 및 활용법을 설명합니다.

Gazebo, JMAVSim and NuttX (Pixhawk) Targets

Use the ubuntu.sh 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 소스 코드를 다운로드하십시오: 

    1.  bash
    2.  git clone https://github.com/PX4/PX4-Autopilot.git --recursive

  2. 어떤 인자값도 주지 말고 ubuntu.sh 파일을 (배시 셸에서) 실행하여 모든 요소를 설치하십시오: 

    1.  bash
    2.  bash ./Tools/setup/ubuntu.sh
    • 스크립트 진행 과정 중 프롬프트에 응답하십시오.
    • nuttx 또는 모의시험 도구 설치를 생략할 때 --no-nuttx 와 --no-sim-tools 인자를 활용할 수 있습니다.
  3. 설치가 끝나면 컴퓨터를 다시 시작하십시오.

Note You can alternatively download ubuntu.sh and requirements.txt from the PX4 source repository (/Tools/setup/) and run ubuntu.sh in place:
wget https://raw.githubusercontent.com/PX4/PX4-Autopilot/{{ book.px4_version }}/Tools/setup/ubuntu.sh
wget https://raw.githubusercontent.com/PX4/PX4-Autopilot/{{ book.px4_version }}/Tools/setup/requirements.txt
bash ubuntu.sh

Notes:

  • PX4는 가제보 버전 7, 8, 9에서 동작합니다. 가제보 9을 설치할 때 gazebosim.org 과정을 활용합니다.
  • ROS를 다루려 할 경우 ROS/가제보 의 절차를 따르십시오(해당 설명 과정은 ROS 설치시 일부 구성요소로 가제보를 자동으로 설치합니다).

  • 아래와 같이 GCC 버전이 나타남을 확인하면 NuttX 설치가 끝났음을 검증할 수 있습니다:

    1.   $arm-none-eabi-gcc --version
    3.   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]
    4.   Copyright (C) 2017 Free Software Foundation, Inc.
    5.   This is free software; see the source for copying conditions.  There is NO
    6.   warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Raspberry Pi

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

Warning 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](https://docs.px4.io/master/en/flight_controller/raspberry_pi_pilotpi_rpios.html#alternative-build-method-using-docker).

To get the common dependencies for Raspberry Pi:

  1. Download ubuntu.sh and requirements.txt from the PX4 source repository (/Tools/setup/):
    wget https://raw.githubusercontent.com/PX4/PX4-Autopilot/{{ book.px4_version }}/Tools/setup/ubuntu.sh
    wget https://raw.githubusercontent.com/PX4/PX4-Autopilot/{{ book.px4_version }}/Tools/setup/requirements.txt

  2. 터미널에서 ubuntu.sh 명령을 실행하여 일반 의존 요소를 받으십시오: 

    1.  bash
    2.  bash ubuntu.sh --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:

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

Set them as default:

  1. 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
  2. sudo update-alternatives --config arm-linux-gnueabihf-gcc

GCC (aarch64)

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

  1. sudo apt-get install -y gcc-8-aarch64-linux-gnu g++-8-aarch64-linux-gnu
  2. 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
  3. 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:

  1. sudo apt-get install clang

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

  1. cd <PATH-TO-PX4-SRC>
  2. mkdir build/px4_raspberrypi_default_clang
  3. cd build/px4_raspberrypi_default_clang
  4. cmake \
  5. -G"Unix Makefiles" \
  6. -DCONFIG=px4_raspberrypi_default \
  7. -UCMAKE_C_COMPILER \
  8. -DCMAKE_C_COMPILER=clang \
  9. -UCMAKE_CXX_COMPILER \
  10. -DCMAKE_CXX_COMPILER=clang++ \
  11. ../..
  12. make

Detailed Information

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

ROS/Gazebo

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

To install the development toolchain:

  1. 배시 셸에서 스크립트를 다운로드하십시오:
    wget https://raw.githubusercontent.com/PX4/Devguide/{{ book.px4_version }}/build_scripts/ubuntu_sim_ros_melodic.sh
  2. 스크립트를 실행하십시오: 
    1.  bash
    2.  bash ubuntu_sim_ros_melodic.sh 스크립트 처리 진행시 일부 프롬프트에 응답해야 합니다.

Note:

  • 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.

스냅드래곤 비행체

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.