文章目录
- 激光雷达/IMU/深度相机配置与RViz可视化全指南
- 一、文档概述
- 二、前置准备
- 2.1 环境与依赖
- 2.2 功能包与目录结构
- 三、传感器配置步骤（URDF/Xacro）
- 3.1 激光雷达（LiDAR）配置
- 3.1.1 编写Xacro配置文件
- 3.1.2 关键参数说明
- 3.2 惯性测量单元（IMU）配置
- 3.2.1 在Xacro文件中追加IMU配置
- 3.2.2 关键参数说明
- 3.3 深度相机配置
- 3.3.1 在Xacro文件中追加深度相机配置
- 3.3.2 关键参数说明
- 3.4 编写启动文件
- 四、RViz2可视化传感器数据
- 4.1 基础配置（必做）
- 4.2 激光雷达数据可视化
- 4.3 IMU数据可视化
- 4.4 深度相机数据可视化
- 4.5 保存RViz2配置（避坑）
- 五、常见问题排查
- 5.1 传感器数据不显示
- 5.2 图像方向错误
- 5.3 IMU数据漂移严重
- 六、总结
激光雷达/IMU/深度相机配置与RViz可视化全指南
一、文档概述
本文面向ROS2入门开发者，详细讲解在URDF/Xacro文件中为机器人模型添加激光雷达、惯性测量单元（IMU）、深度相机三类核心传感器的完整步骤，以及在RViz2中可视化传感器数据的实操方法。全文以ROS2 Humble版本为例，示例代码可直接复用，覆盖从配置到可视化的全流程。
二、前置准备
2.1 环境与依赖
确保已安装ROS2 Humble及以下依赖包：
# 安装核心依赖sudoaptinstallros-humble-gazebo-ros ros-humble-gazebo-pluginssudoaptinstallros-humble-rviz2 ros-humble-sensor-msgssudoaptinstallros-humble-xacro ros-humble-urdf2.2 功能包与目录结构
创建标准化功能包目录，方便管理文件：
# 创建功能包（依赖需包含以下内容）ros2 pkg create --build-type ament_cmake robot_sensor_demo\--dependencies rclcpp gazebo_ros urdf xacro sensor_msgs rviz2# 创建目录结构mkdir-p robot_sensor_demo/urdf robot_sensor_demo/launch robot_sensor_demo/config目录说明：
urdf/：存放URDF/Xacro模型文件；launch/：存放启动文件；config/：存放RViz2配置文件。
三、传感器配置步骤（URDF/Xacro）
传感器配置核心逻辑：先定义传感器挂载的连杆/关节，再通过Gazebo插件配置传感器物理属性和ROS2通信参数。以下为三类传感器的完整配置代码及分步解释。
3.1 激光雷达（LiDAR）配置
激光雷达用于环境障碍物检测，以2D激光雷达为例（适配Gazebo的ray类型传感器）。
3.1.1 编写Xacro配置文件
在urdf/robot_sensors.xacro中添加以下内容：
<?xml version="1.0"?><robotxmlns:xacro="http://www.ros.org/wiki/xacro"name="sensor_robot"><!-- 1. 定义激光雷达挂载连杆 --><linkname="laser_link"><visual><geometry><cylinderlength="0.05"radius="0.03"/></geometry><materialname="Gazebo/Black"/></visual><collision><geometry><cylinderlength="0.05"radius="0.03"/></geometry></collision><!-- 补充惯性参数（Gazebo必需） --><inertial><massvalue="0.1"/><inertiaixx="0.0001"ixy="0.0"ixz="0.0"iyy="0.0001"iyz="0.0"izz="0.0001"/></inertial></link><!-- 2. 将激光雷达挂载到机器人根连杆（base_link） --><jointname="laser_joint"type="fixed"><parentlink="base_link"/><childlink="laser_link"/><originxyz="0 0 0.2"rpy="0 0 0"/><!-- 安装位置：base_link上方0.2m --><axisxyz="0 0 1"/></joint><!-- 3. Gazebo激光雷达插件配置 --><gazeboreference="laser_link"><sensorname="laser_sensor"type="ray"><!-- 基础参数 --><always_on>true</always_on><visualize>false</visualize><!-- 关闭Gazebo激光可视化，减少资源占用 --><update_rate>10</update_rate><!-- 数据发布频率10Hz --><pose>0 0 0 0 0 0</pose><!-- 相对laser_link的位姿 --><!-- 激光扫描参数 --><ray><scan><horizontal><samples>360</samples><!-- 采样点数量（360°全向） --><resolution>1.0</resolution><!-- 分辨率1°/点 --><min_angle>0.0</min_angle><!-- 扫描起始角度0° --><max_angle>6.28</max_angle><!-- 扫描终止角度360°（2π） --></horizontal></scan><range><min>0.12</min><!-- 最小检测距离0.12m --><max
