Contents UM2356
2/27 DocID031478 Rev 1
内容
1
VL53L1X系统概述 .............................................................................................................. 4
2
测距API函数描述 .............................................................................................................. 5
2.1
自主测距说明 ...................................................................................................................... 5
2.2
时机考虑 ............................................................................................................................. 5
2.3
API函数调用流程 ................................................................................................................ 6
2.3.1 校准流程 ............................................................................................................................. 6
2.3.2 流量 .................................................................................................................................... 7
2.4 强制测距功能 .................................................................................................................... ..8
2.4.1 数据初始化 ........................................................................................................................ ..8
2.4.2 静态初始化 ........................................................................................................................ ..8
2.4.3 开始测量 ........................................................................................................................... ..8
2.4.4 等待结果:轮询或中断 ...................................................................................................... ..8
2.4.5 获取测量 ........................................................................................................................... ..8
2.4.6 清楚中断的来源 ................................................................................................................ ..9
2.4.7 停止测量 ........................................................................................................................... ..9
2.5 可选的驱动功能 ................................................................................................................ ..9
2.5.1 等待启动 ........................................................................................................................... ..9
2.5.2 时间预算和测量间期 ......................................................................................................... ..9
2.5.3 距离模式 ........................................................................................................................... 10
2.5.4 限制检查设置 .................................................................................................................... 10
2.5.5 阈值 .................................................................................................................................. 12
2.5.6 感兴趣区域(ROI)设置 ................................................................................................... 13
2.5.7 Spad数组坐标与场景 .......................................................................................................... 15
2.5.8 光学中心坐标 .................................................................................................................... 15
2.5.9 VDDIO配置 ......................................................................................................................... 16
2.6 RangingMeasurementData结构 ........................................................................................... 16
3
校准功能 ........................................................................................................................ 18
3.1
RefSPAD校准 ...................................................................................................................... 18
3.1.1 RefSPAD校准功能 ............................................................................................................... 18
3.1.2 RefSPAD校准程序 ............................................................................................................... 19
3.1.3 获得RefSPAD校准结果 ....................................................................................................... 19
Contents UM2356
3/27 DocID031478 Rev 1
3.1.4 设置RefSPAD校准数据 ....................................................................................................... 19
3.2 偏移校准 ........................................................................................................................... 20
3.2.1 偏移校准功能 .................................................................................................................... 20
3.2.2 偏移校准程序 .................................................................................................................... 20
3.2.3 获得偏移校准结果 ............................................................................................................ 20
3.2.4 设置偏移校准数据 ............................................................................................................ 20
3.3 串扰校准 ........................................................................................................................... 21
3.3.1 串扰校准功能 .................................................................................................................... 21
3.3.2 串扰校准程序 .................................................................................................................... 21
3.3.3 串扰校准距离表征 ............................................................................................................ 21
3.3.4 获得串扰校准结果 ............................................................................................................ 22
3.3.5 设置串扰校准数据 ............................................................................................................ 22
3.3.6 启用/禁用串扰补偿 ........................................................................................................... 23
4
驱动程序错误和警告 ...................................................................................................... 24
5
缩略语 ............................................................................................................................ 26
6
修订记录 ........................................................................................................................ 27
4/27 DocID031478 Rev 1
VL53L1X system overview UM2356
y^LJƐƚĞ
s>ρϯ ϭy
ŵŵĚƵĚ
ƵĞ
1
VL53L1X系统概述
VL53L1X系统由VL53L1X模块和在主机上运行的驱动程序组成。
图2. VL53L1X系统
ST提供了一个软件驱动程序,在本文档中称为“驱动程序”。
本文档介绍主机可以访问的驱动程序功能,以控制设备并获取测距数据。
该驱动程序是使用VL53L1X器件的一组功能的实现。 它对OS集成和服务做了最少的假设。
因此,动作的排序,执行/线程模型,平台适配和设备结构分配不是驱动程序实现的一部
分,而是对软件集成商保持开放。
函数调用的顺序必须遵循本文档中定义的一组规则。
,ŽƐƚ
ŽƐ
ƚ
s>ϱϯ>ϭy^LJƐƚĞŵ
s>ϱϯ>ϭy
ŵŽĚƵůĞ
s>ϱϯ>ϭy
ƌŝǀĞƌ
/Ϯ
5/27 DocID031478 Rev 1
UM2356 Ranging API function descriptions
2
测距API函数描述
本节给出了测距的功能描述,并描述了使用VL53L1X执行测距测量时应遵循的API呼叫流程。
2.1
自主测距说明
传感器通过可编程的测量间隔周期连续自动执行测距。
测距是在没有主机参与的情况下完成的,这允许主机处于低功率状态。 当测距可用时,
主机仅在测量中断时唤醒。
可以设置距离和/或信号检测标准的阈值,然后在满足标准时引发中断。
2.2
时机考虑
定时预算定义为传感器执行和报告测距测量数据所需的编程时间。 在此期间,VCSEL脉动。
在计时预算结束时引发中断或更新日期就绪寄存器。
测量间期被定义为两次连续测量之间的编程时间。
图3
显示时间预算和测量间期。
主机可以通过使用专用驱动程序功能来更改默认的时间预算和测量间隔时间
第2.5.2节:时
间预算和相互测量
期
.
主持人可以决定更改时间预算以提高测距精度或最大距离限制。
图3. VL53L1X自动量程序列和时序
5DQJLQJ
3RZHU6XSSO\
*3,2,QWHUUXSW
;6KXW
'ULYHU&RPPDQG
6WDUW
5DQJLQJ
6\VWHP6WDWH
6:6WDQGE\
6:6WDQGE\
5DQJLQJ
6WRS
5DQJ
*HW
5DQJ
&OHDU
,QW
5DQJLQJ
5DQJLQJ
,QLW
*HW
5DQJ
7LPLQJ%XGJHW
,QWHU0HDVXUHPHQW
7LPLQJ%XGJHW
,QWHU0HDVXUHPHQW
,QWHU0HDVXUHPHQW3HULRG
评论0