跳转至

Fairy (48TX) 产品手册

1 安全提示

1.1 法律声明

Warning

除非我们另行声明 RoboSense 的所有产品、技术、软件、程序、数据及其他信息(包括文字、图标、照片、音频、视频、图表、色彩组合、版面设计等)的所有权利(报告版权、商标权、专利权、商业秘密及其他相关权利)均归 RoboSense 及其授权方所有。

未经 RoboSense 书面同意,任何人不得以任何方式非法使用本手册中所承载在的任何内容。

“RoboSense”、“速腾聚创”等文字及/或标识,以及其他标识、产品和服务名称等均为 RoboSense 所有,如有宣传、展示等任何使用需要,您必须取得 RoboSense 的事先书面授权。

1.2 使用规范

请按以下要求,规范使用本产品

  1. 请严格遵守国家激光安全相关法律法规;
  2. 请在使用产品前,详细阅读本产品手册;
  3. 请在相关针对的领域范围内使用本产品;
  4. 请避免在爆炸性、高腐蚀性、超越产品 IP 防护等级的环境中使用本产品。

1.3 违规操作

请按规定使用本产品,否则可能会造成产品损坏、财产损失及人员受伤。对违反规定的操作行为,需用户自行承担风险。

  1. 请勿私自拆解、改装本产品(包含配套配件)
  2. 禁止使用非规定供电电源及配套配件
  3. 请避免跌落、碰撞、焚烧等非正常操作
  4. 如发现产品外观受损,请立即停止使用,并及时联系 RoboSense
  5. 如发现产品工作异常等情况,请立即停止使用,并及时联系 RoboSense

1.4 操作人员的要求

本产品的使用,对操作人员的基础专业知识及其他相关资质有一定要求。对无基础知识及未经培训上岗人员的不当操作行为,给产品及人员财产造成损害、伤害、损失等后果 RoboSense 不承担相关责任。

  1. 使用产品前,详细阅读本产品手册;
  2. 禁止违规操作;
  3. 上岗前需经过培训,且有相关工种施工资格;
  4. 有一定的计算机数据连接、电气等基础知识。

1.5 工作安全和特殊危险

使用本产品前,为避免对用户或他人产生意外,同时损坏产品及违反保修条款,请务必仔细阅读并遵循本说明书中的操作及规范。

  1. 激光安全:本产品激光安全等级符合 IEC 60825-1:2014 标准:

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

  3. 保留说明:请保留所有安全和操作说明,以备将来参考。

  4. 注意警告:请遵守产品和操作说明中的所有警告,以免发生意外。

  5. 产品维修:请勿在缺少官方指导的情况下尝试打开产品进行维修。如需维修,请及时联系 RoboSense

2 产品描述

2.1 产品概要

Fairy 是 RoboSense 的一款高精高清中长距数字化激光雷达,主要应用于机器人环境感知、无人驾驶汽车环境感知、无人机测绘、智慧城市等领域。

Fairy 采用 RoboSense 革新的芯片化收发方案与数字化架构,具备行业顶尖最高 0.5cm@1σ(重复精度)的超高精度,同时提供 \(360^{\circ} \times 32^{\circ}\) 的宽广 FOV 和 150m 的探测能力,并满足商用车振动要求。

2.2 产品结构

Fairy 结构图如图 1 所示。

图 1 产品结构说明

主要包括以下结构:

  1. 防护罩

激光雷达发射激光束和接收到的激光回波都需透过弧形特制防护罩, 因此在激光发散的 FOV 范围内, 严禁遮挡。

  1. 航空插头

激光雷达本体通过航插头与航插线连接,实现供电和数据传输的功能。

  1. M4 螺钉安装孔

用于激光雷达与安装支架间的固定,通过 M4 螺钉进行锁紧,详细参数见附录 D 结构图纸部分。

  1. 定位孔

用于支撑、固定激光雷达与支架之间的位置和方向, 可提高安装效率与精度, 详细参数见附录 D 结构图纸部分。

2.3 FOV 分布

Fairy 的 FOV 在水平方向的角度范围是 \(0 \sim 360^{\circ}\) ,在垂直方向的角度范围是 \(-15.84^{\circ} \sim +15.84^{\circ}\) ,角度间隔约为 \(0.67^{\circ}\) 分布。48 路通道与真实的垂直角度对应关系如图 2 所示。

图 2 FOV 示意图

Fairy 每 10 帧点云中有 1 帧点云出现约 \(30^{\circ}\) 的点云缺口。该缺口的起始角度在固件上可配置,用户可根据实际需求配置在影响较小的位置处,见附录 A2.2。

2.4 规格参数 \(^{1}\)

表 1 Fairy 规格参数

规格参数
线数 48 水平视场角 0° ~ 360°
激光安全等级 Class1 人眼安全 垂直视场角 -15.84° ~ +15.84°
测距能力2 150 m (80 m @10% NIST) 水平角分辨率 0.25°
盲区 ≤0.2 m 垂直角分辨率 0.67°
转速 600 rpm 精度(典型值)3 0.5 cm (1 σ)
出点数 ~690,000 pts/s (单回波)
~1,380,000 pts/s (双回波)
帧率 10 Hz
以太网连接 100Base-T1/100Base-TX 传输带宽 <19 Mbps
输出数据协议 UDP Packets Over Ethernet
激光雷达数据包内容 空间坐标、反射强度、时间戳等
工作电压 9 V - 32 V 工作寿命4 17520 h
产品功率5 <10 W 尺寸 直径 75 mm × 高 70 mm
重量 <350 g (激光雷达本体) 工作温度6 -40℃ ~ +60℃
时间同步 GPS & gPTP & PTP 存储温度 -40℃ ~ +85℃
产品型号 Fairy 防护等级 IP67 / IP6K9K

1 以下数据只针对量产产品,任何样品、试验机等其它非量产版本可能并不适用本规格数据,如有疑问请联系 RoboSense;

2 测距能力以 10%NIST 漫反射板为目标,最远测距以 80%NIST 漫反射板为目标,测试结果会受到环境影响,包括但不限于环境温度、光照强度等因素;

3 测距精度以 50%NIST 漫反射板为目标,30℃户外环境,0.5 m~70 m 测距范围,通道 25 至 72 的平均值,测试结果会受到环境影响,包括但不限于环境温度、目标物距离等因素,且精度值适用于大部分通道,部分通道之间存在差异;

4 该工作寿命是指在室温(25℃)条件下,每天工作 16 小时,每年工作 365 天,工作三年。

5 设备功耗测试结果会受到外部环境影响,包括但不限于环境温度、目标物的距离、目标物反射强度等因素;

