# TOF10120 小激光的使用 | 封装为函数直接调用 | 手写 | HAL库 | 附官方标准库例程

最新推荐文章于 2023-03-02 10:06:34 发布
最新推荐文章于 2023-03-02 10:06:34 发布
阅读量2.1k 收藏 48
点赞数 24
分类专栏： 源码 C语言 传感器 文章标签： 嵌入式 串口通信 c语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Choulongx/article/details/119722392
版权
C语言 同时被 3 个专栏收录
5 篇文章 0 订阅
订阅专栏
源码
1 篇文章 0 订阅
订阅专栏
传感器
1 篇文章 0 订阅
订阅专栏

TOF10120 小激光的使用 | 封装为函数直接调用 | 手把手写HAL库 | 附官方标准库例程 | 可直接调用 | 串口

目录放给大家，只是需要源码的文末自取。
但是兄弟们不要忘记点个赞，收个藏呀！
谢谢各位了！

（链接定期更新，记得收藏! ）

文章目录

1. TOF10120传感器介绍

TOF是一款比较常用的近距离测距传感器，精度相对较高，价格也相对亲民。最近需要使用它来实现小车贴墙行走，所以在朋友的推荐下使用了这款传感器。但是在购买时店家给的手册很难读懂，后期调试代码时也出现了很多问题，所以打算写一篇教程来帮助大家更快入手这款传感器，帮助各位少走弯路。

这里贴上官方手册。

TOF10120官方手册 提取码：bai1

2. 如何使用

拿到一款传感器，首先要问自己，究竟它是什么通信方式。

TOF10120用了串口。

这里引用@Z小旋的教程，大家根据它来配置就好

STM32CubeMx串口配置

但是这里用一点需要重视！

在手册中提到TOF10120通信的波特率为9600bit

所以在教程中，要将这里
在这里插入图片描述

改成9600

记得开中断！

之后了解该传感器的通信原理，这里必须要从官方给的说明书中获取或者是官方给出的源代码。

说明书前面给到了。

这里给出官方给的stm32的标准库代码，格式很标准但是对于初学者不是很有好，这里我也贴出来。使用标准库的同学可以直接搬来用，但是用HAL库的直接看这篇博客就好。

官方TOF10120代码 提取码:bai1

那么这款传感器究竟是什么读取原理呢？

通过手册我们知道，在串口通信模式下，我们如果要读取距离信息要使用蓝色框住的这条命令

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-wBHKGm7E-1629041247738)(C:\Users\Loard_Bai\AppData\Roaming\Typora\typora-user-images\1629037751016.png)]

但是在 说明 栏目下提到，必须要在被动读取模式下才有效

所以在写代码之前，必须要在初始化代码中发出 “被动读取命令”

那什么是被动读取命令呢？

往下翻手册，发现

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-hpSh57GG-1629041247742)(C:\Users\Loard_Bai\AppData\Roaming\Typora\typora-user-images\1629037945647.png)]

所以现在思路很明确了，先开启被动读取命令吗，再循环读取距离就好了

但是注意，这里的返回值

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-pec0XGKC-1629041247744)(C:\Users\Loard_Bai\AppData\Roaming\Typora\typora-user-images\1629038067227.png)]

这个返回值应该是一串字符，而不是现成的数据，这一点是通过阅读源码得知的。想了解的可以自己下载下来看。

所以，我们还有一步是要将字符转换为16进制数，也就是我们后期提到的数据解算。

所以现在思路就很明确了。
设置被动读取模式
循环发送读取命令
循环数据结解算

接下来讲代码思路。

3. 代码思路

作为嵌入式程序员，我们不仅要知道功能怎么实现，更要将代码进行函数封装以达到直接调用的目的。这样不仅会让你移植程序更加简单便捷，而且整体的代码风格会更加清新简约。

这里将封装三个函数

  1. 初始化部分，也就是设置被动读取模式

  2. 循环发送读取命令的部分

  3. 数据解算 = 数据接收 + 数据转换

3.1 .被动读取模式 + 循环读取命令

两者其实是一类型的功能，都是通过串口，向TOF发送一系列字符作为指令，所以这里通过操作寄存器的方式实现此功能。

