Airy 产品手册

1 安全提示
1.1 法律声明
Warning
除非我们另行声明 RoboSense 的所有产品、技术、软件、程序、数据及其他信息(包括文字、图标、照片、音频、视频、图表、色彩组合、版面设计等)的所有权利(报告版权、商标权、专利权、商业秘密及其他相关权利)均归 RoboSense 及其授权方所有。
未经 RoboSense 书面同意,任何人不得以任何方式非法使用本手册中所承载在的任何内容。
“RoboSense”、“速腾聚创”等文字及/或标识,以及其他标识、产品和服务名称等均为 RoboSense 所有,如有宣传、展示等任何使用需要,您必须取得 RoboSense 的事先书面授权。
1.2 使用规范
请按以下要求,规范使用本产品
- 请严格遵守国家激光安全相关法律法规;
- 请在使用产品前,详细阅读本产品手册;
- 请在相关针对的领域范围内使用本产品;
- 请避免在爆炸性、高腐蚀性、超越产品 IP 防护等级的环境中使用本产品。
1.3 违规操作
请按规定使用本产品,否则可能会造成产品损坏、财产损失及人员受伤。对违反规定的操作行为,需用户自行承担风险。
- 请勿私自拆解、改装本产品(包含配套配件)
- 禁止使用非规定供电电源及配套配件
- 请避免跌落、碰撞、焚烧等非正常操作
- 如发现产品外观受损,请立即停止使用,并及时联系 RoboSense
- 如发现产品工作异常等情况,请立即停止使用,并及时联系 RoboSense
1.4 操作人员的要求
本产品的使用,对操作人员的基础专业知识及其他相关资质有一定要求。对无基础知识及未经培训上岗人员的不当操作行为,给产品及人员财产造成损害、伤害、损失等后果 RoboSense 不承担相关责任。
- 使用产品前,详细阅读本产品手册;
- 禁止违规操作;
- 上岗前需经过培训,且有相关工种施工资格;
- 有一定的计算机数据连接、电气等基础知识。
1.5 工作安全和特殊危险
使用本产品前,为避免对用户或他人产生意外,同时损坏产品及违反保修条款,请务必仔细阅读并遵循本说明书中的操作及规范。
-
激光安全:本产品激光安全等级符合 IEC 60825-1:2014 标准:

-
高温注意:注意表面过热标识,谨防发生意外。

-
保留说明:请保留所有安全和操作说明,以备将来参考。
-
注意警告:请遵守产品和操作说明中的所有警告,以免发生意外。
-
产品维修:请勿在缺少官方指导的情况下尝试打开产品进行维修。如需维修,请及时联系 RoboSense
2 产品描述
2.1 产品概要
Airy 是 RoboSense 专门为扫除盲区设计的新型近距离 3D 激光雷达,主要应用于机器人环境感知、无人驾驶汽车环境感知、无人机测绘、智慧城市等领域。
Airy 采用 RoboSense 创新性的信号处理技术,最小探测距离可近至 10 厘米,加上半球型超广视角的设计,可大范围内有效探测各类极近距离障碍物。
2.2 产品结构
Airy 结构图如图 1 所示。

图1 产品结构说明
主要包括以下结构:
- 防护罩:激光雷达发射激光束和接收到的激光回波都需透过弧形特制防护罩,因此在激光发散的 FOV 范围内,严禁遮挡。
- 航空插头:激光雷达本体通过航插头与航插线连接,实现供电和数据传输的功能。
- 定位孔:用于支撑、固定激光雷达与支架之间的位置和方向,可提高安装效率与精度。
- M3螺钉安装孔:用于激光雷达与安装支架间的固定,通过 M3 螺丝进行锁紧。
2.3 FOV 分布
Airy 的 FOV 在水平方向的角度范围是 \(0 \sim 360^\circ\),在垂直方向的角度范围是 \(0 \sim 90^\circ\),角度间隔为约为 \(0.947^\circ\) 分布。96 路通道与真实的垂直角度对应关系如图 2 所示。

图2 Airy FOV 示意图
Airy 因其设计架构及扫描时序限制,每秒约有 9 ms 时间无法接收点云,也就是每 10 帧点云中有 1 帧点云出现约 \(32^\circ\) 的点云缺口。该缺口的起始角度在量产固件上可配置,用户可根据实际需求配置在影响较小的位置处,见附录 A.2.2。
2.4 规格参数1
表1 Airy 规格参数
| 规格参数 | |||
|---|---|---|---|
| 线数 | 96 | 水平视场角 | 360° |
| 激光波长 | 940 nm | 垂直视场角 | 0~90° |
| 激光安全等级 | Class1 人眼安全 | 水平角分辨率 | 0.4° |
| 测距能力2 | 60 m (30 m @10% NIST) | 垂直角分辨率 | 0.947° |
| 盲区 | 0.1 m | 精度(典型值)3 | 1.5 cm (1 σ) |
| 转速 | 600 | 帧率 | 10 Hz |
| 出点数 | 856,320 pts / s | ||
| 以太网传输速率 | 100 Base-TX | ||
| 输出数据协议 | UDP Packets Over Ethernet | ||
| 激光雷达数据包内容 | 距离、反射强度、时间戳等 | ||
| 工作电压 | 9 V - 32 V | 尺寸4 | Φ 60 mm (底部) × H 63 mm |
| 产品功率5 | 8 W(典型值) | 工作温度6 | - 40℃ ~ + 60℃ |
| 重量 | 230g±20g(激光雷达本体) | 存储温度 | - 40℃ ~ + 85℃ |
| 时间同步 | GPS, PTP & gPTP | 防护等级 | IP67 / IP6K9K (工作中) |
| 产品型号 | Airy | ||
1 以下数据只针对量产产品,任何样品、试验机等其它非量产版本可能并不适用本规格数据,如有疑问请联系 RoboSense
2 测距能力的测试结果可能受环境因素影响,包括但不限于环境温度和光照强度
3 测距精度以 50% NIST 漫反射板为目标,测试结果会受到环境影响,包括但不限于环境温度、目标物距离等因素,且精度值适用于大部分通道,部分通道之间存在差异
4 具体尺寸参考附录 E 结构图纸或整机数模
5 设备功耗测试结果会受到外部环境影响,包括但不限于环境温度、目标物的距离、目标物反射强度等因素
6 设备运行温度可能会受到外部环境影响,包括但不限于光照环境、气流变化等因素
2.5 产品原理
2.5.1 坐标映射
由于激光雷达封装的数据包仅为水平旋转角度和距离参量,为了呈现三维点云图的效果,将极坐标下的角度和距离信息转化为了笛卡尔坐标系下的 x, y, z 坐标,它们的转换关系如下式所示:
其中
- \(r\) 为实测距离
- \(\omega\) 为激光的垂直角度
- \(\alpha\) 为激光的水平旋转角度
- \(R\) 为光心到原点的平面半径
- \(Z\) 为光心到原点的 Z 轴高度
- \(x, y, z\) 为极坐标投影到笛卡尔 X, Y, Z 轴上的坐标
2.5.2 反射强度解读
Airy 激光雷达提供了反射强度信息来表征被测物体的反射率。在 Airy 数据中,标定后的反射强度范围区间为 1 ~ 255(该范围区间为 RoboSense 产品自定义的对目标反射率探测的数值)。
2.5.3 回波模式
2.5.3.1 回波模式原理
Airy 支持多种回波模式,包括最强回波 (Strongest Return)、最后回波 (Last Return)、及最近回波 (First Return) 模式。
Airy 分析接收到的多个返回值,并根据用户选择分别输出最强、最后、最近一个回波值。若设置为最强回波模式,则仅输出最强的反射回波值;若设置为最后回波模式,则仅输出时域上检测到的最后回波。
2.5.3.2 回波模式标志
Airy 出厂默认为最强回波 (Strongest Return) 模式,如若用户需更改设置,可在 Web 端中产品回波模式参数设定进行配置。在 DIFOP 中第 300 个 byte 是回波模式的标志位。
表2 回波模式和标志位对照表
| DIFOP Offset | 标志位 | 回波模式 |
|---|---|---|
| 1 | 00 | 最强回波 |
| 01 | 最近回波 | |
| 02 | 最后回波 |
2.5.4 相位锁定
Airy 相位锁定功能可用于设定 Airy 在整秒时刻,传感器旋转到特定的角度发射激光。
图 3 展示了 Airy 在不同相位角度下的设定示意,红色箭头表示在整秒时刻,传感器旋转到 \(0^\circ\)、\(135^\circ\) 和 \(270^\circ\) 发射激光,坐标系细节参见图 11。

图3 Airy 不同相位设定示意图
Web 端 Setting > Phase Lock Setting 中提供了一个"Phase Lock"的参数设定,可用于设定锁定的相位角度,输入范围为 0~360 的整数,详情参见产品手册章节 4.2
2.5.5 时间同步方式
Airy 支持 GPS + PPS、PTP(IEEE 1588 V2 协议)、gPTP(IEEE 802.1 AS 协议)三种同步方式,用户可在 Web 端进行设置,详情参见产品手册章节 4.2
2.5.5.1 GPS 时间同步原理
GPS 模块连续向产品发送 GPRMC 数据和 PPS 同步脉冲信号,PPS 同步脉冲长度为 20~200 ms,GPRMC 数据必须在 PPS 同步脉冲下降沿后 10 ms 之后发射,在下一个 PPS 同步脉冲上升沿前 300 ms~500 ms 之间完成(建议 GPRMC 数据在两个 PPS 脉冲信号的正中间发送)。时序图如图 4 所示。