6 设备运行温度可能会受到外部环境影响,包括但不限于光照环境、气流变化等因素;

2.5 产品原理

2.5.1 坐标映射

由于激光雷达封装的数据包仅为水平旋转角度和距离参量, 为了呈现三维点云图的效果, 将极坐标下的角度和距离信息转化为了笛卡尔坐标系下的 x, y, z 坐标, 它们的转换关系如下式所示:

\[ \left\{ \begin{array}{l} x = r c o s (\omega) s i n (\alpha) + R c o s (\alpha); \\ y = r c o s (\omega) c o s (\alpha) + R s i n (\alpha); \\ z = r s i n (\omega) + Z; \end{array} \right. \]

其中 r 为实测距离, \(\omega\) 为激光的垂直角度, \(\alpha\) 为激光的水平旋转角度,R 为光心到原点的平面半径,Z 为光心到原点的 Z 轴高度,x, y, z 为极坐标投影到笛卡尔 X, Y, Z 轴上的坐标。

2.5.2 反射强度解读

Fairy 激光雷达提供了反射强度信息来表征被测物体的反射率。在 Fairy 数据中,标定后的反射强度范围区间为 1~255(该范围区间为 RoboSense 产品自定义的对目标反射率探测的数值)。

2.5.3 回波模式

2.5.3.1 回波模式原理

Fairy 支持多种回波模式,包括最强回波(Strongest Returnrn)、最后回波(Last Returnrn)、最近回波(First Returnrn)及双回波(Dual Returnrn)模式。在双回波模式下,目标物的详细信息得以展现,并且数据量是单回波的两倍。Fairy 能够分析接收到的多个返回值,并根据用户选择分别输出最强、最后、最近一个回波值,或者输出双回波值。若设置为最强回波模式,则仅输出最强的反射回波值;若设置为最后回波模式,则仅输出时域上检测到的最后回波。

图 3 双回波检测

2.5.3.2 回波模式标志

Fairy 出厂默认为最强回波(Strongest Returnrn)模式,如若用户需更改设置,请参照章节 A.2 中产品参数设定进行配置。在 DIFOP 中第 300 个 byte 是回波模式的标志位,详情参见表 2。

表 2 回波模式和标志位对照表

DIFOP Offset 标志位 回波模式
300 00 最强回波
01 最近回波
02 最后回波
03 双回波

2.5.4 相位锁定

Fairy 相位锁定功能可用于设定 Fairy 在整秒时刻, 传感器旋转到特定的角度发射激光。

图 4 为 Fairy 设置不同相位的示意图,红色箭头表明,在整秒时刻,传感器分别旋转到 \(0^{\circ}\)\(135^{\circ}\)\(270^{\circ}\) 发射激光,坐标系详情参见图 12。

图 4 Fairy 不同相位设定示意图

Web 端 Setting > Phase Lock Setting 中提供了一个“Phase Lock”的参数设定,可用于设定锁定的相位角度,输入范围为 0 ~ 360 的整数,详情参见附录 A Web 端部分。

2.5.5 时间同步方式

Fairy 支持 GPS、PTP(IEEE 1588 V2 协议)、gPTP(IEEE802.1 AS 协议)三种同步方式,用户可在 Web 端进行设置,详情参见附录 A Web 端部分。

2.5.5.1 GPS 时间同步原理

GPS 模块连续向产品发送 GPRMC 数据和 PPS 同步脉冲信号,PPS 同步脉冲长度为 20~200 ms,GPRMC 数据必须在 PPS 同步脉冲下降沿后 10ms 之后发射,在下一个 PPS 同步脉冲上升沿前 300ms~500ms 之间完成(建议 GPRMC 数据在两个 PPS 脉冲信号的正中间发送),时序图如图 5 所示。

图 5 GPS 时间同步时序图

提示说明

为确保时间同步的准确性,建议将 PPS 的脉宽设置在 20~200 ms 之间。GPRMC 的完成时间建议为 PPS 下降沿后 10ms 和下一个 PPS 上升沿前 300ms~500ms 之间。

2.5.5.2 GPS 时间同步使用

Fairy 激光雷达 GPS 接口电平协议为 RS232 电平标准,详情参见表 3。

表 3 产品授时引脚定义

通讯方式 接收引脚定义
GPS_GPRMC GPS_PPS
RS232 接 GPS 模块输出的 RS232 电平标准的串口数据 接 GPS 模块输出的正同步脉冲信号,电平要求 3.0 ~ 15.0 V

外接的 GPS 模块需要设置输出串口的波特率为 9600 bps,数据位 8 bits,无校验位,停止位 1 bit。Fairy 只读取 GPS 模块发出的 GPRMC 格式的数据,其标准格式如下:

\[ \$ \text { GPRMC }, < 1 >, < 2 >, < 3 >, < 4 >, < 5 >, < 6 >, < 7 >, < 8 >, < 9 >, < 1 0 >, < 1 1 >, < 1 2 > * h h \]

<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 为$到所有字符的异或和。

提示说明

  1. Fairy 航插线上面的 GPS 接口规格为 SM2.54 端子插头,引脚定义如图 9 所示
  2. 1 PPS 脉冲的发送时间间隔需控制在 \(1 \, s \pm 200 \, us\)
  3. GPRMC 消息中状态位必须在 A 有效的情况才允许进行时间同步授时
  4. 目前市场的 GPS 模块发出的 GPRMC 消息长度存在不一致情况,本产品可兼容市场上大部分 GPS 模块发出来的 GPRMC 消息格式,如果在使用过程中发现不兼容的情况,请联系 RoboSense
2.5.5.3 PTP 同步原理

PTP(Precision Time Protocol,IEEE 1588V2 协议)是一种时间同步的协议,其本身只是用于设备之间的高精度时间同步,但也可被借用于设备之间的频率同步。相比现有的各种时间同步机制,PTP 具备以下优势:

1) 相比 NTP(Network Time Protocol,网络时间协议),PTP 能够满足更高精度的时间同步要求,NTP 一般只能达到亚秒级的时间同步精度,而 PTP 则可达到亚微秒级。

2) 相比 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 同步方式,需要做以下准备,连接方式详情参见产品手册章节 3.4:

1) 在 Web 端中选择 PTP / gPTP 模式,详情参见产品手册章节 4.2;

2) PTP Master / gPTP Master 授时主机(即插即用,无需额外配置);

3) 以太网交换机;

4) 支持 PTP / gPTP 协议的待授时设备。

