树莓派2/3自动驾驶仪

官网英文原文地址：http://dev.px4.io/hardware-rpi.html

开发者快速开始使用

OS Image系统镜像

使用Emlid RT Raspbian image这个前期配置好的有效的PX4树莓派镜像。这个镜像默认最大化的事先配置了程序。

Important: make sure not to upgrade the system (more specifically the kernel). By upgrading, a new kernel can get installed which lacks the necessary HW support (you can check with ls /sys/class/pwm, the directory should not be empty).

访问设置

此树莓派镜像已经事先设置好了SSH。用户名：pi 和密码：raspberry。你可以直接通过网络去连接你的树莓派2（以太网已经启动并且默认自动分配IP）和可以配置使用wifi。在这篇文档中，我们采取默认的用户名和密码登入树莓派系统。

设置你的树莓派加入你的本地wifi网络（使你的树莓派连接你的wifi），关于如何设置请参考这篇
指导文章。找到树莓派在你网络中的IP地址，随后你可以开始通过SSH的方式连接Pi2。

ssh pi@<IP-ADDRESS>

Expand the Filesystem

After installing the OS and connecting to it, make sure to expand the Filesystem,so there is enough space on the SD Card.

改变树莓派主机名

为了避免与同一网络上的其他树莓派有冲突，我们建议你改变默认主机名为明显的名字。我们使用px4autopilot作为我们的主机名。通过ssh连接pi并执行指令。

编辑主机名文件:

sudo nano /etc/hostname

更改主机名 raspberry为你想要的任何主机名 (一个word字的有限字符)

下一步更改主机host文件:

sudo nano /etc/hosts

更改入口 127.0.1.1 raspberry 为 127.0.1.1 <YOURNEWHOSTNAME>
做完这步重启电脑成功后允许他重新关联你的网络。

Setting up Avahi (Zeroconf)

为了使你更容易的连接上你的树莓派，我们推荐设置Avahi（Zeroconf：零配置网络服务规范）来更简单的使用连接网络。
使连接到树莓派更容易，我们建议设立的avahi（zeroconf）允许方便地访问任何网络PI直接指定主机名。

sudo apt-get install avahi-daemon
sudo insserv avahi-daemon

接下来，设置Avahi配置文件

sudo nano /etc/avahi/services/multiple.service

把下面文字加入文件中：

<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
        <name replace-wildcards="yes">%h</name>
        <service>
                <type>_device-info._tcp</type>
                <port>0</port>
                <txt-record>model=RackMac</txt-record>
        </service>
        <service>
                <type>_ssh._tcp</type>
                <port>22</port>
        </service>
</service-group>

重新启动后台进程

sudo /etc/init.d/avahi-daemon restart

到此就结束了。你应该可以在同一网络上的任意一台电脑上通过树莓派的主机名访问你的树莓派。

Configuring a SSH Public-Key

为了允许PX4开发环境自动的更新可执行文件到你的开发板子上，你需要配置无密码访问RPi。我们使用公钥的验证方法。

输入下面的命令来创建新的SSH密钥 (使用合理的主机名如 <YOURNANME>@<YOURDEVICE>. 在这我们使用 pi@px4autopilot)

这些命令需要运行在主机开发电脑上！

ssh-keygen -t rsa -C pi@px4autopilot

执行上面这条命令，将会询问你这个密钥存在哪个位置。我们建议你直接回车让它存储在默认位置($HOME/.ssh/id_rsa)。

现在你可以看到这些文件 id_rsa 和 id_rsa.pub 在你的 电脑主目录文件夹下的.ssh 文件夹里:

ls ~/.ssh
authorized_keys  id_rsa  id_rsa.pub  known_hosts

这 id_rsa 文件是你的私人密钥. 让它保存在开发主机电脑上.
这 id_rsa.pub 文件是你的公共密钥. This is what you put on the targets you want to connect to.

把你的公共密钥复制到你的树莓派上，使用下面的命令来将你的公共密钥添加到树莓派上的密钥授权文件里。sending it over SSH:

cat ~/.ssh/id_rsa.pub | ssh pi@px4autopilot 'cat >> .ssh/authorized_keys'

注意：这一次你将通过密码的方式进行身份验证(默认是”raspberry”).

现在尝试使用 ssh pi@px4autopilot 连接时没有密码提示.

如果你看到这条信息”Agent admitted failure to sign using the key.“ 然后加入你的RSA或者DSA认证身份到你的 ssh-agent（密钥管理器），并执行下面的命令：

ssh-add

如果它不工作, 使用 rm ~/.ssh/id*这条命令删除你的密钥，然后按照上面的操作重新再做一遍。

测试文件传输

我们使用SCP命令通过网络（wifi或者以太网）从开发主机传输文件到目标板。

为了测试你的设置, 现在尝试通过网络从开发主机上推送到树莓派上。确保你的树莓派能正确访问网络，并且你可以使用ssh访问它。

echo "Hello" > hello.txt
scp hello.txt pi@px4autopilot:/home/pi/
rm hello.txt

这是拷贝一个”hello.txt”文件到你树莓派的家目录下（/home/pi）。
确认这个文件是真的拷贝进去了，你就可以执行下一步了。

本地构建 (可选)

You can run PX4 builds directly on the Pi if you desire. This is the native build. The other option is to run builds on a development computer which cross-compiles for the Pi, and pushes the PX4 executable binary directly to the Pi. This is the cross-compiler build, and the recommended one for developers due to speed of deployment and ease of use.

For cross-compiling setups, you can skip this step.

The steps below will setup the build system on the Pi to that required by PX4. Run these commands on the Pi itself!

sudo apt-get update
sudo apt-get install cmake python-empy

Then clone the Firmware directly onto the Pi.

Building the code

Continue with our standard build system installation.