US-016模拟量超声波测距模块在TI MSPM0G3507开发板上的移植与驱动开发最近在做一个智能小车的项目需要用到超声波传感器来探测前方障碍物的距离。市面上常见的超声波模块大多是数字接口比如HC-SR04需要单片机发触发信号再接收回响脉冲计算时间差来算距离。这次我选了个不太一样的模块——US-016它直接输出模拟电压电压值和距离成正比接线和编程都简单不少。正好手头有TI的MSPM0G3507开发板这是TI新推出的基于ARM Cortex-M0内核的微控制器性能不错价格也亲民。今天我就来分享一下怎么把US-016这个模拟量超声波模块完整地驱动起来在MSPM0G3507上实现稳定的距离测量。如果你也在用TI MSPM0系列芯片或者对模拟传感器采集感兴趣这篇手把手的教程应该能帮到你。1. 认识US-016一款不一样的超声波模块在开始写代码之前咱们先得搞清楚手头的传感器到底是个啥。US-016在超声波模块里算是个“异类”。它最大的特点就是输出模拟电压。市面上绝大多数超声波模块比如大家熟悉的HC-SR04都是数字脉冲输出。你需要单片机发一个10us以上的高电平触发信号然后模块会发出超声波并回传一个高电平脉冲脉冲的宽度和距离成正比。你需要用单片机定时器去测量这个脉冲宽度再换算成距离。US-016则省去了这些麻烦。它上电后自己就在不停地测距然后把实时的距离信息转换成一个0到Vcc供电电压之间的模拟电压从OUT引脚输出。距离越远电压越高。你只需要用一个单片机的ADC模数转换器引脚去读取这个电压值然后套用一个简单的公式就能算出距离。这有什么好处呢编程简单不用操心发触发信号、抓上升沿下降沿、开定时器这些事只需要配置好ADC定期去读电压值就行。响应快它是连续输出的没有HC-SR04那种“触发-等待-测量”的周期延迟对于需要快速反应的场景更友好。接口通用模拟电压输出几乎任何带ADC的单片机都能接兼容性极强。US-016的关键参数工作电压3.3V - 5V 和MSPM0G3507的3.3V系统完美匹配工作电流3.8mA 非常省电测量范围2厘米 到 300厘米 (3米)测量精度0.3厘米 测量值的1%输出方式模拟电压 (0 - Vcc)感应角度小于15度 指向性比较好不容易受旁边物体干扰引脚4个 (VCC, GND, OUT, RANGE)这里要特别关注一下RANGE引脚。这个引脚决定了模块的量程当RANGE引脚**悬空或者接高电平VCC**时量程为3米。输出电压Vcc对应3.072米。当RANGE引脚**接低电平GND**时量程为1米。输出电压Vcc对应1.024米。量程切换会影响距离计算公式的系数咱们后面写代码的时候会用到。我的模块RANGE引脚悬空了所以默认是3米量程。2. 硬件连接与引脚规划硬件连接非常简单只有4根线。我们使用TI MSPM0G3507开发板来供电和采集信号。接线表US-016模块引脚连接到 MSPM0G3507 开发板说明VCC3.3V 电源引脚模块供电注意开发板要能提供足够的电流。GNDGND (地)共地这是必须的确保电压参考点一致。OUTPA27(ADC输入通道)模拟信号输出线这是我们采集数据的关键。RANGE悬空 (或接3.3V/接GND)量程选择。悬空3米量程。注意为什么选PA27这是根据原始资料和开发板资源决定的。MSPM0G3507的ADC模块可以复用多个GPIO引脚作为输入通道我们需要在TI的SysConfig图形化工具里指定使用PA27的ADC功能。当然你也可以根据自己板子的布局选择其他具有ADC功能的引脚只需要在软件配置时相应修改即可。接好线硬件部分就搞定了。是不是比接HC-SR04需要两个GPIO一个触发一个回响还要简单3. 软件工程配置使用SysConfig工具TI为MSPM0系列提供了非常方便的SysConfig图形化配置工具我们可以用它来配置ADC外设和引脚功能避免直接去啃寄存器手册。这也是现代嵌入式开发的一个趋势——图形化配置降低门槛。步骤1打开工程与SysConfig在你的Code Composer Studio (CCS) 或 IAR 工程中找到empty.syscfg文件或其他类似的.syscfg文件双击打开。文件界面会自动加载SysConfig工具面板。如果没有你也可以在菜单栏点击Tools-SYSCONFIG来启动它。步骤2添加并配置ADC模块在左侧的“Software”或“Peripherals”目录下找到ADC12模块MSPM0G3507的ADC是12位的。点击ADD按钮将它添加到你的工程配置中。在右侧的配置面板中我们需要设置几个关键参数实例 (Instance)选择ADC12_0通常使用第一个实例。输入通道 (Input Channel)选择与硬件连接对应的通道。因为我们把US-016的OUT接到了PA27所以这里需要选择PA27对应的ADC通道例如ADC_CH0或其他具体请参考你的开发板原理图和数据手册。参考电压 (Reference Voltage)选择VREF通常是内部参考电压例如1.4V或2.5V具体看芯片手册或VDDA模拟电源电压这里是3.3V。这个选择非常重要因为它直接关系到距离计算公式原始代码中提到了Vref指的就是这里选择的ADC参考电压。为了简化我们通常选择和模块供电电压Vcc一致的VDDA3.3V这样公式里的Vref/Vcc比值就是1计算更简单。采样模式可以选择单次采样或连续采样。对于US-016这种连续输出的传感器单次采样然后定时读取就足够了。中断 (Interrupt)勾选“Enable Interrupt”并选择“Conversion Complete”相关的中断。这样ADC转换完成后会产生中断我们在中断服务函数里读取数据。步骤3配置GPIO引脚为ADC功能在SysConfig的“Pins”或“Ports”部分找到PA27这个引脚。将其功能Mode/Function从默认的GPIO修改为ADC功能。这一步确保了PA27内部连接到ADC模块而不是普通的数字输入输出。步骤4保存并生成代码点击保存按钮。保存时可能会弹出对话框询问是否要更新工程中的源文件一定要选择Yes to All。SysConfig工具会自动根据你的图形化配置生成对应的C代码和头文件主要是ti_msp_dl_config.h和ti_msp_dl_config.c。点击编译工程。初次编译可能会因为文件包含路径等问题报一些警告通常不影响可以暂时不管。关键是确认ti_msp_dl_config.h文件被正确生成。这个头文件里定义了所有你配置的外设实例和引脚比如ADC12_0_INSTADC实例、ADC12_0_ADCMEM_ADC_CH0ADC结果存储器等。我们的驱动代码会用到这些定义。提示ti_msp_dl_config.h通常会被主工程的头文件board.h所包含。所以在我们自己写的驱动文件里只需要包含#include “board.h”就可以使用所有配置好的硬件资源了非常方便。4. 驱动代码编写与解析硬件和工程配置好后我们来写最核心的驱动代码。我会把代码分成几个函数并详细解释每一部分是干什么的。首先在工程里新建两个文件bsp_US016.c和bsp_US016.h“bsp”意为板级支持包。4.1 头文件定义 (bsp_US016.h)头文件很简单就是声明我们提供给主程序调用的函数。#ifndef _BSP_US016_H_ #define _BSP_US016_H_ #include board.h // 包含所有硬件配置 void US016_Init(void); float Get_distance(void); #endif这里就两个函数一个是初始化函数一个是获取距离函数。4.2 源文件实现 (bsp_US016.c)这是重头戏我们一步步来拆解。第一部分宏定义与全局变量#include bsp_US016.h #include stdio.h // 为了使用printf调试可选 // 超声波量程 Range接地量程为1米 Range接VCC或悬空量程为3米 // 根据你的硬件连接修改这个宏我这里是悬空所以是3米量程。 #define RANGE 0 // 0 表示3米量程 1 表示1米量程 volatile bool gCheckADC false; // ADC转换完成标志位RANGE宏非常重要必须根据你模块上RANGE引脚的实际接法来设置。接GND设为1悬空或接VCC设为0。它决定了后面距离计算用哪个公式。gCheckADC变量一个标志位用于在ADC中断服务函数和主循环之间通信告诉我们一次ADC转换是否完成了。用volatile修饰是因为它会在中断中被修改防止编译器优化出错。第二部分模块初始化函数void US016_Init(void) { // 开启ADC中断使能NVIC中的ADC中断通道 NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); }初始化函数异常简单仅仅开启了ADC的中断。这是因为ADC模块本身的时钟、引脚、基本参数等我们已经通过SysConfig图形化工具配置好了相关初始化代码由SysConfig自动生成并在board_init()中调用。所以我们这里只需要使能中断即可。第三部分ADC数据读取核心函数这里有两个关键函数ADC_GET负责触发并等待一次ADC转换Get_ADC_Value负责多次采样取平均值提高稳定性。uint32_t ADC_GET(void) { unsigned int gAdcResult 0; int timeout 20; // 超时计数器防止卡死 // 1. 软件触发让ADC开始一次转换 DL_ADC12_startConversion(ADC12_0_INST); // 2. 等待转换完成标志位 while (false gCheckADC) { delay_us(1); // 短暂延时等待中断发生 timeout--; if(timeout 0) // 超时处理打印错误信息 { printf(ADC转换超时错误!! LINE:%d\r\n,__LINE__); return 0; // 返回0表示错误 } } // 3. 转换完成从ADC结果存储器中读取12位的原始值 gAdcResult DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_ADC_CH0); // 4. 清除标志位为下一次转换做准备 gCheckADC false; return gAdcResult; // 返回ADC原始值 (0-4095 for 12-bit ADC) }这个函数是阻塞式的会一直等到ADC转换完成。DL_ADC12_开头的函数是TI提供的底层驱动库DriverLib函数封装了对寄存器的操作让我们编程更简单。unsigned int Get_ADC_Value(unsigned int num) { unsigned int Data 0; int i 0; for( i 0; i num; i ) { /* 读取ADC常规组数据寄存器 */ Data ADC_GET(); // 累加多次采样值 delay_ms(10); // 每次采样间隔10ms让信号稳定 } Data Data / num; // 计算平均值 return Data; // 返回平均后的ADC原始值 }Get_ADC_Value函数通过多次采样比如50次然后取平均值可以有效地滤除电源噪声或传感器本身的微小波动让读回来的距离值更稳定。num参数就是你想平均的次数。第四部分距离计算函数核心算法这是把ADC原始值转换成实际距离厘米或米的关键。float Get_distance(void) { float distance 0; unsigned int d Get_ADC_Value(50); // 获取50次采样的平均ADC值 #if !RANGE // 如果 RANGE 宏定义为 0 (3米量程) // 量程为3米时的计算公式: L d * (3096 / 4096) * (Vref / Vcc) // 假设 Vref Vcc 3.3V则 (Vref/Vcc)1 // 公式简化为: L d * (3096 / 4096) d * 0.75586 ≈ d * 0.75 (毫米) // 代码中直接用了 d * 0.75结果是毫米。如果要厘米再除以10。 distance d * 0.75; #else // 如果 RANGE 宏定义为 1 (1米量程) // 量程为1米时的计算公式: L d * (1024 / 4096) * (Vref / Vcc) // 简化后: L d * 0.25 (毫米) distance d * 0.25; #endif // 此时distance单位是毫米(MM) // 通常我们更习惯用厘米(CM)所以在主函数里会处理 value distance / 10.0 return distance; }公式解析 这是整个驱动的数学核心来源于原始资料。d是12位ADC的原始值范围是0-4095。3096和1024这是模块在3米和1米量程下的满量程系数。当输出Vcc时对应的理论最大距离分别是3096毫米(3.096米)和1024毫米(1.024米)。4096是12位ADC的最大值 (2^12 4096)。Vref/VccADC参考电压与模块供电电压的比值。如果我们像前面配置的那样让ADC使用VDDA3.3V作为参考电压并且模块也用3.3V供电那么这个比值就是1公式可以简化。所以在3米量程、VrefVcc的条件下计算毫米距离的公式简化为距离(mm) ADC原始值 * (3096 / 4096) ≈ ADC原始值 * 0.756。代码里用了0.75是一个近似对精度要求高的项目可以换成更精确的0.756或直接用分数计算。第五部分ADC中断服务函数这个函数由硬件自动调用当ADC转换完成时触发。void ADC12_0_INST_IRQHandler(void) { // 查询是哪个ADC中断源触发的 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 检查是否是我们用的那个ADC存储器MEM0完成了数据装载 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC true; // 置位标志位通知主循环数据准备好了 break; default: break; } }中断函数里做的事情要尽可能少、快。这里只是设置了一个标志位告诉ADC_GET函数“数据好了快来取”。5. 主程序调用与验证最后我们在主函数里把整个流程串起来。#include board.h #include stdio.h #include bsp_US016.h int main(void) { // 开发板初始化时钟、SysConfig配置的外设等都在这里初始化 board_init(); // 初始化US-016模块主要是使能ADC中断 US016_Init(); printf(US-016测距实验开始\r\n); while(1) { // 1. 获取距离值单位毫米 float distance_mm Get_distance(); // 2. 转换为厘米并格式化输出 // 乘以10是为了保留两位小数进行打印例如 20.56厘米 uint32_t value_cm_x100 (uint32_t)(distance_mm / 10.0 * 100); printf(距离障碍物 %d.%02d CM\r\n\n, value_cm_x100 / 100, // 整数部分 value_cm_x100 % 100); // 小数部分两位 // 3. 延时500ms再测下一次 delay_ms(500); } }上电测试 将模块对准大约20厘米处的障碍物比如一本书打开串口调试助手。你应该能看到类似距离障碍物 20.12 CM的输出并且数值会随着障碍物移动而平稳变化。调试小技巧数值跳变大尝试增加Get_ADC_Value函数中的采样平均次数比如从50改到100。数值始终为0或很小检查硬件接线特别是OUT线是否接到了正确的ADC引脚用万用表测量OUT引脚对地电压看是否有变化。数值接近最大值且不变可能是量程选择RANGE宏设置错误或者前方没有障碍物超出量程模块输出接近Vcc。公式计算不准确认你的Vref和Vcc是否真的相等。如果不相等需要修改Get_distance函数中的系数使用完整的公式distance d * 系数 * (Vref / Vcc)来计算。Vref的值可以在芯片数据手册和SysConfig的ADC配置中找到。好了整个移植和驱动开发的过程就是这样。从硬件连接到软件配置再到核心算法和调试我都把自己实际做项目时的步骤和注意事项分享出来了。US-016这个模块用起来确实方便省去了处理数字脉冲的麻烦特别适合快速原型开发和对实时性要求不极端的中低速测距场景。希望这篇教程能帮你顺利搞定它。
US-016模拟量超声波测距模块在TI MSPM0G3507开发板上的移植与驱动开发
发布时间：2026/6/9 21:30:57
US-016模拟量超声波测距模块在TI MSPM0G3507开发板上的移植与驱动开发最近在做一个智能小车的项目需要用到超声波传感器来探测前方障碍物的距离。市面上常见的超声波模块大多是数字接口比如HC-SR04需要单片机发触发信号再接收回响脉冲计算时间差来算距离。这次我选了个不太一样的模块——US-016它直接输出模拟电压电压值和距离成正比接线和编程都简单不少。正好手头有TI的MSPM0G3507开发板这是TI新推出的基于ARM Cortex-M0内核的微控制器性能不错价格也亲民。今天我就来分享一下怎么把US-016这个模拟量超声波模块完整地驱动起来在MSPM0G3507上实现稳定的距离测量。如果你也在用TI MSPM0系列芯片或者对模拟传感器采集感兴趣这篇手把手的教程应该能帮到你。1. 认识US-016一款不一样的超声波模块在开始写代码之前咱们先得搞清楚手头的传感器到底是个啥。US-016在超声波模块里算是个“异类”。它最大的特点就是输出模拟电压。市面上绝大多数超声波模块比如大家熟悉的HC-SR04都是数字脉冲输出。你需要单片机发一个10us以上的高电平触发信号然后模块会发出超声波并回传一个高电平脉冲脉冲的宽度和距离成正比。你需要用单片机定时器去测量这个脉冲宽度再换算成距离。US-016则省去了这些麻烦。它上电后自己就在不停地测距然后把实时的距离信息转换成一个0到Vcc供电电压之间的模拟电压从OUT引脚输出。距离越远电压越高。你只需要用一个单片机的ADC模数转换器引脚去读取这个电压值然后套用一个简单的公式就能算出距离。这有什么好处呢编程简单不用操心发触发信号、抓上升沿下降沿、开定时器这些事只需要配置好ADC定期去读电压值就行。响应快它是连续输出的没有HC-SR04那种“触发-等待-测量”的周期延迟对于需要快速反应的场景更友好。接口通用模拟电压输出几乎任何带ADC的单片机都能接兼容性极强。US-016的关键参数工作电压3.3V - 5V 和MSPM0G3507的3.3V系统完美匹配工作电流3.8mA 非常省电测量范围2厘米 到 300厘米 (3米)测量精度0.3厘米 测量值的1%输出方式模拟电压 (0 - Vcc)感应角度小于15度 指向性比较好不容易受旁边物体干扰引脚4个 (VCC, GND, OUT, RANGE)这里要特别关注一下RANGE引脚。这个引脚决定了模块的量程当RANGE引脚**悬空或者接高电平VCC**时量程为3米。输出电压Vcc对应3.072米。当RANGE引脚**接低电平GND**时量程为1米。输出电压Vcc对应1.024米。量程切换会影响距离计算公式的系数咱们后面写代码的时候会用到。我的模块RANGE引脚悬空了所以默认是3米量程。2. 硬件连接与引脚规划硬件连接非常简单只有4根线。我们使用TI MSPM0G3507开发板来供电和采集信号。接线表US-016模块引脚连接到 MSPM0G3507 开发板说明VCC3.3V 电源引脚模块供电注意开发板要能提供足够的电流。GNDGND (地)共地这是必须的确保电压参考点一致。OUTPA27(ADC输入通道)模拟信号输出线这是我们采集数据的关键。RANGE悬空 (或接3.3V/接GND)量程选择。悬空3米量程。注意为什么选PA27这是根据原始资料和开发板资源决定的。MSPM0G3507的ADC模块可以复用多个GPIO引脚作为输入通道我们需要在TI的SysConfig图形化工具里指定使用PA27的ADC功能。当然你也可以根据自己板子的布局选择其他具有ADC功能的引脚只需要在软件配置时相应修改即可。接好线硬件部分就搞定了。是不是比接HC-SR04需要两个GPIO一个触发一个回响还要简单3. 软件工程配置使用SysConfig工具TI为MSPM0系列提供了非常方便的SysConfig图形化配置工具我们可以用它来配置ADC外设和引脚功能避免直接去啃寄存器手册。这也是现代嵌入式开发的一个趋势——图形化配置降低门槛。步骤1打开工程与SysConfig在你的Code Composer Studio (CCS) 或 IAR 工程中找到empty.syscfg文件或其他类似的.syscfg文件双击打开。文件界面会自动加载SysConfig工具面板。如果没有你也可以在菜单栏点击Tools-SYSCONFIG来启动它。步骤2添加并配置ADC模块在左侧的“Software”或“Peripherals”目录下找到ADC12模块MSPM0G3507的ADC是12位的。点击ADD按钮将它添加到你的工程配置中。在右侧的配置面板中我们需要设置几个关键参数实例 (Instance)选择ADC12_0通常使用第一个实例。输入通道 (Input Channel)选择与硬件连接对应的通道。因为我们把US-016的OUT接到了PA27所以这里需要选择PA27对应的ADC通道例如ADC_CH0或其他具体请参考你的开发板原理图和数据手册。参考电压 (Reference Voltage)选择VREF通常是内部参考电压例如1.4V或2.5V具体看芯片手册或VDDA模拟电源电压这里是3.3V。这个选择非常重要因为它直接关系到距离计算公式原始代码中提到了Vref指的就是这里选择的ADC参考电压。为了简化我们通常选择和模块供电电压Vcc一致的VDDA3.3V这样公式里的Vref/Vcc比值就是1计算更简单。采样模式可以选择单次采样或连续采样。对于US-016这种连续输出的传感器单次采样然后定时读取就足够了。中断 (Interrupt)勾选“Enable Interrupt”并选择“Conversion Complete”相关的中断。这样ADC转换完成后会产生中断我们在中断服务函数里读取数据。步骤3配置GPIO引脚为ADC功能在SysConfig的“Pins”或“Ports”部分找到PA27这个引脚。将其功能Mode/Function从默认的GPIO修改为ADC功能。这一步确保了PA27内部连接到ADC模块而不是普通的数字输入输出。步骤4保存并生成代码点击保存按钮。保存时可能会弹出对话框询问是否要更新工程中的源文件一定要选择Yes to All。SysConfig工具会自动根据你的图形化配置生成对应的C代码和头文件主要是ti_msp_dl_config.h和ti_msp_dl_config.c。点击编译工程。初次编译可能会因为文件包含路径等问题报一些警告通常不影响可以暂时不管。关键是确认ti_msp_dl_config.h文件被正确生成。这个头文件里定义了所有你配置的外设实例和引脚比如ADC12_0_INSTADC实例、ADC12_0_ADCMEM_ADC_CH0ADC结果存储器等。我们的驱动代码会用到这些定义。提示ti_msp_dl_config.h通常会被主工程的头文件board.h所包含。所以在我们自己写的驱动文件里只需要包含#include “board.h”就可以使用所有配置好的硬件资源了非常方便。4. 驱动代码编写与解析硬件和工程配置好后我们来写最核心的驱动代码。我会把代码分成几个函数并详细解释每一部分是干什么的。首先在工程里新建两个文件bsp_US016.c和bsp_US016.h“bsp”意为板级支持包。4.1 头文件定义 (bsp_US016.h)头文件很简单就是声明我们提供给主程序调用的函数。#ifndef _BSP_US016_H_ #define _BSP_US016_H_ #include board.h // 包含所有硬件配置 void US016_Init(void); float Get_distance(void); #endif这里就两个函数一个是初始化函数一个是获取距离函数。4.2 源文件实现 (bsp_US016.c)这是重头戏我们一步步来拆解。第一部分宏定义与全局变量#include bsp_US016.h #include stdio.h // 为了使用printf调试可选 // 超声波量程 Range接地量程为1米 Range接VCC或悬空量程为3米 // 根据你的硬件连接修改这个宏我这里是悬空所以是3米量程。 #define RANGE 0 // 0 表示3米量程 1 表示1米量程 volatile bool gCheckADC false; // ADC转换完成标志位RANGE宏非常重要必须根据你模块上RANGE引脚的实际接法来设置。接GND设为1悬空或接VCC设为0。它决定了后面距离计算用哪个公式。gCheckADC变量一个标志位用于在ADC中断服务函数和主循环之间通信告诉我们一次ADC转换是否完成了。用volatile修饰是因为它会在中断中被修改防止编译器优化出错。第二部分模块初始化函数void US016_Init(void) { // 开启ADC中断使能NVIC中的ADC中断通道 NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); }初始化函数异常简单仅仅开启了ADC的中断。这是因为ADC模块本身的时钟、引脚、基本参数等我们已经通过SysConfig图形化工具配置好了相关初始化代码由SysConfig自动生成并在board_init()中调用。所以我们这里只需要使能中断即可。第三部分ADC数据读取核心函数这里有两个关键函数ADC_GET负责触发并等待一次ADC转换Get_ADC_Value负责多次采样取平均值提高稳定性。uint32_t ADC_GET(void) { unsigned int gAdcResult 0; int timeout 20; // 超时计数器防止卡死 // 1. 软件触发让ADC开始一次转换 DL_ADC12_startConversion(ADC12_0_INST); // 2. 等待转换完成标志位 while (false gCheckADC) { delay_us(1); // 短暂延时等待中断发生 timeout--; if(timeout 0) // 超时处理打印错误信息 { printf(ADC转换超时错误!! LINE:%d\r\n,__LINE__); return 0; // 返回0表示错误 } } // 3. 转换完成从ADC结果存储器中读取12位的原始值 gAdcResult DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_ADC_CH0); // 4. 清除标志位为下一次转换做准备 gCheckADC false; return gAdcResult; // 返回ADC原始值 (0-4095 for 12-bit ADC) }这个函数是阻塞式的会一直等到ADC转换完成。DL_ADC12_开头的函数是TI提供的底层驱动库DriverLib函数封装了对寄存器的操作让我们编程更简单。unsigned int Get_ADC_Value(unsigned int num) { unsigned int Data 0; int i 0; for( i 0; i num; i ) { /* 读取ADC常规组数据寄存器 */ Data ADC_GET(); // 累加多次采样值 delay_ms(10); // 每次采样间隔10ms让信号稳定 } Data Data / num; // 计算平均值 return Data; // 返回平均后的ADC原始值 }Get_ADC_Value函数通过多次采样比如50次然后取平均值可以有效地滤除电源噪声或传感器本身的微小波动让读回来的距离值更稳定。num参数就是你想平均的次数。第四部分距离计算函数核心算法这是把ADC原始值转换成实际距离厘米或米的关键。float Get_distance(void) { float distance 0; unsigned int d Get_ADC_Value(50); // 获取50次采样的平均ADC值 #if !RANGE // 如果 RANGE 宏定义为 0 (3米量程) // 量程为3米时的计算公式: L d * (3096 / 4096) * (Vref / Vcc) // 假设 Vref Vcc 3.3V则 (Vref/Vcc)1 // 公式简化为: L d * (3096 / 4096) d * 0.75586 ≈ d * 0.75 (毫米) // 代码中直接用了 d * 0.75结果是毫米。如果要厘米再除以10。 distance d * 0.75; #else // 如果 RANGE 宏定义为 1 (1米量程) // 量程为1米时的计算公式: L d * (1024 / 4096) * (Vref / Vcc) // 简化后: L d * 0.25 (毫米) distance d * 0.25; #endif // 此时distance单位是毫米(MM) // 通常我们更习惯用厘米(CM)所以在主函数里会处理 value distance / 10.0 return distance; }公式解析 这是整个驱动的数学核心来源于原始资料。d是12位ADC的原始值范围是0-4095。3096和1024这是模块在3米和1米量程下的满量程系数。当输出Vcc时对应的理论最大距离分别是3096毫米(3.096米)和1024毫米(1.024米)。4096是12位ADC的最大值 (2^12 4096)。Vref/VccADC参考电压与模块供电电压的比值。如果我们像前面配置的那样让ADC使用VDDA3.3V作为参考电压并且模块也用3.3V供电那么这个比值就是1公式可以简化。所以在3米量程、VrefVcc的条件下计算毫米距离的公式简化为距离(mm) ADC原始值 * (3096 / 4096) ≈ ADC原始值 * 0.756。代码里用了0.75是一个近似对精度要求高的项目可以换成更精确的0.756或直接用分数计算。第五部分ADC中断服务函数这个函数由硬件自动调用当ADC转换完成时触发。void ADC12_0_INST_IRQHandler(void) { // 查询是哪个ADC中断源触发的 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 检查是否是我们用的那个ADC存储器MEM0完成了数据装载 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC true; // 置位标志位通知主循环数据准备好了 break; default: break; } }中断函数里做的事情要尽可能少、快。这里只是设置了一个标志位告诉ADC_GET函数“数据好了快来取”。5. 主程序调用与验证最后我们在主函数里把整个流程串起来。#include board.h #include stdio.h #include bsp_US016.h int main(void) { // 开发板初始化时钟、SysConfig配置的外设等都在这里初始化 board_init(); // 初始化US-016模块主要是使能ADC中断 US016_Init(); printf(US-016测距实验开始\r\n); while(1) { // 1. 获取距离值单位毫米 float distance_mm Get_distance(); // 2. 转换为厘米并格式化输出 // 乘以10是为了保留两位小数进行打印例如 20.56厘米 uint32_t value_cm_x100 (uint32_t)(distance_mm / 10.0 * 100); printf(距离障碍物 %d.%02d CM\r\n\n, value_cm_x100 / 100, // 整数部分 value_cm_x100 % 100); // 小数部分两位 // 3. 延时500ms再测下一次 delay_ms(500); } }上电测试 将模块对准大约20厘米处的障碍物比如一本书打开串口调试助手。你应该能看到类似距离障碍物 20.12 CM的输出并且数值会随着障碍物移动而平稳变化。调试小技巧数值跳变大尝试增加Get_ADC_Value函数中的采样平均次数比如从50改到100。数值始终为0或很小检查硬件接线特别是OUT线是否接到了正确的ADC引脚用万用表测量OUT引脚对地电压看是否有变化。数值接近最大值且不变可能是量程选择RANGE宏设置错误或者前方没有障碍物超出量程模块输出接近Vcc。公式计算不准确认你的Vref和Vcc是否真的相等。如果不相等需要修改Get_distance函数中的系数使用完整的公式distance d * 系数 * (Vref / Vcc)来计算。Vref的值可以在芯片数据手册和SysConfig的ADC配置中找到。好了整个移植和驱动开发的过程就是这样。从硬件连接到软件配置再到核心算法和调试我都把自己实际做项目时的步骤和注意事项分享出来了。US-016这个模块用起来确实方便省去了处理数字脉冲的麻烦特别适合快速原型开发和对实时性要求不极端的中低速测距场景。希望这篇教程能帮你顺利搞定它。
