保姆级教程：在Ubuntu 20.04上用ROS Noetic和PX4 SITL，实现Gazebo无人机键盘遥控

从零构建Gazebo无人机仿真环境ROS Noetic与PX4 SITL深度整合指南开篇为什么需要完整的仿真环境在无人机开发领域仿真环境的重要性不亚于实体飞行测试。一个稳定可靠的仿真平台能够大幅降低开发成本避免硬件损坏风险同时提供可重复的测试条件。Ubuntu 20.04 ROS Noetic PX4 SITL Gazebo的组合已经成为行业标准配置但初次配置时总会遇到各种坑——依赖冲突、版本不匹配、网络连接问题等。本文将彻底解决这些痛点带你完成从系统准备到键盘控制的完整流程。1. 基础环境搭建避开90%的常见错误1.1 Ubuntu 20.04系统优化在开始前建议使用全新的Ubuntu 20.04 LTS系统。如果已有系统执行以下清理命令sudo apt update sudo apt upgrade -y sudo apt autoremove必须安装的依赖项sudo apt install -y \ git zip qtcreator cmake \ python3-dev python3-pip \ ninja-build protobuf-compiler \ libeigen3-dev libopencv-dev提示建议预留至少30GB磁盘空间PX4编译和Gazebo模型下载会占用大量空间1.2 PX4源码编译的隐藏细节不同于简单执行git clone推荐以下优化流程mkdir -p ~/px4_ws/src cd ~/px4_ws/src git clone --recursive https://github.com/PX4/PX4-Autopilot.git cd PX4-Autopilot make px4_sitl gazebo常见问题解决方案错误类型解决方案submodule更新失败执行git submodule sync --recursive git submodule update --init --recursive编译内存不足添加swap空间sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfileGazebo模型下载慢手动下载模型包到~/.gazebo/models目录2. ROS Noetic与MAVROS深度配置2.1 ROS Noetic定制化安装标准安装后需要额外配置echo source /opt/ros/noetic/setup.bash ~/.bashrc sudo rosdep init rosdep update关键功能包安装sudo apt install -y \ ros-noetic-mavros \ ros-noetic-mavros-extras \ ros-noetic-geographic-msgs \ ros-noetic-tf2-sensor-msgs2.2 MAVROS连接参数优化创建自定义launch文件~/px4_ws/src/px4_mavros.launchlaunch arg namefcu_url defaultudp://:14540127.0.0.1:14557 / arg namegcs_url default / arg nametgt_system default1 / arg nametgt_component default1 / include file$(find mavros)/launch/node.launch arg namepluginlists_yaml value$(find mavros)/launch/px4_pluginlists.yaml / arg nameconfig_yaml value$(find mavros)/launch/px4_config.yaml / arg namefcu_url value$(arg fcu_url) / arg namegcs_url value$(arg gcs_url) / arg nametgt_system value$(arg tgt_system) / arg nametgt_component value$(arg tgt_component) / /include /launch验证连接是否成功rostopic echo /mavros/state应看到connected: True的输出3. 键盘控制系统的工程级实现3.1 改进版键盘控制节点创建keyboard_control.cpp#include ros/ros.h #include geometry_msgs/Twist.h #include termios.h #include unistd.h class KeyboardControl { public: KeyboardControl() : nh_(~) { cmd_pub_ nh_.advertisegeometry_msgs::Twist(/mavros/setpoint_velocity/cmd_vel_unstamped, 10); linear_speed_ 0.5; // m/s angular_speed_ 0.5; // rad/s print_instructions(); } void print_instructions() { ROS_INFO(Keyboard Control Instructions:); ROS_INFO(---------------------------); ROS_INFO( W: Move Forward); ROS_INFO( S: Move Backward); ROS_INFO( A: Move Left); ROS_INFO( D: Move Right); ROS_INFO( P: Ascend); ROS_INFO( L: Descend); ROS_INFO( Q: Yaw Left); ROS_INFO( E: Yaw Right); ROS_INFO( SPACE: Emergency Stop); ROS_INFO( CTRLC: Exit); } void run() { struct termios oldt, newt; tcgetattr(STDIN_FILENO, oldt); newt oldt; newt.c_lflag ~(ICANON | ECHO); tcsetattr(STDIN_FILENO, TCSANOW, newt); ros::Rate rate(20); while (ros::ok()) { if (read(STDIN_FILENO, key_, 1) 0) { geometry_msgs::Twist cmd_vel; switch (key_) { case w: cmd_vel.linear.x linear_speed_; break; case s: cmd_vel.linear.x -linear_speed_; break; case a: cmd_vel.linear.y linear_speed_; break; case d: cmd_vel.linear.y -linear_speed_; break; case p: cmd_vel.linear.z linear_speed_; break; case l: cmd_vel.linear.z -linear_speed_; break; case q: cmd_vel.angular.z angular_speed_; break; case e: cmd_vel.angular.z -angular_speed_; break; case : cmd_vel geometry_msgs::Twist(); break; // Stop default: break; } cmd_pub_.publish(cmd_vel); } ros::spinOnce(); rate.sleep(); } tcsetattr(STDIN_FILENO, TCSANOW, oldt); } private: ros::NodeHandle nh_; ros::Publisher cmd_pub_; char key_; double linear_speed_, angular_speed_; }; int main(int argc, char** argv) { ros::init(argc, argv, keyboard_control); KeyboardControl kc; kc.run(); return 0; }3.2 安全机制与Offboard模式切换创建安全检查脚本safety_check.py#!/usr/bin/env python3 import rospy from mavros_msgs.msg import State from mavros_msgs.srv import CommandBool, SetMode class SafetyMonitor: def __init__(self): self.current_state State() rospy.Subscriber(/mavros/state, State, self.state_cb) def state_cb(self, state): self.current_state state def arm(self): rospy.wait_for_service(/mavros/cmd/arming) try: arm_service rospy.ServiceProxy(/mavros/cmd/arming, CommandBool) response arm_service(True) return response.success except rospy.ServiceException as e: rospy.logerr(Arming failed: %s % e) return False def set_mode(self, mode): rospy.wait_for_service(/mavros/set_mode) try: set_mode_service rospy.ServiceProxy(/mavros/set_mode, SetMode) response set_mode_service(0, mode) return response.mode_sent except rospy.ServiceException as e: rospy.logerr(Mode change failed: %s % e) return False if __name__ __main__: rospy.init_node(safety_monitor) monitor SafetyMonitor() # 等待连接建立 while not monitor.current_state.connected: rospy.sleep(0.1) # 设置Offboard模式 if monitor.set_mode(OFFBOARD): rospy.loginfo(Offboard mode enabled) if monitor.arm(): rospy.loginfo(Vehicle armed) else: rospy.logerr(Arming failed) else: rospy.logerr(Failed to set Offboard mode)4. 完整工作流程与调试技巧4.1 分步执行流程启动PX4仿真cd ~/px4_ws/src/PX4-Autopilot make px4_sitl gazebo启动MAVROSroslaunch px4_mavros.launch运行安全监控python3 safety_check.py启动键盘控制rosrun keyboard_control keyboard_control4.2 高级调试技巧查看MAVLink消息rostopic echo /mavros/from_log重置Gazebo环境rosservice call /gazebo/reset_simulation {}可视化无人机轨迹rosrun rqt_plot rqt_plot /mavros/local_position/pose/pose/position/x:y:z5. 性能优化与扩展方向5.1 Gazebo性能调优在~/.bashrc中添加export SVGA_VGPU100 # 禁用虚拟GPU加速 export GAZEBO_RESOURCE_PATH/usr/share/gazebo-11 export GAZEBO_PLUGIN_PATH/usr/lib/x86_64-linux-gnu/gazebo-11/plugins export GAZEBO_MODEL_PATH~/.gazebo/models:/usr/share/gazebo-11/models5.2 扩展功能建议添加障碍物检测集成RPLidar或深度相机模型实现自主导航结合ROS导航栈多机仿真使用PX4的多实例功能硬件在环测试连接真实飞控进行半实物仿真在Gazebo中添加障碍物model nameobstacle pose5 0 0.5 0 0 0/pose statictrue/static link namelink collision namecollision geometry box size1 1 1/size /box /geometry /collision visual namevisual geometry box size1 1 1/size /box /geometry material ambient1 0 0 1/ambient /material /visual /link /model