STM32驱动TOF400激光测距与OLED显示及蓝牙传输实战

简介这份资源面向嵌入式开发初学者与物联网方向学习者提供一套以STM32单片机为核心、集成TOF400激光测距模块的完整工程实践。系统通过飞行时间原理采集距离数据经STM32处理后由OLED1286显示屏实时呈现并借助蓝牙模块实现无线数据传输覆盖传感器驱动、显示控制与串口通信等关键环节。压缩包共172个文件约3.8MB以38个h头文件、35个c源文件为主体配合Keil工程配置、编译中间文件及hex烧录文件构成可直接编译调试的完整工程。目前已有1174人学习下载。读者可从中获取STM32外设编程、TOF400接口时序、OLED1286驱动初始化以及蓝牙通信协议等模块的参考实现适合作为课程设计、毕业设计或嵌入式入门练手的对照范例帮助快速理解多模块协同开发流程与硬件接口调试思路。1. 从一颗TOF400到一块OLED这套STM32激光测距方案到底在解决什么如果你手头正好有一块TOF400激光测距模块、一颗STM32最小系统板、一块OLED1286显示屏再外加一个蓝牙模块那么这套方案要干的事情其实很明确让单片机通过I2C把TOF400测到的距离读出来经过简单滤波和单位换算后实时显示在OLED屏上同时通过蓝牙把数据发到手机或上位机。它解决的是“短距离、非接触、低成本测距并即时可视化”的需求适合做机器人避障、液位检测、简易测距仪、教学实验这类场景。整套东西不复杂但坑集中在I2C时序、TOF400的初始化流程、OLED刷新效率和蓝牙串口的数据帧格式上。下面按“先跑通单模块、再拼系统、最后调稳定性”的顺序讲每一步都给可复现的代码和参数。2. TOF400与STM32的I2C对接从地址确认到单次测距2.1 先确认TOF400的通信方式和默认地址TOF400本质上是一颗基于飞行时间原理的激光测距芯片常见封装会带I2C接口默认7位地址一般是0x52具体以模块手册为准不同批次可能不同。它内部有测距配置寄存器、中断状态寄存器和距离结果寄存器。上电后不能直接读距离必须先写配置寄存器启动一次测量然后轮询状态位等数据就绪后再读结果。很多新手一上来就读结果寄存器读回来全是0或者0xFFFF这就是没走初始化流程。STM32这边我一般用硬件I2C速率设100kHz或400kHz都行但TOF400对时序比较敏感建议先用100kHz跑通再提速。GPIO要配成开漏复用模式外部上拉电阻4.7kΩ到3.3V不能省。如果模块自带电平转换确认逻辑电平是3.3V还是5V接错会直接烧I2C引脚。2.2 用HAL库写TOF400的初始化与单次读取下面这段代码是基于STM32 HAL库的I2C读写封装假设I2C句柄为hi2c1TOF400地址为0x52。先写配置寄存器启动单次测量再轮询状态寄存器最后读距离。#include stm32f1xx_hal.h #define TOF400_ADDR (0x52 1) // HAL库需要左移一位 #define TOF400_REG_CFG 0x00 #define TOF400_REG_STATUS 0x01 #define TOF400_REG_DIST 0x02 // 写一个字节到指定寄存器 uint8_t TOF400_WriteReg(uint8_t reg, uint8_t data) { return HAL_I2C_Mem_Write(hi2c1, TOF400_ADDR, reg, I2C_MEMADD_SIZE_8BIT, data, 1, 100); } // 读一个字节 uint8_t TOF400_ReadReg(uint8_t reg, uint8_t *data) { return HAL_I2C_Mem_Read(hi2c1, TOF400_ADDR, reg, I2C_MEMADD_SIZE_8BIT, data, 1, 100); } // 启动一次单次测距返回0表示成功 uint8_t TOF400_StartSingleMeasure(void) { // 配置寄存器bit0写1表示启动单次测量其余位保持默认 if (TOF400_WriteReg(TOF400_REG_CFG, 0x01) ! HAL_OK) return 1; return 0; } // 等待数据就绪并读取距离单位mm uint8_t TOF400_ReadDistance(uint16_t *dist_mm) { uint8_t status 0; uint32_t timeout 0; // 轮询状态寄存器bit0直到为1或超时 do { if (TOF400_ReadReg(TOF400_REG_STATUS, status) ! HAL_OK) return 1; HAL_Delay(1); timeout; } while (((status 0x01) 0) (timeout 100)); if (timeout 100) return 2; // 超时 // 距离结果通常是16位低字节在前 uint8_t buf[2]; if (HAL_I2C_Mem_Read(hi2c1, TOF400_ADDR, TOF400_REG_DIST, I2C_MEMADD_SIZE_8BIT, buf, 2, 100) ! HAL_OK) return 3; *dist_mm (uint16_t)(buf[1] 8) | buf[0]; return 0; }逻辑说明TOF400_WriteReg和TOF400_ReadReg用HAL_I2C_Mem_Write/Read直接操作寄存器地址。启动测量时只写配置寄存器bit0其他位保持默认避免误改量程或测量模式。轮询状态位时加了100ms超时防止I2C死锁导致程序卡死。距离结果按小端模式拼接如果读出来数值明显偏大或偏小先检查字节序。参数说明I2C超时时间100ms是保守值实际TOF400单次测量时间在几十毫秒量级如果超时频繁先降I2C速率到100kHz再检查上拉电阻是否焊好。TOF400_ADDR左移一位是因为HAL库要求传入8位地址而手册给的是7位地址。2.3 验证单模块用串口打印原始距离在接OLED之前先用串口把距离打出来确认TOF400本身工作正常。初始化串口后在主循环里每200ms调用一次TOF400_StartSingleMeasure和TOF400_ReadDistance把结果通过printf重定向到串口。如果串口助手能看到稳定变化的数据说明I2C链路和TOF400配置没问题。这一步不要跳过否则后面OLED不显示时你分不清是屏的问题还是TOF400的问题。常见现象是数据偶尔跳变到0或65535这通常是测量超时或目标反射率太低。解决方法是连续读三次取中值或者加一个简单的滑动平均。我一般会先连续读5次去掉最大最小值后取平均这样显示出来的数值会稳很多。3. OLED1286显示驱动从I2C地址扫描到距离刷新3.1 OLED1286的I2C地址与初始化序列OLED1286通常是0.96寸或1.3寸的I2C OLED屏控制器多为SSD1306或SH1106默认7位地址0x3C或0x3D。和TOF400共用一个I2C总线时要确保两个设备地址不冲突。上电后先扫描总线确认能同时看到0x52和0x3C。初始化序列包括关闭显示、设置时钟分频、设置多路复用比、设置显示偏移、设置起始行、设置对比度、设置预充电周期、设置COM引脚配置、设置VCOMH、开启电荷泵、开启显示。这些寄存器值在SSD1306数据手册里有典型值直接照抄即可。如果OLED不亮先量VCC和GND再量SCL和SDA是否有上拉。很多模块自带电平转换和上拉但有些廉价模块没有需要外接。I2C地址可以用下面这段扫描代码确认。// 扫描I2C总线上的设备打印地址 void I2C_Scan(void) { uint8_t addr; printf(I2C scan start...\r\n); for (addr 1; addr 128; addr) { if (HAL_I2C_IsDeviceReady(hi2c1, addr 1, 1, 10) HAL_OK) { printf(Found device at 0x%02X\r\n, addr); } } printf(I2C scan done.\r\n); }逻辑说明HAL_I2C_IsDeviceReady会尝试和每个7位地址通信如果收到ACK就认为设备存在。扫描前确保总线上只有TOF400和OLED避免其他设备干扰。如果只扫到0x52没扫到0x3C检查OLED的DC和RESET引脚是否接好有些模块需要硬件复位。3.2 把距离值显示到OLED最小刷新逻辑OLED显示距离不需要复杂GUI直接调用现成的SSD1306驱动库把距离格式化成字符串显示即可。下面是一个简化的刷新函数假设你已经移植好了OLED_Init、OLED_Clear、OLED_ShowString。#include oled.h #include stdio.h void Display_Distance(uint16_t dist_mm) { char str[20]; // 格式化成4位数字加单位不足补空格 sprintf(str, Dist:%4d mm, dist_mm); OLED_Clear(); OLED_ShowString(0, 0, (uint8_t *)TOF400 Laser, 16); OLED_ShowString(0, 2, (uint8_t *)str, 16); OLED_Refresh(); }逻辑说明OLED_Clear清空显存OLED_ShowString按页和列写入字符OLED_Refresh把显存推到屏幕。如果刷新率太高屏幕会闪建议每200ms刷新一次和TOF400测量周期匹配。sprintf在STM32上默认可能不支持浮点这里只用整数没问题。参数说明OLED_ShowString的坐标参数一般是列页页是8像素一行16号字体占两页。如果显示乱码检查字体取模方式是否和驱动库匹配。距离值如果超过9999mmTOF400可能已经超出量程显示“----”更合适。3.3 共总线时的时序冲突与分时复用TOF400和OLED挂在同一个I2C总线上时最大的坑是时序冲突。OLED刷新一次要写几百个字节如果在这期间去读TOF400I2C总线会被打断导致TOF400读取出错。解决办法是分时复用先读TOF400再刷OLED中间不要交叉。如果用了DMA刷OLED要等DMA完成后再启动TOF400测量。我一般会在主循环里用一个状态机状态0读TOF400状态1刷OLED状态2发蓝牙每个状态执行完再切下一个避免总线争用。另外OLED的I2C速率可以比TOF400高但共总线时只能取两者较低值。如果TOF400在400kHz下不稳定就把整个总线降到100kHzOLED刷新慢一点但不会出错。4. 蓝牙串口透传把距离数据发到手机4.1 蓝牙模块的AT配置与串口参数常见蓝牙模块默认波特率9600或115200数据位8停止位1无校验。用USB转TTL接模块发AT命令确认通信正常再改波特率和名称。STM32这边用一路USART接蓝牙的TXD和RXD注意交叉连接。如果蓝牙模块是3.3V逻辑直接接STM32的TX和RX如果是5V逻辑加电平转换。配置蓝牙时我一般会设成从机模式手机作为主机去连接。模块名称和PIN码按默认即可不需要复杂配对。关键是串口参数要和STM32端一致否则收到乱码。4.2 定义数据帧格式并发送直接发ASCII字符串最简单手机端用任意串口助手都能看。但为了后续解析方便建议加帧头和帧尾。下面是一个发送函数帧格式为“$DIST,1234mm#”。#include usart.h #include string.h void Bluetooth_SendDistance(uint16_t dist_mm) { char frame[32]; int len sprintf(frame, $DIST,%dmm#\r\n, dist_mm); HAL_UART_Transmit(huart2, (uint8_t *)frame, len, 100); }逻辑说明sprintf把距离拼成带帧头和帧尾的字符串HAL_UART_Transmit阻塞发送超时100ms。如果蓝牙模块波特率是9600发送32字节大约需要33ms不会阻塞太久。如果主循环里还有其他任务可以改用DMA发送。参数说明帧头$DIST和帧尾#是自定义的手机端解析时先找$再找#中间部分按逗号分割。\r\n是为了串口助手换行显示如果不需要可以去掉。距离值建议用整数避免浮点格式化占用太多空间。4.3 手机端接收验证与简单解析手机端可以用常见的蓝牙串口助手连接模块后打开通知就能看到不断刷新的距离字符串。如果收不到数据先检查STM32的TX是否接到蓝牙的RX蓝牙的TX是否接到STM32的RX。再用示波器或逻辑分析仪看STM32的TX引脚有没有波形。如果波形有但手机收不到检查蓝牙模块是否已经配对成功有些模块需要先配对再透传。解析时注意帧的完整性如果一次收到半帧要缓存起来等下一帧。简单做法是收到#才认为一帧结束然后提取中间的数字。距离值可以用来做阈值报警比如小于200mm时手机震动这部分在手机端实现即可。5. 避坑与排查TOF400激光测距系统最常见的5个翻车点5.1 现象OLED亮但TOF400读数为0或65535原因TOF400没有正确启动测量或者I2C地址不对。有些模块上电后需要拉低某个使能引脚才能工作手册里可能没写清楚。另外如果I2C总线上只有TOF400没有OLED时读数正常加上OLED后读数异常那就是总线冲突。解决先用I2C扫描确认地址再单独测试TOF400。检查使能引脚电平必要时加延时。共总线时降低速率到100kHz并在读TOF400前后加短暂延时让总线空闲。5.2 现象距离值跳变严重静止目标也上下浮动几十毫米原因TOF400的测量结果受目标反射率、环境光和测量模式影响。默认配置可能是短距离高精度模式但反射率低时噪声大。另外电源纹波也会导致激光驱动不稳定。解决在TOF400的VCC和GND之间并一个10uF和0.1uF电容。软件上连续读5次去掉最大最小值后取平均。如果还跳检查目标表面是否太暗或太亮换一个白色纸板测试。5.3 现象蓝牙发送数据时OLED闪烁或死机原因蓝牙发送是阻塞的如果波特率低发送期间CPU被占用OLED刷新被推迟看起来像闪烁。如果发送时中断了I2C时序可能导致OLED驱动库状态错乱。解决把蓝牙发送放到主循环最后或者用DMA发送。如果必须阻塞发送先把OLED刷完再发蓝牙。另外检查蓝牙模块的电源是否和STM32共地不共地会导致串口电平异常。5.4 现象I2C通信偶尔失败重启后正常原因I2C总线死锁通常是从设备在传输过程中被复位或电源波动导致SCL被拉低。STM32的硬件I2C在死锁后不会自动恢复。解决在I2C初始化后加一段总线恢复代码手动发送9个时钟脉冲。或者改用软件I2C虽然慢但不会死锁。电源上加复位芯片确保上电时序一致。5.5 现象手机能连上蓝牙但收不到数据原因蓝牙模块的串口波特率和STM32不一致或者模块处于AT模式没有退出。有些模块需要发ATRESET才能进入透传。解决用USB转TTL单独接蓝牙模块确认波特率。发AT命令看返回确认模块处于透传模式。检查STM32的TX引脚是否配置为复用推挽输出如果是开漏没有上拉波形会不正常。6. 进阶技巧用定时器中断做非阻塞测量与显示前面所有代码都是阻塞式主循环里读TOF400、刷OLED、发蓝牙任何一个环节卡住都会影响其他环节。实际产品里我一般会用定时器中断来分时调度定时器每10ms中断一次在中断里置标志位主循环根据标志位切换状态。TOF400的测量启动和读取分成两个状态中间留出足够的转换时间。OLED刷新和蓝牙发送也各自独立互不阻塞。具体做法是配置一个基本定时器比如TIM6溢出时间10ms中断里对一个全局计数器累加。主循环里判断计数器是否达到20200ms到了就启动一次TOF400测量再判断是否达到21到了就读距离并刷新OLED再判断是否达到22到了就发蓝牙。这样每个任务的时间片错开不会互相打断。验证方法很简单用逻辑分析仪抓I2C的SCL和串口TX看波形是否规整有没有交叉。如果TOF400读取时OLED的I2C没有活动说明分时成功。另外可以在每个状态切换时翻转一个GPIO用示波器看时间片是否均匀。我自己的习惯是任何需要同时跑多个外设的项目先画一个简单的时间片表格把每个任务的周期和耗时标出来再决定用中断还是状态机。这套TOF400加OLED加蓝牙的组合最稳的节奏就是200ms一轮TOF400测量占50msOLED刷新占30ms蓝牙发送占20ms剩下100ms空闲。不要试图把周期压到50ms以内TOF400本身响应不过来OLED也会闪。希望帮到你。本文还有配套的精品资源点击获取