提示说明

  1. Master 授时设备属于第三方设备,RoboSense 出货时不包含此配件,需用户自行采购
  2. RoboSense 产品只作为 Slave 设备只获取 Master 发出的时间, 不对 Master 时钟源的准确度判断, 若解析激光雷达点云时间出现突变, 请检查 Master 提供的时间是否准确
  3. 激光雷达同步之后, Master 断开连接, 点云数据包中的时间则会按照激光雷达内部时钟进行叠加, 激光雷达断电重启后才会被重置

3 产品安装

3.1 配件说明

Fairy 配件清单如表 4 所示,清单仅供参考。

表 4 配件清单

序号 配件名称 规格 数量
1 激光雷达
LiDAR
Fairy 1
2 螺丝包
Screw Pack
M4*6 3
3 螺丝包(选配)
Screw Pack
M4*10 3
4 航插连接线(选配)
Aviation Connector Cable
1.5 m 1
5 电源适配器(选配)
Power Adapter
DC12 V × 3.34 A / 40 W 1
6 电源线(选配)
Power Cable
1.2 m 1
7 网线(选配)
Ethernet Cable
1.5 m 1
8 产品包装清单和出货检验报告
Product Packing List and Shipment Inspection Report
/ 1

如特殊要求请以商务协议为准。

3.2 机械安装

激光雷达的结构安装图如图 6 所示。

图 6 激光雷达结构安装示意图

  1. 螺钉规格

    • GB/T70.1,M4×6,内六角圆柱头,不锈钢,强度等级A2-70;
  2. 安装及定位方式

    • 支架与雷达定位如图所示;推荐采用雷达底部定位柱方式进行定位;
    • 底部支架建议在 3 个安装孔附近使用小凸台与雷达配合,凸台整体平面度要求 0.15 mm 以内;
    • 底面用 3 个 M4 螺钉安装,出安装面 3.5~4.5mm,推荐锁紧扭矩 15 ±1 kgf·cm;
    • 底面用 2 个 \(\Phi 3\) 定位销进行安装定位, 不能高于 \(3 \mathrm{~mm}\) ;
    • 激光雷达安装的时候,如果激光雷达上下面都有接触式的安装面,请确保安装面之间的间距大于激光雷达高度,避免挤压激光雷达;
    • 由于激光雷达需要线束与外界进行通信,如果线束走线空间太小,弯折半径太小,会对线束寿命与信号质量有影响,对线束安装的要求如下:

      • 激光雷达安装走线时,请勿使激光雷达接线线缆太过紧绷,确保线缆具有一定的松弛度;
      • 线束直径 \(6 \pm 0.2 ~mm\) ,线束最小弯折半径为 5 倍线束直径;

    图 7 激光雷达底部定位孔及螺钉孔示意图

  3. 支架刚度和强度要求

    固定支架需有较好的刚性用于安装固定激光雷达,并在各种工况下保持激光雷达处于一个稳定的状态,设计要求如下:

    • 推荐雷达固定支架保持一定的刚性,具体边界要求由客户感知算法评估决定;
    • 雷达支架在经历随机振动、机械冲击等工况下会承受较大的负载,应结合实际工况校核支架强度。机械冲击工况,支架最大应力应小于拉伸强度的 2/3。随机振动工况,支架 1sigma RMS 应力应小于拉伸强度的 1/5;
  4. 支架散热要求

    Fairy 在使用过程中会有一定程度的温升,且受周边热源、环境温度、太阳辐射等因素的影响,可能会加剧激光雷达的温升。RoboSense 可根据具体设计方案提供热仿真评估及优化建议。常规散热建议如下:

    • 激光雷达附近环境温度需控制在工作温度范围内( \(-40^{\circ}C \sim +60^{\circ}C\) );
    • 支架材料建议采用导热系数大于 \(50 \, W/m \cdot K\) 的铝合金或者镀锌钢板等材料,尽量在支架上做一些散热鳍片,并合理的控制鳍片间距、高度和方向,尽量增大散热面积,方向上与空气对流方向一致,可以更有效散热;
    • 激光雷达底座或顶盖部位,确保不被非金属材质包覆,以免影响整机散热,造成激光雷达温升过高;
    • 必要时可在激光雷达与支架之间增加导热材料,以提升传热效率;

3.3 接口说明

3.3.1 航插接口及定义

Fairy 激光雷达侧的航插头,如图 8 所示。

图 8 航插接口引脚序号

激光雷达侧的航插接口上具体引脚定义参见表 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 连接线(选配)

Fairy 选配附件连接线如下图所示:

图 9 连接线示意图

连接线各接口规格详情参见表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 电源接口

Fairy 电源接口使用标准 DC 5.5 - 2.1 接口。

若连接电源后,雷达电机不转动,可能是线束损坏,请联系 Robosense

重要

  1. 本机接地方式:本雷达采用机壳与内部电路板共地设计。
  2. 安装环境建议:当安装环境中的设备外壳为浮地状态时,为确保设备正常工作并防止潜在干扰,建议通过非金属绝缘件或其他方式,使雷达外壳与设备外壳之间实现电气隔离。

3.3.4 RJ45 网口

Fairy 网络接口遵循 EIA / TIA568B 标准。

3.3.5 同步接口

Fairy 同步接口定义:GPS REC 为 GPS GPRMC 输入;GPS PULSE 为 GPS PPS 输入。

重要

Fairy 的 “地” 与外部系统连接时,外部系统供电电源负极(“地”)与 GPS 系统的 “地” 必须为非隔离共地系统。

3.4 快速连接

Fairy 网络参数可配置,出厂默认采用固定 IP 和端口号模式,详情参见表 7。

表 7 出厂默认网络配置表

设备 IP 地址 MSOP 包端
口号
DIFOP 包端
口号
Fairy 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. 连接激光雷达

连接方式如图 10 所示。

  1. 激光雷达通过航插头转连接接口;
  2. PC 与航插线间通过 RJ45 网口接头进行连接;
  3. 通电后,激光雷达即可正常工作。

图 10 激光雷达连接示意图

2. 通过 Wireshark 抓包,解析 ARP 报文进行本地 IP 配置

  1. 如上步骤,激光雷达与 PC 完成连接后,启动 Wireshark(第三方网络解析工具),选择正确的网口,开始抓包;
  2. 通过 Wireshark 的搜索框,输入 “arp” 进行搜索激光雷达与 PC 间的互相寻址报文,如图 11 所示;

图 11 解析 ARP 报文

  1. 如图 11 所示,Source 列中的 SutengIn 字样为激光雷达的信息源,提示 192.168.1.200 为 Source IP,即为激光雷达 IP,再请求访问 192.168.1.102,即为 PC IP。如若本地 IP 非请求访问的 IP,则需配置 PC 的本地 IP 为 192.168.1.102,详情操作见步骤 3; 如若可以正常访问,则跳转至步骤 4;