void Send_Data_To_UART(uint8_t dat){      
	  USART1->DR = dat; 
		while(!(USART1->SR & (1 << 6))); //循环发送，直到结束
}

有了这个函数做基础，我们来书写设置被动读取模式的函数，也就是初始化函数

void Tof_Init(void){
	Send_Data_To_UART('s');
	Send_Data_To_UART('5');
	Send_Data_To_UART('-');
	Send_Data_To_UART('1');
	Send_Data_To_UART('#'); //Set to passive reading mode
	HAL_Delay(10);
	HAL_UART_Receive_DMA(&huart1,tof0_dma_buff,TF_BUFFER_SIZE);	
	__HAL_UART_ENABLE_IT(&huart1,UART_IT_IDLE);	
}

可以看到，我们顺便开启了串口 空闲中断

此函数在初始化部分调用

之后再写设置发送读取命令的函数

void Get_Data_From_TOF0(void){

		Send_Data_To_UART('r');
		Send_Data_To_UART('6');
		Send_Data_To_UART('#');
}

此函数再rtos的任务 或者while 中循环调用

两大基本函数定义完成，接下来是数据解算了

3.2 .数据解算

数据解算分为数据接收 + 数据转换

3.2.1数据的接收。

首先是数据的接收

这是放在 中断中的

	if(huart->Instance== USART1){							//小激光串口
		Get_Data_From_TOF0();//发送读取命令
		HAL_UART_Receive_DMA(&huart1,tof0_dma_buff,TF_BUFFER_SIZE);	//开启DMA传输
		T0f_Conversion_HEX( tof0_dma_buff, &tof0 );//数据转换
	}

第三个后面会讲到

3.2.2 数据的转换

接下来要做的是数据转换。

我们知道，TOF接受到的数据格式直接就是字符串，所以为了得到距离信息，我们要做到提取以字符串形式存在的距离数字并储存在变量中。

这就引出了我们在 数据转换中要做的 第一步：判断有效数字的位置

3. 2.1 判断有效数字的位置

上文已经提到，TOF这个传感器直接给出 ‘L’ ‘’=’’ ‘X’ ‘X’ ‘X’ ‘m’ ‘m’ 或 ‘L’ ‘’=’’ ‘X’ ‘X’ ‘m’ ‘m’ 的字符串，这里的X就是我们要的有效数字，既然要提取这些数字，第一想法自然是区分两种情况了。

数组字符字符
0LL
1==
2XX
3XX
4Xm
5mm
6m

在这张表格中就可以很清晰的看出，区分两个数组的方法就是看【4】位置上的元素，如果是m 那么有两个 X，也就是说距离是两位数，如果不是m，那么它就是个三位数。 （由于TOF是可以测距到2000mm的，那么如果是四位数的量级你也要自己会写，这里限于篇幅原因只写到三位数，当做作业自己去完善试试）

于是给出以下代码进行判断

void T0f_Conversion_HEX( uint8_t tof0_dma_buff[], int *ptof0 ){
	
	int i = 0;
	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){	
			 break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
			 break;
		}else if( i == 6 && tof0_dma_buff[i] == 'm' ){
			 break;
		}
	}
	printf("%d\n",i);//测试代码，无需关注
}

对上述代码进行拆分讲解，看懂的可以略过。

	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){	
			 break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
			 break;
		}else if( i == 6 && tof0_dma_buff[i] == 'm' ){
			 break;
		}
	}

定义i变量后对数组进行遍历，发现字符 ‘m’ 后跳出循环，第一步， 选择有效数字 完成。

数据解算的第二步：解算为有效数字

3.2.2 解算为有效数组

由于不想增加思考难度，所以我这里打算对每种情况进行分类讨论，这样做虽然代码量较大，但是易于理解，这也是我写这篇教程的初心。如果大家有改善化的写法，欢迎放在评论区进行交流

我们直接讨论 i = 5的情况，也就是

数组字符
0L
1=
2x
3x
4x
5m
6m

此时大家发现，[2] 位乘100，[3] 位乘10，[4] 位乘1相加就是最后的准确数字
所以，我们只需要的到键入以下代码即可。

