不少人一开始碰PX4都是从我会写代码直接跳到我要把程序跑在真机上的。结果往往很惨螺旋桨还没转起来先炸了桨叶或者把自己吓出一身冷汗。我在接手一个室内定位试验项目的时候也差不多代码逻辑和传感器模型都还能看但整整两周都被环境问题卡住——仿真里飞机姿态不稳、QGC连不上、DDS话题死活不出来。后来我把PX4、Gazebo、XRCE-DDS、QGC这一整条链路从头到尾重新走了一遍才反应过来大部分问题都出在我对这几个组件之间的版本关系、启动顺序和通信端口理解得不够清楚。这篇文章就是把这条完整的仿真开发链路拆开讲清楚PX4负责跑飞控逻辑Gazebo负责提供物理仿真环境XRCE-DDS负责把PX4的数据送到ROS2生态QGC则充当你的飞行仪表盘。适合刚从源码编译起步、想在PC上先把无人机飞起来、或者正准备给机载电脑比如RK3588这类ARM板子做配套开发的朋友。你不需要老手带着只要按着下面的顺序走一遍大概率能跑通。1. 四个工具拧成一条链PX4仿真开发到底在解决什么问题很多教程上来就让人敲命令敲完也不知道自己干了什么。所以我先把这条链子的逻辑说清楚。1.1 每个工具都在链路里的位置拿一套真实的无人机系统来类比PX4就是机身上那颗飞控的大脑。它负责姿态解算、控制律计算、任务调度也是我们改算法、调参数的主要对象。Gazebo是一个物理仿真器它模拟了飞机机身、电机、螺旋桨、地面、风力等物理属性。在仿真里机架上电、电机转动、飞机起飞都属于Gazebo的工作。XRCE-DDS是PX4和ROS2之间的通信管道。PX4内部的uORB消息没法直接出现在ROS2的话题列表里必须靠一个中间代理把它翻译成标准的DDS话题。这也是PX4 v1.14之后主推的通信方式。QGC是全图形化的地面站。你可以在上面看姿态、切飞行模式、调参数、看航迹甚至直接点按钮解锁起飞。用一张表把这四个组件的职责对应起来会更直观组件类比真实系统核心作用常见误区PX4 SITL飞控硬件 固件运行飞控逻辑与算法以为SITL只是软件在PC上跑忽略了它还要接仿真器Gazebo真实物理世界提供重力、空气动力、碰撞、传感器模型把Gazebo当成画面好看的3D播放器XRCE-DDS飞控到机载电脑的数据总线把uORB翻译成DDS话题供ROS2节点订阅/发布以为装了ROS2就能直接看到PX4话题QGC地面站笔记本监控、调参、指令控制、日志忘了QGC走的是MAVLink协议和DDS是两回事1.2 从不敢真机到仿真先跑的工作方式变化刚开始搞无人机开发的人容易陷入一个循环写一段代码想想这个上真机不会炸吧然后反复检查不敢烧真烧上去又担心参数不对一飞就飘最后改起来非常痛苦。把上面这条链路搭起来之后开发方式会完全变你可以在Gazebo里随便炸机不需要买桨叶。你可以在QGC里反复改PID仿真里改完马上看飞行动作不用去外场。你可以在ROS2侧订阅PX4的姿态、位置、速度消息调试offboard控制算法就像真机上用机载电脑开发一样。所以这套环境的核心价值就是让你把90%的日常开发问题先锁死在PC上解决把真机试飞变成最后一步验证。如果你以后要往RK3588、树莓派这类机载电脑上部署仿真阶段跑通过的程序移植过去也只是改通信地址和串口设备的问题。2. 动手之前的版本排列组合Ubuntu、ROS2、PX4、Gazebo的兼容关系我刚开始踩的第一个坑就是随便装了一个Gazebo版本再拉最新的PX4代码结果编译直接失败。这几个工具的关系像锁和钥匙版本不匹配后面全是眼泪。2.1 推荐组合与备选组合我自己实测最稳的组合是系统推荐组合说明Ubuntu 22.04ROS2 Humble PX4 v1.15.x Gazebo Classic 11目前最稳妥资料多踩坑容易搜到Ubuntu 20.04ROS2 Foxy PX4 v1.13.x Gazebo 11老项目常用但v1.13的DDS通信用的是旧方案Ubuntu 24.04ROS2 Jazzy PX4 v1.16 Gazebo Sim较新默认用新架构遇到问题需要去官方文档翻注意一个特别容易误解的地方PX4官方在v1.14/v1.15里把编译命令从make px4_sitl gazebo改成了make px4_sitl gazebo-classic原因是gazebo这个名字被新版Gazebo Sim占用了。如果你照着老教程的命令敲大概率会看到gazebo target not found之类的报错。如果你是第一次搞就选第一行Ubuntu 22.04 Humble PX4 v1.15.x。这也是我下面所有命令的基准环境。2.2 系统依赖和前置软件的安装先把基础工具补齐sudo apt update sudo apt install -y git zip cmake build-essential genromfs ninja-build exiftool python3-pip如果你打算在ROS2侧做收发还要装ROS2 Humble。这里用的是二进制版不需要自己编译sudo apt install -y ros-humble-ros-base ros-dev-tools source /opt/ros/humble/setup.bashPX4自己的依赖建议直接用官方脚本一次装完在PX4-Autopilot目录里执行bash ./Tools/setup/ubuntu.sh这个脚本会装很多东西包括Gazebo Classic、交叉编译器、Python依赖等。执行时间比较久建议编译的时候人别走太远。另外我建议装之前先翻一下这个脚本至少知道它要把哪些东西放进你的系统。这里有个经验不要执行两遍脚本然后强行跳过中间的错误。我第一次装的时候中途断网第二次执行提示already installed结果make的时候缺少某个Python包。稳妥的做法是脚本跑完后关掉终端重开手动确认gazebo --version能正常输出版本号。3. 从拉取PX4源码到Gazebo里出现飞机模型环境准备妥当后进入正题。这一步做完你的PC上就是一个可以反复炸机的仿真飞行场。3.1 源码准备和子模块更新PX4项目依赖大量子模块直接clone主干很容易漏东西所以我习惯一次性递归拉取git clone --recursive -j8 https://github.com/PX4/PX4-Autopilot.git cd PX4-Autopilot git checkout v1.15.4 git submodule update --init --recursive新手常犯的一个错误是以为代码拉下来就完了忽略了git submodule update。PX4的很多驱动和仿真插件都在子模块里不更新到正确版本编译会出一堆莫名其妙的错误。如果网络不好子模块拉取会非常痛苦。我自己的做法是白天把命令挂在那儿让它慢慢拉不要中途CtrlC后重新拉那反而容易把子模块目录搞成半初始化状态。3.2 编译并启动SITL仿真v1.15.x的编译命令是make px4_sitl gazebo-classic这条命令实际上做了三件事编译PX4固件的SITL版本SITL Software In The Loop软件在环仿真。启动PX4的Simulator命令行界面。启动Gazebo Classic并加载默认的四旋翼模型。第一次执行时编译耗时可能超过二十分钟取决于机器性能。编译完成后你会发现终端变成了一个PX4的nsh控制台可以敲一些PX4命令同时Gazebo窗口弹出一架小四轴停在水泥地面上。有个细节很多人忽略make px4_sitl gazebo-classic默认加载的模型是iris四旋翼如果你想加载别的机型可以用PX4_SIM_MODELplane make px4_sitl gazebo-classic之类的方式覆盖但新手先用默认的iris就好。3.3 验证仿真是否真的跑起来怎么确认仿真状态正常看两个信号第一PX4控制台输出了类似[logger] file: rootfs/fs/microsd/log之类的日志路径说明固件正常启动。第二Gazebo窗口里的飞机模型处于待解锁状态地面没有异常抖动传感器数据没有报错。我第一次跑通时飞机在Gazebo里直接侧翻后来发现是模型加载不完整重启Gazebo就好。遇到这种情况不要慌先重启仿真再想是不是代码问题。很多所谓代码问题其实是仿真环境没加载好。4. QGC地面站接入给仿真飞机装上仪表盘光有Gazebo里的飞机还差点意思你看不到飞控内部状态。这时候需要QGC上场。4.1 安装QGC与自动连接UDP链路QGC的Linux版是AppImage格式从官网下载后chmod x ./QGroundControl.AppImage ./QGroundControl.AppImage如果你前面已经启动了PX4 SITLQGC开起来以后会自动连接。原因是PX4 SITL默认在UDP 14550端口向地面站广播MAVLink数据QGC在同一台机器上运行时会自动发现这个端口。如果QGC没连上先检查UDP端口是否被占用。我自己遇到过开着多个仿真终端导致端口冲突的情况关掉多余的PX4进程就好。还有一次是虚拟机里跑QGC网络模式设置不对导致UDP广播到不了后来把虚拟机的网络改成桥接模式才解决。视频流相关的GStreamer插件在仿真里一般用不上但如果你后续要接仿真摄像头最好提前装sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly libgstreamer-plugins-base1.0-dev4.2 常用地面站操作解锁、起飞、切模式、改参数QGC连接成功后左侧飞行界面会显示姿态、高度、GPS状态。仿真环境里GPS是通过Gazebo插件模拟的所以定位数据会正常出现。我常用的操作有四个解锁Arm点左上角的Arm按钮飞机电机会转起来。仿真里解锁是最安全的排错方式不会切到任何人。起飞Takeoff切换到任务模式后点Takeoff按钮并设置目标高度飞机会自动起降。切换飞行模式在右侧飞行模式下拉菜单里切换Position、Offboard、Land等模式。Offboard模式是后面跑ROS2控制必须的。调参进入参数界面搜PID相关参数比如MC_ROLL_P、MC_PITCH_P改完立即生效。这也是仿真调试最大的优势真机你敢这么改飞机就敢给你脸色看。4.3 关于内八解锁这个说法的一次澄清网上经常有人问PX4内八解锁要设置哪个参数。这里必须说清楚PX4里面根本没有内八解锁这个参数。内八两个摇杆同时向内下方解锁是ArduPilot系飞控的典型动作。PX4的遥控器解锁逻辑是油门最低 偏航YAW打满一侧保持零点几秒。所以你在QGC虚拟摇杆里模拟遥控器解锁时要把油门拉到最低、YAW掰到最左或最右而不是摆一个内八字造型。如果你嫌麻烦直接在QGC里点Arm按钮它发送的是MAVLink指令MAV_CMD_COMPONENT_ARM_DISARM固件里的Commander模块收到就解锁整个过程和摇杆无关。这条指令也是后面用ROS2或者MAVSDK控制飞机解锁的核心命令。5. XRCE-DDS通信链路PX4和ROS2之间的中间人这一节是整套环境里最容易被忽略、也最值得花时间理解的部分。5.1 为什么PX4 v1.14之后选XRCE-DDS在PX4 v1.13及更早的版本里PX4和ROS2通信用的是RTPS基于Fast DDS实现功能上也能用但问题是资源占用偏高、配置复杂而且对动态话题的支持不够好。从v1.14开始PX4切换到了Eclipse的Micro XRCE-DDS方案。核心区别是对比项旧方案RTPS/Fast DDS新方案uXRCE-DDS客户端资源占用较高很低适合资源紧张的嵌入式设备消息定义配置繁琐支持动态消息扩展与ROS2集成需要额外桥接原生对接配合micro-ROS Agent适用版本PX4 v1.13及更早PX4 v1.14及以后你可以把uXRCE-DDS理解成一条轻量化隧道PX4飞控内部跑的是uORB消息这些消息在固件端被封装成Micro XRCE-DDS格式通过UDP或串口发给PC上的micro-ROS AgentAgent再翻译成标准的DDS话题供ROS2节点使用。5.2 编译micro-ROS Agent并建立连接XRCE-DDS链路有两个端固件端PX4默认已经内置了客户端PC端需要单独跑一个micro-ROS Agent。我习惯从源码编译Agentmkdir -p ~/ws_px4/src cd ~/ws_px4/src git clone https://github.com/micro-ROS/micro_ros_agent.git cd ~/ws_px4 source /opt/ros/humble/setup.bash colcon build source install/setup.bashAgent编译完成后启动一个专门跑Agent的终端ros2 run micro_ros_agent micro_ros_agent udp4 --port 8888这里的8888端口就是PX4固件端默认连接的端口。如果你用的是串口通信命令会变成类似micro_ros_agent serial --dev /dev/ttyUSB0后面真机部署时会用到。之后新开一个终端启动PX4仿真cd PX4-Autopilot make px4_sitl gazebo-classic正常的话Agent终端会出现Client connected之类的日志表示PX4固件和Agent已经握手成功。如果没看到检查一下是不是Agent先启动的。PX4的uXRCE-DDS客户端在固件启动时会主动去找UDP 8888端口上的Agent顺序反了就会连接失败。5.3 在ROS2里看到PX4的话题PX4固件端把uORB消息映射成DDS话题时按命名空间组织了话题。要看到这些话题还需要编译PX4的消息定义包cd ~/ws_px4/src git clone https://github.com/PX4/px4_msgs.git cd ~/ws_px4 colcon build source install/setup.bash完成之后运行ros2 topic list你会看到一堆以/fmu/out/开头的话题比如/fmu/out/vehicle_status飞控状态/fmu/out/vehicle_attitude姿态四元数/fmu/out/vehicle_local_position本地位置/fmu/out/battery_status电池状态想实时看姿态四元数ros2 topic echo /fmu/out/vehicle_attitude这和在真机上用机载电脑看数据是同一个套路。对搞算法的人来说到这一步才算是真正通了。5.4 从仿真延伸到机载电脑的部署思路如果你以后的目标是做RK3588这类ARM板载电脑这条XRCE-DDS链路会直接迁移过去。区别只在于PX4机身通过UART比如Telem2端口或以太网连接机载电脑。micro-ROS Agent运行在机载电脑上。PX4固件内部的uXRCE-DDS客户端自动向Agent发起连接。仿真里写好的offboard控制程序改一下通信地址和串口设备名就能在真机上跑。这也是我特别强调先吃透这套链路的原因你现在在PC上看到的所有/fmu/out/话题以后在真机上一字不差地出现在RK3588的ROS2环境里。唯一要注意的是真机上Agent运行在ARM环境编译时用aarch64工具链串口设备名可能是/dev/ttyS1或者/dev/ttyTHS1需要根据板卡手册确认。6. 每次搭建都会遇到的几个坑和排查思路写教程不能光讲顺风局。下面这几个坑我基本每次在别人机器上搭仿真都能遇到排查思路也一并给出来。6.1 Gazebo模型下载卡死启动Gazebo时卡在类似Downloading model...的界面是新手最常见的问题。原因是Gazebo启动时需要加载模型数据库某些模型文件不在本地时它会自动去网上下载。网络状况不太好时这一步能卡到你怀疑人生。我的处理办法是先手动把常用的模型库放到本地mkdir -p ~/.gazebo cd ~/.gazebo git clone https://github.com/osrf/gazebo_models models这样Gazebo到本地模型库查找时能找到文件就不会一直卡在下载。如果已经卡住了先把Gazebo进程全部关掉再重新启动否则模型列表还是锁死的。6.2 gazebo命令找不到或插件报错有时候你明明装了Gazebo终端却提示gazebo: command not found。多半是因为没有source环境变量source /usr/share/gazebo/setup.sh另外很多人分不清Gazebo Classic和Gazebo Sim这是两个不同的程序。PX4 v1.15的gazebo-classic对应的是Gazebo 11如果你额外装了Ignition Fortress那又是另一套东西。编译报插件找不到时先确认你装的是不是Gazebo Classic 11别混着用。6.3 QGC连不上SITLQGC连不上排查顺序我一般是这样确认PX4 SITL已经启动控制台有没有报MAVLink相关的错误。确认UDP 14550没被其他程序占用sudo ss -ulpn | grep 14550。杀掉所有残留PX4进程重新启动仿真。检查虚拟机网络模式是不是NAT导致UDP广播异常。还有一个容易忽略的点QGC不能同时连接多个相同类型的端口。如果你开了多个PX4 SITL实例第二个实例抢不到14550端口QGC反而可能连到第一个旧实例上去造成数据混乱。6.4 编译慢、内存不足、多实例冲突PX4编译比较吃内存4GB内存的机器跑make px4_sitl gazebo-classic很容易卡死或者OOM。解决办法是限制并行编译make px4_sitl gazebo-classic -j2或者临时加swap分区比如sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile多实例方面同一时间不建议跑多个Gazebo仿真。PX4 SITL默认用固定的UDP端口同时跑两个实例必定冲突。如果你做多机仿真需要通过环境变量把每个实例的通信口和命名空间分开比如PX4_UXRCE_DDS_NSdrone1 make px4_sitl gazebo-classic PX4_UXRCE_DDS_NSdrone2 make px4_sitl gazebo-classic但这是后话先把单机跑稳再说。7. 一套适合日常开发的自检流程和个人体会环境打通之后最重要的事情其实是建立一套自己的自检流程。我现在的固定套路是这样的7.1 我推荐的开发循环每次动手改代码之前先确认四件事打开一个终端启动micro-ROS Agent确保uXRCE-DDS链路在线。新开终端启动PX4仿真确认Gazebo模型加载正常。打开QGC确认它自动连接上了SITL姿态数据显示正常。在ROS2侧启动自己的节点前先ros2 topic list看一眼话题列表有没有预期中的/fmu/out/消息。这个循环看起来简单但能帮你把环境问题和代码问题迅速分开。我见过太多人花一整天调算法最后发现是Gazebo模型加载不全导致的传感器数据异常。7.2 上真机前必须检查的事项清单仿真没问题之后如果你要往真机迁移有几件事不能跳过检查项说明传感器校准真机必须做加速度计、陀螺仪、磁力计校准仿真默认是理想状态解锁动作验证确认遥控器解锁逻辑PX4不是内八别被习惯带偏机架参数真机几何尺寸和电机布局要与固件配置一致Agent通信设备确认到机载电脑的串口设备名和波特率安全措施螺旋桨朝外、上电前检查油门最低先解锁小油门观察反应我个人体会是仿真阶段最值得多花时间的不是把飞机飞得多花哨而是把XRCE-DDS链路和QGC参数调整这两块用熟。它们是真机开发时最依赖的两个能力。你在Gazebo里培养的调试直觉——比如看到某个参数变化对姿态的直接影响——会直接转化为真机试飞时的底气。最后再分享一个小经验仿真环境不要追求看着好看Gazebo的物理引擎参数、模型质量都是可以为了调试效率做取舍的。我目前就跑着一个看起来粗糙但启动快、资源占用低的经典iris模型重要的不是模型好不好看而是你能否在自己的开发模式里做到改代码—跑仿真—看数据三分钟一个循环。把这套链路练熟了后面无论换哪块板子、上什么传感器你都会先想着在Gazebo里把它仿真一遍。