3. 配置 PC 的本地 IP

  1. 在控制面板中,通过 “网络与 Internet” 进入 “网络与共享中心”,在 “查看活动网络” 内容中,点击对应的以太网连接,进入对应的“以太网状态”,点击其中的“属性”设置;
  2. 双击 Internet 协议版本 4(TCP/IPv4),进入 IP 信息设置,使用静态 IP 进行配置;
  3. 将本地 IP 地址设置为 192.168.1.102,子网掩码 255.255.255.0,点击 “确认”,完成 PC 的静态 IP 设置。

4. 连接完成

提示说明

  1. 时间同步模块(PTP & gPTP、GPS 时间同步模块)非出厂标配产品,如需使用相关功能,请自行购买,按照图 10 方式连接即可。
  2. 以上配置本地静态 IP 仅以 Windows 系统操作为例,其它操作系统请以实际为准。

4 产品使用

4.1 产品坐标系

产品的坐标及旋转方向如图 12 所示。

图 12 激光雷达坐标及旋转方向示意图

提示说明

激光雷达的坐标原点定义在激光雷达底座中心处。

4.2 Web 端使用

4.2.1 Web 端功能

Fairy 支持通过网页端对产品进行参数设定、运行信息/状态查看及固件升级等操作。

Fairy 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 使用

在 Fairy 的数据的检测上,可使用 Wireshark 和 tcp-dump 等免费工具获取原始数据,而 RSView 可帮助用户更为便捷的实现对原始数据的可视化。

4.3.1 软件功能

RSView 提供将 Fairy 数据进行实时可视化的功能。RSView 也能回放保存为 “.pcap” 文件格式的数据,但是目前还不支持 “.pcapng” 格式的文件。

RSView 将 Fairy 得到距离测量值显示为一个点。它能够支持多种自定义颜色来显示数据,例如反射强度、时间、距离、水平角度和激光线束序号。所显示的数据能够导出保存为 “.csv” 格式,RSView 3.1.3 以后的版本支持导出 “.las” 格式的数据。

RSView 包含以下功能:

  1. 通过以太网实时显示数据;
  2. 将实时数据记录保存为 PCAP 文件;
  3. 从记录的 PCAP 文件中回放;
  4. 不同类型可视化模式,例如距离、时间、水平角度等等;
  5. 用表格显示点的数据;
  6. 将点云数据导出为 CSV 格式文件;
  7. 测量距离工具;
  8. 将回放数据的连续多帧同时显示;
  9. 显示或者隐藏 Fairy 中个别线束;
  10. 裁剪显示。

4.3.2 安装 RSView

RSView 支持在 Windows 64 位、Ubuntu 18.04 以上操作系统上运行。请联系 RoboSense 技术支持人员获取 Fairy 最新版本 RSView 软件压缩包。软件的解压路径请勿出现中文字符,软件无需安装,解压后运行可执行文件即可正常使用。

4.4 通信协议

Fairy 与电脑之间的通信采用以太网介质,使用 UDP 协议,和电脑之间的通信协议主要分为两类,详情参见表 8。

表 8 产品协议一览表

(协议/包)名称 简写 功能 类型 包大小 发送间隔
Main data Stream Output Protocol MSOP 扫描数据输出 UDP 1248 bytes 约 555.55 us
Device Information Output Protocol DIFOP 产品信息输出 UDP 1248 bytes 约 1 s

提示说明

  1. 产品手册 4.4 节皆为对协议中的有效载荷(1248 bytes)部分进行描述和定义
  2. 主数据流输出协议 MSOP,将激光雷达扫描出来的距离,角度,反射强度等信息封装成包输出
  3. 产品信息输出协议 DIFOP,将激光雷达当前状态的各种配置信息输出

4.4.1 MSOP 与 DIFOP 数据协议

图 13 激光雷达数据结构示意图

4.4.2 主数据流输出协议(MSOP)

主数据流输出协议:Main data Stream Output Protocol,简称:MSOP。

I/O 类型:产品输出,电脑解析。

出厂默认端口号为 6699。

4.4.2.1 帧头

帧头 Header 共 42 bytes,用于识别出数据的开始位置,数据结构详情参见表 9。

表 9 MSOP Header 数据表

信息 Offset 长度 (byte) 释义 总长度
(byte)
pkt_head 0 4 0x55AA055A 42
预留 4 8 /
pktcnt 12 4 发送包循环计数:0-65535
预留 16 4 /
timestamp 20 10 时间戳,前 6 byte 表示秒,后 4 byte 表示微秒
预留 30 1 /
lidar_type 31 1 0x0A: Fairy
lidar_model 32 1 0x02: 48 线
预留 33 9 /

提示说明

定义的时间戳用来记录系统的时间,分辨率为 1 us

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 数据包定义

信息 Offset 长度 (byte) 释义 总长度
(byte)
Data_ide 0 2 0xffee 148
Azimuth 2 2 极坐标系下,水平夹角,分辨率 0.01
data 1 4 2 测距(取低 15bits,最高 bit 预留)
6 1 反射率
data 2 7 3 同 data 1
data 3 10 3 同 data 1
... ... ... ...
data 47 142 3 同 data 1
data 48 145 3 同 data 1

1. 通道数据定义

通道数据 Channel data 是 3 bytes,高两字节用于表示距离信息,低一字节用于表示反射强度信息,如表 11 所示。

表 11 Channel Data 示意表

通道数据(3 bytes)
2 bytes Distance 1 byte Reflectivity
取低 15bits,最高 bit 预留 反射强度信息

提示说明

Distance 是 2 bytes,分辨率为 0.5 cm

图 14 MSOP 包示意图

红色框:Header ID;

绿色框:LiDAR Type 和 LiDAR Model;

蓝色框:Data Block 标志位;

黑色框:Channel data 1 的 Azimuth 值;

黄色框:Channel data 1 的 Distance 值;

白色框:Channel data 1 反射强度值。

数据包的距离值计算,计算方式如下:

  1. 数据包里的距离值的十六进制数:0x04,0xEE
  2. 将数据组成 16 bits,为 16 bits 无符号整型数据。表示为:0x04EE
  3. 取低 15bits,距离值转换为十进制数字:1262,根据距离分辨率不同进行计算
  4. 结果 \(1262 \times 0.5 \, cm = 631 \, cm = 6.31 \, m\)