void T0f_Conversion_HEX( uint8_t tof0_dma_buff[], int *ptof0 ){
	int i = 0;
	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){	
		 	break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
							//转换为16进制 
	 		*ptof0 = tof0_dma_buff[i - 3] *100 + 
		 				tof0_dma_buff[i - 2] *10 + 
		 			 		tof0_dma_buff[i - 1] *1; 
		 break;
		}
	}
	printf("%d\n",i);
}

但是一个关键的问题是，我们每一位的数字实际上是ASCII码而不是16进制数，所以这样的数据执行现在的操作是不可行的，所以必须在注释位置进行进制转换。我们直接引用这位博主ASCII码转16进制的源码。

ASCII码转十六进制

这里贴出源码

unsigned char HexToChar(unsigned char bChar){
	if((bChar>=0x30)&&(bChar<=0x39)){
		bChar -= 0x30;
	}
	else if((bChar>=0x41)&&(bChar<=0x46)) {// Capital
		bChar -= 0x37;
	}
	else if((bChar>=0x61)&&(bChar<=0x66)) {//littlecase
		bChar -= 0x57;
	}else {
		bChar = 0xff;
	}
		return bChar;
}

我们在解算函数中调用

void T0f_Conversion_HEX( uint8_t tof0_dma_buff[], int *ptof0 ){
	
	int i = 0;
	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){	
			 break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
			
			tof0_dma_buff[i - 3] = HexToChar(tof0_dma_buff[i - 3]);
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 = tof0_dma_buff[i - 3] *100 + 
			 			tof0_dma_buff[i - 2] *10 + 
			 			 	tof0_dma_buff[i - 1] *1; 
			 break;
		}else if( i == 6 && tof0_dma_buff[i] == 'm' ){
			 break;
		}
	}
	printf("%d\n",i);
}

至此，三位数的解算完成，我们补全所有代码。

void T0f_Conversion_HEX( uint8_t tof0_dma_buff[], int *ptof0 ){
	
	int i = 0;
	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){
					
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 =  	tof0_dma_buff[i - 2] *10 + 
			 			 	tof0_dma_buff[i - 1] *1; 	
			 break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
			
			tof0_dma_buff[i - 3] = HexToChar(tof0_dma_buff[i - 3]);
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 = tof0_dma_buff[i - 3] *100 + 
			 			tof0_dma_buff[i - 2] *10 + 
			 			 	tof0_dma_buff[i - 1] *1; 
			 break;
		}else if( i == 6 && tof0_dma_buff[i] == 'm' ){
			tof0_dma_buff[i - 4] = HexToChar(tof0_dma_buff[i - 4]);
			tof0_dma_buff[i - 3] = HexToChar(tof0_dma_buff[i - 3]);
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 = tof0_dma_buff[i - 4] * 1000 +
			 			tof0_dma_buff[i - 3] * 100 + 
			 				tof0_dma_buff[i - 2] * 10 + 
			 			 		tof0_dma_buff[i - 1] * 1; 
			 break;
		}
	}
}

给你们把四位数的也贴出来了，不得点赞收藏转发支持一下???

???

4.核心代码

初始化（被动读取）：

void Send_Data_To_UART(uint8_t dat){      
	  USART1->DR = dat; 
		while(!(USART1->SR & (1 << 6))); //循环发送，直到结束
} 

void Tof_Init(void){
	Send_Data_To_UART('s');
	Send_Data_To_UART('5');
	Send_Data_To_UART('-');
	Send_Data_To_UART('1');
	Send_Data_To_UART('#'); //Set to passive reading mode
	HAL_Delay(10);
	HAL_UART_Receive_DMA(&huart1,tof0_dma_buff,TF_BUFFER_SIZE);	
	__HAL_UART_ENABLE_IT(&huart1,UART_IT_IDLE);	
}

发送读取命令：

void Get_Data_From_TOF0(void){

		Send_Data_To_UART('r');
		Send_Data_To_UART('6');
		Send_Data_To_UART('#');
}

数据解算：

	if(huart->Instance== USART1){							//小激光串口
		Get_Data_From_TOF0();//发送读取命令
		HAL_UART_Receive_DMA(&huart1,tof0_dma_buff,TF_BUFFER_SIZE);	//开启DMA传输
		T0f_Conversion_HEX( tof0_dma_buff, &tof0 );//数据转换
	}

