简介这份资源是面向机器人、自动驾驶与无人机方向研究人员和工程师的集成教程聚焦在Ubuntu 18.04环境下完成mid360激光雷达、Livox SDK2、Livox ROS Driver2与FAST-LIO2的部署与联调帮助读者打通从传感器驱动到LiDAR-惯性里程计定位的完整链路。压缩包内共1个文件为单个html文档体积约21KB内容以图文步骤形式组织便于按章节查阅与对照操作。目前已有951人学习说明该集成方案在相关开发者群体中具有一定参考价值。教程覆盖SDK安装、ROS驱动配置、点云与IMU数据融合调试等关键环节并给出FAST-LIO2运行验证思路读者可据此搭建可复现的定位导航实验环境减少驱动版本不匹配、话题配置错误等常见问题带来的试错成本适合具备一定ROS基础、希望快速上手Livox mid360与FAST-LIO2组合的中高级开发者参考。1. 从一台刚上电的 Mid-360 说起这套驱动链路到底解决什么问题刚拿到 Livox Mid-360 的人十有八九会卡在同一个地方雷达通电、网线插好但ros2 topic list里空空如也或者能看到点云却进不了 FAST-LIO2。问题往往不在雷达本身而在 Livox-SDK2、livox_ros_driver2、FAST-LIO2 这三层之间的版本匹配和话题对接。Mid-360 是 Livox 面向机器人场景的固态激光雷达非重复扫描、大视场角配合 FAST-LIO2 做建图定位是当前很常见的组合。这套教程要解决的就是从零把 SDK2 编译好、驱动跑起来、点云喂进 FAST-LIO2 并看到地图的完整链路。适合刚接触 Mid-360 的机器人开发者、做 Gazebo 仿真建图定位验证的同学以及从 ROS1 迁到 ROS2 想跑通 FAST-LIO2 的从业者。下面按我实际部署的顺序拆每一步都给出可抄的命令和参数。2. 环境与依赖SDK2、驱动、FAST-LIO2 的版本怎么对齐2.1 三层结构先理清别一上来就 cloneLivox 的软件栈是分层的最底层是 Livox-SDK2负责和雷达硬件通信提供 C 接口中间层是 livox_ros_driver2把 SDK2 的数据封装成 ROS2 话题最上层才是 FAST-LIO2 这类 SLAM 算法订阅点云话题做里程计和建图。很多人翻车是因为把 livox_ros_driverROS1 版和 livox_ros_driver2ROS2 版搞混或者 SDK2 装成了老版 SDK1。Mid-360 必须用 SDK2SDK1 不支持这个型号。常见做法是先确认系统是 Ubuntu 20.04 或 22.04ROS2 用 Foxy 或 Humble然后按 SDK2 → driver2 → FAST-LIO2 的顺序编译顺序反了会出现找不到库的情况。2.2 依赖安装与工作空间准备先装基础依赖这些在编译 SDK2 和 driver2 时都会用到sudo apt update sudo apt install -y cmake g git libpcl-dev libeigen3-dev \ libboost-all-dev libyaml-cpp-dev python3-colcon-common-extensions逻辑说明libpcl-dev和libeigen3-dev是 FAST-LIO2 编译必需的libyaml-cpp-dev给 driver2 解析配置文件用colcon是 ROS2 的构建工具。参数上没有需要改的直接装即可。装完确认cmake --version不低于 3.16低于这个版本 SDK2 编译会报 C17 相关的错。工作空间建议单独建不要和已有的 ROS2 包混在一起mkdir -p ~/mid360_ws/src cd ~/mid360_ws/src后面 SDK2 装在系统目录driver2 和 FAST-LIO2 都放这个 src 下方便统一 colcon build。2.3 SDK2 编译与安装路径SDK2 从官方仓库拉下来后编译安装cd ~ git clone https://github.com/Livox-SDK/Livox-SDK2.git cd Livox-SDK2 mkdir build cd build cmake .. -DCMAKE_INSTALL_PREFIX/usr/local make -j$(nproc) sudo make install逻辑说明CMAKE_INSTALL_PREFIX指定安装到/usr/local这样 driver2 编译时能通过默认搜索路径找到livox_lidar_sdk库。make -j$(nproc)用满 CPU 核数加速。装完可以ls /usr/local/lib | grep livox确认有liblivox_lidar_sdk_static.a和liblivox_lidar_sdk_shared.so。如果这里没装成功driver2 编译一定会报livox_lidar_sdk.h: No such file所以这一步别跳过验证。3. livox_ros_driver2 编译与 Mid-360 网络配置3.1 驱动编译与 ROS2 版本选择driver2 支持 ROS2 的 Foxy 和 Humble编译前要指定版本cd ~/mid360_ws/src git clone https://github.com/Livox-SDK/livox_ros_driver2.git cd livox_ros_driver2 source /opt/ros/humble/setup.bash ./build.sh humble逻辑说明build.sh是 driver2 自带的构建脚本参数humble告诉它按 Humble 的接口编译如果你用的是 Foxy 就换成foxy。这个脚本内部会调用 colcon并处理 ROS2 版本差异。常见坑是直接colcon build而不走build.sh结果编译出来的包缺少版本宏运行时报undefined symbol。编译完成后source install/setup.bash让环境生效。3.2 Mid-360 的 IP 与网络参数Mid-360 出厂默认 IP 是192.168.1.1xx段主机需要配同网段静态 IP。用ip addr看网卡名假设是enp3s0sudo ip addr add 192.168.1.50/24 dev enp3s0 sudo ip link set enp3s0 up ping 192.168.1.1xx逻辑说明192.168.1.50是主机地址要和雷达同网段但不冲突1xx换成你雷达标签上的实际地址。能 ping 通说明物理链路和 IP 配置没问题。如果 ping 不通先查网线是不是插在雷达的以太网口而不是同步口再查主机防火墙有没有拦 ICMP。这一步是后面所有话题能出来的前提ping 不通就别往下走。3.3 配置文件里改什么driver2 的配置在livox_ros_driver2/config/MID360_config.json关键字段{ lidar_configs: [ { ip: 192.168.1.1xx, publish_freq: 10.0, output_data_type: xyzrtl } ], host_net_info: { cmd_data_ip: 192.168.1.50, push_msg_ip: 192.168.1.50, point_data_ip: 192.168.1.50 } }逻辑说明ip填雷达实际地址publish_freq是点云发布频率Mid-360 常用 10Hzoutput_data_type选xyzrtl表示输出含时间戳和反射率的点FAST-LIO2 需要这个格式。host_net_info里三个 IP 都填主机地址这是 SDK2 和雷达通信用的。改完保存启动 launch 时驱动会读这个文件。参数改错最典型的表现是话题有但没数据或者数据频率不对。3.4 启动驱动并验证话题source ~/mid360_ws/install/setup.bash ros2 launch livox_ros_driver2 rviz_MID360_launch.py逻辑说明这个 launch 会同时起驱动和 RViz方便直接看点云。另开终端ros2 topic list应该能看到/livox/lidar和/livox/imu。ros2 topic hz /livox/lidar看频率是否接近配置的 10Hz。如果只有 IMU 没有点云多半是output_data_type或网络配置问题如果频率远低于 10Hz检查网卡是不是千兆、有没有丢包。4. FAST-LIO2 接入话题映射与外参初值4.1 FAST-LIO2 编译FAST-LIO2 依赖 PCL、Eigen 和 livox_ros_driver2 的消息类型cd ~/mid360_ws/src git clone https://github.com/hku-mars/FAST_LIO.git cd FAST_LIO git checkout ROS2 cd ~/mid360_ws colcon build --symlink-install逻辑说明FAST-LIO2 主分支是 ROS1ROS2 要切到ROS2分支。--symlink-install方便改配置不用重编。编译时如果报找不到livox_ros_driver2的消息说明 driver2 没 source 或者没编译成功先回去确认 driver2 的 install 目录存在。4.2 话题重映射与配置FAST-LIO2 默认订阅的话题名和 driver2 发布的不完全一致需要在 launch 或配置里映射。常见做法是改config/mid360.yamlcommon: lid_topic: /livox/lidar imu_topic: /livox/imu time_sync_en: false preprocess: lidar_type: 1 scan_line: 4 blind: 0.5逻辑说明lid_topic和imu_topic要和 driver2 实际发布的一致lidar_type: 1对应 Livox 类型scan_line对 Mid-360 填 4blind是盲区过滤0.5 米内的点丢掉避免近处噪声影响。time_sync_en没有硬件同步时保持 false。这些参数直接决定 FAST-LIO2 能不能正常初始化填错会一直卡在等待点云。4.3 外参初值与常见调整Mid-360 和 IMU 的外参在config里的extrinsic_R和extrinsic_T。如果雷达和 IMU 是刚性连接且 IMU 在雷达附近初值可以用单位阵和零平移extrinsic_R: [1, 0, 0, 0, 1, 0, 0, 0, 1] extrinsic_T: [0, 0, 0]逻辑说明这两个参数是雷达坐标系到 IMU 坐标系的旋转和平移。初值不准时建图会出现墙面弯曲或回环对不上。常见做法是先跑一段直走廊看地图有没有明显扭曲再微调。Mid-360 外参调整是个细活没有标定板的情况下靠观察地图质量迭代是常用手段。如果 IMU 和雷达朝向差异大extrinsic_R要按实际安装角度填不能偷懒用单位阵。4.4 启动建图并看结果source ~/mid360_ws/install/setup.bash ros2 launch fast_lio mapping_mid360.launch.py逻辑说明启动后 RViz 里应该能看到累积的点云地图和当前帧。手持或推车缓慢移动地图会逐渐成形。如果地图漂移严重先查 IMU 数据是否正常ros2 topic echo /livox/imu看有没有角速度和加速度再查外参。FAST-LIO2 对 IMU 质量敏感IMU 噪声大或频率不稳会直接导致发散。5. 避坑与排查这几处我踩过不止一次5.1 现象编译 driver2 报找不到 livox_lidar_sdk原因SDK2 没装或装到了非默认路径driver2 的 CMake 找不到库。解决确认/usr/local/lib下有liblivox_lidar_sdk_shared.so没有就回 SDK2 目录重新sudo make install如果装在自定义路径编译 driver2 时加-DCMAKE_PREFIX_PATH你的路径。5.2 现象话题有但点云是空的原因MID360_config.json里host_net_info的 IP 填错或者雷达 IP 和配置不一致。解决用ping确认雷达地址把配置里三处 IP 都改成主机实际地址雷达 IP 改成标签上的地址重启驱动。5.3 现象FAST-LIO2 一直不初始化RViz 没地图原因话题名不匹配或lidar_type填错。解决ros2 topic list确认实际话题名改mid360.yaml里的lid_topiclidar_type对 Livox 必须是 1填 0 会当成其他雷达解析失败。5.4 现象建图漂移、墙面弯曲原因外参初值不准或 IMU 数据异常。解决先ros2 topic hz /livox/imu看频率是否稳定再检查extrinsic_R/T。手持设备走动时尽量平稳急转急停会让 FAST-LIO2 短时发散。5.5 现象Gazebo 仿真里 Mid-360 不出点云原因仿真插件的话题名和驱动不一致或者仿真雷达配置没加载。解决确认仿真 launch 里雷达插件发布的话题把它映射到 FAST-LIO2 订阅的话题仿真环境下 IMU 噪声参数也要和真实接近否则建图效果参考价值有限。6. 进阶用 Gazebo 仿真验证链路再上真机真机调试前我习惯先在 Gazebo 里把整条链路跑一遍这样能把驱动和算法的问题分开。Gazebo 仿真 Mid-360 建图定位的关键是让仿真雷达发布和真机一致的话题格式。常见做法是用 livox 的仿真插件或自己写一个发布PointCloud2的节点话题名对齐/livox/lidar然后直接启动 FAST-LIO2 的 launch。仿真里没有网络配置问题能快速验证 FAST-LIO2 的参数和外参是否合理。等仿真里地图正常了再上真机此时如果出问题基本就锁定在网络或硬件层排查范围小很多。验证方法上我一般会看三个指标点云频率是否稳定在配置值、IMU 频率是否够高通常 200Hz 左右、地图闭合后回到起点误差是否可接受。这三个都过了这套 Mid-360 SDK2 driver2 FAST-LIO2 的链路才算真正跑通。外参调整没有捷径仿真里调好初值真机上再微调比一上来就硬调真机省时间。从那以后我每次部署新雷达都强制先走一遍仿真验证再动真机。希望帮到你。本文还有配套的精品资源点击获取 Mid-360激光雷达ROS2驱动与FAST-LIO2建图全链路实战
简介这份资源是面向机器人、自动驾驶与无人机方向研究人员和工程师的集成教程聚焦在Ubuntu 18.04环境下完成mid360激光雷达、Livox SDK2、Livox ROS Driver2与FAST-LIO2的部署与联调帮助读者打通从传感器驱动到LiDAR-惯性里程计定位的完整链路。压缩包内共1个文件为单个html文档体积约21KB内容以图文步骤形式组织便于按章节查阅与对照操作。目前已有951人学习说明该集成方案在相关开发者群体中具有一定参考价值。教程覆盖SDK安装、ROS驱动配置、点云与IMU数据融合调试等关键环节并给出FAST-LIO2运行验证思路读者可据此搭建可复现的定位导航实验环境减少驱动版本不匹配、话题配置错误等常见问题带来的试错成本适合具备一定ROS基础、希望快速上手Livox mid360与FAST-LIO2组合的中高级开发者参考。1. 从一台刚上电的 Mid-360 说起这套驱动链路到底解决什么问题刚拿到 Livox Mid-360 的人十有八九会卡在同一个地方雷达通电、网线插好但ros2 topic list里空空如也或者能看到点云却进不了 FAST-LIO2。问题往往不在雷达本身而在 Livox-SDK2、livox_ros_driver2、FAST-LIO2 这三层之间的版本匹配和话题对接。Mid-360 是 Livox 面向机器人场景的固态激光雷达非重复扫描、大视场角配合 FAST-LIO2 做建图定位是当前很常见的组合。这套教程要解决的就是从零把 SDK2 编译好、驱动跑起来、点云喂进 FAST-LIO2 并看到地图的完整链路。适合刚接触 Mid-360 的机器人开发者、做 Gazebo 仿真建图定位验证的同学以及从 ROS1 迁到 ROS2 想跑通 FAST-LIO2 的从业者。下面按我实际部署的顺序拆每一步都给出可抄的命令和参数。2. 环境与依赖SDK2、驱动、FAST-LIO2 的版本怎么对齐2.1 三层结构先理清别一上来就 cloneLivox 的软件栈是分层的最底层是 Livox-SDK2负责和雷达硬件通信提供 C 接口中间层是 livox_ros_driver2把 SDK2 的数据封装成 ROS2 话题最上层才是 FAST-LIO2 这类 SLAM 算法订阅点云话题做里程计和建图。很多人翻车是因为把 livox_ros_driverROS1 版和 livox_ros_driver2ROS2 版搞混或者 SDK2 装成了老版 SDK1。Mid-360 必须用 SDK2SDK1 不支持这个型号。常见做法是先确认系统是 Ubuntu 20.04 或 22.04ROS2 用 Foxy 或 Humble然后按 SDK2 → driver2 → FAST-LIO2 的顺序编译顺序反了会出现找不到库的情况。2.2 依赖安装与工作空间准备先装基础依赖这些在编译 SDK2 和 driver2 时都会用到sudo apt update sudo apt install -y cmake g git libpcl-dev libeigen3-dev \ libboost-all-dev libyaml-cpp-dev python3-colcon-common-extensions逻辑说明libpcl-dev和libeigen3-dev是 FAST-LIO2 编译必需的libyaml-cpp-dev给 driver2 解析配置文件用colcon是 ROS2 的构建工具。参数上没有需要改的直接装即可。装完确认cmake --version不低于 3.16低于这个版本 SDK2 编译会报 C17 相关的错。工作空间建议单独建不要和已有的 ROS2 包混在一起mkdir -p ~/mid360_ws/src cd ~/mid360_ws/src后面 SDK2 装在系统目录driver2 和 FAST-LIO2 都放这个 src 下方便统一 colcon build。2.3 SDK2 编译与安装路径SDK2 从官方仓库拉下来后编译安装cd ~ git clone https://github.com/Livox-SDK/Livox-SDK2.git cd Livox-SDK2 mkdir build cd build cmake .. -DCMAKE_INSTALL_PREFIX/usr/local make -j$(nproc) sudo make install逻辑说明CMAKE_INSTALL_PREFIX指定安装到/usr/local这样 driver2 编译时能通过默认搜索路径找到livox_lidar_sdk库。make -j$(nproc)用满 CPU 核数加速。装完可以ls /usr/local/lib | grep livox确认有liblivox_lidar_sdk_static.a和liblivox_lidar_sdk_shared.so。如果这里没装成功driver2 编译一定会报livox_lidar_sdk.h: No such file所以这一步别跳过验证。3. livox_ros_driver2 编译与 Mid-360 网络配置3.1 驱动编译与 ROS2 版本选择driver2 支持 ROS2 的 Foxy 和 Humble编译前要指定版本cd ~/mid360_ws/src git clone https://github.com/Livox-SDK/livox_ros_driver2.git cd livox_ros_driver2 source /opt/ros/humble/setup.bash ./build.sh humble逻辑说明build.sh是 driver2 自带的构建脚本参数humble告诉它按 Humble 的接口编译如果你用的是 Foxy 就换成foxy。这个脚本内部会调用 colcon并处理 ROS2 版本差异。常见坑是直接colcon build而不走build.sh结果编译出来的包缺少版本宏运行时报undefined symbol。编译完成后source install/setup.bash让环境生效。3.2 Mid-360 的 IP 与网络参数Mid-360 出厂默认 IP 是192.168.1.1xx段主机需要配同网段静态 IP。用ip addr看网卡名假设是enp3s0sudo ip addr add 192.168.1.50/24 dev enp3s0 sudo ip link set enp3s0 up ping 192.168.1.1xx逻辑说明192.168.1.50是主机地址要和雷达同网段但不冲突1xx换成你雷达标签上的实际地址。能 ping 通说明物理链路和 IP 配置没问题。如果 ping 不通先查网线是不是插在雷达的以太网口而不是同步口再查主机防火墙有没有拦 ICMP。这一步是后面所有话题能出来的前提ping 不通就别往下走。3.3 配置文件里改什么driver2 的配置在livox_ros_driver2/config/MID360_config.json关键字段{ lidar_configs: [ { ip: 192.168.1.1xx, publish_freq: 10.0, output_data_type: xyzrtl } ], host_net_info: { cmd_data_ip: 192.168.1.50, push_msg_ip: 192.168.1.50, point_data_ip: 192.168.1.50 } }逻辑说明ip填雷达实际地址publish_freq是点云发布频率Mid-360 常用 10Hzoutput_data_type选xyzrtl表示输出含时间戳和反射率的点FAST-LIO2 需要这个格式。host_net_info里三个 IP 都填主机地址这是 SDK2 和雷达通信用的。改完保存启动 launch 时驱动会读这个文件。参数改错最典型的表现是话题有但没数据或者数据频率不对。3.4 启动驱动并验证话题source ~/mid360_ws/install/setup.bash ros2 launch livox_ros_driver2 rviz_MID360_launch.py逻辑说明这个 launch 会同时起驱动和 RViz方便直接看点云。另开终端ros2 topic list应该能看到/livox/lidar和/livox/imu。ros2 topic hz /livox/lidar看频率是否接近配置的 10Hz。如果只有 IMU 没有点云多半是output_data_type或网络配置问题如果频率远低于 10Hz检查网卡是不是千兆、有没有丢包。4. FAST-LIO2 接入话题映射与外参初值4.1 FAST-LIO2 编译FAST-LIO2 依赖 PCL、Eigen 和 livox_ros_driver2 的消息类型cd ~/mid360_ws/src git clone https://github.com/hku-mars/FAST_LIO.git cd FAST_LIO git checkout ROS2 cd ~/mid360_ws colcon build --symlink-install逻辑说明FAST-LIO2 主分支是 ROS1ROS2 要切到ROS2分支。--symlink-install方便改配置不用重编。编译时如果报找不到livox_ros_driver2的消息说明 driver2 没 source 或者没编译成功先回去确认 driver2 的 install 目录存在。4.2 话题重映射与配置FAST-LIO2 默认订阅的话题名和 driver2 发布的不完全一致需要在 launch 或配置里映射。常见做法是改config/mid360.yamlcommon: lid_topic: /livox/lidar imu_topic: /livox/imu time_sync_en: false preprocess: lidar_type: 1 scan_line: 4 blind: 0.5逻辑说明lid_topic和imu_topic要和 driver2 实际发布的一致lidar_type: 1对应 Livox 类型scan_line对 Mid-360 填 4blind是盲区过滤0.5 米内的点丢掉避免近处噪声影响。time_sync_en没有硬件同步时保持 false。这些参数直接决定 FAST-LIO2 能不能正常初始化填错会一直卡在等待点云。4.3 外参初值与常见调整Mid-360 和 IMU 的外参在config里的extrinsic_R和extrinsic_T。如果雷达和 IMU 是刚性连接且 IMU 在雷达附近初值可以用单位阵和零平移extrinsic_R: [1, 0, 0, 0, 1, 0, 0, 0, 1] extrinsic_T: [0, 0, 0]逻辑说明这两个参数是雷达坐标系到 IMU 坐标系的旋转和平移。初值不准时建图会出现墙面弯曲或回环对不上。常见做法是先跑一段直走廊看地图有没有明显扭曲再微调。Mid-360 外参调整是个细活没有标定板的情况下靠观察地图质量迭代是常用手段。如果 IMU 和雷达朝向差异大extrinsic_R要按实际安装角度填不能偷懒用单位阵。4.4 启动建图并看结果source ~/mid360_ws/install/setup.bash ros2 launch fast_lio mapping_mid360.launch.py逻辑说明启动后 RViz 里应该能看到累积的点云地图和当前帧。手持或推车缓慢移动地图会逐渐成形。如果地图漂移严重先查 IMU 数据是否正常ros2 topic echo /livox/imu看有没有角速度和加速度再查外参。FAST-LIO2 对 IMU 质量敏感IMU 噪声大或频率不稳会直接导致发散。5. 避坑与排查这几处我踩过不止一次5.1 现象编译 driver2 报找不到 livox_lidar_sdk原因SDK2 没装或装到了非默认路径driver2 的 CMake 找不到库。解决确认/usr/local/lib下有liblivox_lidar_sdk_shared.so没有就回 SDK2 目录重新sudo make install如果装在自定义路径编译 driver2 时加-DCMAKE_PREFIX_PATH你的路径。5.2 现象话题有但点云是空的原因MID360_config.json里host_net_info的 IP 填错或者雷达 IP 和配置不一致。解决用ping确认雷达地址把配置里三处 IP 都改成主机实际地址雷达 IP 改成标签上的地址重启驱动。5.3 现象FAST-LIO2 一直不初始化RViz 没地图原因话题名不匹配或lidar_type填错。解决ros2 topic list确认实际话题名改mid360.yaml里的lid_topiclidar_type对 Livox 必须是 1填 0 会当成其他雷达解析失败。5.4 现象建图漂移、墙面弯曲原因外参初值不准或 IMU 数据异常。解决先ros2 topic hz /livox/imu看频率是否稳定再检查extrinsic_R/T。手持设备走动时尽量平稳急转急停会让 FAST-LIO2 短时发散。5.5 现象Gazebo 仿真里 Mid-360 不出点云原因仿真插件的话题名和驱动不一致或者仿真雷达配置没加载。解决确认仿真 launch 里雷达插件发布的话题把它映射到 FAST-LIO2 订阅的话题仿真环境下 IMU 噪声参数也要和真实接近否则建图效果参考价值有限。6. 进阶用 Gazebo 仿真验证链路再上真机真机调试前我习惯先在 Gazebo 里把整条链路跑一遍这样能把驱动和算法的问题分开。Gazebo 仿真 Mid-360 建图定位的关键是让仿真雷达发布和真机一致的话题格式。常见做法是用 livox 的仿真插件或自己写一个发布PointCloud2的节点话题名对齐/livox/lidar然后直接启动 FAST-LIO2 的 launch。仿真里没有网络配置问题能快速验证 FAST-LIO2 的参数和外参是否合理。等仿真里地图正常了再上真机此时如果出问题基本就锁定在网络或硬件层排查范围小很多。验证方法上我一般会看三个指标点云频率是否稳定在配置值、IMU 频率是否够高通常 200Hz 左右、地图闭合后回到起点误差是否可接受。这三个都过了这套 Mid-360 SDK2 driver2 FAST-LIO2 的链路才算真正跑通。外参调整没有捷径仿真里调好初值真机上再微调比一上来就硬调真机省时间。从那以后我每次部署新雷达都强制先走一遍仿真验证再动真机。希望帮到你。本文还有配套的精品资源点击获取