数据包的角度值计算,计算方式如下:

  1. 数据包里的角度值的十六进制数:0x79,0x46;
  2. 将数据组成 16 bits,为 16 bits 无符号整型数据。表示为:0x7946;
  3. 转换为十进制数字:31046,将转化成十进制后的数据除以 100;
  4. 结果 \(31046^{\circ} / 100 = 310.46^{\circ}\)

数据包的反射强度值计算,计算方式如下:

  1. 数据包里的反射强度值得十六进制数: 0x04;
  2. 转换为十进制数字: 4;
  3. 结果得到反射强度值为 4。

2. 角度值定义

在每个 Block 中,Fairy 输出的角度值是该 Block 中第一个通道激光测距时的角度值。角度值来源于角度编码器,角度编码器的零位即角度的零点,水平旋转角度值的分辨率为 \(0.01^{\circ}\)

4.4.2.3 帧尾

帧尾(Tail)包含两部分,一个长度为 6 bytes 固定字符的 Tails,和 16 bytes 的预留位。

4.4.3 产品信息输出协议(DIFOP)

产品信息输出协议,Device Info Output Protocol,简称:DIFOP。

I/O 类型:产品输出,电脑读取。

默认端口号为 7788。

DIFOP 是为了将产品序列号(S/N)、固件版本信息、上位机驱动兼容性信息、配置信息、角度信息、运行状态、故障诊断等信息,定期发送给用户的“仅输出”协议,用户可以通过读取 DIFOP 解读当前使用产品的各种参数的具体信息。

一个完整的 DIFOP Packet 的数据格式结构为同步帧头,数据区,帧尾。每个数据包共 1248 bytes。数据包的基本结构如表 12 所示。

表 12 DIFOP Packet 的数据格式结构

信息 Offset 长度 (byte) 说明
DIFOP 帧头 0 8 0xA5 0xFF 0x00 0x5A 0x11 0x11 0x55 0x55
预留 8 2
以太网 IP 源地址 10 4 附录 C.1
以太网 IP 目标地址 14 4
雷达 MAC 地址 18 6
MSOP 端口 24 2
预留 26 2
DIFOP 端口 28 2
预留 30 2
FOV 起始角度 32 2 范围为 0-359, 精度为 0.01°
FOV 结束角度 34 2 范围为 0-359, 精度为 0.01°
预留 36 2
锁相相位 38 2 范围为 0-360, 精度为 1°
主板固件版本 40 5 附录 C.2
底板固件版本 45 5 附录 C.3
APP 固件版本 50 5 附录 C.4
电机固件版本 55 5 附录 C.5
预留 60 25
PTP 参数配置 85 2 PTP domain number
87 1 响应 peer delay request 消息
88 1 没有闰秒偏差
89 1 丢失 sync 消息的超时时间 s
90 1 offset 从 unlock 到 lock 的阈值 ms
91 1 offset 从 lock 到 unlock 的阈值 ms
预留 92 196
GPS 同步模式下的 GPRMC 波特率 288 1 波特率取值如下:
0x00: 1200, 0x01: 2400, 0x02: 4800, 0x03: 9600 (默认), 0x04: 14400, 0x05: 19200, 0x06: 38400, 0x07: 43000, 0x08: 57600, 0x09: 76800, 0x0A: 115200, 0x0B: 128000, 0x0C: 230400, 0x0D: 256000, 0x0E: 460800, 0x0F: 921600, 0x10: 1382400
预留 289 3
产品序列号 292 6 附录 C.6
预留 298 2
回波模式 300 1
时间同步方式设置 301 1 附录 C.7
时间同步状态 302 1
时间 303 10 附录 C.8
角度脉冲配置 313 1 角度脉冲模式 0: mode2, 1: mode1(+25%)
314 1 角度脉冲开关 0: off, 1: on
315 4 角度脉冲宽度 ns (取值乘以 10 为设置 ns 数)
319 2 角度脉冲起始角度 (取值乘以 0.01 为设置角度)
321 2 角度脉冲步长 (取值乘以 0.01 为设置角度)
预留 323 5
性能配置 328 2 帧起始空洞角度偏移 0-360
预留 330 27
GPS 状态 357 1 bit0(PPS 锁定标志):锁相 = 1, 失锁 = 0
bit1(GPRMC 锁定标志):锁相 = 1, 失锁 = 0
bit2(UTC 锁定标志):锁相 = 1, 失锁 = 0
bit3(GPRMC 输入状态):有输入 = 1, 无输入 = 0
bit4(PPS 输入状态):有输入 = 1, 无输入 = 0
bit5-bit7 预留
IMU 配置信息 358 1 imu 使能控制 0:off 1:on
359 2 imu udp 端口号
361 1 imu 消息输出频率
0: 25hz
1: 50hz
2: 100hz
3: 200hz
362 1 imu 加速度计量程
0: +/- 2g
1: +/- 4g
2: +/- 8g
3: +/- 16g
363 1 imu 陀螺仪量程
0: +/- 250 dps
1: +/- 500 dps
2: +/- 1000 dps
3: +/- 2000 dps
预留 364 7
实时相位 371 2 单位: 度
电机实时转速 373 2 附录 C.9
预留 375 93
垂直角校准 468 288 附录 C.10
水平角校准 756 288 附录 C.11
主板输入电压 1044 2 附录 C.12
预留 1046 20
整机输入电压 1066 2 附录 C.13
底板 12V 电压 1068 2 附录 C.14
预留 1070 22
IMU 标定数据 1092 28 附录 C.15
预留 1120 126 预留
帧尾 1246 2 0x0F 0xF0

提示说明

  1. Header(DIFOP 识别头)内容为 0xA5, 0xFF, 0x00, 0x5A, 0x11, 0x11, 0x55, 0x55, 可作为包的检查序列;
  2. Tail 帧尾内容为 0x0F, 0xF0;
  3. 每一项信息的寄存器的定义以及使用参见产品手册附录 C 中的详细描述,对应关系见表 12 说明栏内容。

4.4.4 IMU 数据流输出协议

I/O 类型:产品输出,电脑解析。

出厂默认端口号为 6688。

IMU 输出的为产品内部 IMU 的姿态信息,可用于客户产品外参调整。一个完整的 IMU Packet 的数据格式结构为帧头,数据区,帧尾。每个数据包共 51 bytes。数据包的基本结构如表 13 所示。

表 13 IMU 数据格式结构