void T0f_Conversion_HEX( uint8_t tof0_dma_buff[], int *ptof0 ){
	
	int i = 0;
	for( ; i < 10; i++ ){
		if( i == 4 && tof0_dma_buff[i] == 'm' ){
					
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 =  	tof0_dma_buff[i - 2] *10 + 
			 			 	tof0_dma_buff[i - 1] *1; 	
			 break;
		}else if( i == 5 && tof0_dma_buff[i] == 'm' ){
			
			tof0_dma_buff[i - 3] = HexToChar(tof0_dma_buff[i - 3]);
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 = tof0_dma_buff[i - 3] *100 + 
			 			tof0_dma_buff[i - 2] *10 + 
			 			 	tof0_dma_buff[i - 1] *1; 
			 break;
		}else if( i == 6 && tof0_dma_buff[i] == 'm' ){
			tof0_dma_buff[i - 4] = HexToChar(tof0_dma_buff[i - 4]);
			tof0_dma_buff[i - 3] = HexToChar(tof0_dma_buff[i - 3]);
			tof0_dma_buff[i - 2] = HexToChar(tof0_dma_buff[i - 2]);
			tof0_dma_buff[i - 1] = HexToChar(tof0_dma_buff[i - 1]);				//转换为16进制 
			 *ptof0 = tof0_dma_buff[i - 4] * 1000 +
			 			tof0_dma_buff[i - 3] * 100 + 
			 				tof0_dma_buff[i - 2] * 10 + 
			 			 		tof0_dma_buff[i - 1] * 1; 
			 break;
		}
	}
}

！后记

这篇文章太小众了，完整代码就不发了，如果需要可以在评论区留下你的邮箱，我会在当日发送。

如果喜欢这篇文章，可以在右下角点个 收藏

如果你也对嵌入式开发和算法感兴趣，可以点点关注，我的下一篇文章为你而来哦！

拜拜！

Loard_Bai
关注
  • 24
    点赞
  • 踩
  • 48
    收藏
    觉得还不错? 一键收藏
  • 42
    评论
