PX4 用户指南（V1.13）

# MacOS 开发环境

以下说明为 macOS 设置了 PX4 开发环境。该环境可用于为以下设备构建 PX4：

苹果 M1 Macbook 用户！

如果您使用的是苹果 M1 Macbook，请确保通过设置 x86 终端以 x86 运行终端：

  1. 在 "实用工具 "文件夹中找到 "终端 "应用程序 (查找工具> 转到菜单> 实用工具)
  2. 选择 终端.应用程序 并右键单击它，然后选择 重复.
  3. 将复制的终端应用程序重命名，例如重命名为 x86 终端
  4. 现在选择重命名后的 x86 终端 应用程序，然后右键单击并选择 *获取信息
  5. 勾选 使用 Rosetta 打开然后关闭窗口
  6. 运行 x86 终端 这将完全支持当前的 PX4 工具链

TIP

PX4 开发团队支持这种设置。要构建其他目标，您需要使用 不同的操作系统 （或一个 不支持的开发环境).

# 视频指南

# 自制软件安装

Homebrew 的安装非常简单快捷： 安装说明 (打开新窗口）.

# 启用更多打开的文件（处理 "LD：打开的文件太多"错误）

创建 ~/.zshenv 文件或添加它（通过运行 打开 ~/.zshenv 在终端上）并添加这一行：

限制 -S -n 2048

# 执行 Python 版本

如果尚未存在，请创建文件 ~/.zshrc 并添加这几行：

# 将 pip3 指向 MacOS 系统 python 3 pip
别称 管道3=/usr/bin/pip3

# 常用工具

安装 Homebrew 后，在 shell 中运行这些命令来安装常用工具：

酿造龙头 PX4/px4 brew 安装 px4-dev

安装所需的 Python 软件包

# 使用 pip3 安装所需软件包
python3 -m pip 安装 --user pyserial empty toml numpy pandas jinja2 pyyaml pyros-genmsg packaging kconfiglib future jsonschema
# 如果此命令失败并显示权限错误，则说明 Python 安装在系统路径中 - 请使用此命令：
苏都 -H python3 -m pip 安装 --user pyserial empty toml numpy pandas jinja2 pyyaml pyros-genmsg packaging kconfiglib future jsonschema

# 仿真场景Gazebo模拟

首先运行以下命令：

brew unlink tbb brew 安装 tbb@2020 brew 链接 tbb@2020

备注

2021 年 9 月：上述命令是解决此错误的方法： PX4-Autopilot#17644 (打开新窗口）.修复后即可将其删除（连同本说明）。

使用 Gazebo 安装 SITL 仿真：

酿 安装 --桶装特穆林啤酒 安装 --桶装石英啤酒 安装 px4-sim-gazebo

运行此 macOS 设置脚本： PX4-Autopilot/Tools/setup/macos.sh 最简单的方法是克隆 PX4 源代码，然后从该目录运行脚本，如图所示：

Git 克隆 https://github.com/PX4/PX4-Autopilot.git --recursive
CD PX4-自动驾驶仪/工具/设置
吁 macos.sh

# jMAVSim 模拟

要使用 jMAVSim 进行 SITL 仿真，您需要安装最新版本的 Java（如 Java 15）。您可以下载 Oracle Java 15（或更高版本 (打开新窗口） 或使用 Eclipse Temurin (打开新窗口）:

酿 安装 --卡斯克-特穆林

然后安装 jMAVSim：

酿 安装 px4-sim-jmavsim

警告

PX4 v1.11 及以后版本的 jMAVSim 仿真至少需要 JDK 15。

对于早期版本，macOS 用户可能会看到以下错误 线程 "main" java.lang.UnsupportedClassVersionError 中出现异常：.您可以在 jMAVSim 与 SITL > 故障排除).

# 下一步工作

完成命令行工具链的设置后：

← Ubuntu 设置 →