信息 Offset 长度 (byte) 说明 备注
IMU 帧头 0 4 0xAA 0x55 0x5A 0x05
时间 4 10 UTC 时间格式,前 6 个 byte 为秒时间戳,后 4 个 byte 为微秒时间戳。
AccelX 14 4 X 轴加速度值,浮点数,单位 m/s^2
AccelY 18 4 Y 轴加速度值,浮点数,单位 m/s^2
AccelZ 22 4 Z 轴加速度值,浮点数,单位 m/s^2
GyroX 26 4 X 轴角速度值,浮点数,单位 rad/s
GyroY 30 4 Y 轴角速度值,浮点数,单位 rad/s
GyroZ 34 4 Z 轴角速度值,浮点数,单位 rad/s
内部温度 38 4 IMU 内部温度,有符号,分辨率 0.01 度
ODR 42 1 数据输出频率 0:25Hz
1:50Hz
2:100Hz
3:200Hz
4:1000Hz
AccelFsr 43 1 加速度计量程 0: +/- 2g
1: +/- 4g
2: +/- 8g
3: +/- 16g
GyroFsr 44 1 陀螺仪量程 0: +/- 250 dps
1: +/- 500 dps
2: +/- 1000 dps
3: +/- 2000 dps
包计数 45 4 u32 类型,由 1 开始
帧尾 49 2 0xF0 0x0F

5 故障诊断

本章列举了部分在使用产品的过程中常见的问题以及对应的问题排查方法,详情参见表 14。

表 14 常见故障排查方法表

故障现象 解决方法
产品电机不旋转 检查航插线电源/产品端的连接线是否松动及线束破损。
产品在启动时不断重启 检查输入电源连接和极性是否正常;
检查输入电源的电压和电流是否满足要求;
检查产品安装平面是否水平或激光雷达底部固定螺丝是否拧得太紧。
产品内部旋转,但是没有数据 检查激光是否正常发射;
检查网络连接是否正常;
确认电脑端网络配置是否正确;
使用另外的软件(例如 Wireshark)检查数据是否有被接收;
关闭防火墙和其它可能阻止网络的安全软件;
检查电源供电正常;
尝试重启产品。
Wireshark 可以收到数据但是 RSView 不显示点云 关闭电脑防火墙,并且运行 RSView 通过防火墙;
确认电脑的 IP 配置和产品设置的目的地址一致;
确认 RSView 中 Sensor Network Configuration 设置正确;
确认 RSView 安装目录或配置文件存放目录不包含任何中文字符;
确认 Wireshark 中收到的数据包是 MSOP 类型的包。
产品存在频发的数据丢失 确认网络中是否有大量的其它网络数据包或网络冲突;
确认网络中是否存在其它网络产品以广播模式发送大量数据造成传感器数据阻塞;
确认电脑的性能和接口性能是否满足要求;
移除其它所有网络产品,直连电脑确认是否存在丢包现象。
无法同步 GPS/PTP/gPTP 时间 确认已在网页端将同步模式切换到正确模式下;
在 GPS 时间同步方式下:
确认 GPS 模块波特率为 9600 bps,8 bits 数据位,无校验位,停止位 1;
确认 GPS 模块输出为 3.3 V TTL 还是 RS232 电平;
确认 1 PPS 脉冲连续且接线正确;
确认 GPRMC 的 NMEA 消息格式正确;
确认 GPS 模块和航插线共地;
确认 GPS 模块收到了有效的解;
确认 GPS 模块是否为有效定位(室外);
在 PTP / gPTP 时间同步方式下:
确认 PTP / gPTP Master 同步协议是否符合当前 PTP / gPTP 协议;
确认 PTP / gPTP Master 是否正常工作。
产品通过路由器后无数据输出 关闭路由器的 DHCP 功能或在路由器内部设置传感器的 IP 为正确的 IP。
ROS 驱动显示点云时有固定的空白区域不断旋转 此现象正常,是因为 ROS 驱动按照固定包数进行分帧显示,空白部分的数据会在下一帧进行显示。
RSView 软件输出点云成一条射线 如果是 Windows 10 系统请设置 RSView 使用 Windows 7 兼容模式运行。

6 产品维护

6.1 运输与物流

运输不当会导致产品损坏

  1. 应采用防震防潮包装材料包装产品,以避免运输途中损毁。建议使用原始包装;
  2. 运输过程务必小心轻放,避免磕碰、摔落等危险行为;
  3. 每次运输收到货物时,必须详细检查交付货物清单与是否有损坏(含产品与包装);
  4. 如若有运输损坏,请拒绝收货,并及时联系 RoboSense

6.2 存储

Note

  1. 请将产品存储于室内常温、干燥的环境中;
  2. 请轻拿轻放,避免产品遭受磕碰、摔落等;
  3. 产品应存放于安全环境中,避免腐蚀、机械冲击及暴露于超过防护等级的环境中;
  4. 请定期检查所有组件和包装的状态,建议检查周期为 3 个月。

6.3 产品清洁

为了能够准确地感知周围环境 RS-LiDAR 需保持环形防护罩洁净。

6.3.1 注意事项

Note

  1. 请在清理 RS-LiDAR 前仔细并完整的阅读本节的内容,否则不当的操作可能会损坏产品。
  2. 激光雷达在环境比较恶劣的情况下使用时,需及时清理表面的脏污保持激光雷达清洁,否则会影响激光雷达的正常使用。

6.3.2 需要的材料

  1. 洁净的无尘布;
  2. 温度适中的中性溶液(如肥皂水、蒸馏水、99%浓度乙醇等)。

6.3.3 清洁方法

  1. 如果激光雷达的表面只是粘附了一些灰尘/粉尘:

    • a. 首先用洁净的无尘布,蘸取少量的中性溶液;
    • b. 其次轻轻地对激光雷达表面拭擦清洁;
    • c. 最后用一块干燥洁净的无尘布将其擦干。
  2. 如果激光雷达表面沾上了泥浆等块状异物:

    • d. 首先应使用洁净水喷洒在激光雷达脏污部位表面让泥浆等异物脱离(注意:不能直接用无尘布将泥浆擦掉,这样做可能会划伤表面特别是防护罩表面);
    • e. 其次用温的肥皂水喷洒在脏污部位,因肥皂水的润滑作用可加速异物的脱离。再次用纤维布轻轻试擦激光雷达表面,但注意不要擦伤表面;
    • f. 最后用洁净的水清洗激光雷达表面肥皂的残留(如果表面仍有残留,可用 \(99\%\) 乙醇对其再次清洁),同时用一块干燥的无尘布擦干即可。

7 售后

如果“故障诊断”章节未能解决问题,请及时联系 RoboSense

官网:https://www.robosense.cn/contact

邮箱:support@robosense.cn

电话:0755-86325830/15338772453

