产品简介

TOF Laser Range Sensor 系列是基于 TOF (飞行时间) 技术的激光测距传感器。内置控制器和测距算法，测距范围可达25m，精度高达 ±3cm。支持 UART、I2C和 I/O互补电平输出通信，具备超小的 FOV 角，使得距离更远抗光干扰能力更强，室内外环境均适用，抗环境光能力最高约 100K LUX 照度，可以作为测距工具进行距离检测，也可作为机器人避障/路线规划，还可用于无人机定高/天花板检测和料位测量等领域。

免责声明

应用场景

• 无人机定高、天花板检测
• 机器人避障
• 测量与检测
• 智能手势控制
• 料位测量

工作原理

TOF是一种绝对距离检测技术，即传感器发出经过调试的近红外光，遇物体后反射，传感器通过计算光线发射和反射时差或相位差，来换算被拍摄景物的距离，以产生深度信息。相比于双目方案与3D结构光方案，TOF具有工作距离远，适用场景广，较远距离精度高等优点。因此常被应用于人员接近检测、机器人避障、照相机自动对焦等场合。

产品参数

Frame Header + Function Mark + Data + Sum Check

57 00 ff 00 9e 8f 00 00 ad 08 00 00 03 00 06 41

57 10 FF FF 00 FF FF 63

AD 08 00 00 03 00 FF FF

软件说明

TOF Assistant是TOF激光测距模块配套的调试软件，主要作用为：配置调试、状态显示、功能应用、固件升级：

• 配置调试：用于配置节点相关参数，如ID、工作模式、波特率等。
• 功能应用：用于应用开发，如数据导入导出、运动轨迹存储、历史轨迹回放等。
• 固件升级：用于给产品进行有线固件升级。

产品尺寸

树莓派使用

• 成功开机后，进行树莓派环境配置

下载程序

wget https://www.waveshare.net/w/upload/0/01/TOF_Laser_Range_Sensor_demo.zip
unzip TOF_Laser_Range_Sensor_demo.zip
cd TOF_Laser_Range_Sensor_demo/

UART示例使用

开启树莓派 UART

• 在树莓派终端输入命令：sudo raspi-config nonint do_serial 2
• 再弹出的窗口中第一个选择NO，第二个选择YES,最后选择OK.

使用上位机配置成UART

• 默认是不需要配置的，可以直接使用，如果之前配置成了I2C或者I/O模式，需要参考FAQ的方法，将传感器复原。
• 复原视频请参考这个：

硬件连接

• 参考下图进行连接：

运行C程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/c/UART/
make
./main

• 终端就会输出相关的信息，如下图：

运行Python程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/python/UART/example
python main.py 

• 终端就会输出相关的信息，如下图：

I2C示例使用

开启树莓派 I2C

• 在树莓派终端输入命令：sudo raspi-config nonint do_i2c 0

使用上位机配置成I2C

• 如何配置成I2C模式，请参考功能描述中的 I2C | 集成电路总线

硬件连接

接入树莓派I2C的参考如下： 

运行C程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/c/I2C/
make
./main

• 终端就会输出相关的信息，如下图：

运行Python程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/python/I2C/example
python main.py 

• 终端就会输出相关的信息，如下图：

IO示例使用

使用上位机配置成IO

• 如何配置成IO模式，请参考功能描述中的 I/O Output | I/O 输出

硬件连接

接入树莓派IO的参考如下： 

安装C库

sudo apt-get update
sudo apt install gpiod libgpiod-dev

运行C程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/c/IO/
make
./main

• 终端就会输出相关的信息，如下图：

运行Python程序

cd ~/TOF_Laser_Range_Sensor_demo/Raspberry/python/IO/
python TOF_IO_Demo.py 

• 终端就会输出相关的信息，如下图：

ESP32S3使用

• 环境搭建完成后，即可连接传感器，下载示例

硬件连接

• 参考下图进行连接：

Arduino示例使用

UART

• 使用上位机配置成UART，默认是不需要配置的，可以直接使用，如果之前配置成了I2C或者I/O模式，需要参考FAQ的方法，将传感器复原。
• 复原视频请参考这个：

• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\UART\Arduino\TOF_URAT_Demo，双击TOF_URAT_Demo.ino文件
• 选择开发板：

• 选择ESP32S3的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

I2C

• 如何配置成I2C模式，请参考功能描述中的 I2C | 集成电路总线
• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\I2C\Arduino\TOF_I2C_Demo，双击TOF_I2C_Demo.ino文件
• 选择开发板：

• 选择ESP32S3的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

IO

• 如何配置成IO模式，请参考功能描述中的 I/O Output | I/O 输出
• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\IO\Arduino\TOF_IO_Demo，双击TOF_IO_Demo.ino文件
• 选择开发板：

