保姆级避坑指南：速腾RS-Hellos-16P雷达驱动在Ubuntu20.04下的完整配置流程（含ROS Noetic）

速腾RS-Hellos-16P雷达Ubuntu20.04配置全攻略：从驱动安装到Cartographer建图的避坑指南

第一次接触速腾激光雷达和ROS Noetic的开发者，往往会在配置过程中遇到各种意想不到的问题。本文将带你一步步完成从驱动安装到Cartographer建图的完整流程，重点解决那些容易让人崩溃的"坑点"。

1. 环境准备与依赖安装

在开始配置速腾雷达之前，确保你的Ubuntu 20.04系统已经正确安装了ROS Noetic。很多问题其实源于基础环境配置不当。

常见问题1：ROS Noetic安装不完整

# 验证ROS核心组件是否安装完整 rosversion -d dpkg -l | grep ros-noetic

如果发现缺少关键包，重新执行：

sudo apt install ros-noetic-desktop-full

依赖项检查清单：

• CMake ≥ 3.16
• GCC/G++ ≥ 9.0
• Python ≥ 3.8
• PCL ≥ 1.10
• Eigen3 ≥ 3.3

# 安装必要依赖 sudo apt-get install -y \ libpcap-dev \ libyaml-cpp-dev \ libproj-dev \ libboost-all-dev \ libeigen3-dev

2. 雷达驱动安装与配置

速腾雷达的官方驱动安装看似简单，但有几个关键点容易出错。

2.1 驱动源码获取与子模块更新

常见问题2：git子模块更新失败

mkdir -p ~/robosense_ws/src cd ~/robosense_ws/src git clone https://github.com/RoboSense-LiDAR/rslidar_sdk.git cd rslidar_sdk

这里最容易出问题的是子模块更新：

# 先初始化子模块 git submodule init # 如果直接update失败，尝试指定深度 git submodule update --depth 1 # 或者单独克隆子模块 git clone https://github.com/RoboSense-LiDAR/rslidar_msg.git ./src/rslidar_msg

2.2 配置文件修改

config.yaml文件的配置错误是导致雷达无法启动的常见原因：

# 关键配置项 lidar: driver: lidar_type: RSHELIOS_16P # 必须准确匹配雷达型号 frame_id: rslidar # 与后续TF配置一致 msop_port: 6699 # 默认端口 difop_port: 7788 # 默认端口

验证配置正确性：

cd ~/robosense_ws catkin_make -DCMAKE_BUILD_TYPE=Release source devel/setup.bash roslaunch rslidar_sdk start.launch

如果看到类似"Device IP not set"的错误，检查网络配置：

# 设置有线连接 sudo nmcli con mod "有线连接" ipv4.addresses "192.168.1.102/24" sudo nmcli con mod "有线连接" ipv4.gateway "192.168.1.1" sudo nmcli con up "有线连接"

3. 点云数据转换处理

Cartographer建图需要2D激光数据，而速腾雷达输出的是3D点云，需要进行转换。

3.1 pointcloud_to_laserscan安装

cd ~/robosense_ws/src git clone https://github.com/ros-perception/pointcloud_to_laserscan.git cd ~/robosense_ws catkin_make

常见问题3：转换节点无法接收点云数据

检查launch文件配置：

<launch> <node pkg="pointcloud_to_laserscan" type="pointcloud_to_laserscan_node" name="pointcloud_to_laserscan"> <remap from="cloud_in" to="/rslidar_points"/> <!-- 确保与雷达输出topic一致 --> <rosparam> min_height: -0.5 # 根据实际应用场景调整 max_height: 1.0 angle_min: -3.1415926 angle_max: 3.1415926 range_min: 0.2 range_max: 100.0 </rosparam> </node> </launch>

3.2 数据流验证

启动雷达和转换节点后，检查数据流：

# 终端1 roslaunch rslidar_sdk start.launch # 终端2 roslaunch pointcloud_to_laserscan point_to_scan.launch # 终端3 rostopic echo /scan # 查看转换后的2D激光数据