图4 GPS 时间同步时序图
提示
为确保时间同步的准确性,建议将 PPS 的脉宽设置在 20~200 ms 之间。GPRMC 的完成时间建议为 PPS 下降沿后 10 ms 和下一个 PPS 上升沿前 300~500 ms 之间。
2.5.5.2 GPS 时间同步使用
Airy 激光雷达 GPS 接口电平协议为 RS232 电平标准,详情参见表 3
表3 产品授时引脚定义
| 通讯方式 | 接收引脚定义 | |
|---|---|---|
| GPS GPRMC | GPS PULSE | |
| RS232 | 接 GPS 模块输出的 RS232 电平标准的串口数据 | 接 GPS 模块输出的正同步脉冲信号,电平要求 3.0 ~ 15.0 V |
外接的 GPS 模块需要设置输出串口的波特率为 9600 bps,数据位 8 bits,无校验位,停止位 1 bit。Airy 只读取 GPS 模块发出的 GPRMC 格式的数据,其标准格式如下:
$GPRMC,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>,<9>,<10>,<11>,<12>*hh
<1>UTC 时间<2>定位状态,A=有效定位,V=无效定位<3>纬度<4>纬度半球 N(北半球)或 S(南半球)<5>经度<6>经度半球 E(东经)或 W(西经)<7>地面速率<8>地面航向<9>UTC 日期<10>磁偏角<11>磁偏角方向,E(东)或W(西)<12>模式指示 (A=自主定位, D=差分, E=估算, N=数据无效)
* 后 hh 为到 * 所有字符的异或和
Tip
- Airy 航插线上面的 GPS REC 接口规格为 SM2.54 插头,引脚定义如图 8 所示
- 1 PPS 脉冲的发送时间间隔需控制在 \(1 s \pm 200 \mu s\) 内
- GPRMC 消息中状态位必须在 A 有效的情况才允许进行时间同步授时
- 目前市场的 GPS 模块发出的 GPRMC 消息长度存在不一致情况,本产品可兼容市场上大部分 GPS 模块发出来的 GPRMC 消息格式,如果在使用过程中发现不兼容的情况,请联系 RoboSense
2.5.5.3 PTP 同步原理
PTP(Precision Time Protocol,IEEE 1588V2 协议)是一种时间同步的协议,其本身只是用于设备之间的高精度时间同步,但也可被借用于设备之间的频率同步。相比现有的各种时间同步机制,PTP 具备以下优势:
- 相比 NTP(Network Time Protocol,网络时间协议),PTP 能够满足更高精度的时间同步要求,NTP 一般只能达到亚秒级的时间同步精度,而 PTP 则可达到亚微秒级;
- 相比 GPS(Global Positioning System,全球定位系统),PTP 具备更低的建设和维护成本。
2.5.5.4 gPTP 同步原理
gPTP (general Precise Time Protocol, IEEE802.1AS 协议) 是 PTP 在时效性网络(Time-Sensitive Networking)的派生协议。同步机制采用和 PTP 协议一致的 P2P 端延迟机制(Peer Delay Mechanism),同时采用以太网 L2 层通信。与 PTP 不同,gPTP 要求使用硬件方式打时间戳,即硬件时间戳,所以对于交换机和 Master 时钟要求较为严苛,需满足 IEEE802.1AS 协议。
2.5.5.5 PTP/gPTP 接线方式
使用 PTP / gPTP 同步方式,需要做以下准备:
- 在 Web 端中选择 PTP / gPTP 模式
- PTP Master / gPTP Master 授时主机(即插即用,无需额外配置)
- 以太网交换机
- 支持 PTP / gPTP 协议的待授时设备
提示
- Master 授时设备属于第三方设备,RoboSense 出货时不包含此配件,需用户自行采购;
- RoboSense 产品作为 Slave 设备只获取 Master 发出的时间,不对 Master 时钟源的准确度判断,若解析激光雷达点云时间出现突变,请检查 Master 提供的时间是否准确;
- 激光雷达同步之后,Master 断开连接,点云数据包中的时间则会按照激光雷达内部时钟进行叠加,激光雷达断电重启后才会被重置。
3 产品安装
3.1 配件说明
Airy 出货配件清单如表 4 所示,清单仅供参考。
表4 Airy 配件清单
| 序号 | 配件名称 | 规格 | 数量 |
|---|---|---|---|
| 1 | 激光雷达 LiDAR |
Airy | 1 |
| 2 | 螺丝包 Screw Pack |
M3*8 | 3 |
| 3 | 螺丝包(选配) Screw Pack |
M3*12 | 3 |
| 4 | 航插连接线(选配) Aviation Connector Cable |
1.5m | 1 |
| 5 | 电源适配器(选配) Power Adapter |
DC12 V × 3.34 A / 40 W | |
| 6 | 电源线(选配) Power Cable |
1.2 m | |
| 7 | 网线(选配) Ethernet Cable |
1.5 m | 1 |
| 8 | 产品包装清单和出货检验报告 Product Packing List and Shipment Inspection Report |
/ | 1 |
提示
如特殊要求请以商务协议为准
3.2 机械安装
激光雷达的结构安装图如图 5 所示。

图5 激光雷达结构安装示意图
1. 螺丝规格
- GB/T70.1,M3×8,内六角杯头,强度等级10.9,带耐落
2. 安装要求
- 安装面平面度应优于 0.15 mm
- 底面用 3 个 M3 螺钉安装,出安装面 4~5 mm,推荐锁紧扭矩 \(13 \pm 1\) kgf·cm
- 底面用 2 个 Φ3 定位销进行安装定位,出安装面 3 mm
- 激光雷达安装的时候,如果激光雷达上下面都有接触式的安装面,请确保安装面之间的间距大于激光雷达高度,避免挤压激光雷达
- 激光雷达安装走线时,请勿使激光雷达接线线缆太过紧绷(预留 2 cm 以上安装裕量),确保线缆具有一定的松弛度

图6 激光雷达底部定位孔及螺钉孔示意图
3. 支架刚度和强度要求
- 固定支架需有较好的刚性用于安装固定激光雷达,并在各种工况下保持激光雷达处于一个稳定的状态,因此要求激光雷达及其固定支架整体的一阶模态频率至少大于 \(50 Hz\)
- 激光雷达在使用过程中会经受各种随机振动、机械冲击等工况。在这些工况下,支架需承受较大的负载,因此支架还需有足够的强度。支架材质建议使用铝合金(厚度 4 mm 以上)或镀锌钢板(厚度 2 mm 以上),同时在各个方向尽可能增加加强筋以提高其刚度和强度,尽量避免设计出现尖角或小于 0.3 mm 的圆角、缺口等易产生应力集中的结构,支架强度需要经过仿真校核
4. 散热要求
- 支架材料建议采用导热系数大于 \(50 W/m \cdot K\) 的铝合金或者镀锌钢板等材料,尽量在支架上做一些散热鳍片,并合理的控制鳍片间距、高度和方向,尽量增大散热面积,方向上与空气对流方向一致,可以更有效散热
- 激光雷达底座或顶盖部位,确保不被非金属材质包覆,以免影响整机散热,造成激光雷达温升过高
- 若客户安装方式对散热不友好,或者无法确定散热状态是否 OK,请提前与我司 FAE 沟通,确定好散热方案,避免雷达过热导致影响产品性能或寿命
3.3 接口说明
3.3.1 航插接口及定义
Airy 激光雷达侧的航插头,如图 7 所示。

图7 航插接口引脚序号
雷达侧的航插接口上具体引脚定义参见表 5。
表5 航插接口引脚定义
| 引脚编号 | 规格 | 信号 |
|---|---|---|
| 1 | 26AWG | 2P(RX+) |
| 2 | 26AWG | 2N(RX-) |
| 3 | 26AWG | 1P(TX+) |
| 4 | 26AWG | 1N(TX-) |
| 5 | 26AWG | GND |
| 6 | 26AWG | VIN |
| 7 | 26AWG | VIN |
| 8 | 26AWG | GND |
| 9 | 30AWG | GPS PPS |
| 10 | 30AWG | SYNC_OUT1 |
| 11 | 30AWG | GPS GPRMC |
3.3.2 连接线(选配)
Airy 选配附件连接线如下图示:

