Mid-360坐标系、数据输出协议与Livox SDK底层通信解读

在把Livox Mid-360（简称Mid-360）集成到机器人、自动驾驶系统里时，软件层面的第一步，是理解这台设备的数据输出方式和底层通信机制：点云数据是在什么坐标系下表示的、数据通过什么协议和端口传输、Livox SDK是怎么和设备完成底层通信的。很多初次集成Mid-360的开发者，直接按机械式雷达的习惯去接SDK、去理解点云坐标系，结果踩了不少坑：点云坐标系方向理解反了、设备没正常连接、数据帧解析不对。这篇文章就从Mid-360的坐标系、数据输出协议、以及Livox SDK底层通信三个层面，做一次偏底层的解读，帮助开发者建立对设备软件接口的系统认识。

Mid-360的坐标系定义

理解Mid-360，先要清楚它的点云是在什么样的坐标系下输出的，坐标系定义直接影响后续的点云处理、运动补偿、以及对标定。

Mid-360的点云通常以设备自身为原点，定义在一个三维直角坐标系里。这个坐标系的坐标轴方向、正负约定，和设备的安装朝向相关，一般在设备说明里会有明确约定。比如X、Y、Z三个轴分别对应哪个方向、哪个方向为正，使用时要以设备官方定义的坐标系为准，而不是凭机械雷达的习惯去猜。

实际集成时，坐标系有两层关系要理清：一是Mid-360自身的点云坐标系，这是设备直接输出的、以雷达为原点的坐标系；二是把这个雷达坐标系转换到车体、机器人基座坐标系，这需要通过安装位置的标定，把雷达坐标和车体坐标的对应关系算出来。很多系统里，雷达不是装在原点，而是装在车体的某个位置，点云要转换到车体坐标系才能统一使用。

Mid-360内置IMU输出的惯性数据，也有自己的坐标系和参考框架，激光点云和IMU数据之间有时间同步、坐标对齐的关系，这两类数据要在统一的时间戳和坐标系下处理，才能做运动补偿等计算。

数据输出协议与端口

Mid-360通过以太网向主机输出数据，采用基于UDP的传输协议，理解这个协议是接数据的基础。

Mid-360的数据输出，走的是Livox协议族，底层是UDP报文。设备把点云数据、IMU数据等封装成协议规定的数据包，通过特定的端口发送给主机。因为UDP是无连接的传输，不保证可靠到达，所以数据接收端要按协议正确解析、处理可能的数据丢包和乱序，这对数据处理的健壮性有要求。

数据输出的内容，主要包括点云数据和IMU数据。点云数据包含每个点的三维坐标、反射强度等信息；IMU数据包含角速度、加速度等惯性量。这些数据以一定频率持续输出，主机通过接收、解析UDP数据包，获得实时点云和IMU信息。Livox SDK封装了这套协议，开发者通过SDK接口获取数据，不需要直接手写UDP解析，但理解底层是UDP有助于排查连接和数据问题。

设备发现和连接上，Mid-360通过Livox设备协议在局域网里被发现和连接，主机和雷达要处于同一个网络，SDK通过设备发现、建立连接，才能开始接收数据。

Livox SDK的底层通信机制

Livox SDK是连接应用和Mid-360底层协议的桥梁，它把设备发现、连接、数据收发、以及协议解析都封装起来，向开发者提供较高层的接口。理解SDK的底层通信机制，有助于用好它、以及排查问题。

在通信结构上，SDK通过UDP与设备交互，主要包含两类通道：一类是控制、配置通道，用于设备发现、建立连接、配置参数、查询状态；一类是数据通道，用于接收设备输出的点云、IMU数据。控制通道负责"和设备对话、建立和管理连接"，数据通道负责"持续接收数据流"，两者配合构成完整的通信。

在数据回传上，SDK把底层UDP数据包解析成结构化数据，通过回调机制把点云、IMU数据推送给应用程序。开发者注册回调函数，SDK在收到数据时调用回调，把解析好的数据交给应用处理。这种"注册回调、异步收数据"的方式，让应用不需要自己轮询底层UDP，降低了接入复杂度。

SDK还处理了数据的时间戳、以及一些协议层的细节，比如多设备管理、设备状态查询、数据包的组帧等。理解这些底层机制，遇到设备连不上、收不到数据、数据异常时，就能按"网络是否通-设备是否被发现-连接是否建立-数据是否在接收-解析是否正确"这条链路去排查。

实际集成中的常见注意点

在实际集成Mid-360时，有几个和坐标系、协议、SDK相关的注意点，能帮开发者少踩坑。

第一个注意点是坐标系和安装朝向要对齐。点云坐标系的正负方向、以及雷达安装的朝向，要在系统里统一约定，标定时把雷达坐标系和车体坐标系的关系算准确，避免坐标系方向理解错导致点云处理结果错误。

第二个注意点是网络配置要正确。Mid-360通过以太网通信，主机和雷达要在同一个网段、网络要通，SDK才能发现并连接设备。网络不通、地址冲突、防火墙拦截，都可能让设备连不上、收不到数据，排查时要先确认网络链路。

第三个注意点是数据接收要处理UDP的不可靠性。底层是UDP，可能出现丢包、乱序，应用层的数据处理要对丢包有一定容忍，必要时做补偿或重采样，不能假设数据每次都完整可靠到达。

第四个注意点是点云和IMU的时间同步。Mid-360的激光点云和IMU数据要统一时间戳，运动补偿等计算依赖两者时间对齐，集成时要确认时间同步的配置和处理正确，否则运动状态下的点云会因时间不对齐而畸变。

整体来看，Mid-360的数据输出，底层走的是基于UDP的Livox协议，通过以太网向主机输出点云和IMU数据；点云在设备自身的坐标系下表示，集成时还要通过标定转换到车体坐标系；Livox SDK封装了设备发现、连接、数据收发和协议解析，通过控制通道和数据通道、以及回调机制向应用提供数据。集成时要重点处理好坐标系与安装朝向对齐、网络配置、UDP不可靠性的容错、以及点云与IMU的时间同步。理解了这套坐标系、协议和SDK底层通信机制，就能在开发时更顺畅地把Mid-360接入系统，也更能定位和解决集成中遇到的数据与连接问题。