• 选择ESP32S3的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

Micropython示例使用

UART

• 使用上位机配置成UART，默认是不需要配置的，可以直接使用，如果之前配置成了I2C或者I/O模式，需要参考FAQ的方法，将传感器复原。
• 复原视频请参考这个：

• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\UART\micropython，双击TOF_URAT_Demo.py文件
• 选择开发板：

• 选择ESP32S3的端口，然后运行程序
• Shell就会输出相关的信息，如下图：

I2C

• 如何配置成I2C模式，请参考功能描述中的 I2C | 集成电路总线
• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\I2C\micropython，双击TOF_I2C_Demo.py文件
• 选择开发板：

• 选择ESP32S3的端口，然后运行程序
• Shell就会输出相关的信息，如下图：

IO

• 如何配置成IO模式，请参考功能描述中的 I/O Output | I/O 输出
• 进入到TOF_Laser_Range_Sensor_demo\ESP32S3\IO\micropython，双击TOF_IO_Demo.py文件
• 选择开发板：

• 选择ESP32S3的端口，然后运行程序
• Shell就会输出相关的信息，如下图：

Arduino使用

• 环境搭建完成后，即可连接传感器，下载示例

Arduino示例使用

UART

• 使用上位机配置成UART，默认是不需要配置的，可以直接使用，如果之前配置成了I2C或者I/O模式，需要参考FAQ的方法，将传感器复原。
• 复原视频请参考这个：

硬件连接

• 参考下图进行连接：

Arduino UNO R3

Arduino UNO R4

运行程序

• 进入到TOF_Laser_Range_Sensor_demo\Arduino\UART\TOF_URAT_Demo，双击TOF_URAT_Demo.ino文件
• 选择开发板：

Arduino UNO R3

Arduino UNO R4

• 选择开发板的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

I2C

• 如何配置成I2C模式，请参考功能描述中的 I2C | 集成电路总线

硬件连接

• 参考下图进行连接：

运行程序

• 进入到TOF_Laser_Range_Sensor_demo\Arduino\I2C\TOF_I2C_Demo，双击TOF_I2C_Demo.ino文件
• 选择开发板：

Arduino UNO R3

Arduino UNO R4

• 选择开发板的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

IO

• 如何配置成IO模式，请参考功能描述中的 I/O Output | I/O 输出

硬件连接

• 参考下图进行连接：

运行程序

• 进入到TOF_Laser_Range_Sensor_demo\Arduino\IO\TOF_IO_Demo，双击TOF_IO_Demo.ino文件
• 选择开发板：

Arduino UNO R3

Arduino UNO R4

• 选择开发板的端口，然后进行编译上传
• 上传完成后，打开串口监测器，就会输出相关的信息，如下图：

资料

程序

• 示例程序

软件

• TOF Assistant上位机助手 (Windows 7/10 64位机用)

FAQ

Q1. 室外（强光）条件下可以用吗？

  模块可以抵抗一定的自然光影响。可以在室外使用。

Q2. 多个模块是否有干扰？

  当多个模块同时工作时，即使相互之间的红外光线交叉或打到同一个位置，也不会影响实际测量。如果两个模块处于同一水平高度，且分别朝向对方时测量会对双方都有影响。

Q3. 为什么模块没有数据输出？

  各个模块均经过严格的测试后发货，没有数据时请先自行检查模式、接线（供电电压、线序 是否正确，以及推荐使用万用表测试通信双方两端的引脚是否导通）、波特率等配置是否正确； 对于 IIC 输出模式，需要使用主机通过 IIC 通信向设置的从机地址按照手册的通信时序来读取数 据；对于 I/O 输出模式，请参考 I/O 模式相关章节介绍。

Q4. 安装时需要注意什么？

安装时需避免 FOV 角度内有遮挡。另外需要注意与地面高度，应避免 FOV 内出现地面遮挡 等类似反射面，如果安装高度离地面较近，可以考虑将模块稍微倾斜向上进行安装。

Q5. 模块的 UART、IIC 和 I/O 是同一个接口吗？

模块的 UART、IIC、I/O 接口共用相同的物理接口，针对不同的通讯模式转换对应线序即可。

Q6. 切换到 IIC 或 I/O 模式后，为什么 Waveshare TOFAssistant 软件识别不了模块？如何在不同通讯模式间 进行切换？