提示

  1. 请在收到 RoboSense 售后服务回信确认后,再寄回产品;
  2. 产品只能使用原包装或等效的软垫防潮包装寄。

附录 A Web 端操作

A.1 产品信息

激光雷达 Web 端默认为产品信息页,如图所示。

  1. Top Board Firmware Version 为主板固件版本
  2. Bottom Board Firmware Version 为底板固件版本
  3. Software Version 为软件版本
  4. Motor Firmware Version 为电机版本
  5. S/N 为产品序列号
  6. Mac Address 为 MAC 地址
  7. Model 为产品名称

A.2 产品参数设定

A.2.1 General Setting

网页端 "General Setting" 栏为激光雷达基本参数设定页,在此处可更改 Device IP、端口号、回波模式及角度触发等功能设定,如图所示。

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

A.2.2 Performance Setting

网页端 "Performance Setting" 栏为激光雷达高级参数设定页,在此处可进行雷达的反射率表现、吸拖点滤除和雨雾检测等高级功能的设定,如图所示。

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

A.2.3 Angle Pulse Setting

网页端 "Angle Pulse Setting"栏为激光雷达角度脉冲触发设定页,在此处可设定雷达的角度触发信号,如图所示。

  1. Trigger Mode:起始角模式有两种,模式1为起始脉宽增加25%,模式2为起始脉宽不增加(默认)
  2. Group:此栏为对应 SYNC OUT 组,Airy 内含 SYNC OUT1
  3. Pulse Trigger Switch: 开启/关闭触发功能,当 Pulse Trigger Switch 勾选 "ON" 开启后选项为可编辑状态,关闭时为灰色不可编辑状态
  4. Pulse Start Angle:可设置对应的起始角,输入值需为整数
  5. Pulse Width: 可设置对应的脉宽
  6. Pulse Step:可设置对应的步距,输入值需为浮点数,保留1位小数

Tip

  1. Device IP 和 Destination IP 需在同一网段,否则可能会导致无法正常连接
  2. MSOP、DIFOP 和 IMU 端口号值的范围为 1025 ~ 65535,且 MSOP 端口、DIFOP 端口和 IMU 端口不可设置为相同的值
  3. 更改完成后需点击"Save"进行保存,提示成功则表示设定生效

A.3 产品诊断/运行状态

此页可实时查看激光雷达运行状态,包括电压、电流、实时转速、运行时长及温度等信息,如图所示。

  1. 用户可查看 Machine Temperature 获取当前产品运行温度
  2. 用户可查看 RPM 获取产品当前实时转速信息
  3. 用户可查看 Phase 获取产品当前旋转相位
  4. Laser Status 有"On"(默认)和"Off"两种状态,用户设置 Standby 模式时为"Off"
  5. 用户可查看 Time Sync Mode 获取激光雷达的时间同步模式
  6. 用户可查看 Time Sync Data 获取激光雷达的时间同步数据
  7. 用户可查看 PPP Status 获取 PPS 状态
  8. 用户可查看 GPRMC Status 获取 GPRMC 状态
  9. 用户可查看 Time Sync Status 获取当前时间同步状态,Lock 表示已成功锁定,Unlock 表示时间同步尚未成功
  10. 用户可查看 Startup Times 获取当前产品总启动次数,每断电重启后会累加一次
  11. 用户可查看 Elapsed time 获取产品总运行时间和产品在各温度下累计工作时间

提示

  1. 本页刷新频率为 5 秒
  2. 若产品电压/电流框变红时,请检查产品当前是否为 Standby 模式,若不是则检查产品是否正常工作

A.4 产品固件升级

点击网页"System",此页可对产品的 App、底板、主板固件进行升级。

  1. 请联系 RoboSense 获得升级固件。准备好待升级的固件后,点击"选择文件",如图所示:

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

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

提示

  1. 升级包的格式为 Zip,web 的升级界面只支持上传 Zip 格式文件包
  2. 升级包名称需符合如下要求方可正常升级,否则会报错
  3. 主板升级文件:顺序逻辑必要后缀 ".bin"
  4. 底板升级文件:顺序逻辑必要后缀 ".bit"
  5. Web App 升级文件:顺序逻辑必要后缀 ".hs_fs"

附录 B ROS & ROS2 Package

rslidar_sdk 是 ROS 平台下的驱动 SDK,请通过 github 上的 RoboSense 主页下载,或联系 RoboSense 获取。

  1. rslidar_sdk 依赖 rs_driver,后者是 RoboSense 的基本驱动。rs_driver 请从 github 平台下载
  2. 如使用环境为 ROS2,rslidar_sdk 还依赖 rslidar_msg,这是 msg 定义文件。msg 文件请从 github 平台下载
  3. 驱动 SDK 下载包内含丰富的使用指引,请在使用驱动 SDK 前,详细阅读文件内的 README 文件及 doc 文件夹下的文档

提示

  1. SDK 获取地址:https://github.com/RoboSense-LiDAR/rsLiDAR_sdk
  2. rs_driver 获取地址:https://github.com/RoboSense-LiDAR/rs_driver
  3. msg 获取地址:https://github.com/RoboSense-LiDAR/rslidar_msg

附录 C DIFOP 数据定义

本附录内容补充章节 4.4.3 的 DIFOP 协议里各个信息定义的说明,便于用户对产品的使用和开发,涉及到计算部分,均采用大端模式,Value 代表对应 offset 字节换算后得出的十进制数值。

C.1 以太网

ETH

表 15 以太网寄存器