专栏目录
基于stmf4激光测距传感器程序及其资料
06-17
电赛时改的程序，程序没有错误完美运行,模块是摩天的L1，程序都是通用的
【STM32训练—TOF激光测距模块】第一篇、STM32驱动TOF10120测量距离
热门推荐
大屁桃的博客
06-02 1万+
STM32调试TOF10120激光测距
利用STM32F103ZET6开发板基于HAL库的STM32学习笔记五：串口通信基础例程
01-21
以STM32CubeMX为依托，基于HAL库的STM32学习笔记之串口通信基础，使用STM32F103ZET6开发板，理解串行通信的相关概念，初步利用串口通信进行传输内容。
激光测距模块tof10120基于stm32f103开发板实现
10-27
tof10120激光模块最大的优势在于测距远、操作简单，程序中仅仅需要通过单片机给模块串口发送命令字符串，模块就可以向单片机发送回距离数据。如果发送自动测距的字符串命令，则模块会按照一定频率自动回送数据，相关物理量都可以通过命令字符串设置。仅需要串口就可以实现。
TOF距离传感器
TSINGHUAJOKING
02-01 9661
第十四届智能车竞赛赛道中凸显的横断路障，它让去年韩国国内智能车竞赛中参加决赛的队伍备受困扰，同样，它也使得今年国内参加比赛的队员感到苦恼。 2018年韩国全国大学生智能车竞赛中的横断路障 成功越过横断路障的关键就是需要能够尽可能提前检测到它的存在，然后在路障前后的一米区内精确绕过路障。 在绕过路障的过程中，车模不再具有赛道的导引。如果仅仅依靠车模开环控制完成绕行，则车模的轨迹就会受到赛道环境的影...
激光测距模块tof10120基于stm32f103开发板实现 3串口操作（串口1用于和上位机通信，串口2，3可用来连接激光模块）
10-28
上次的程序由于串口2USART2.c文件里串口2中断函数对数据的处理中没有对0x0a和0x0D进行判断，因此只有串口一是可以正常用的，这次的程序我对串口2中断函数进行了修改，完全按照串口一的处理，同时保留了u2_printf函数可用于和单片机向测距模块传送字符串；另外按照相同的模式，扩展了串口三，也是串口一中断的方法，扩展了u3_printf函数。 因此可以用三个串口中任何一个使单片机与上位机通信，另外两个各接一个激光测距模块，可以同时监控两个测距模块，实际做小车等机器人时，三个串口都可以接激光测距模块，这样可以同时搞三个，如果还想扩展，可以按照相同方法加入新的串口。程序完全自己写的，也是在网上没找到stm32的实现例程，淘宝卖家说只有用Arduino的程序，所以就自己写了，希望用这个模块的人都能看到。
TOF10120规格书
01-29
TOF10120测距传感器提供了精确和可重复的远距离测量用于高速自动对焦（AF）.创新的TOF time-of-flight技术使该传感器性能独立于目标物体的反射率 .
基于STM32F4的TOF10120激光测距
pi的博客
12-25 4253
使用的是串口触发方式，板子还是iCore3那块，芯片是F4的，大同小异，直接上代码 distance.c #include "..\include\distance.h" #include "..\include\sys.h" #include "..\include\delay.h" #include "..\include\timer3.h" #include "..\include\usart.h" #include "..\fwlib\inc\stm32f4xx_gpio.h" #include "
TOF10120技术参数规格书_20190409.pdf
08-03
激光测距模块TOF10120技术参数规格书
TOF10120.rar
09-03
新手小白一个。最近在学习STM32，买了TOF10120激光测距模块，在网上找了很多资源学习，最后实现用使用激光测距来改变LED的闪烁频率。
stm32 hal库 激光测距模块ToF 串口版本
08-01
stm32 hal库 激光测距模块ToF 串口版本
TOF10120技术参数规格书及代码0711_tof_
09-29
TOF10120技术参数规格书及代码0711
TOF10120技术参数规格书及代码.zip
08-18
激光测距模块开发手册，详细的器件资料以及代码说明
STM32驱动TOF10120激光测距模块的完整代码
06-02
STM32驱动TOF10120激光测距模块的完整代码
模块学习（三）——激光测距模块（TOF10120）
qq_51406846的博客
07-19 4207
基于MSP430f5529的TOF10120模块使用
STM32 HAL库硬I2C的TOF050C模块
星羽空间
03-02 2058
STM32 基于硬I2C开发TOF050C模块
VL53L0x TOF激光测距的 stm32 HAL库驱动代码
Mark_md的博客
07-30 7484
VL53L0x 是ST公司生成的TOF激光测距传感器，得益于非常小巧的尺寸，很容易放入手机、无人机中，提供更加精准、稳定的测距方式。 本文代码，使用 STM32F4xx的 HAL库。 VL53L0x.c #include "VL53L0x.h" #include <math.h> #include "PersonalMath.h" struct VL53L0xData VL53L0x_Bottom; //底部连接在IIC2的VL53L0x的数据 void VL53...
stm32TOF400H激光测距hal库
最新发布
07-28
根据引用\[1\]和引用\[3\]的内容，可以看出STM32F4系列的MCU可以通过使用HAL库来实现激光测距功能。在使用HAL库之前，需要进行一些配置，包括RCC配置、SYS配置、VL530使能口配置等。然后，可以使用Keil来配置STM32F4和引入相关库文件，包括IIC口配置和VL530底层配置。接下来，可以通过初始化配置、获取数据和结果展示来读取激光测距数据。根据引用\[2\]的内容，激光测距模块可以提供环境统计、信号数统计和相对距离等数据。测距模块的测试精度为20mm到3m，如果超出这个范围，会显示20或者8190。整个程序的初始化配置可以在主函数中完成，包括包含相关头文件和进行测距初始化。如果需要完整的工程，可以通过提供的程序下载链接获取。 #### 引用[.reference_title] - *1* *2* *3* [STM32F4+VL530L0x激光测距cubemx实现](https://blog.csdn.net/weixin_44984773/article/details/118878481)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 42
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值