保姆级教程：用XTDrone+Gazebo搭建你的第一个无人机仿真环境（支持键盘控制飞行）

从零构建XTDrone无人机仿真环境：Gazebo实战与键盘控制全指南

无人机仿真技术正在重塑现代机器人开发流程。想象一下，在完全数字化的环境中测试飞行算法，无需担心硬件损坏或场地限制——这正是XTDrone与Gazebo结合带来的革命性体验。对于ROS初学者和无人机爱好者而言，搭建一个可交互的仿真环境不再是遥不可及的专业技能。本文将带您跳过繁琐的理论直击实战，在30分钟内创建完整的无人机仿真系统，并通过Python脚本实现键盘控制飞行。

1. 环境准备：构建仿真基石

仿真环境的稳定性始于基础组件的正确配置。我们推荐使用Ubuntu 18.04/20.04 LTS系统，这是目前对ROS Melodic和Gazebo兼容性最好的平台。在开始前，请确保系统已更新至最新状态：

sudo apt update && sudo apt upgrade -y

关键依赖安装直接影响后续组件的运行效率。以下命令将安装编译工具链和Python生态支持：

sudo apt install -y ninja-build exiftool python-argparse python-empy \ python-toml python-numpy python-yaml python-dev python-pip \ protobuf-compiler libeigen3-dev genromfs xmlstarlet

提示：若遇到软件包下载失败，可尝试追加--fix-missing参数或更换软件源

Python环境需要额外配置两个版本的包管理。Python 2.7环境需安装：

pip2 install pandas jinja2 pyserial cerberus pyulog numpy toml pyquaternion

而Python 3环境则需要：

pip3 install packaging numpy empy toml pyyaml jinja2

2. ROS与Gazebo：仿真核心引擎

ROS Melodic（对应Ubuntu 18.04）是当前最稳定的机器人操作系统版本。安装过程建议使用国内镜像源加速：

sudo sh -c 'echo "deb http://mirrors.ustc.edu.cn/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 sudo apt update sudo apt install ros-melodic-desktop-full

Gazebo模型库的本地化能显著提升加载速度。执行以下命令获取完整模型集：

git clone https://gitee.com/mirrors/gazebo_models.git mkdir -p ~/.gazebo/models && cp -r gazebo_models/* ~/.gazebo/models/

环境变量配置是保证组件协同工作的关键。将以下命令加入~/.bashrc文件末尾：

source /opt/ros/melodic/setup.bash echo "export GAZEBO_MODEL_PATH=~/.gazebo/models:\$GAZEBO_MODEL_PATH" >> ~/.bashrc source ~/.bashrc

3. PX4生态链集成

PX4作为无人机领域最流行的开源飞控，其仿真环境搭建需要特定版本控制。推荐使用XTDrone适配的v1.11.0-beta1版本：

git clone https://gitee.com/mirrors/PX4-Autopilot.git mv PX4-Autopilot PX4_Firmware cd PX4_Firmware git checkout -b xtdrone/dev v1.11.0-beta1 git submodule update --init --recursive

编译过程可能持续10-30分钟，取决于硬件性能。使用-j参数可加速编译：

make px4_sitl_default gazebo -j$(nproc)

MAVROS桥接配置需要特别注意路径准确性。地理数据集安装命令如下：

wget https://gitee.com/mirrors/mavros/raw/master/mavros/scripts/install_geographiclib_datasets.sh sudo bash install_geographiclib_datasets.sh

验证PX4与Gazebo联调成功的标志是能够正常启动仿真世界：

roslaunch px4 mavros_posix_sitl.launch

在另一个终端执行以下命令检查连接状态，当出现connected: True时表示系统就绪：

rostopic echo /mavros/state

4. XTDrone定制化部署

XTDrone的源码部署需要特别注意子模块更新和文件替换操作。建议按照以下顺序执行：

git clone https://gitee.com/robin_shaun/XTDrone.git cd XTDrone git submodule update --init --recursive

关键文件替换直接影响仿真场景的完整性。执行以下拷贝命令前请确认目标路径存在：

cp sensing/gimbal/gazebo_gimbal_controller_plugin.cpp ~/PX4_Firmware/Tools/sitl_gazebo/src/ cp -r sitl_config/worlds/* ~/PX4_Firmware/Tools/sitl_gazebo/worlds/ cp -r sitl_config/launch/* ~/PX4_Firmware/launch/

工作空间初始化是ROS开发的必要步骤。创建标准catkin工作空间结构：

mkdir -p ~/catkin_ws/src cd ~/catkin_ws catkin_make

5. 键盘控制实战

完整的仿真控制流程需要三个终端协同工作。首先启动Gazebo仿真环境：

cd ~/PX4_Firmware roslaunch px4 indoor1.launch

在第二个终端建立通信链路，其中iris表示机型，0表示无人机编号：

cd ~/XTDrone/communication/ python multirotor_communication.py iris 0

最后在第三个终端启动键盘控制模块，参数1表示控制1架无人机，vel代表速度控制模式：

cd ~/XTDrone/control/keyboard python multirotor_keyboard_control.py iris 1 vel

控制指令对照表：

常见问题排查首要检查MAVROS连接状态。若发现connected: False，通常需要检查：

1. 确认~/.bashrc中PX4路径配置正确
2. 验证indoor1.launch文件中的UDP端口设置
3. 检查ROS master是否正常运行

仿真环境中无人机的物理响应可能存在0.5-1秒延迟，这是正常现象。建议首次飞行时先让无人机悬停在1米高度，熟悉控制响应特性后再尝试复杂动作。