目前 NAssistant 软件只支持识别 UART 模式下的模块。在 UART 模式下时，可以通过上位机识别成功后进入设置页面将模块配置为 IIC 或 I/O 通讯模式；在 IIC 通讯模式下，可以按照IIC通信协议通过 IIC 通信向模块发送指令来切换回 UART 或 I/O 模式；此外，在没有IIC 测试环境或者切换到 I/O 模式后可以通过以下方式来切换回 UART 模式：
1、用户需要准备一个支持 921600 波特率的 USB 转 TTL 模块（推荐CP2102）并且安装对应的驱动程序，将 USB 转 TTL 模块的 TX、RX、GND 三根线连接到 TOF 模块的对应引脚，VCC引脚暂时先不连接，然后把 USB 转 TTL 模块插入电脑。
2、打开 NAssistant 软件，点击 图标进入串口调试助手，把波特率改为921600，选择USB转 TTL 模块对应的 COM 口然后点击 连接按钮连接 COM 口（大部分情况下会自动连接），在单项发送的文本框内输入 54 20 00 ff 00 ff ff ff ff 00 ff ff 00 10 0e ff ff ff ff ff ff ff ff ff ff ff 00 ff ff ff ff 7c，在右下角的定时发送栏将发送间隔改为 20ms，然后勾选定时发送。
3、此时将 USB 转 TTL 模块的 5V 接到 TOF 模块的 VCC 引脚，模块会切换到UART模式并开始输出数据，此时取消勾选定时发送按钮，然后拔掉 USB 转 TTL 模块重新给模块上电后点击主页面的 识别按钮即可识别模块。
如果切换失败，将 USB 转 TTL 模块拔掉再重复一下整个步骤，切勿在发送命令的情况下多次插拔 VCC 引脚。如果能够正常识别模块但是串口输出数据异常，可以在设置页面中手动更改到 UART 模式。
PS：如果将 TOF 模块的 VCC 引脚接到 USB 转 TTL 模块的 5V 后出现模块一直发送80 00 8000..类似的协议数据的情况，先点击 连接按钮暂时断开 COM 口，把波特率改为115200 然后点击 连接按钮重新连接 COM 口，如果此时串口调试助手的数据为 b3 b1 开头的数据则需要在单项发送的文本框内输入 de ed 00 00 05 04 3b 01 00 00 10 ，单击发送，然后拔掉USB 转TTL模块重新给模块上电后点击主页面的识别按钮即可识别模块。如果重新插上后数据还是b3 b1 开头，重复一下 PS 的步骤。

Q7. 超量程时模块会输出什么数据？

超过 25 米量程时，距离输出固定值 0 米，此时可以参考数据手册的距离状态指示来判断数据是否有效。

Q8. 模块是否支持输出点云信息？

模块单次只能输出一个距离，暂时不支持点云信息的输出。

Q9. 模块使用的串口通信端子型号是什么？飞控、单片机上没有这个端子的接口怎么办？

模块使用的是 GH1.25 的端子。可以自行购买 GH1.25 转其他端子的转接线，或者剪断产 品 附带的 GH1.25-GH1.25 接线，自行焊接其他的端子。线序、供电电压、信号线电平等请参 考数 据手册。

Q10. 接收到的 ad 08 00 如何解算为距离值？

协议帧中的数据是小端模式存储的，而且编码时乘了一定的倍率，举例来说 ad 08 00 先恢复 成 16 进制数据 0x0008ad 换算成 10 进制为 2221，除以 1000 为 2.221 米。

Q11. 校验和是怎么计算的？

校验和就是前面所有的字节相加然后取最低字节的数据，比如 55 01 00 ef 03 的校验和就是 0x55+0x01+0x00+0xef+0x03=0x0148，那校验和就是 48，所以这一帧的完整数据是 55 01 00 ef 03 48。

Q12. 为什么 IIC 模式下无法通信？

IIC 模式下，设备的 SDA 和 SCL 引脚推荐使用开漏模式输出，此时总线上需要有上拉电阻。 通信时需要按照标准的 IIC 通信时序来编写起始、终止、读、写、应答等函数，与 TOF 模块通 信时，参考用户手册的 NLink_TOFSense_IIC_Frame0 协议来对寄存器进行读取和写入。特别要 注意 7 位从机地址的移位与增加读写位发送。

Q13. 打开软件报错“由于找不到 MSVC***.dll 文件……”，可能是电脑缺少微软相应运行时组件，选择系统对应位数下载安装通常即可解决？

Visual C++ Redistributable for Visual Studio 2017，若上述安装失败或者 显示成功但打开TOFAssistant程序仍提示缺少dll文件，则尝试安装 KB2999226 补丁程序，注意，请选择电脑系统对应版本补丁程序，详细请参考博客关于 api-ms-win-crt-runtimel1-1-0.dll 缺失的解决方案

Q14. 打开软件报错“由于找不到Qt***.dll……”？

请检查安装文件是否被360等安全软件无声拦截，请退出安全软件后，重新安装。另外以管理员权限运行

Q15. 物体表面反射率会影响传感器吗？

售后

啊