简介这是一份基于51单片机的VL53L0X激光距离传感器校准与距离读取C源码工程适合51单片机学习者和毕业设计、课程设计场景。代码通过I2C接口驱动传感器包含初始化校准、距离测量以及通过串口输出的完整逻辑并适配STC15系列单片机方便移植到其他51平台。工程文件共94个涵盖C源文件、头文件、Keil工程配置、Hex烧录文件以及说明文档压缩包仅355KB结构紧凑便于直接查看和二次修改。当前已有226人学习使用。资源内还附带项目必读与README说明帮助快速了解编译环境和硬件连接降低上手门槛。代码变量命名清晰函数模块划分明确适合用于学习激光测距原理、I2C通信以及单片机嵌入式开发也可作为实际项目的前期验证基础。1. 为什么 51 单片机也能跑 VL53L0X而且还要先做校准VL53L0X 是 ST 基于 ToF飞行时间原理的激光距离传感器测距范围标称 30mm 到 2000mmI2C 接口。很多开发者下意识以为只有 STM32 这类主控才能带得动实际上它只是一个从设备只要主控能模拟出合格的 I2C 时序51 单片机完全可以把距离数据读回来。这套 C 源码是基于 STC15 系列做的完整 Keil 工程包含 i2c.c、vl53l0x.c、uart.c、delay.c烧录后通过串口就能看到毫米级距离值。适合做毕业设计、课程设计的学生也适合做倒车雷达、智能小车避障的 DIY 爱好者。不过直接读数是会出问题的模块前面的玻璃盖板、装配应力、甚至焊锡不均匀都会让测量值整体偏移。这就是为什么要先校准。这份代码把校准和读取做了分离校准后的参数可以直接参与后续运算。2. VL53L0X 测距原理与 51 侧 I2C 时序设计2.1 ToF 原理决定了 VL53L0X 不能被当超声波用VL53L0X 内部有一个 940nm 的 VCSEL 激光发射器和一个 SPAD 单光子雪崩二极管阵列。它测量的是激光发出后打到目标再反射回来的飞行时间乘以光速除以 2 就是距离。这个原理和超声波测距完全不一样不受环境光和物体颜色的影响但非常依赖反射面。反射率低的黑色物体、倾斜角度过大的表面、透明玻璃都会让测距值失真。寄存器层面VL53L0X 的 7 位 I2C 地址是 0x298 位写地址是 0x52。它内部其实是一大片寄存器和一小块 RAM控制测量模式、读取状态、校准参数都要通过 I2C 访问。最常打交道的几个寄存器如下寄存器地址名称作用0x00WHO_AM_I固定返回 0xEE用于确认 I2C 通信正常0x80VHV_CONFIG触发测量、配置 VHV 校准0x83MSRC_CONFIG_CONTROL测量就绪状态0x91RESULT_INTERRUPT_STATUS判断测量数据是否有效0x94 / 0x95RESULT_RANGE_MM距离原始值低 13 位有效2.2 51 用 GPIO 模拟 I2C 的时序取舍STC15 系列是大致兼容 8051 指令集的增强型单片机有硬件 I2C但很多封装下引脚复用和内部上拉配置比较绕工程里普遍更愿意直接用两个普通 IO 口模拟 I2C。模拟 I2C 时需要注意三个点SCL 频率、起始/停止条件、ACK 处理。VL53L0X 支持标准 100kHz 和快速 400kHz 模式。51 单片机主频通常跑在 11.0592MHz 或 24MHz模拟 I2C 跑 100kHz 比较稳妥。我一般会在延时函数上加 5 微秒左右的半周期延时SCL 高电平时采样 SDA保证从设备有足够时间准备数据。2.2.1 i2c.c 里的起始、停止和字节收发#define I2C_SCL P2_0 #define I2C_SDA P2_1 void I2C_Start(void) { I2C_SDA 1; I2C_SCL 1; Delay_us(5); I2C_SDA 0; // SCL 高电平期间 SDA 拉低产生起始条件 Delay_us(5); I2C_SCL 0; } void I2C_Stop(void) { I2C_SDA 0; I2C_SCL 1; Delay_us(5); I2C_SDA 1; // SCL 高电平期间 SDA 拉高产生停止条件 Delay_us(5); } unsigned char I2C_WriteByte(unsigned char dat) { unsigned char i; for (i 0; i 8; i) { I2C_SDA (dat 0x80) ? 1 : 0; // 先发高位 dat 1; I2C_SCL 1; Delay_us(5); I2C_SCL 0; Delay_us(5); } I2C_SDA 1; // 释放 SDA等待从设备 ACK I2C_SCL 1; Delay_us(5); if (I2C_SDA) { // SDA 仍为高说明没有 ACK I2C_SCL 0; return 1; } I2C_SCL 0; Delay_us(5); return 0; }代码里的Delay_us(5)是重新定义的一个微秒级延时函数循环空转次数要根据主频和编译器优化级别调整。如果 I2C 波特率上不去先检查这里是否被优化掉了。ACK 检测很重要VL53L0X 在内部状态还没就绪时会直接不响应如果没有 ACK 就盲目写后续数据整个校准流程会静默失败。注意如果 VL53L0X 的 SCL/SDA 直接接在 5V 单片机的 IO 口上中间必须加电平转换否则长期运行可能损坏传感器。2.3 校准前必须完成的初始化序列VL53L0X 上电后不能直接开始测距要先做一次软复位然后配置 VHV 和相位校准相关寄存器。下面这段初始化代码是 vl53l0x.c 里最前面的部分执行完才能保证测量的基线是正确的unsigned char VL53L0X_Init(void) { unsigned char id; I2C_WriteReg(0x00, 0x00); // 解除寄存器访问保护 id I2C_ReadReg(0x00); // 读 WHO_AM_I if (id ! 0xEE) return 0xFF; // 通信失败 I2C_WriteReg(0x80, 0x01); // 软复位 Delay_ms(10); I2C_WriteReg(0x80, 0x00); // 退出软复位 // 参考时钟配置 I2C_WriteReg(0x89, 0x00); I2C_WriteReg(0x88, 0x00); Delay_ms(100); return 0; }I2C_WriteReg和I2C_ReadReg是在 i2c.c 上层封装的寄存器读写函数内部先发设备地址再发寄存器地址最后读或写数据。初始化完成后建议读一次寄存器 0x91正常情况下应该是 0x04 之外的合法状态值。如果卡在这里多半是模块供电不足或者 SCL/SDA 上拉电阻缺失VL53L0X 内部有上拉但外部再加 4.7k 上拉到 3.3V 更稳。3. 距离读取流程与校准参数处理3.1 单次测量比连续测量更适合 51VL53L0X 支持单次测距和连续测距。连续模式下传感器自己按设定周期刷新数据主控只要一边读一边显示。听起来方便但对 51 单片机来说反而容易踩坑主控忙别的事情时数据可能已经更新了好几轮读到的结果和触发的时刻对不上。单次测量是「写触发、等中断或轮询、读结果」的闭环过程每次结果都对应一次真实测量精度和可解释性都更好。下面是单次测距的流程设置测量模式为单次写入 0x80 触发然后不断轮询 0x91 寄存器等待状态位置 1。unsigned int VL53L0X_ReadDistance(void) { unsigned char status; unsigned int dist 0; I2C_WriteReg(0x80, 0x01); // 触发单次测距 do { status I2C_ReadReg(0x91); } while ((status 0x07) 0); // 等待测量完成 dist I2C_ReadReg(0x94); // 高字节 dist (dist 8) | I2C_ReadReg(0x95); // 低字节 dist 0x1FFF; // 用低 13 位 return dist; }这里0x91寄存器的低三位是中断状态位数据处理完成后会被硬件置位。0x94和0x95组成的 16 位数据实际有效位数是 13 位也就是最大 8191mm。如果读回来是 8190 或者 8191不要当真实距离那是传感器的错误码表示测量超范围或目标太近导致无法解析回波。3.2 偏移校准和 Xtalk 校准要分开看VL53L0X 的校准有两个层面。第一个是器件级偏移校准解决的是 VCSEL 和 SPAD 之间的光路误差。出厂时每颗芯片都有内部参数但装配到模块上后焊接应力和 PCB 厚度会引入新的偏差。第二个是串扰校准也就是 Xtalk calibration针对传感器前面有玻璃、保护膜或者传感器和被测物之间有透明遮挡物时发射光直接反射回接收端引起的固定误差。标准做法是用 ST 官方 API 在目标距离 100mm 处执行 Xtalk 校准但在 51 工程里完整移植 API 太重。这份代码的做法是寄存器级偏移校准把传感器放在已知距离的平面墙前测量一次把「真实距离 - 测量距离」的差值写回偏移寄存器。Xtalk 校准也可以通过软件层补偿来实现不需要改寄存器。3.2.1 寄存器级偏移校准的具体实现unsigned int real_dist 300; // 用尺子量的真实距离单位 mm unsigned int measured VL53L0X_ReadDistance(); int offset (int)real_dist - (int)measured; // 偏移寄存器存的是有符号值高字节在 0x18低字节在 0x19 I2C_WriteReg(0x18, (unsigned char)(offset 4)); I2C_WriteReg(0x19, (unsigned char)(offset 0x0F));0x18是偏移寄存器的高字节0x19是低四位组合起来范围是 -256 到 255。不同批次模块对这几位符号位的布局有差异如果发现校准后误差方向反了就把符号位取反再写一次。每次校准前要保证测量环境没有强烈红外干扰墙面要正对传感器距离不要小于 50mm。这个校准值只影响当前模块换一个模块就得重新做一遍所以量产程序里一般会加一个「长按按键进入校准模式」的隐藏功能按下时自动跑到 300mm 处校准并保存。3.3 软件层补偿解决不了的场景寄存器级偏移只能校正固定偏差如果目标物反射率很低或者传感器前面加了一层厚的亚克力Xtalk 造成的偏差会随距离变化这时候软件层就要做分段线性拟合。做法是分别在 100mm、300mm、500mm 处采样用最小二乘拟合出真实值 k * 测量值 b这样的直线关系。#define FIT_K 1.03f #define FIT_B -8.0f unsigned int Dist_Calibrated(unsigned int raw) { float f (float)raw * FIT_K FIT_B; return (unsigned int)(f 0.5f); }FIT_K和FIT_B的来源是标定数据。我在实际项目里是先把原始值通过串口打出来在 Excel 里做一次线性回归再把这组系数写回 config.h。要注意的是线性拟合只在标定距离范围内可靠超出范围会外推得很离谱。宁可让近距离测不准也要保证 200mm 到 800mm 这个主要区间是准的。3.4 读数和跳变的排查顺序如果调试时发现距离值一直在飘先看一眼供电。VL53L0X 工作电流有几十毫安峰值会到 100mA 以上用 STC15 的 3.3V 引脚直接供电很容易把电压拉到 2.8V 以下表现就是读数周期性跳变。第二个检查点是 I2C 上拉电阻外部没有上拉时偶尔能通但时序余量不足一发热就掉线。第三个才是寄存器配置问题排查时用逻辑分析仪抓 SCL/SDA确认每个 ACK 都出现再往上查测量状态位。下表是我常用的快速定位表现象优先检查读数固定在 8190目标太近或反射面太差先换白色纸板测试读数随机跳 100mm 以上电源纹波、VCSEL 驱动电流不足I2C 通信时好时坏上拉电阻、杜邦线长度、接线端子氧化距离整体偏近 10mm需要重做偏移校准4. 串口输出与 Keil 工程整合4.1 STC15 串口 1 的波特率配置测距结果最终要通过 UART 输出到电脑或者上位机。STC15 的串口 1 可以工作在定时器 2 波特率发生器模式下这样定时器 1 还能留给其他任务。下面这段是 uart.c 里的初始化代码使用 11.0592MHz 晶振、9600 波特率void UART1_Init(void) { SCON 0x50; // 8 位 UART允许接收 AUXR 0x01; // 定时器 2 作为波特率发生器 T2L 0xE8; // 9600 11.0592MHz T2H 0xFF; AUXR | 0x04; // 启动定时器 2 ES 1; EA 1; } void UART1_SendChar(unsigned char ch) { SBUF ch; while (!TI); TI 0; }AUXR寄存器的配置在所有 STC15 系列上并不完全一样比如 STC15W4K32S4 和 STC15F2K60S2 的定时器分配就有差异。所以工程里的 config.h 才显得重要里面统一做了引脚和波特率的宏定义。换芯片时不要只改串口初始化要先把 config.h 里的芯片型号宏和主频宏改掉再重新看波特率重装值。4.2 工程文件结构与 hex 生成解压后你会在根目录看到 main.uvproj、main.hex以及一堆 .lst/.obj 等 Keil 中间文件。main.uvproj 是 Keil uVision 工程文件双击直接打开就能编译生成路径下会有 main.hex。目录里还有 STC15Fxxxx.H 和 STC15.H 两个头文件这是 STC 官方提供的寄存器定义不要随便删很多外设位的别名都声明在这里。我一般会先做一个「干净工程」操作删掉 Debug 目录、所有 .obj/.lst/.plg 文件只保留 .c/.h/.uvproj然后重新编译一次。这样做可以确认源码本身没有隐藏的路径依赖。编译通过后用 STC-ISP 烧录软件加载 main.hex选择对应的 STC15 型号注意勾选「下次启动时使用 P3.2/P3.3 口设置系统参数」不然某些开发板会被程序里的引脚配置干扰。4.3 主循环里整合距离读取和串口打印main.c 的逻辑很直白系统初始化、传感器初始化、循环读取距离、串口输出。void main(void) { unsigned int dist; System_Init(); // 时钟、GPIO、UART Delay_ms(200); // 等 VL53L0X 上电稳定 if (VL53L0X_Init() ! 0) { UART1_SendString(VL53L0X init fail\r\n); while (1); } while (1) { dist VL53L0X_ReadDistance(); UART1_SendString(dist); UART1_SendInt(dist); UART1_SendString( mm\r\n); Delay_ms(100); // 控制读取频率 } }UART1_SendInt是 uart.c 里把整数逐位转换成 ASCII 的函数实际项目里建议在它前面加一个超时保护比如连续 5 次读到 8190 就认为传感器被遮挡输出错误提示而不是一直刷无效值。100ms 的延时对应约 10Hz 刷新率激光测距在这个频率下已经足够顺滑再快会加大电源负担。5. 把校准参数写进 STC15 内部 EEPROM避免每次开机重标定前面的重启逻辑里有个明显痛点偏移校准值写在变量里断电就没了每次上电都要重新校准。STC15 系列单片机内部集成了 EEPROM用 IAP 指令可以像操作外部存储一样读写。这样校准流程就变成第一次开机进入校准模式测完把偏移值写入 EEPROM以后每次启动直接读出来填进寄存器。void EEPROM_Write(unsigned int addr, unsigned char dat) { IAP_CONTR 0x80; // 允许 IAP设置等待时间 IAP_CMD 0x02; // 字节编程命令 IAP_ADDRL addr 0xFF; IAP_ADDRH (addr 8) 0xFF; IAP_DATA dat; IAP_TRIG 0x5A; // 触发序列 IAP_TRIG 0xA5; IAP_CONTR 0x00; // 关闭 IAP } unsigned char EEPROM_Read(unsigned int addr) { unsigned char dat; IAP_CONTR 0x80; IAP_CMD 0x01; // 字节读取命令 IAP_ADDRL addr 0xFF; IAP_ADDRH (addr 8) 0xFF; IAP_TRIG 0x5A; IAP_TRIG 0xA5; dat IAP_DATA; IAP_CONTR 0x00; return dat; }写入 EEPROM 时有个坑STC15 的 IAP 操作必须连续执行0x5A - 0xA5触发序列中间不能有外部中断插入否则这次写入会变成非法操作。所以这段代码在 Keil 里编译时要确保没有开全局中断或者把中断暂时关闭。另一个坑是 EEPROM 有擦写寿命大约 10 万次校准参数这种不频繁更新的数据没问题但如果把实时距离值也写进去很快会写坏。读取校准值可以这样做上电时先从 EEPROM 0x0000 地址读出一个偏移量如果等于校准标志0xA5A5就把偏移量写入偏移寄存器否则进入校准模式提示用户把传感器对准 300mm 处的障碍物按一下按键完成标定。这个流程比每次上电都跑一遍 Xtalk 校准要快得多也更适合从这套 C 源码里衍生出的倒车雷达、自动门触发这类产品原型。烧录时记得在 STC-ISP 里勾选「允许 IAP 编程」否则 EEPROM_Write 会直接卡死在触发序列上。调试校准参数时我最常用的是先不开 EEPROM 写只通过串口打印原始距离和补偿后的距离确认线性系数没有问题再打开写保护这样能少刷很多次 Flash。把这套「校准一次、保存、上电加载」的思路迁移到 STM32 上时只需要把 IAP 函数替换成内部 Flash 操作VL53L0X 的寄存器读写代码几乎可以原样保留。本文还有配套的精品资源点击获取