图8 连接线示意图
连接线各接口规格详情参见表 6。
表6 航插线接口规格
| A 端序号 | 芯线规格 | 芯线定义 | A 端颜色 | B 端序号 | C 端序号 | D 端序号 | D 端颜色 |
|---|---|---|---|---|---|---|---|
| 1 | 26AWG | 2P(RX+) | 橙白色 | \ | 1 | \ | \ |
| 2 | 26AWG | 2N(RX-) | 橙色 | \ | 2 | \ | \ |
| 3 | 26AWG | 1P(TX+) | 绿白色 | \ | 3 | \ | \ |
| 4 | 26AWG | 1N(TX-) | 绿色 | \ | 6 | \ | \ |
| 5 | 26AWG | GND | 黑色 | 2 | \ | \ | \ |
| 6 | 26AWG | VIN | 红色 | 1 | \ | \ | \ |
| 7 | 26AWG | VIN | 红色 | 1 | \ | \ | \ |
| 8 | 26AWG | GND | 黑色 | 2 | \ | 4 | 黑色 |
| 9 | 30AWG | GPS PPS | 紫色 | \ | \ | 3 | 紫色 |
| 10 | 30AWG | SYNC_OUT1 | 蓝色 | \ | \ | 2 | 蓝色 |
| 11 | 30AWG | GPS GPRMC | 黄色 | \ | \ | 1 | 黄色 |
3.3.3 电源接口
Airy 电源接口使用标准 DC 5.5 - 2.1 接口。
若连接电源后,雷达电机不转动,可能是线束损坏,请联系 Robosense
重要
- 本机接地方式:本雷达采用机壳与内部电路板共地设计。
- 安装环境建议:当安装环境中的设备外壳为浮地状态时,为确保设备正常工作并防止潜在干扰,建议通过非金属绝缘件或其他方式,使雷达外壳与设备外壳之间实现电气隔离。
3.3.4 RJ45 网口
Airy 网络接口遵循 EIA / TIA568B 标准。
3.3.5 同步接口
Airy 同步接口定义:
- GPS REC 为 GPS GPRMC 输入
- GPS PULSE 为 GPS PPS 输入
重要
Airy 的"地"与外部系统连接时,外部系统供电电源负极("地")与 GPS 系统的"地"必须为非隔离共地系统。
3.4 快速连接
Airy 网络参数可配置,出厂默认采用固定 IP 和端口号模式,详情参见表 7。
表7 出厂默认网络配置表
| 设备 | IP 地址 | MSOP 包端 口号 |
DIFOP 包端 口号 |
|---|---|---|---|
| Airy | 192.168.1.200 | 6699 | 7788 |
| 电脑 | 192.168.1.102 |
用户使用产品时,需要把电脑的 IP 设置为与产品同一网段上,例如 192.168.1.x (x 的取值范围为 1~254),子网掩码为 255.255.255.0。未知产品网络配置信息,请连接产品并使用 Wireshark 抓取产品输出包进行分析。配置 IP 与连接方式如下:
1. 连接激光雷达
连接方式如图 9 所示。

图9 雷达航插线连接示意图
- 激光雷达通过航插头转连接接口
- PC 与航插线间通过 RJ45 网口接头进行连接
- 通电后,激光雷达即可正常工作
2. 通过 Wireshark 抓包,解析 ARP 报文进行本地 IP 配置

图10 解析 ARP 报文
- 如上步骤,激光雷达与 PC 完成连接后,启动 Wireshark(第三方网络解析工具),选择正确的网口,开始抓包
- 通过 Wireshark 的搜索框,输入 "arp" 进行搜索激光雷达与 PC 间的互相寻址报文,如图 10 所示
- Source 列中的 SutengIn 字样为激光雷达的信息源,提示 192.168.1.200 为 Source IP,即为激光雷达 IP,再请求访问 192.168.1.102,即为 PC IP
3. 配置 PC 的本地 IP
- 在控制面板中,通过"网络与 Internet"进入"网络与共享中心",在"查看活动网络"内容中,点击对应的以太网连接,进入对应的"以太网状态",点击其中的"属性"设置
- 双击 Internet 协议版本 4(TCP/IPv4),进入 IP 信息设置,使用静态 IP 进行配置
- 将本地 IP 地址设置为 192.168.1.102,子网掩码 255.255.255.0,点击"确认",完成 PC 的静态 IP 设置
4. 连接完成
提示
- 时间同步模块(PTP & gPTP、GPS 时间同步模块)非出厂标配产品,如需使用相关功能,请自行购买
- 以上配置本地静态 IP 仅以 Windows 系统操作为例,其它操作系统请以实际为准
4 产品使用
4.1 产品坐标系
产品的坐标及旋转方向如图 11 所示。关于激光雷达坐标原点数值以及 IMU 的外参,可以通过 SDK 或者 DIFOP 的对应字段获取。

