Livox Mid-360 这台雷达我第一次上手的时候其实有点轻敌。之前用过不少机械式多线雷达习惯了那种插上网线、配个IP、打开rviz就能看到点云的流程结果拿到Mid-360之后插上线、打开官方上位机界面上干干净净什么都没有。折腾了小半天才搞明白这台雷达的调试逻辑和传统雷达完全不是一回事——它用的是非重复扫描方式出厂默认IP是固定的上位机连接方式也有自己的脾气。这篇就把我用livox_viewer2调试Mid-360的完整过程拆开讲一遍包括连接、参数配置、点云观察、常见问题排查以及后面怎么衔接到建图流程。如果你手上正好有一台Mid-360或者准备入手又或者已经卡在连不上看不到点云点云稀稀拉拉这些坑里下面的内容应该能帮你省掉不少试错时间。1. 先搞清楚Mid-360和livox_viewer2到底是什么关系1.1 Mid-360的定位不是传统机械雷达Livox Mid-360是览沃推出的一款固态式激光雷达水平视场角360度垂直视场角-7度到52度最远探测距离官方标称260米80%反射率下近处盲区比较小。它和传统机械旋转雷达最大的区别在于扫描方式——不是靠电机带动整个光学组件旋转而是通过非重复扫描的花瓣式轨迹来覆盖视场。这个差异带来的直接影响是点云在单帧内不是均匀分布的而是随着积分时间增加逐渐填充。你如果只截取很短的一帧去看会觉得点云又稀又散但只要让它在视野里多待几秒点云密度会明显上来。很多新手第一次看到Mid-360的点云第一反应是这雷达是不是坏了其实只是没理解它的扫描特性。另一个关键点是接口。Mid-360通过以太网通信同时支持PTP时间同步供电是9到27V的宽压输入。它出厂默认IP是192.168.1.1XX这个网段具体最后一位和序列号有关上位机需要把本机IP配到同一网段才能通信。1.2 livox_viewer2的角色官方调试与可视化工具livox_viewer2是Livox官方提供的上位机软件主要用来做设备发现、参数配置、固件升级、点云实时显示这几件事。它不是一个建图工具也不是SLAM系统它的定位就是让你确认雷达工作正常并且把雷达调到适合你后续使用的状态。很多人会把它和rviz搞混。简单说livox_viewer2是雷达厂商自己的工具功能聚焦在雷达本身rviz是ROS生态里的通用可视化工具需要配合livox_ros_driver2这类驱动才能显示Mid-360的点云。调试阶段先用livox_viewer2确认硬件没问题再去搞ROS驱动这个顺序比较合理。1.3 为什么调试这一步不能跳过我见过不少人拿到雷达直接就去跑建图算法结果点云质量差、建图飘、时间戳对不上回头排查发现是雷达本身的配置就没弄对。比如外参没标定、IP冲突、固件版本太老、扫描模式选错这些问题在livox_viewer2里几分钟就能发现和解决但如果你跳过这一步直接上算法排查成本会成倍增加。调试阶段要确认的核心事项其实就几个雷达能不能被发现、点云是否正常、时间同步是否工作、固件是否需要升级、网络配置是否稳定。这几件事确认完后面接ROS2、接Cartographer或者接其他SLAM框架心里就有底了。2. 连接前的网络配置这一步错了后面全白搭2.1 确认雷达默认IP和本机网段Mid-360出厂默认IP通常是192.168.1.1XXXX和设备的序列号后两位相关。你可以在雷达机身标签上找到序列号也可以先用官方提供的设备发现工具扫一下。如果手头没有标签信息最稳妥的办法是把本机网卡配成192.168.1.50这类同网段地址然后用livox_viewer2的设备发现功能去扫。具体操作上Windows下进网络和Internet设置→更改适配器选项找到你连雷达的那块网卡右键属性→IPv4→手动设置IP。子网掩码255.255.255.0网关可以不填。Linux下用ip命令或者nmcli都行我一般用sudo ip addr add 192.168.1.50/24 dev eth0 sudo ip link set eth0 up这里有个细节如果你电脑上有多块网卡一定要确认你配的是连雷达的那一块。我有一次配了半天连不上最后发现配到了WiFi网卡上有线网卡还是自动获取IP的状态。2.2 网线选择和供电注意事项Mid-360标配的是一根带供电的以太网线一头是RJ45另一头分出电源线和网线。供电范围是9到27V我用的是12V/2A的电源适配器实测工作稳定。如果你用的电源电压偏低或者电流不够雷达可能会反复重启表现就是livox_viewer2里设备时有时无。网线本身建议用超五类或六类长度不要超过50米。虽然理论上以太网可以跑更远但雷达这种对时间同步有要求的设备线太长会引入额外的延迟和丢包。我实测用一根3米的六类线连接非常稳定换成一根劣质的超五类长线之后偶尔会出现点云卡顿。注意Mid-360不支持PoE供电必须用配套的电源线单独供电。直接插普通交换机的PoE口是带不动的。2.3 防火墙和杀毒软件的干扰这个问题在Windows上特别常见。livox_viewer2通过UDP和雷达通信Windows Defender或者第三方杀毒软件有时候会把UDP广播包拦掉导致设备发现失败。排查方法很简单临时关闭防火墙试一下如果能发现设备了就说明是防火墙的问题然后把livox_viewer2加到白名单里。Linux下相对省心但如果你开了ufw或者iptables规则比较严也可能挡住UDP。可以临时用sudo ufw disable确认能连上之后再按需放行对应端口。3. livox_viewer2里的设备发现与参数配置3.1 设备发现失败的排查链路打开livox_viewer2之后左侧设备列表里应该能看到雷达的序列号和IP。如果列表是空的按下面这个顺序排查第一步确认本机IP和雷达IP在同一网段。用ping测试一下ping 192.168.1.1XX如果ping不通说明网络层就没通先解决网络问题。第二步确认网线连接正常。看网口指示灯有没有亮不亮的话换根线或者换个网口试试。第三步确认供电正常。雷达上电后有没有指示灯亮起风扇有没有转Mid-360内部有散热风扇靠近能听到声音。第四步检查防火墙。按上一节说的方法临时关闭试试。第五步确认livox_viewer2版本。老版本的viewer可能不支持Mid-360去官网下载最新版。这五步走下来基本上90%的连接问题都能定位到。3.2 关键参数逐项说明设备连上之后点进设备详情页会看到一堆参数。我挑几个最关键的讲IP配置可以在这里修改雷达的IP地址。如果你后续要接入ROS2或者多雷达系统建议把IP改成固定且好记的地址。修改后需要重启雷达生效。扫描模式Mid-360支持不同的扫描模式默认是非重复扫描。这个模式适合建图和SLAM因为点云覆盖更均匀。如果你的应用需要更高帧率的重复扫描可以切换但一般建图场景不建议改。时间同步Mid-360支持PTP和GPS同步。如果你只有单雷达用默认的内部时钟就行如果是多雷达或者和相机做融合就需要配置PTP。PTP配置需要你的主机也支持PTPWindows下比较麻烦Linux下相对好搞。点云格式可以选笛卡尔坐标或者球坐标。一般用笛卡尔坐标就行后续驱动和算法都默认这个格式。返回模式Mid-360支持单次返回和多次返回。多次返回在雨雾天气或者有玻璃的场景下有用但数据量会翻倍。一般室内建图用单次返回就够了。3.3 固件升级的必要性和操作固件升级这件事我的建议是如果当前固件工作正常不急着升如果遇到了已知的bug或者需要新功能再升。升级操作在livox_viewer2里有专门的入口选中设备后点固件升级选择下载好的固件文件等待进度条走完就行。升级过程中有两点要注意一是保证供电稳定中途断电可能把雷达变砖二是升级完成后雷达会自动重启重启后需要重新连接。提示升级前建议先记录一下当前的IP配置和参数设置升级后有些参数可能会恢复默认。4. 点云观察怎么判断雷达工作是否正常4.1 正常点云应该长什么样Mid-360在livox_viewer2里的点云显示刚打开的时候可能比较稀疏等几秒钟之后会逐渐变密。这是非重复扫描的正常表现。你可以对着一个有明显结构的场景比如房间角落、走廊观察应该能看到清晰的墙面、地面和物体轮廓。如果点云出现以下情况就说明有问题点云完全不动像一张静态图点云只有零星几个点怎么等都密不起来点云出现明显的同心圆或者放射状条纹点云颜色异常livox_viewer2里一般按距离或反射率着色4.2 点云稀疏的几种原因点云稀疏是最常见的问题原因可能有这么几个积分时间太短。livox_viewer2里有个点云累积的选项默认可能只显示很短时间的点云。把累积时间调长一点比如1秒或2秒点云密度会明显改善。扫描模式不对。如果误切到了某种低密度模式点云自然会稀。恢复默认的非重复扫描模式试试。目标反射率太低。Mid-360的测距能力跟目标反射率强相关。对着黑色物体、远处墙面点云会明显变少。这是正常物理现象不是雷达故障。镜头脏了。雷达前面的光学窗口如果有灰尘或者指纹会影响出光和接收。用镜头布轻轻擦一下。4.3 用livox_viewer2做简单的视场检查livox_viewer2里可以切换不同的视角我一般会用俯视图看一下水平360度覆盖是否完整用侧视图看一下垂直视场是否符合预期。Mid-360的垂直视场是-7度到52度侧视图上应该能看到一个明显偏向一侧的扇形。如果你发现某个方向完全没有点云可能是那个方向被遮挡了或者雷达安装姿态有问题。调试阶段先把雷达放在开阔位置确认全视场正常再装到最终位置。5. 从调试到建图调试完成后怎么衔接ROS2和Cartographer5.1 调试完成后的检查清单在把雷达接入ROS2之前先确认这几件事雷达IP已固定且和主机同网段livox_viewer2里点云显示正常固件版本确认记录一下当前版本号时间同步方式确认单雷达用内部时钟即可扫描模式和返回模式确认这几项确认完就可以进入ROS2环节了。5.2 livox_ros_driver2的配置要点ROS2下用Mid-360需要装livox_ros_driver2。这个驱动包的配置文件里有几个地方要改{ lidar_configs: [ { ip: 192.168.1.1XX, pcl_data_type: 1, pattern_mode: 0, extrinsic_parameter: { roll: 0.0, pitch: 0.0, yaw: 0.0, x: 0.0, y: 0.0, z: 0.0 } } ] }IP要改成你雷达的实际IPpattern_mode对应扫描模式extrinsic_parameter是外参单雷达先全填0后续标定再改。启动驱动之后用ros2 topic list应该能看到/livox/lidar和/livox/imu这两个话题。用rviz2订阅/livox/lidarFixed Frame设成livox_frame就能看到点云了。5.3 接Cartographer建图时的常见坑Cartographer建图飘很多时候不是算法的问题而是雷达配置或者时间戳的问题。我踩过的几个坑时间戳不同步。如果雷达和主机时间差太多Cartographer的扫描匹配会出问题。确保主机开了NTP或者雷达配了PTP。IMU数据没接。Mid-360内置IMUCartographer用IMU做初始位姿估计能明显改善建图效果。确认/livox/imu话题有数据。外参没标定。如果雷达安装姿态和配置文件里的外参不一致建图会飘。单雷达可以先不标但多传感器融合必须标。点云降采样参数不合理。Cartographer的voxel_filter_size如果设得太小计算量会爆炸设得太大特征会丢失。一般0.1到0.2米之间比较合适。5.4 建图保存和后续验证Cartographer建完图之后可以用rosservice调用保存ros2 service call /write_state cartographer_ros_msgs/srv/WriteState {filename: /path/to/map.pbstream}保存成pbstream之后可以用cartographer_pbstream_to_ros_map转成pgm和yaml方便后续在rviz里查看或者做导航。验证建图质量的方法把保存的地图和实际场景对比看墙面是否直、角落是否清晰、有没有明显的重影。如果有重影多半是时间同步或者外参的问题。6. 几个我实际踩过的坑和对应的解法6.1 雷达能ping通但viewer发现不了这个情况我遇到过两次。一次是防火墙的问题关掉就好了。另一次是livox_viewer2的版本太老换了最新版就正常了。所以排查的时候网络层通了不代表应用层就通还要看软件本身的兼容性。6.2 点云显示正常但接ROS2后没数据这个通常是驱动配置的问题。检查livox_ros_driver2的配置文件里IP是否写对了还有ROS2的domain id是否和你的其他节点一致。另外Mid-360的数据量比较大如果网络带宽不够或者交换机性能差也可能丢包。建议雷达直连主机不要经过多级交换机。6.3 建图过程中点云突然卡顿有一次建图跑到一半点云突然卡住不动了过几秒又恢复。排查发现是主机的CPU占用太高rviz2和Cartographer抢资源。解决办法是关掉rviz2的点云显示或者降低点云的显示频率。建图的时候其实不需要实时看完整点云看个大概就行。6.4 修改IP后连不上了Mid-360修改IP之后需要重启重启后如果本机IP还在原来的网段就连不上了。这时候要把本机IP也改到新网段。我一般会把雷达IP改成192.168.1.100这种好记的地址本机固定192.168.1.50这样以后就不用反复改。7. 一些提高调试效率的个人习惯调试雷达这件事说到底是跟硬件和网络打交道很多问题是重复性的。我养成了几个习惯分享出来供参考。第一每次调试前先列一个检查清单按顺序过一遍。网络、供电、软件版本、防火墙这四项确认完再开始能省掉大量无效排查。第二把常用的命令写成脚本。比如配置本机IP、ping雷达、启动驱动我都写成了shell脚本一条命令搞定不用每次手敲。第三记录每次调试的参数和结果。雷达IP、固件版本、扫描模式、外参这些信息记下来下次出问题的时候可以快速对比。第四遇到问题先看官方文档和社区。Livox的官方文档写得还算详细社区里也有不少踩坑记录。很多问题别人已经遇到过了搜一下比自己去试快得多。第五不要跳过livox_viewer2这一步直接上ROS。看起来是省时间实际上后面排查问题花的时间更多。先用官方工具确认硬件没问题再去搞软件这个顺序是最省事的。Mid-360这台雷达用熟了之后其实很省心点云质量好、视场大、体积小适合各种移动平台和建图场景。但前提是调试这一步要做扎实。希望这篇内容能帮你少走点弯路把时间花在真正有价值的算法和应用上而不是跟网络和配置较劲。