保姆级教程：用MAVROS连接Pixhawk飞控与ROS，实现无人车基础控制（附避坑清单）

从零搭建ROS与Pixhawk的通信桥梁MAVROS实战指南当第一次将Pixhawk飞控接入ROS系统时许多开发者都会遇到通信链路搭建的难题。本文将以实操为导向手把手带你完成MAVROS环境配置、飞控参数调试、通信验证全流程并附上经过实战检验的避坑指南。1. 硬件准备与系统环境搭建在开始之前确保你已准备好以下硬件Pixhawk系列飞控如Pixhawk 4、Cube等配套的电源模块和电池微型USB数据线或数传模块安装Ubuntu 18.04/20.04的计算机可选GPS模块、遥控器接收机关键步骤# 安装ROS MelodicUbuntu 18.04或NoeticUbuntu 20.04 sudo sh -c echo deb http://packages.ros.org/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-${ROS_DISTRO}-desktop-full # 安装MAVROS sudo apt install ros-${ROS_DISTRO}-mavros ros-${ROS_DISTRO}-mavros-extras wget https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh chmod x install_geographiclib_datasets.sh sudo ./install_geographiclib_datasets.sh注意不同版本的Ubuntu需要对应不同版本的ROS。Pixhawk官方推荐使用Ubuntu 18.04 ROS Melodic组合兼容性最佳。2. Pixhawk飞控基础配置连接飞控到QGroundControl地面站进行必要参数设置参数组关键参数推荐值说明SystemSYSID_MYGCS255地面站IDMAVROS默认使用该值SerialSERIAL1_BAUD921600TELEM1端口波特率使用数传时SerialSERIAL2_PROTOCOL1TELEM2端口启用MAVLink协议NetworkMAV_BROADCAST1启用广播模式SafetyCBRK_USB_CHK197848禁用USB连接安全检查常见问题排查如果飞控无法被识别尝试更换USB线或检查端口权限ls /dev/ttyACM* sudo chmod 666 /dev/ttyACM0波特率不匹配会导致通信失败确保飞控和MAVROS使用相同波特率3. MAVROS启动与通信验证创建启动文件mavros.launchlaunch arg namefcu_url default/dev/ttyACM0:57600 / 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启动MAVROS节点roslaunch mavros mavros.launch验证通信状态rostopic echo /mavros/state rostopic echo /mavros/heartbeat提示正常状态下connected字段应为Truesystem_status为3Standby或4Active4. 核心话题与服务解析MAVROS提供了丰富的接口供开发者使用主要分为以下几类4.1 状态监控话题/mavros/state飞控连接状态/mavros/battery电池信息/mavros/imu/dataIMU原始数据/mavros/global_position/globalGPS全局位置4.2 控制指令话题/mavros/setpoint_position/local本地坐标系位置指令/mavros/setpoint_velocity/cmd_vel速度控制指令/mavros/rc/override遥控器通道重载4.3 常用服务rosservice list | grep mavros/mavros/cmd/arming解锁/锁定飞控/mavros/set_mode切换飞行模式/mavros/param/get获取飞控参数5. 实战基础控制实现下面通过Python脚本实现基础的飞控控制#!/usr/bin/env python import rospy from geometry_msgs.msg import PoseStamped from mavros_msgs.msg import State from mavros_msgs.srv import CommandBool, SetMode current_state State() def state_cb(state): global current_state current_state state if __name__ __main__: rospy.init_node(offb_node, anonymousTrue) state_sub rospy.Subscriber(mavros/state, State, state_cb) local_pos_pub rospy.Publisher(mavros/setpoint_position/local, PoseStamped, queue_size10) arming_client rospy.ServiceProxy(mavros/cmd/arming, CommandBool) set_mode_client rospy.ServiceProxy(mavros/set_mode, SetMode) rate rospy.Rate(20) # Hz # 等待飞控连接 while not current_state.connected: rate.sleep() pose PoseStamped() pose.pose.position.x 0 pose.pose.position.y 0 pose.pose.position.z 2 # 发送若干设定点 for i in range(100): local_pos_pub.publish(pose) rate.sleep() # 切换到OFFBOARD模式 if set_mode_client(0, OFFBOARD).mode_sent: rospy.loginfo(OFFBOARD enabled) # 解锁飞控 if arming_client(True).success: rospy.loginfo(Vehicle armed) # 主控制循环 while not rospy.is_shutdown(): local_pos_pub.publish(pose) rate.sleep()6. 避坑清单与调试技巧根据实际项目经验整理出以下常见问题及解决方案问题现象可能原因解决方案MAVROS无法连接飞控串口权限不足执行sudo usermod -a -G dialout $USER后重新登录通信时断时续波特率不匹配检查飞控参数SERIALx_BAUD与MAVROS启动参数无法切换到OFFBOARD模式未发送设定点在切换模式前持续发送设定点至少2秒遥控器信号丢失SYSID_MYGCS设置错误确保地面站ID与飞控参数匹配IMU数据异常飞控校准不完整在QGC中执行传感器校准流程高级调试技巧使用rqt_graph可视化节点通信关系通过rostopic hz检查话题发布频率启用MAVROS调试日志rosrun mavros mavros_node _debug:true在实际部署中建议先通过仿真环境验证控制逻辑。硬件在环HITL仿真可以大幅降低开发风险PX4生态提供了完善的仿真工具链支持。