# PilotPi 使用 Ubuntu Server 操作系统


Ubuntu Server on RPi 4B consumes a lot of current and generates a lot of heat. Design for better heat dissipation and high power consumption when using this hardware.

# 开发者快速指南

# 操作系统镜像

请从官方 cdimage (opens new window) 页面获取最新更新的操作系统。

# armhf

# arm64

# 最新操作系统

当首次设置树莓派的 WiFi 时,我们建议先使用有线网络连接你的路由器与树莓派,并使用显示器和键盘。

# 首次启动

When setting up RaPi's WiFi for the first time we recommended using a wired Ethernet connection between your home router and RPi, and a monitor and keyboard.

# 启动前

现在将 SD 卡插入您的 Pi 并首次开机。 请确认您可以获得树莓派的 shell —— 通过有线以太网连接 SSH ,或直接通过键盘和显示器。

Now plug the SD card onto your Pi and boot for the first time. Make sure you have shell access to the RPi - either SSH connection over wired Ethernet, or direct accessing with keyboard and monitor.

# WiFi 区域

First install required package:

sudo apt-get install crda

Edit the file /etc/default/crda to change the correct WiFi region. Reference List (opens new window)

sudo nano /etc/default/crda


# 主机名和 mDNS

Let's set up hostname at first.

sudo nano /etc/hostname

Change the hostname to whatever you like. Then install the package required by mDNS:

sudo apt-get update
sudo apt-get install avahi-daemon


sudo reboot

您也可能想要设置 无密码认证 (opens new window)

ssh ubuntu@pi_hostname.local

# 无密码认证(可选)

在 Ubuntu 中的相应文件是 /boot/firmware/usercfg.txt

# 配置操作系统

# config.txt


sudo nano /boot/firmware/usercfg.txt

Ubuntu Server 20.04:

# enable sc16is752 overlay
# enable I2C-1 and set the frequency to 400KHz
# enable spidev0.0
# enable RC input
# enable I2C-0
# switch Bluetooth to miniuart

# cmdline.txt

在Ubuntu Server 18.04 或更早版本,nobtcmd.txtbtcmd.txt 都需要修改。

sudo nano /boot/firmware/cmdline.txt

找到 console=/dev/ttyAMA0,115200 并删除该部分以禁用串口上的登录shell。

sudo nano /boot/firmware/nobtcmd.txt

Find console=/dev/ttyAMA0,115200 and remove that part to disable the login shell on serial interface.

这告诉Linux内核不要在 CPU 核心2 上调度任何进程。 我们将在稍后手动在该核心运行PX4。

net.ifnames=0 dwc_otg.lpm_enable=0 console=tty1 root=LABEL=writable rootfstype=ext4 elevator=deadline rootwait fixrtc isolcpus=2

The above line tells the Linux kernel do not schedule any process on CPU core 2. We will manually run PX4 onto that core later.


应该有 /dev/ttyAMA0, /dev/ttySC0/dev/ttySC1

ls /dev/tty*

检查 I2C:

应该有 /dev/i2c-0/dev/i2c-1

ls /dev/i2c*


应该有 /dev/spidev0.0

ls /dev/spidev*

There should be /dev/spidev0.0.

# rc.local

In this section we will configure the auto-start script in rc.local. Note that we need to create this file, as it is not present on a fresh Ubuntu OS.

sudo nano /etc/rc.local

Append the content below to the file:

echo "25" > /sys/class/gpio/export
echo "in" > /sys/class/gpio/gpio25/direction
if [ $(cat /sys/class/gpio/gpio25/value) -eq 1 ] ; then
        echo "Launching PX4"
        cd /home/ubuntu/px4 ; nohup taskset -c 2 ./bin/px4 -d -s pilotpi_mc.config 2 &> 1 > /home/ubuntu/px4/px4.log &
echo "25" > /sys/class/gpio/unexport
exit 0

Save and exit. Then set the correct permissions:

sudo chmod +x /etc/rc.local


Don't forget to turn off the switch when it is not needed!

# CSI 相机


Enable CSI camera will stop anything works on I2C-0.

sudo nano /boot/firmware/usercfg.txt


# 构建代码


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


This is all you need to do just to build the latest code.

# 配置上传


export AUTOPILOT_HOST=192.168.X.X

如果您是首次使用 Docker 进行编译,请参考官方说明 (opens new window)

export AUTOPILOT_HOST=pi_hostname.local

在 PX4-Autopilot 文件夹下执行:

export AUTOPILOT_USER=ubuntu

# 为 armhf 目标交叉编译


cd Firmware
make scumaker_pilotpi_default


make scumaker_pilotpi_default upload

# 备选armhf构建方法 (使用 docker)


如果您是首次使用 Docker 进行编译,请参考官方说明 (opens new window)

./Tools/docker_run.sh "export AUTOPILOT_HOST=192.168.X.X; export AUTOPILOT_USER=ubuntu; export NO_NINJA_BUILD=1; make scumaker_pilotpi_default upload"


mDNS is not supported within docker. You must specify the correct IP address every time when uploading.


If your IDE doesn't support ninja build, NO_NINJA_BUILD=1 option will help. You can compile without uploading too. Just remove upload target.

通过 ssh 连接并运行它:

./Tools/docker_run.sh "make scumaker_pilotpi_default"

# 为arm64交叉编译


This step requires aarch64-linux-gnu tool-chain to be installed.


cd PX4-Autopilot
make scumaker_pilotpi_arm64

这时应当使用基于 Docker 的编译。

make scumaker_pilotpi_arm64 upload

# 备选 arm64 构建方法 (使用 docker)



./Tools/docker_run.sh "export AUTOPILOT_HOST=192.168.X.X; export AUTOPILOT_USER=ubuntu; export NO_NINJA_BUILD=1; make scumaker_pilotpi_arm64 upload"


mDNS is not supported within docker. You must specify the correct IP address everytime when uploading.


If your IDE doesn't support ninja build, NO_NINJA_BUILD=1 option will help. You can compile without uploading too - just remove the upload target.

It is also possible to just compile the code with command:

./Tools/docker_run.sh "make scumaker_pilotpi_arm64"

# 手动运行 PX4

Connect over SSH and run it with:

cd px4
sudo taskset -c 2 ./bin/px4 -s pilotpi_mc.config

Now PX4 is started with multi-rotor configuration.

If you encountered the similar problem executing bin/px4 on your Pi as following:

bin/px4: /lib/xxxx/xxxx: version `GLIBC_2.29' not found (required by bin/px4)

Then you should compile with docker instead.

Before proceeding to next step, clear the existing building at first:

rm -rf build/scumaker_pilotpi_*

Then go back to the corresponding chapter above.

# 后期配置

Please refer to the instructions here