以太网寄存器(共 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
功能 预留 DIFOP 预留

寄存器说明

  1. LIDAR_IP 为激光雷达的源 IP 地址,占据 4 bytes
  2. DEST_PC_IP 为目的 PC 的 IP 地址,占据 4 bytes
  3. MAC_ADDR 为激光雷达的 MAC 地址
  4. MSOP 与 DIFOP 分别占 2 bytes,源端口号与目的端口号强制一致

C.2 主板固件版本

TOP_FRM

表 16 主板固件版本

主板固件版本(共 5 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5
功能 TOP_FRM

寄存器说明

  1. 该寄存器用于读取主板固件版本号
  2. 如 byte 1=0x00, byte 2=0x10, byte 3=0x04, byte 4=0x0c, byte 5=0x00, 则固件版本号为:00 10 04 0c 00

C.3 底板固件版本

BOT_FRM

表 17 底板固件版本

底板固件版本(共 5 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5
功能 BOT_FRM

寄存器说明

  1. 该寄存器用于读取底板固件版本号
  2. 如 byte 1=0x00, byte 2=0x24, byte 3=0x12, byte 4=0x13, byte 5=0x12, 则固件版本号为:00 24 12 13 12

C.4 APP 固件版本

SOF_FRM

表 18 软件版本

APP 固件版本(共 5 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5
功能 SOF_FRM

寄存器说明

  1. 该寄存器用于读取 APP 固件版本号
  2. 如 byte 1=0x00, byte 2=0x24, byte 3=0x12, byte 4=0x13, byte 5=0x12, 则固件版本号为:00 24 12 13 12

C.5 电机固件版本

MOT_FRM

表 19 电机固件版本

电机固件版本(共 5 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5
功能 MOT_FRM

寄存器说明

  1. 该寄存器用于读取电机固件版本号
  2. 如 byte 1=0x00, byte 2=0x24, byte 3=0x12, byte 4=0x12, byte 5=0x25, 则固件版本号为:00 24 12 12 25

C.6 序列号

SN

表 20 序列号寄存器

序列号(共 6 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5 byte 6
功能 SN

寄存器说明

  1. 该寄存器用于设备序列号
  2. 类似 mac 地址,共 6 bytes,以 16 进制表示产品序列号

C.7 时间同步信息

TIME_SYNC_INFO

表 21 时间同步信息

时间同步信息(共 2 bytes)
序号 byte 1 byte 2
功能 Time_Sync_Mode Time_Sync_State

寄存器说明

  1. 该寄存器用于读取时间同步信息
  2. byte 1 为时间同步模式状态位,定义如下:
    • 0x00: GPS
    • 0x01: E2E-L4
    • 0x02: P2P
    • 0x03: gPTP
    • 0x04: E2E-L2
  3. byte 2 为时间同步成功状态位,定义如下:
    • 0x00: 未同步
    • 0x01: 同步成功

C.8 时间

UTC_TIME

表 22 时间寄存器

时间寄存器(共 10 bytes)
序号 byte 1 byte 2 byte 3 byte 4 byte 5 byte 6 byte 7 byte 8 byte 9 byte 10
功能 sec us

寄存器说明

  1. 该寄存器用于读取时间信息
  2. us 值范围:0 ~ 999999

C.9 电机实时转速

REALTIME_ROTATION_SPEED

表 23 实时转速寄存器

序号 byte 1 byte 2
功能 REALTIME_ROTATION_SPEED

寄存器说明

  1. 该寄存器用于读取电机实时转速信息
  2. 共 2 byte,以 16 进制表示
  3. 例如 byte1=0x01,byte2=0x28,电机实际转速转成十进制是 600

C.10 垂直角校准

COR_VERT_ANG

表 24 垂直角校准寄存器

垂直角校准寄存器(共 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 通道垂直角度

寄存器说明

  1. 角度值为区分为正负,每个通道的垂直角度由 3 bytes 组成,其中第 1 个 byte 表示正负,第 2 和第 3 个 byte 共同组成角度的值
  2. 表示正负的第 1 个 byte 属性为 0x00 则通道垂直角度为正值,属性为 0x01 则通道垂直角度为负值
  3. 角度分辨率为 \(0.01^{\circ}\)
  4. 例如通道 5 寄存器的值为 byte 1=0x00, 为正数; byte 2=0x01, byte 3=0x71 转换成十进制 369。则通道 5 的垂直角度值为 \(3.69^{\circ}\)

C.11 水平偏移角校准

COR_HOR_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 通道水平偏移角度

寄存器说明

  1. 角度值为区分为正负,每个通道的水平偏移角度由 3 bytes 组成,其中第 1 个 byte 表示正负,第 2 和第 3 个 byte 共同组成角度的值
  2. 表示正负的第 1 个 byte 属性为 0x00 则通道水平偏移角度为正值,属性为 0x01 则通道水平偏移角度为负值
  3. 角度分辨率为 \(0.01^{\circ}\)
  4. 例如通道 5 寄存器的值为 byte 1=0x01,为负数;byte 2=0x00,byte 3=0xae 转换成十进制 174。则通道 5 的水平偏移角度值为 \(-1.74^{\circ}\)

C.12 主板总输入电压

MAINBOARD_VOLTAGE

表 26 主板总输入电压

序号 byte 1 byte 2
功能 Mainboard Voltage

寄存器说明

  1. 该寄存器用于读取设备的主板输入电压
  2. 单位 V,电压值由 2 bytes 组成。计算公式:Mainboard Voltage = Value / 100

C.13 整机输入电压

MACHINE_VOLTAGE

表 27 整机输入电压

序号 byte 1 byte 2
功能 Machine Voltage

寄存器说明

  1. 该寄存器用于读取设备的整机输入电压
  2. 单位 V,电压值由 2 bytes 组成。计算公式:Machine Voltage = Value / 100

C.14 底板 12V 电压

BOTTOMBOARD_VOLTAGE(12V)

表 28 整机输入电压

序号 byte 1 byte 2
功能 Bottomboard Voltage (12V)

寄存器说明

  1. 该寄存器用于读取设备的底板 12V 电压
  2. 单位 V,电压值由 2 bytes 组成。计算公式:Bottomboard Voltage (12V) = Value / 100

C.15 IMU 标定数据

IMU_CALIB_DATA

表 29 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

寄存器说明

  1. 该寄存器用于读取 IMU 相对于激光雷达坐标系的标定数据
  2. 该标定数据包含姿态估计和位置偏移,数据类型为 32 位 float(符合 IEEE 754 标准)
  3. 例如当前 x(byte 17~byte 20)的字节为 3b 8b 43 96,其计算方式如下:

    首先将 4 个字节组合为 32 位二进制数,即 00111011 10001011 01000011 10010110

  4. 分出符号位,指数域和尾数域。其中符号位是 31 位,即 0,指数域是 23 位~30 位,即 01110111,尾数域是 0~22 位,即 00010110100001110010110

  5. 计算各个域的值,根据 IEEE 754,其中符号域是 0,代表正数。指数域是 01110111,转换为十进制为 119,实际指数为 119-127=-8。尾数域对应 00010110100001110010110,该二进制代表的是小数位,再加上尾数位包含的 1,因此尾数为 1.00010110100001110010110,转化为十进制为 1.088
  6. 计算浮点数,利用公式 \(\text{Float32} = (-1)^{\text{符号域}} \times \text{尾数域} \times 2^{\text{指数域}} = (-1)^0 \times 1.088 \times 2^{-8} = 0.00425\)

附录 D 结构图纸

附录 E 各通道发射延时表

表 30 各通道发射延时表

通道序号 发射延时 (ns) 通道序号 发射延时 (ns)
00-07 0 24-31 28160
08-15 5280 32-39 42240
16-23 14080 40-47 51040