图11 激光雷达坐标及旋转方向示意图
提示
激光雷达的坐标原点定义在激光雷达底座中心处
4.2 Web 端使用
4.2.1 Web 端功能
Airy 支持通过网页端对产品进行参数设定、运行信息/状态查看及固件升级等操作。
Airy Web 地址跟随 Device IP 变化而变化,出厂默认 Device IP 为 192.168.1.200,若用户更改过 Device IP,则 Web 地址变更为新设定的 IP 地址。
4.2.2 访问 Web 端
产品按照要求连接及正确配置完成后,使用连接激光雷达的电脑浏览器访问产品 IP 地址(默认 Device IP:192.168.1.200)进入激光雷达 Web 首页,首页默认为"Device"栏。
4.2.3 使用 Web 端
关于使用 Web 进行操作详情参见产品手册附录 A。
4.3 RSView 使用
在 Airy 的数据的检测上,可使用 Wireshark 和 tcp-dump 等免费工具获取原始数据,而 RSView 可帮助用户更为便捷地实现对原始数据的可视化。
4.3.1 软件功能
RSView 提供将 Airy 数据进行实时可视化的功能。RSView 也能回放保存为 ".pcap" 文件格式的数据,但是目前还不支持 ".pcapng" 格式的文件。
RSView 将 Airy 得到距离测量值显示为一个点。它能够支持多种自定义颜色来显示数据,例如反射强度、时间、距离、水平角度和激光线束序号。所显示的数据能够导出保存为 ".csv" 格式,RSView 3.1.3 以后的版本支持导出 ".las" 格式的数据。
RSView 包含以下功能:
- 通过以太网实时显示数据
- 将实时数据记录保存为 PCAP 文件
- 从记录的 PCAP 文件中回放
- 不同类型可视化模式,例如距离、时间、水平角度等等
- 用表格显示点的数据
- 将点云数据导出为 CSV 格式文件
- 测量距离工具
- 将回放数据的连续多帧同时显示
- 显示或者隐藏 Airy 中个别线束
- 裁剪显示
4.3.2 安装 RSView
RSView 支持在 Windows 64 位、Ubuntu 18.04 以上操作系统上运行。可从 Robosense 的官网(http://www.robosense.cn/resources)下载最新版本 RSView 软件压缩包。下载后,软件的解压路径请勿出现中文字符,软件无需安装,解压后运行可执行文件即可正常使用。
4.3.3 使用 RSView
打开 RSview 后,在软件界面,可通过 F1 按钮打开软件使用指南,或通过点击软件菜单栏 Help 选项中的 RS-LiDARUserGuide 进行查阅。
4.4 通信协议
Airy 与电脑之间的通信采用以太网介质,使用 UDP 协议,和电脑之间的通信协议主要分为两类,详情参见表 8。
表8 产品协议一览表
| (协议/包)名称 | 简写 | 功能 | 类型 | 包大小 | 发送间隔 |
|---|---|---|---|---|---|
| Main Data Stream Output Protocol | MSOP | 扫描数据输出 | UDP | 1248 bytes | 约 444.44 us |
| Device Information Output Protocol | DIFOP | 产品信息输出 | UDP | 1248 bytes | 约 1 s |
提示
- 产品手册 4.4 节皆为对协议中的有效载荷(1248 bytes)部分进行描述和定义
- 主数据流输出协议 MSOP,将激光雷达扫描出来的距离,角度,反射强度等信息封装成包输出
- 产品信息输出协议 DIFOP,将激光雷达当前状态的各种配置信息输出
4.4.1 MSOP 与 DIFOP 数据协议

图12 激光雷达数据结构图
4.4.2 主数据流输出协议(MSOP)
主数据流输出协议:Main data Stream Output Protocol,简称:MSOP
- I/O 类型:产品输出,电脑解析
- 出厂默认端口号:6699
4.4.2.1 帧头
帧头 Header 共 42 bytes,用于识别出数据的开始位置。
表9 MSOP Header 数据表
| 信息 | Offset | 长度 (byte) | 释义 | 总长度 (byte) |
|---|---|---|---|---|
| pkt_head | 0 | 4 | 0x55AA055A | 42 |
| REV0 | 4 | 8 | / | |
| pktcnt | 12 | 4 | 发送包循环计数:0-65535 | |
| REV1 | 16 | 4 | / | |
| timestamp | 20 | 10 | 时间戳,前 6 byte 表示秒,后 4 byte 表示微秒 | |
| REV2 | 30 | 1 | / | |
| lidar_type | 31 | 1 | 0x31: airy | |
| lidar_model | 32 | 1 | 0x02:96 线 | |
| REV3 | 33 | 9 | / |
提示
定义的时间戳用来记录系统的时间,分辨率为 \(1 \mu s\),具体参见产品手册附录 C.9 中的时间定义。
4.4.2.2 数据块区间
如表 10 所示,数据块区间 Data block 是 MSOP 包中传感器测量值部分,共 1184 bytes。它由 8 个 Data block 组成,每个 block 长度为 148 bytes。
Data block 中 148 bytes 的空间包括:2 bytes 的标志位,使用 0xffee 表示;2 bytes 的 Azimuth,表示水平旋转角度信息,每个角度信息对应着 48 个的 channel data。
表10 Data Block 数据包定义
| 说明 | 数据块 (1184 bytes) | ||||
|---|---|---|---|---|---|
| 数据块序号 | Data Block 1 | Data Block 2 | … | Data Block 7 | Data Block 8 |
| 标志位 | 0xffee | 0xffee | … | 0xffee | 0xffee |
| 水平旋转角 | Azimuth 1 | Azimuth 1 | … | Azimuth 2 | Azimuth 2 |
| 通道 1 | Channel Data 1 | Channel Data 49 | … | Channel Data 1 | Channel Data 49 |
| 通道 2 | Channel Data 2 | Channel Data 50 | … | Channel Data 2 | Channel Data 50 |
| … | … | … | … | … | … |
| 通道 48 | Channel Data 48 | Channel Data 96 | … | Channel Data 48 | Channel Data 96 |
1. 通道数据定义
通道数据 Channel data 是 3 bytes,高两字节用于表示距离信息,低一字节用于表示反射强度信息。
表11 Channel Data 示意表
| 通道数据(3 bytes) | ||
|---|---|---|
| 2 bytes Distance | 1 byte Reflectivity | |
| Distance1 [15:8] | Distance2 [7:0] | Reflectivity(反射强度信息) |
Tip
Distance 是 2 bytes,分辨率为 0.5 cm

图13 MSOP 包示意图
红色框:Header ID
绿色框:LiDAR Type 和 LiDAR Model
蓝色框:Data Block 标志位
黑色框:Channel Data 1 的 Azimuth 值
黄色框:Channel Data 1 的 Distance 值
橙色框:Channel Data 1 反射强度值
数据包的距离值计算
- 数据包里的距离值的十六进制数:0x01, 0x0D
- 将数据组成 16 bits,为 16 bits 无符号整型数据。表示为:0x010D
- 距离值转换为十进制数字:269,根据距离分辨率不同,进行计算
- 结果 \(269 \times 0.5 cm = 134.5 cm = 1.345 m\)
数据包的角度值计算
- 数据包里的角度值得十六进制数:0x00,0x8B
- 将数据组成 16 bits,为 16 bits 无符号整型数据。表示为:0x008B
- 转换为十进制数字:139,将转化成十进制后的数据除以100
- 结果 \(139^\circ / 100 = 1.39^\circ\)
数据包的反射强度值计算
- 数据包里的反射强度值得十六进制数:0x6E
- 转换为十进制数字:110
- 结果得到反射强度值为 110
2. 角度值定义
在每个 Block 中,Airy 输出的角度值是该 Block 中第一个通道激光测距时的角度值。角度值来源于角度编码器,角度编码器的零位即角度的零点,水平旋转角度值的分辨率为 \(0.01^\circ\)
4.4.2.3 帧尾
帧尾(Tail)长度 6 bytes,4 bytes 位预留信息,2 bytes 的 0x00,0xFF。
4.4.3 产品信息输出协议(DIFOP)
产品信息输出协议,Device Info Output Protocol,简称:DIFOP
- I/O 类型:产品输出,电脑读取
- 默认端口号:7788
DIFOP 是为了将产品序列号(S/N)、固件版本信息、上位机驱动兼容性信息、配置信息、角度信息、运行状态、故障诊断等信息,定期发送给用户的"仅输出"协议,用户可以通过读取 DIFOP 解读当前使用产品的各种参数的具体信息。
一个完整的 DIFOP Packet 的数据格式结构为同步帧头,数据区,帧尾。每个数据包共 1248 bytes。
表12 DIFOP Packet 的数据格式结构
| 序号 | 信息 | Offset | 长度 (byte) | 说明 |
|---|---|---|---|---|
| 1 | DIFOP 帧头 | 0 | 8 | 0xA5 0xFF 0x00 0x5A 0x11 0x11 0x55 0x55 |
| 2 | 电机设置转速 | 8 | 2 | 附录 C.1 |
| 3 | 以太网 IP 源地址 | 10 | 4 | 附录 C.2 |
| 4 | 以太网 IP 目标地址 | 14 | 4 | |
| 5 | 雷达 MAC 地址 | 18 | 6 | |
| 6 | MSOP 端口 | 24 | 2 | |
| 7 | 预留 | 26 | 2 | |
| 8 | DIFOP 端口 | 28 | 2 | |
| 9 | 预留 | 30 | 10 | |
| 10 | 主板固件版本 | 40 | 5 | 附录 C.3 |
| 11 | 底板固件版本 | 45 | 5 | 附录 C.4 |
| 12 | APP 固件版本 | 50 | 5 | 附录 C.5 |
| 13 | 电机固件版本 | 55 | 5 | 附录 C.6 |
| 14 | 预留 | 60 | 229 | |
| 15 | 产品序列号 | 292 | 6 | 附录 C.7 |
| 16 | 预留 | 298 | 2 | |
| 17 | 回波模式 | 300 | 1 | |
| 18 | 时间同步方式设置 | 301 | 1 | 附录 C.8 |
| 19 | 时间同步状态 | 302 | 1 | |
| 20 | 时间 | 303 | 10 | 附录 C.9 |
| 21 | 预留 | 313 | 60 | |
| 22 | 电机实时转速 | 373 | 2 | 附录 C.10 |
| 23 | 预留 | 375 | 93 | |
| 24 | 垂直角校准 | 468 | 288 | 附录 C.11 |
| 25 | 水平角校准 | 756 | 288 | 附录 C.12 |
| 26 | 主板总输入电压 | 1044 | 2 | 附录 C.13 |
| 27 | 预留 | 1046 | 20 | |
| 28 | 整机输入电压 | 1066 | 2 | 附录 C.14 |
| 29 | 底板 12V 电压 | 1068 | 2 | 附录 C.15 |
| 30 | 预留 | 1070 | 10 | |
| 31 | 主板发射温度 | 1080 | 2 | 附录 C.16 |
| 32 | 预留 | 1082 | 10 | |
| 33 | IMU 标定数据 | 1092 | 28 | 附录 C.17 |
| 34 | 预留 | 1120 | 126 | 预留 |
| 35 | 帧尾 | 1246 | 2 | 0x0F 0xF0 |
提示
- Header(DIFOP 识别头)内容为 0xA5, 0xFF, 0x00, 0x5A, 0x11, 0x11, 0x55, 0x55,可作为包的检查序列
- Tail 帧尾内容为 0x0F, 0xF0
- 每一项信息的寄存器的定义以及使用参见产品手册附录 A 中的详细描述,对应关系见表 12 备注栏内容。
4.4.4 IMU 数据流输出协议
- I/O 类型:产品输出,电脑解析
- 出厂默认端口号:6688
IMU 输出的为产品内部 IMU 的姿态信息,可用于客户产品外参调整。一个完整的 IMU Packet 的数据格式结构为帧头,数据区,帧尾。每个数据包共 51 bytes。
表13 IMU 数据格式结构
| 序号 | 信息 | Offset | 长度 (byte) | 说明 | 备注 |
|---|---|---|---|---|---|
| 1 | IMU 帧头 | 0 | 4 | 0xAA 0x55 0x5A 0x05 | |
| 2 | 时间 | 4 | 10 | UTC 时间格式,前 6 个 byte 为秒时间戳,后 4 个 byte 为微秒时间戳。 | |
| 3 | AccelX | 14 | 4 | X 轴加速度值,有符号,原始值 |
原始值转换为实际值跟量程有关,如量程为+/-16g,则实际加速度值为: 原始值*16/32768(单位 g) g 值为 9.80665m/s² |
| 4 | AccelY | 18 | 4 | Y 轴加速度值,有符号,原始值 | 同上 |
| 5 | AccelZ | 22 | 4 | Z 轴加速度值,有符号,原始值 | 同上 |
| 6 | GyroX | 26 | 4 | X 轴角速度值,有符号,原始值 | 原始值转换为实际值跟量程有关,如量程为+/-2000 dps,则实际角速度值为:原始值*2000/32768*PI/180(单位 rad/s) |
| 7 | GyroY | 30 | 4 | Y 轴角速度值,有符号,原始值 | 同上 |
| 8 | GyroZ | 34 | 4 | Z 轴角速度值,有符号,原始值 | 同上 |
| 9 | 内部温度 | 38 | 4 | IMU 内部温度,有符号,分辨率 0.01 度 | |
| 10 | ODR | 42 | 1 | 数据输出频率 |
0: 25Hz 1: 50Hz 2: 100Hz 3: 200Hz 4: 1000Hz |
| 11 | AccelFsr | 43 | 1 | 加速度计量程 |
0: +/- 2g 1: +/- 4g 2: +/- 8g 3: +/- 16g |
| 12 | GyroFsr | 44 | 1 | 陀螺仪量程 |
0: +/- 250 dps 1: +/- 500 dps 2: +/- 1000 dps 3: +/- 2000 dps |
| 13 | 包计数 | 45 | 4 | u32 类型,由 1 开始 | |
| 14 | 帧尾 | 49 | 2 | 0xF0 0x0F |
5 故障诊断
本章列举了部分在使用产品的过程中常见的问题以及对应的问题排查方法。
表14 常见故障排查方法表
| 故障现象 | 解决方法 |
|---|---|
| 产品电机不旋转 | 检查航插线电源/产品端的连接线是否松动及线束破损。 |
| 产品在启动时不断重启 |
检查输入电源连接和极性是否正常; 检查输入电源的电压和电流是否满足要求(12 V 电压输入条件下,输入电流 ≥ 2 A); 检查产品安装平面是否水平或激光雷达底部固定螺丝是否拧的太紧。 |
| 产品内部旋转,但是没有数据 |
检查激光是否正常发射; 检查网络连接是否正常; 确认电脑端网络配置是否正确; 使用另外的软件(例如 Wireshark)检查数据是否有被接收; 关闭防火墙和其它可能阻止网络的安全软件; 检查电源供电正常; 尝试重启产品。 |
| Wireshark 可以收到数据但是 RSView 不显示点云 |
关闭电脑防火墙,并且运行 RSView 通过防火墙; 确认电脑的 IP 配置和产品设置的目的地址一致; 确认 RSView 中 Sensor Network Configuration 设置正确; 确认 RSView 安装目录或配置文件存放目录不包含任何中文字符; 确认 Wireshark 中收到的数据包是 MSOP 类型的包。 |
| 产品存在频发的数据丢失 |
确认网络中是否有大量的其它网络数据包或网路冲突; 确认网络中是否存在其它网络产品以广播模式发送大量数据造成传感器数据阻塞; 确认电脑的性能和接口性能是否满足要求; 移除其它所有网络产品,直连电脑确认是否存在丢包现象。 |
| 无法同步 GPS/PTP/gPTP 时间 |
1. 确认已在网页端将同步模式切换到正确模式下; 2. 在 GPS+PPS 时间同步方式下: - 确认 GPS 模块波特率为 9600 bps,8 bits 数据位,无校验位,停止位 1; - 确认 GPS 模块输出为 3.3 V TTL 还是 RS232 电平; - 确认 1 PPS 脉冲连续且接线正确; - 确认 GPRMC 的 NMEA 消息格式正确; - 确认 GPS 模块和航插线共地; - 确认 GPS 模块收到了有效的解; - 确认 GPS 模块是否为有效定位(室外); 3. 在 PTP / gPTP 时间同步方式下: - 确认 PTP / gPTP Master 同步协议是否符合当前 PTP / gPTP 协议; - 确认 PTP / gPTP Master 是否正常工作。 |
| 产品通过路由器后无数据输出 | 关闭路由器的 DHCP 功能或在路由器内部设置传感器的 IP 为正确的 IP。 |
| ROS 驱动显示点云时有固定的空白区域不断旋转 | 此现象正常,是因为 ROS 驱动按照固定包数进行分帧显示,空白部分的数据会在下一帧进行显示。 |
| RSView 软件输出点云成一条射线 | 如果是 Windows 10 系统请设置 RSView 使用 Windows 7 兼容模式运行。 |
6 产品维护
6.1 运输与物流
运输不当会导致产品损坏
- 应采用防震防潮包装材料包装产品,以避免运输途中损毁。建议使用原始包装;
- 运输过程务必小心轻放,避免磕碰、摔落等危险行为;
- 每次运输收到货物时,必须详细检查交付货物清单与是否有损坏(含产品与包装);
- 如若有运输损坏,请拒绝收货,并及时联系 RoboSense
6.2 存储
Note
- 请将产品存储于室内常温、干燥的环境中;
- 请轻拿轻放,避免产品遭受磕碰、摔落等;
- 产品应存放于安全环境中,避免腐蚀、机械冲击及暴露于超过防护等级的环境中;
- 请定期检查所有组件和包装的状态,建议检查周期为 3 个月。
6.3 产品清洁
为了能够准确地感知周围环境 RS-LiDAR 需保持环形防护罩洁净。
6.3.1 注意事项
Note
- 请在清理 RS-LiDAR 前仔细并完整的阅读本节的内容,否则不当的操作可能会损坏产品。
- 激光雷达在环境比较恶劣的情况下使用时,需及时清理表面的脏污保持激光雷达清洁,否则会影响激光雷达的正常使用。
6.3.2 需要的材料
- 洁净的无尘布;
- 温度适中的中性溶液(如肥皂水、蒸馏水、99%浓度乙醇等)。
6.3.3 清洁方法
-
如果激光雷达的表面只是粘附了一些灰尘/粉尘:
- a. 首先用洁净的无尘布,蘸取少量的中性溶液;
- b. 其次轻轻地对激光雷达表面拭擦清洁;
- c. 最后用一块干燥洁净的无尘布将其擦干。
-
如果激光雷达表面沾上了泥浆等块状异物:
- d. 首先应使用洁净水喷洒在激光雷达脏污部位表面让泥浆等异物脱离(注意:不能直接用无尘布将泥浆擦掉,这样做可能会划伤表面特别是防护罩表面);
- e. 其次用温的肥皂水喷洒在脏污部位,因肥皂水的润滑作用可加速异物的脱离。再次用纤维布轻轻试擦激光雷达表面,但注意不要擦伤表面;
- f. 最后用洁净的水清洗激光雷达表面肥皂的残留(如果表面仍有残留,可用 \(99\%\) 乙醇对其再次清洁),同时用一块干燥的无尘布擦干即可。
7 售后
如果“故障诊断”章节未能解决问题,请及时联系 RoboSense
官网:https://www.robosense.cn/contact
邮箱:support@robosense.cn
电话:0755-86325830/15338772453
提示
- 请在收到 RoboSense 售后服务回信确认后,再寄回产品;
- 产品只能使用原包装或等效的软垫防潮包装寄。
附录 A Web 端操作
A.1 产品信息
激光雷达 Web 端默认为产品信息页,如图所示。

- Top Board Firmware Version 为主板固件版本
- Bottom Board Firmware Version 为底板固件版本
- Software Version 为软件版本
- Motor Firmware Version 为电机版本
- S/N 为产品序列号
- Mac Address 为 MAC 地址
- Model 为产品名称
A.2 产品参数设定
A.2.1 General Setting
网页端 "General Setting" 栏为激光雷达基本参数设定页,在此处可更改 Device IP、端口号、回波模式及角度触发等功能设定,如图所示。

- 支持单播(默认)/广播模式,将 Destination IP 设置为 255.255.255.255 则为广播模式,默认出厂为 192.168.1.102
- 可更改 MSOP 和 DIFOP 的数据端口,值范围 1025 ~ 65535
- 可下拉 "Return Mode" 选最强回波(默认),最近回波,最远回波
- 可下拉"Time Synchronization Source"选择 GPS、PTP-E2E、PTP-P2P、PTP-GPTP 和 PTP-E2E-L2 确定时间同步方式
- 可更改 PTP 的时间同步域(对应时间同步报文的 domainNumber 字段),值范围 0~127
- 可下拉 "Respond To PeerDelayRequest" 选择 OFF(默认)和 ON 确定是雷达作为 slave 是否响应其他节点的 peer delay request 请求消息
- 可下拉 "No Leap Second" 选择 OFF(默认)和 ON 确定是否响应 announce 报文的闰秒偏差设置
- 可更改设备因丢失授时 master 消息而导致退出时间同步状态的超时时间(默认 5s),值范围为 1~255 s
- 可更改设备由非同步状态切换到同步状态的与 master 之间的 offset 阈值(默认 1ms),值范围为 1~255 ms
- 可更改设备由同步状态切换到非同步状态的与 master 之间的 offset 阈值(默认 20ms),值范围为 1~255 ms
- 可下拉 "Operation Mode" 选择工作模式,分别为 Standby/High Performance(默认)二种工作模式,当选择 Standby 模式时,激光雷达电机和发射器停止工作
- 可更改设备 Phase lock 的角度,值范围为 0~360 Degree
- 可下拉 "GPS Baud Rate" 选择 GPS 波特率,分别为 9600(默认)、14400、19200、38400、43200、57600、76800、115200 八种选项
- 可下拉 "Imu Ctrl" 选择 OFF 和 ON(默认)确定是否开启对 IMU 功能的控制接口
- 可更改 IMU 的通信端口,值范围为 1025~65535
- 可下拉 "Imu Output Rate" 选择 25Hz/50Hz/100Hz/200Hz(默认)来更改 IMU 输出数据的消息输出频率
- 可下拉"Accel Range"选择 [-2g,2g]/[-4g,4g](默认)/[-8g,8g]/[-16g,16g]来更改 IMU 加速度计的最大加速度范围
- 可下拉 "Gyro Range" 选择 [-250,250]dps/[-500,500]dps(默认)/[-1000,1000]dps/[-2000,2000]dps 来更改 IMU 陀螺仪量程范围
- 可下拉 "Restore Default" 选择 OFF 和 ON 来确认是否启用恢复默认设置功能
A.2.2 Performance Setting
网页端 "Performance Setting" 栏为激光雷达高级参数设定页,在此处可进行雷达的反射率表现、吸拖点滤除和雨雾检测等高级功能的设定,如图所示。

- 可下拉 "Reflectivity Enhancement" 选择 OFF(默认)和 ON 来确定是否开启反射率增强的功能
- 可下拉 "Trail Filter Level" 选择 1/2/3/4(默认)/5 来确认拖点滤除等级
- 可下拉 "Rain/Blockage Detection Distance" 选择 30cm(默认)/20cm/10cm 来确认雨天/遮挡检测距离
- 可下拉"Blockage Detection Sensitivity"选择 high(默认)/medium/low 来控制激光雷达对遮挡的敏感程度
- 可更改设备帧起始空洞角度偏移 Frame Start Angle,值范围为 0~360 Degree
- 可下拉 "Dead Zone 10cm Enable" 选择 On(默认)/Off 来选择是否打开盲区内的点云信息
- 可下拉 "Channel 81 85 89 93" 选择 On/Off(默认)来选择是否启用通道 81、85、89、93
- 可下拉 "Gap Filling Enable" 选择 On/Off(默认)来选择是否为每十帧 32 度的点云空洞进行信息弥补
A.2.3 Angle Pulse Setting
网页端 "Angle Pulse Setting"栏为激光雷达角度脉冲触发设定页,在此处可设定雷达的角度触发信号,如图所示。

- Trigger Mode:起始角模式有两种,模式1为起始脉宽增加25%,模式2为起始脉宽不增加(默认)
- Group:此栏为对应 SYNC OUT 组,Airy 内含 SYNC OUT1
- Pulse Trigger Switch: 开启/关闭触发功能,当 Pulse Trigger Switch 勾选 "ON" 开启后选项为可编辑状态,关闭时为灰色不可编辑状态
- Pulse Start Angle:可设置对应的起始角,输入值需为整数
- Pulse Width: 可设置对应的脉宽
- Pulse Step:可设置对应的步距,输入值需为浮点数,保留1位小数
Tip
- Device IP 和 Destination IP 需在同一网段,否则可能会导致无法正常连接
- MSOP、DIFOP 和 IMU 端口号值的范围为 1025 ~ 65535,且 MSOP 端口、DIFOP 端口和 IMU 端口不可设置为相同的值
- 更改完成后需点击"Save"进行保存,提示成功则表示设定生效
A.3 产品诊断/运行状态
此页可实时查看激光雷达运行状态,包括电压、电流、实时转速、运行时长及温度等信息,如图所示。

- 用户可查看 Machine Temperature 获取当前产品运行温度
- 用户可查看 RPM 获取产品当前实时转速信息
- 用户可查看 Phase 获取产品当前旋转相位
- Laser Status 有"On"(默认)和"Off"两种状态,用户设置 Standby 模式时为"Off"
- 用户可查看 Time Sync Mode 获取激光雷达的时间同步模式
- 用户可查看 Time Sync Data 获取激光雷达的时间同步数据
- 用户可查看 PPP Status 获取 PPS 状态
- 用户可查看 GPRMC Status 获取 GPRMC 状态
- 用户可查看 Time Sync Status 获取当前时间同步状态,Lock 表示已成功锁定,Unlock 表示时间同步尚未成功
- 用户可查看 Startup Times 获取当前产品总启动次数,每断电重启后会累加一次
- 用户可查看 Elapsed time 获取产品总运行时间和产品在各温度下累计工作时间
提示
- 本页刷新频率为 5 秒
- 若产品电压/电流框变红时,请检查产品当前是否为 Standby 模式,若不是则检查产品是否正常工作
A.4 产品固件升级
点击网页"System",此页可对产品的 App、底板、主板固件进行升级。
-
请联系 RoboSense 获得升级固件。准备好待升级的固件后,点击"选择文件",如图所示:

-
选择对应待升级固件的文件夹,选中待升级固件后点击"打开"(路径请勿出现中文字符),如图所示:

-
此时 web 界面会显示待升级固件文件名,选择对应的升级按钮则可升级对应固件,如图所示:

提示
- 升级包的格式为 Zip,web 的升级界面只支持上传 Zip 格式文件包
- 升级包名称需符合如下要求方可正常升级,否则会报错
- 主板升级文件:顺序逻辑必要后缀 ".bin"
- 底板升级文件:顺序逻辑必要后缀 ".bit"
- Web App 升级文件:顺序逻辑必要后缀 ".hs_fs"
附录 B ROS & ROS2 Package
rslidar_sdk 是 ROS 平台下的驱动 SDK,请通过 github 上的 RoboSense 主页下载,或联系 RoboSense 获取。
- rslidar_sdk 依赖 rs_driver,后者是 RoboSense 的基本驱动。rs_driver 请从 github 平台下载
- 如使用环境为 ROS2,rslidar_sdk 还依赖 rslidar_msg,这是 msg 定义文件。msg 文件请从 github 平台下载
- 驱动 SDK 下载包内含丰富的使用指引,请在使用驱动 SDK 前,详细阅读文件内的 README 文件及 doc 文件夹下的文档
提示
- SDK 获取地址:https://github.com/RoboSense-LiDAR/rsLiDAR_sdk
- rs_driver 获取地址:https://github.com/RoboSense-LiDAR/rs_driver
- msg 获取地址:https://github.com/RoboSense-LiDAR/rslidar_msg
附录 C DIFOP 数据定义
本附录内容补充章节 4.4.3 的 DIFOP 协议里各个信息定义的说明,便于用户对产品的使用和开发,涉及到计算部分,均采用大端模式,Value 代表对应 offset 字节换算后得出的十进制数值。
C.1 电机转速
MOT_SPD
表15 电机转速设置
| 电机转速设置(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | MOT_SPD | |
寄存器说明
- 该寄存器用于读取电机的转速设置值
- 如设置值为 600 RPM,读取 byte 1 = 0x02,byte 2 = 0x58,Value = 600
C.2 以太网
ETH
表16 以太网
| 以太网寄存器(共 30 bytes) | ||||||||
|---|---|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 | byte 7 | byte 8 |
| 功能 | LIDAR_IP | DEST_PC_IP | ||||||
| 序号 | byte 9 | byte 10 | byte 11 | byte 12 | byte 13 | byte 14 | byte 15 | byte 16 |
| 功能 | MAC_ADDR | MSOP | ||||||
| 序号 | byte 17 | byte 18 | byte 19 | byte 20 | byte 21 | byte 22 | byte 23 | byte 24 |
| 功能 | 预留 | DIFOP | 预留 | |||||
| 序号 | byte 25 | byte 26 | byte 27 | byte 28 | byte 29 | byte 30 | \ | \ |
| 功能 | 预留 | \ | ||||||
寄存器说明
- LIDAR IP 为激光雷达的源 IP 地址,占据 4 bytes
- DEST PC IP 为目的 PC 的 IP 地址,占据 4 bytes
- MAC_ADDR 为激光雷达的 MAC 地址
- MSOP与DIFOP分别占2 bytes,源端口号与目的端口号强制一致
C.3 主板固件版本
TOP_FRM
表17 主板固件版本
| 主板固件版本(共 5 bytes) | |||||
|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 |
| 功能 | TOP_FRM | ||||
寄存器说明
- 该寄存器用于读取主板固件版本号
- 如 byte 1=0x00,byte 2=0x10,byte 3=0x04,byte 4=0x0c,byte 5=0x00,则固件版本号为:00 10 04 0c 00
C.4 底板固件版本
BOT_FRM
表18 底板固件版本
| 底板固件版本(共 5 bytes) | |||||
|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 |
| 功能 | BOT_FRM | ||||
寄存器说明
- 该寄存器用于读取底板固件版本号
- 如 byte 1=0x00,byte 2=0x24,byte 3=0x12,byte 4=0x13,byte 5=0x12,则固件版本号为:00 24 12 13 12
C.5 APP 固件版本
SOF_FRM
表19 软件版本
| APP 固件版本(共 5 bytes) | |||||
|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 |
| 功能 | SOF_FRM | ||||
寄存器说明
- 该寄存器用于读取 APP 固件版本号
- 如 byte 1=0x00,byte 2=0x24,byte 3=0x12,byte 4=0x13,byte 5=0x12,则固件版本号为:00 24 12 13 12
C.6 电机固件版本
MOT_FRM
表20 电机固件版本
| 电机固件版本(共 5 bytes) | |||||
|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 |
| 功能 | MOT_FRM | ||||
寄存器说明
- 该寄存器用于读取电机固件版本号
- 如 byte 1=0x00, byte 2=0x24, byte 3=0x12, byte 4=0x12, byte 5=0x25,则固件版本号为:00 24 12 12 25
C.7 序列号
SN
表21 序列号寄存器
| 序列号(共 6 bytes) | ||||||
|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 |
| 功能 | SN | |||||
寄存器说明
- 该寄存器用于设备序列号
- 类似 mac 地址,共 6 bytes,以 16 进制表示产品序列号
C.8 时间同步信息
TIME_SYNC_INFO
表22 时间同步信息
| 时间同步信息(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | Time_Sync_Mode | Time_Sync_State |
寄存器说明
- 该寄存器用于读取时间同步信息
- byte 1 为时间同步模式状态位,定义如下:
- 0x00: GPS
- 0x01: E2E-L4
- 0x02: P2P
- 0x03: gPTP
- 0x04: E2E-L2
- byte 2 为时间同步成功状态位,定义如下:
- 0x00: 未同步
- 0x01: 同步成功
C.9 时间
UTC_TIME
表23 时间寄存器
| 时间寄存器(共 10 bytes) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 | byte 7 | byte 8 | byte 9 | byte 10 |
| 功能 | sec | us | ||||||||
寄存器说明
- 该寄存器用于读取时间信息
- us 值范围:0 ~ 999,999
C.10 电机实时转速
REALTIME_ROTATION_SPEED
表24 实时转速寄存器
| 实时转速寄存器(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | REALTIME_ROTATION_SPEED | |
寄存器说明
- 该寄存器用于读取电机实时转速信息
-
共 2 byte,以 16 进制表示
例如 byte 1=0x01,byte 2=0x28,电机实际转速转成十进制是 600
C.11 垂直角校准
COR_VERT_ANG
表25 垂直角校准寄存器
| 垂直角校准寄存器(共 288 bytes) | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 | byte 7 | byte 8 | byte 9 |
| 功能 | 1 通道垂直角度 | 2 通道垂直角度 | 3 通道垂直角度 | ||||||
| 序号 | byte 10 | byte 11 | byte 12 | byte 13 | byte 14 | byte 15 | byte 16 | byte 17 | byte 18 |
| 功能 | 4 通道垂直角度 | 5 通道垂直角度 | 6 通道垂直角度 | ||||||
| 序号 | byte 19 | byte 20 | byte 21 | byte 22 | byte 23 | byte 24 | byte 25 | byte 26 | byte 27 |
| 功能 | 7 通道垂直角度 | 8 通道垂直角度 | 9 通道垂直角度 | ||||||
| 序号 | byte 28 | byte 29 | byte 30 | byte 31 | byte 32 | byte 33 | byte 34 | byte 35 | byte 36 |
| 功能 | 10 通道垂直角度 | 11 通道垂直角度 | 12 通道垂直角度 | ||||||
| 序号 | byte 37 | byte 38 | byte 39 | byte 40 | byte 41 | byte 42 | byte 43 | byte 44 | byte 45 |
| 功能 | 13 通道垂直角度 | 14 通道垂直角度 | 15 通道垂直角度 | ||||||
| 序号 | byte 46 | byte 47 | byte 48 | byte 49 | byte 50 | byte 51 | byte 52 | byte 53 | byte 54 |
| 功能 | 16 通道垂直角度 | 17 通道垂直角度 | 18 通道垂直角度 | ||||||
| 序号 | byte 55 | byte 56 | byte 57 | byte 58 | byte 59 | byte 60 | byte 61 | byte 62 | byte 63 |
| 功能 | 19 通道垂直角度 | 20 通道垂直角度 | 21 通道垂直角度 | ||||||
| 序号 | ... | ... | ... | ||||||
| 功能 | ... | ||||||||
| 序号 | byte 262 | byte 263 | byte 264 | byte 265 | byte 266 | byte 267 | byte 268 | byte 269 | byte 270 |
| 功能 | 88 通道垂直角度 | 89 通道垂直角度 | 90 通道垂直角度 | ||||||
| 序号 | byte 271 | byte 272 | byte 273 | byte 274 | byte 275 | byte 276 | byte 277 | byte 278 | byte 279 |
| 功能 | 91 通道垂直角度 | 92 通道垂直角度 | 93 通道垂直角度 | ||||||
| 序号 | byte 280 | byte 281 | byte 282 | byte 283 | byte 284 | byte 285 | byte 286 | byte 287 | byte 288 |
| 功能 | 94 通道垂直角度 | 95 通道垂直角度 | 96 通道垂直角度 | ||||||
寄存器说明
- 角度值为区分为正负,每个通道的垂直角度由 3 bytes 组成,其中第 1 个 byte 表示正负,第 2 和第 3 个 byte 共同组成角度的值
- 表示正负的第 1 个 byte 属性为 0x00 则通道垂直角度为正值,属性为 0x01 则通道垂直角度为负值
- 角度分辨率为 \(0.01^\circ\)
- 例如通道 5 寄存器的值为 byte 1=0x00,为正数;byte 2=0x01,byte 3=0x71 转换成十进制 369。则通道 5 的垂直角度值为 \(3.69^\circ\)
C.12 水平偏移角校准
COR_HOR_ANG
表26 水平偏移角校准寄存器
| 水平偏移角校准寄存器(共 288 bytes) | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 | byte 7 | byte 8 | byte 9 |
| 功能 | 1 通道水平偏移角度 | 2 通道水平偏移角度 | 3 通道水平偏移角度 | ||||||
| 序号 | byte 10 | byte 11 | byte 12 | byte 13 | byte 14 | byte 15 | byte 16 | byte 17 | byte 18 |
| 功能 | 4 通道水平偏移角度 | 5 通道水平偏移角度 | 6 通道水平偏移角度 | ||||||
| 序号 | byte 19 | byte 20 | byte 21 | byte 22 | byte 23 | byte 24 | byte 25 | byte 26 | byte 27 |
| 功能 | 7 通道水平偏移角度 | 8 通道水平偏移角度 | 9 通道水平偏移角度 | ||||||
| 序号 | byte 28 | byte 29 | byte 30 | byte 31 | byte 32 | byte 33 | byte 34 | byte 35 | byte 36 |
| 功能 | 10 通道水平偏移角度 | 11 通道水平偏移角度 | 12 通道水平偏移角度 | ||||||
| 序号 | byte 37 | byte 38 | byte 39 | byte 40 | byte 41 | byte 42 | byte 43 | byte 44 | byte 45 |
| 功能 | 13 通道水平偏移角度 | 14 通道水平偏移角度 | 15 通道水平偏移角度 | ||||||
| 序号 | byte 46 | byte 47 | byte 48 | byte 49 | byte 50 | byte 51 | byte 52 | byte 53 | byte 54 |
| 功能 | 16 通道水平偏移角度 | 17 通道水平偏移角度 | 18 通道水平偏移角度 | ||||||
| 序号 | byte 55 | byte 56 | byte 57 | byte 58 | byte 59 | byte 60 | byte 61 | byte 62 | byte 63 |
| 功能 | 19 通道水平偏移角度 | 20 通道水平偏移角度 | 21 通道水平偏移角度 | ||||||
| 序号 | ... | ... | ... | ||||||
| 功能 | ... | ||||||||
| 序号 | byte 262 | byte 263 | byte 264 | byte 265 | byte 266 | byte 267 | byte 268 | byte 269 | byte 270 |
| 功能 | 88 通道水平偏移角度 | 89 通道水平偏移角度 | 90 通道水平偏移角度 | ||||||
| 序号 | byte 271 | byte 272 | byte 273 | byte 274 | byte 275 | byte 276 | byte 277 | byte 278 | byte 279 |
| 功能 | 91 通道水平偏移角度 | 92 通道水平偏移角度 | 93 通道水平偏移角度 | ||||||
| 序号 | byte 280 | byte 281 | byte 282 | byte 283 | byte 284 | byte 285 | byte 286 | byte 287 | byte 288 |
| 功能 | 94 通道水平偏移角度 | 95 通道水平偏移角度 | 96 通道水平偏移角度 | ||||||
寄存器说明
- 角度值为区分为正负,每个通道的水平偏移角度由 3 bytes 组成,其中第 1 个 byte 表示正负,第 2 和第 3 个 byte 共同组成角度的值
- 表示正负的第 1 个 byte 属性为 0x00 则通道水平偏移角度为正值,属性为 0x01 则通道水平偏移角度为负值
- 角度分辨率为 \(0.01^\circ\)
- 例如通道 5 寄存器的值为 byte 1=0x01,为负数;byte 2=0x00,byte 3=0xae 转换成十进制 174。则通道 5 的水平偏移角度值为 \(-1.74^\circ\)
C.13 主板总输入电压
MAINBOARD_VOLTAGE
表27 主板总输入电压
| 主板总输入电压(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | Mainboard Voltage | |
寄存器说明
- 该寄存器用于读取设备的主板输入电压
- 单位 V,电压值由 2 bytes 组成。计算公式:Mainboard Voltage = Value / 100
C.14 整机输入电压
MACHINE_VOLTAGE
表28 整机输入电压
| 整机总输入电压(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | Machine Voltage | |
寄存器说明
- 该寄存器用于读取设备的整机输入电压
- 单位 V,电压值由 2 bytes 组成。计算公式:Machine Voltage = Value / 100
C.15 底板 12V 电压
BASEBOARD_VOLTAGE
表29 底板 12V 电压
| 底板 12V 电压(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | Baseboard Voltage (12V) | |
寄存器说明
- 该寄存器用于读取设备的底板 12V 电压
- 单位 V,电压值由 2 bytes 组成。计算公式:Baseboard Voltage (12V) = Value / 100
C.16 主板发射温度
MAINBOARD_EMIT_TEMP
表30 主板发射温度
| 主板发射温度(共 2 bytes) | ||
|---|---|---|
| 序号 | byte 1 | byte 2 |
| 功能 | Mainboard Emit Temp | |
寄存器说明
- 该寄存器用于读取设备的主板发射温度
- 单位℃,电压值由 2 bytes 组成。计算公式:Mainboard Emit Temp = Value / 100
C.17 IMU 标定数据
IMU_CALIB_DATA
表31 IMU 数据
| IMU 标定数据(共 28 bytes) | ||||||||
|---|---|---|---|---|---|---|---|---|
| 序号 | byte 1 | byte 2 | byte 3 | byte 4 | byte 5 | byte 6 | byte 7 | byte 8 |
| 功能 | q_x | q_y | ||||||
| 序号 | byte 9 | byte 10 | byte 11 | byte 12 | byte 13 | byte 14 | byte 15 | byte 16 |
| 功能 | q_z | q_w | ||||||
| 序号 | byte 17 | byte 18 | byte 19 | byte 20 | byte 21 | byte 22 | byte 23 | byte 24 |
| 功能 | x | y | ||||||
| 序号 | byte 25 | byte 26 | byte 27 | byte 28 | ||||
| 功能 | z | |||||||
寄存器说明
- 该寄存器用于读取 IMU 相对于激光雷达坐标系的标定数据
- 该标定数据包含姿态估计和位置偏移,数据类型为 32 位 float(符合 IEEE 754 标准)
-
例如当前 x(byte 17~byte 20)的字节为 3b 8b 43 96,其计算方式如下:
首先将 4 个字节组合为 32 位二进制数,即 00111011 10001011 01000011 10010110
-
分出符号位,指数域和尾数域。其中符号位是 31 位,即 0,指数域是 23 位~30 位,即 01110111,尾数域是 0~22 位,即 00010110100001110010110
- 计算各个域的值,根据 IEEE 754,其中符号域是 0,代表正数。指数域是 01110111,转换为十进制为 119,实际指数为 119-127=-8。尾数域是 00010110100001110010110,该二进制代表的是小数位,因此先将其转化为十进制小数,该尾数位包含一个隐藏的 1.,因此尾数为 1.00010110100001110010110,转化为十进制为 1.088
- 计算浮点数,利用公式 \(\text{Float32} = (-1)^{\text{符号域}} \times \text{尾数域} \times 2^{\text{指数域}} = (-1)^0 \times 1.088 \times 2^{-8} = 0.00425\)
附录 D 各通道测距能力以及发射延时对应表
在每个 MSOP 包中,有 8 个 block,每个 block 包含 48 个通道数据,因此每个 MSOP 包包含 4 列点云的数据,Airy 不同通道测距能力和发射延时见表 32。
表32 Airy-h 测距能力和发射延时
| 通道序号 | 垂直角度(°) | 测距@10% | 发射延时(μs) | 最远测距(米) | 通道序号 | 垂直角度(°) | 测距@10% | 发射延时(μs) | 最远测距(米) |
|---|---|---|---|---|---|---|---|---|---|
| 目标反射物(米) | 目标反射物(米) | ||||||||
| 1 | -0.07 | 30 | 0 | 60 | 49 | 45.05 | 30 | 41.888 | 60 |
| 2 | 0.88 | 30 | 0 | 60 | 50 | 46 | 30 | 41.888 | 60 |
| 3 | 1.81 | 30 | 0 | 60 | 51 | 46.95 | 30 | 41.888 | 60 |
| 4 | 2.76 | 30 | 0 | 60 | 52 | 47.9 | 30 | 41.888 | 60 |
| 5 | 3.69 | 30 | 0 | 60 | 53 | 48.85 | 30 | 41.888 | 60 |
| 6 | 4.62 | 30 | 0 | 60 | 54 | 49.8 | 30 | 41.888 | 60 |
| 7 | 5.54 | 30 | 0 | 60 | 55 | 50.73 | 30 | 41.888 | 60 |
| 8 | 6.48 | 30 | 0 | 60 | 56 | 51.69 | 30 | 41.888 | 60 |
| 9 | 7.41 | 30 | 5.712 | 60 | 57 | 52.62 | 30 | 50.456 | 60 |
| 10 | 8.34 | 30 | 5.712 | 60 | 58 | 53.56 | 30 | 50.456 | 60 |
| 11 | 9.27 | 30 | 5.712 | 60 | 59 | 54.5 | 30 | 50.456 | 60 |
| 12 | 10.21 | 30 | 5.712 | 60 | 60 | 55.45 | 30 | 50.456 | 60 |
| 13 | 11.15 | 30 | 5.712 | 60 | 61 | 56.37 | 30 | 50.456 | 60 |
| 14 | 12.09 | 30 | 5.712 | 60 | 62 | 57.3 | 30 | 50.456 | 60 |
| 15 | 13.03 | 30 | 5.712 | 60 | 63 | 58.24 | 30 | 50.456 | 60 |
| 16 | 13.98 | 30 | 5.712 | 60 | 64 | 59.18 | 30 | 50.456 | 60 |
| 17 | 14.92 | 30 | 12.376 | 60 | 65 | 60.12 | 30 | 59.024 | 60 |
| 18 | 15.87 | 30 | 12.376 | 60 | 66 | 61.05 | 30 | 59.024 | 60 |
| 19 | 16.82 | 30 | 12.376 | 60 | 67 | 61.99 | 30 | 59.024 | 60 |
| 20 | 17.77 | 30 | 12.376 | 60 | 68 | 62.93 | 30 | 59.024 | 60 |
| 21 | 18.72 | 30 | 12.376 | 60 | 69 | 63.86 | 20 | 59.024 | 60 |
| 22 | 19.67 | 30 | 12.376 | 60 | 70 | 64.81 | 20 | 59.024 | 60 |
| 23 | 20.62 | 30 | 12.376 | 60 | 71 | 65.76 | 20 | 59.024 | 60 |
| 24 | 21.57 | 30 | 12.376 | 60 | 72 | 66.69 | 20 | 59.024 | 60 |
| 25 | 22.51 | 30 | 19.040 | 60 | 73 | 67.65 | 20 | 70.448 | 60 |
| 26 | 23.45 | 30 | 19.040 | 60 | 74 | 68.6 | 20 | 70.448 | 60 |
| 27 | 24.4 | 30 | 19.040 | 60 | 75 | 69.56 | 20 | 70.448 | 60 |
| 28 | 25.33 | 30 | 19.040 | 60 | 76 | 70.51 | 20 | 70.448 | 60 |
| 29 | 26.28 | 30 | 19.040 | 60 | 77 | 71.46 | 20 | 70.448 | 60 |
| 30 | 27.21 | 30 | 19.040 | 60 | 78 | 72.42 | 20 | 70.448 | 60 |
| 31 | 28.15 | 30 | 19.040 | 60 | 79 | 73.37 | 20 | 70.448 | 60 |
| 32 | 29.08 | 30 | 19.040 | 60 | 80 | 74.33 | 20 | 70.448 | 60 |
| 33 | 30.02 | 30 | 25.704 | 60 | 81 | 75.29 | 20 | 81.872 | 60 |
| 34 | 30.95 | 30 | 25.704 | 60 | 82 | 76.24 | 20 | 81.872 | 60 |
| 35 | 31.88 | 30 | 25.704 | 60 | 83 | 77.19 | 20 | 81.872 | 60 |
| 36 | 32.82 | 30 | 25.704 | 60 | 84 | 78.14 | 20 | 81.872 | 60 |
| 37 | 33.74 | 30 | 25.704 | 60 | 85 | 79.07 | 20 | 81.872 | 60 |
| 38 | 34.68 | 30 | 25.704 | 60 | 86 | 80.02 | 20 | 81.872 | 60 |
| 39 | 35.62 | 30 | 25.704 | 60 | 87 | 80.96 | 20 | 81.872 | 60 |
| 40 | 36.55 | 30 | 25.704 | 60 | 88 | 81.9 | 20 | 81.872 | 60 |
| 41 | 37.5 | 30 | 33.320 | 60 | 89 | 82.84 | 20 | 93.296 | 60 |
| 42 | 38.43 | 30 | 33.320 | 60 | 90 | 83.78 | 20 | 93.296 | 60 |
| 43 | 39.37 | 30 | 33.320 | 60 | 91 | 84.7 | 20 | 93.296 | 60 |
| 44 | 40.31 | 30 | 33.320 | 60 | 92 | 85.64 | 20 | 93.296 | 60 |
| 45 | 41.25 | 30 | 33.320 | 60 | 93 | 86.57 | 20 | 93.296 | 60 |
| 46 | 42.21 | 30 | 33.320 | 60 | 94 | 87.52 | 20 | 93.296 | 60 |
| 47 | 43.16 | 30 | 33.320 | 60 | 95 | 88.46 | 20 | 93.296 | 60 |
| 48 | 44.09 | 30 | 33.320 | 60 | 96 | 89.4 | 20 | 93.296 | 60 |
附录 E 结构图纸