如果看不到数据，检查TF树：

rosrun tf view_frames evince frames.pdf # 查看TF关系图

4. Cartographer配置与优化

4.1 配置文件调整

复制并修改Cartographer配置文件：

cd ~/catkin_ws/src/cartographer_ros/cartographer_ros/configuration_files cp revo_lds.lua rs16_lidar.lua

关键参数修改：

TRAJECTORY_BUILDER_2D = { use_imu_data = false, -- 速腾雷达不含IMU min_range = 0.2, max_range = 100.0, missing_data_ray_length = 5.0, num_accumulated_range_data = 1, voxel_filter_size = 0.05, adaptive_voxel_filter = { max_length = 0.5, min_num_points = 200, max_range = 50.0, }, loop_closure_adaptive_voxel_filter = { max_length = 0.9, min_num_points = 100, max_range = 50.0, }, submaps = { num_range_data = 90, grid_options_2d = { grid_type = "PROBABILITY_GRID", resolution = 0.05, }, range_data_inserter = { range_data_inserter_type = "PROBABILITY_GRID_INSERTER_2D", probability_grid_range_data_inserter = { insert_free_space = true, hit_probability = 0.55, miss_probability = 0.49, }, }, }, }

4.2 Launch文件配置

<launch> <param name="/use_sim_time" value="false" /> <node name="cartographer_node" pkg="cartographer_ros" type="cartographer_node" args=" -configuration_directory $(find cartographer_ros)/configuration_files -configuration_basename rs16_lidar.lua" output="screen"> <remap from="scan" to="/scan" /> </node> <node pkg="tf" type="static_transform_publisher" name="base_to_laser" args="0.0 0.0 0.45 0 0.0 0.0 base_link rslidar 100" /> <node name="cartographer_occupancy_grid_node" pkg="cartographer_ros" type="cartographer_occupancy_grid_node" args="-resolution 0.05" /> <node name="rviz" pkg="rviz" type="rviz" required="true" args="-d $(find cartographer_ros)/configuration_files/demo_2d.rviz" /> </launch>

常见问题4：TF关系错误

正确的TF关系应该是：

• map → odom → base_link → rslidar

检查TF树是否正确：

rosrun tf tf_echo base_link rslidar

5. 完整建图流程与问题排查

5.1 启动顺序

1. 启动雷达驱动
2. 启动点云转换节点
3. 启动Cartographer
4. 启动RViz可视化

# 终端1 roslaunch rslidar_sdk start.launch # 终端2 roslaunch pointcloud_to_laserscan point_to_scan.launch # 终端3 roslaunch cartographer_ros cartographer_demo_rs16.launch

5.2 常见错误排查

问题5：Cartographer报"No matching sensor"

检查：

1. 确保雷达数据topic正确映射
2. 检查TF树是否完整
3. 确认配置文件中sensor_bridge部分正确

问题6：建图出现大量噪点

调整参数：

• 增加voxel_filter_size
• 调整min_range和max_range
• 检查雷达安装是否稳固

问题7：地图漂移严重

优化方案：

1. 降低移动速度
2. 增加num_accumulated_range_data
3. 考虑添加IMU数据

6. 性能优化技巧

经过多次实际测试，我发现以下优化措施能显著提升建图质量：

1. 雷达安装高度：建议离地0.4-0.6米，角度略微向下倾斜5-10度
2. 移动速度控制：建议不超过0.5m/s
3. 环境特征：确保环境有足够的特征点，避免长走廊等单一场景
4. 参数微调：
   • 降低resolution到0.03-0.05
   • 增加submaps.num_range_data到80-100
   • 调整probability_grid的命中概率

# 保存最终地图 rosrun map_server map_saver -f my_map

在实际项目中，我发现最大的坑往往不是技术本身，而是各种环境配置和依赖关系。建议每次修改配置后，先小范围测试，确认无误后再进行大规模建图。