1. 环境准备与硬件连接第一次接触Livox Mid-360激光雷达时最让人头疼的就是网络配置问题。记得我第一次尝试时整整折腾了半天才让雷达和电脑正常通信。这里分享几个关键步骤帮你少走弯路。首先需要确认你的硬件环境一台运行Ubuntu 22.04的电脑建议使用实体机而非虚拟机Livox Mid-360激光雷达及配套电源千兆以太网线强烈建议使用原装线缆网络配置是第一个关键点。Mid-360默认使用静态IP 192.168.1.153我们需要将电脑的有线网卡配置到同一网段。这里有个小技巧先断开所有网络连接只保留雷达和电脑的有线连接避免其他网络接口干扰。# 查看网络接口名称 ifconfig # 设置静态IP将enx207bd2b27267替换为你的实际接口名 sudo ifconfig enx207bd2b27267 192.168.1.50 netmask 255.255.255.0如果习惯图形界面操作也可以在Ubuntu设置中修改打开设置→网络选择有线连接→齿轮图标IPv4选项卡选择手动地址192.168.1.50子网掩码255.255.255.0保存后重新连接硬件连接时有个常见坑点一定要先接好网线再给雷达通电。我遇到过好几次因为连接顺序不对导致雷达无法识别的情况。正常连接后雷达的指示灯会显示绿色常亮。2. 驱动安装与编译驱动安装是第二个关键环节。Livox为Mid-360提供了专门的SDK2和ROS2驱动与之前的设备驱动不兼容这点要特别注意。先安装必要的依赖sudo apt update sudo apt install -y build-essential cmake git然后是SDK2的安装git clone https://github.com/Livox-SDK/Livox-SDK2.git cd Livox-SDK2 mkdir build cd build cmake .. make -j$(nproc) sudo make install接下来是ROS2驱动的编译。这里建议单独创建工作空间避免与其他ROS包冲突mkdir -p ~/livox_ws/src cd ~/livox_ws/src git clone https://github.com/Livox-SDK/livox_ros_driver2.git编译前有个重要细节一定要确认ROS2环境变量已正确加载。我建议在每个终端都先执行source /opt/ros/humble/setup.bash然后开始编译驱动cd ~/livox_ws colcon build --symlink-install编译过程中可能会遇到Python库冲突的问题。如果报错可以尝试rm -rf build install log colcon build --symlink-install --packages-select livox_ros_driver23. 配置文件的深度解析配置文件是连接雷达和ROS2的关键很多问题都出在这里。Mid-360的配置文件位于~/livox_ws/src/livox_ros_driver2/config/MID360_config.json这个文件有几个关键部分需要特别注意首先是网络配置部分host_net_info: { cmd_data_ip: 192.168.1.50, cmd_data_port: 56101, push_msg_ip: 192.168.1.50, push_msg_port: 56201, point_data_ip: 192.168.1.50, point_data_port: 56301, imu_data_ip: 192.168.1.50, imu_data_port: 56401 }这里的IP必须与之前设置的电脑IP完全一致。端口号通常不需要修改除非有冲突。其次是雷达配置部分lidar_configs: [ { ip: 192.168.1.153, pcl_data_type: 1, pattern_mode: 0, extrinsic_parameter: { roll: 0.0, pitch: 0.0, yaw: 0.0, x: 0, y: 0, z: 0 } } ]这里有个易错点雷达IP的最后两位需要改为你设备SN码的最后两位。比如SN码是MID360-123456那么IP应该是192.168.1.56。4. Rviz可视化实战一切准备就绪后就可以启动Rviz进行可视化了。Livox驱动提供了两个启动文件rviz_MID360_launch.py发布sensor_msgs/PointCloud2类型数据适合Rviz直接显示msg_MID360_launch.py发布CustomMsg类型数据适合Fast-LIO等算法使用启动命令如下source ~/livox_ws/install/setup.bash ros2 launch livox_ros_driver2 rviz_MID360_launch.py第一次启动Rviz时需要手动添加显示点击左下角Add按钮选择By topic选项卡找到/livox/lidar下的PointCloud2点击OK确认如果看不到点云可以检查以下几个地方确保Fixed Frame设置为livox_frame点云大小(Size)建议设置为0.05颜色变换(Color Transformer)选择Intensity我习惯的Rviz布局是左侧显示点云和TF右侧显示雷达状态话题下方保留日志窗口5. 常见问题排查指南在实际部署过程中我遇到过各种奇怪的问题。这里总结几个典型场景问题1Livox Viewer能显示点云但Rviz不行这种情况通常说明硬件连接和驱动没问题问题出在ROS2通信环节。可以检查话题是否正确发布ros2 topic list | grep livox查看点云数据ros2 topic echo /livox/lidar --no-arr问题2点云显示不完整或有明显缺失可能是雷达配置问题检查MID360_config.json中的pcl_data_type尝试修改pattern_mode为1非重复扫描模式确认雷达固件是最新版本问题3驱动编译通过但运行时崩溃这种情况多与环境变量有关确保每次运行前都source了ROS2和livox_ws的环境检查动态库路径echo $LD_LIBRARY_PATH如果使用多版本ROS确认humble是默认版本问题4IMU数据显示异常Mid-360内置IMU如果数据显示不正常检查配置文件中imu_data_ip设置确认IMU话题是否正常发布ros2 topic echo /livox/imu尝试重新校准IMU需要Livox Viewer工具6. 性能优化与高级配置当基础功能调通后可以考虑进一步优化。这里分享几个实用技巧点云降采样配置在MID360_config.json中添加point_cloud_post_process: { noise_filter: 1, outlier_filter: 1, reflectivity_filter: 0 }多雷达同步配置如果需要使用多个Mid-360可以为每个雷达配置不同的IP在lidar_configs数组中添加多个配置项设置同步时间戳timesync_config: { enable_timesync: true, device_timesync: ptp }ROS2参数调优修改launch文件中的参数Node( parameters[ {xfer_format: 1}, {multi_topic: 0}, {data_src: 0}, {publish_freq: 10.0} ] )点云存储与回放可以使用ros2 bag记录数据ros2 bag record /livox/lidar回放时注意时间同步问题ros2 bag play --clock recorded_bag7. 实际应用案例最后分享一个真实项目中的集成案例。我们需要将Mid-360用于室内移动机器人的建图与定位具体配置如下传感器标定使用开源工具标定雷达与机器人基座的TF关系ros2 run tf2_ros static_transform_publisher x y z yaw pitch roll frame_id child_frame_id与Nav2集成在navigation2配置中添加点云层point_cloud: topic: /livox/lidar sensor_frame: livox_frame data_type: PointCloud2性能监控编写简单脚本监控雷达状态import rclpy from livox_interfaces.msg import CustomMsg def callback(msg): print(fPoint count: {len(msg.points)}) rclpy.init() node rclpy.create_node(monitor) sub node.create_subscription(CustomMsg, /livox/lidar, callback, 10) rclpy.spin(node)这套配置在实际运行中达到了10Hz的稳定点云输出满足实时建图需求。关键是要确保网络带宽足够建议使用专用千兆网卡。
ROS2 Humble环境下Livox Mid-360激光雷达的实战部署与Rviz可视化全攻略
发布时间：2026/7/16 19:00:01
1. 环境准备与硬件连接第一次接触Livox Mid-360激光雷达时最让人头疼的就是网络配置问题。记得我第一次尝试时整整折腾了半天才让雷达和电脑正常通信。这里分享几个关键步骤帮你少走弯路。首先需要确认你的硬件环境一台运行Ubuntu 22.04的电脑建议使用实体机而非虚拟机Livox Mid-360激光雷达及配套电源千兆以太网线强烈建议使用原装线缆网络配置是第一个关键点。Mid-360默认使用静态IP 192.168.1.153我们需要将电脑的有线网卡配置到同一网段。这里有个小技巧先断开所有网络连接只保留雷达和电脑的有线连接避免其他网络接口干扰。# 查看网络接口名称 ifconfig # 设置静态IP将enx207bd2b27267替换为你的实际接口名 sudo ifconfig enx207bd2b27267 192.168.1.50 netmask 255.255.255.0如果习惯图形界面操作也可以在Ubuntu设置中修改打开设置→网络选择有线连接→齿轮图标IPv4选项卡选择手动地址192.168.1.50子网掩码255.255.255.0保存后重新连接硬件连接时有个常见坑点一定要先接好网线再给雷达通电。我遇到过好几次因为连接顺序不对导致雷达无法识别的情况。正常连接后雷达的指示灯会显示绿色常亮。2. 驱动安装与编译驱动安装是第二个关键环节。Livox为Mid-360提供了专门的SDK2和ROS2驱动与之前的设备驱动不兼容这点要特别注意。先安装必要的依赖sudo apt update sudo apt install -y build-essential cmake git然后是SDK2的安装git clone https://github.com/Livox-SDK/Livox-SDK2.git cd Livox-SDK2 mkdir build cd build cmake .. make -j$(nproc) sudo make install接下来是ROS2驱动的编译。这里建议单独创建工作空间避免与其他ROS包冲突mkdir -p ~/livox_ws/src cd ~/livox_ws/src git clone https://github.com/Livox-SDK/livox_ros_driver2.git编译前有个重要细节一定要确认ROS2环境变量已正确加载。我建议在每个终端都先执行source /opt/ros/humble/setup.bash然后开始编译驱动cd ~/livox_ws colcon build --symlink-install编译过程中可能会遇到Python库冲突的问题。如果报错可以尝试rm -rf build install log colcon build --symlink-install --packages-select livox_ros_driver23. 配置文件的深度解析配置文件是连接雷达和ROS2的关键很多问题都出在这里。Mid-360的配置文件位于~/livox_ws/src/livox_ros_driver2/config/MID360_config.json这个文件有几个关键部分需要特别注意首先是网络配置部分host_net_info: { cmd_data_ip: 192.168.1.50, cmd_data_port: 56101, push_msg_ip: 192.168.1.50, push_msg_port: 56201, point_data_ip: 192.168.1.50, point_data_port: 56301, imu_data_ip: 192.168.1.50, imu_data_port: 56401 }这里的IP必须与之前设置的电脑IP完全一致。端口号通常不需要修改除非有冲突。其次是雷达配置部分lidar_configs: [ { ip: 192.168.1.153, pcl_data_type: 1, pattern_mode: 0, extrinsic_parameter: { roll: 0.0, pitch: 0.0, yaw: 0.0, x: 0, y: 0, z: 0 } } ]这里有个易错点雷达IP的最后两位需要改为你设备SN码的最后两位。比如SN码是MID360-123456那么IP应该是192.168.1.56。4. Rviz可视化实战一切准备就绪后就可以启动Rviz进行可视化了。Livox驱动提供了两个启动文件rviz_MID360_launch.py发布sensor_msgs/PointCloud2类型数据适合Rviz直接显示msg_MID360_launch.py发布CustomMsg类型数据适合Fast-LIO等算法使用启动命令如下source ~/livox_ws/install/setup.bash ros2 launch livox_ros_driver2 rviz_MID360_launch.py第一次启动Rviz时需要手动添加显示点击左下角Add按钮选择By topic选项卡找到/livox/lidar下的PointCloud2点击OK确认如果看不到点云可以检查以下几个地方确保Fixed Frame设置为livox_frame点云大小(Size)建议设置为0.05颜色变换(Color Transformer)选择Intensity我习惯的Rviz布局是左侧显示点云和TF右侧显示雷达状态话题下方保留日志窗口5. 常见问题排查指南在实际部署过程中我遇到过各种奇怪的问题。这里总结几个典型场景问题1Livox Viewer能显示点云但Rviz不行这种情况通常说明硬件连接和驱动没问题问题出在ROS2通信环节。可以检查话题是否正确发布ros2 topic list | grep livox查看点云数据ros2 topic echo /livox/lidar --no-arr问题2点云显示不完整或有明显缺失可能是雷达配置问题检查MID360_config.json中的pcl_data_type尝试修改pattern_mode为1非重复扫描模式确认雷达固件是最新版本问题3驱动编译通过但运行时崩溃这种情况多与环境变量有关确保每次运行前都source了ROS2和livox_ws的环境检查动态库路径echo $LD_LIBRARY_PATH如果使用多版本ROS确认humble是默认版本问题4IMU数据显示异常Mid-360内置IMU如果数据显示不正常检查配置文件中imu_data_ip设置确认IMU话题是否正常发布ros2 topic echo /livox/imu尝试重新校准IMU需要Livox Viewer工具6. 性能优化与高级配置当基础功能调通后可以考虑进一步优化。这里分享几个实用技巧点云降采样配置在MID360_config.json中添加point_cloud_post_process: { noise_filter: 1, outlier_filter: 1, reflectivity_filter: 0 }多雷达同步配置如果需要使用多个Mid-360可以为每个雷达配置不同的IP在lidar_configs数组中添加多个配置项设置同步时间戳timesync_config: { enable_timesync: true, device_timesync: ptp }ROS2参数调优修改launch文件中的参数Node( parameters[ {xfer_format: 1}, {multi_topic: 0}, {data_src: 0}, {publish_freq: 10.0} ] )点云存储与回放可以使用ros2 bag记录数据ros2 bag record /livox/lidar回放时注意时间同步问题ros2 bag play --clock recorded_bag7. 实际应用案例最后分享一个真实项目中的集成案例。我们需要将Mid-360用于室内移动机器人的建图与定位具体配置如下传感器标定使用开源工具标定雷达与机器人基座的TF关系ros2 run tf2_ros static_transform_publisher x y z yaw pitch roll frame_id child_frame_id与Nav2集成在navigation2配置中添加点云层point_cloud: topic: /livox/lidar sensor_frame: livox_frame data_type: PointCloud2性能监控编写简单脚本监控雷达状态import rclpy from livox_interfaces.msg import CustomMsg def callback(msg): print(fPoint count: {len(msg.points)}) rclpy.init() node rclpy.create_node(monitor) sub node.create_subscription(CustomMsg, /livox/lidar, callback, 10) rclpy.spin(node)这套配置在实际运行中达到了10Hz的稳定点云输出满足实时建图需求。关键是要确保网络带宽足够建议使用专用千兆网卡。
