梁山派GD32F470驱动夏普GP2Y0A02YK0F红外测距传感器实战指南最近在做一个智能小车的项目需要实现20到150厘米范围内的精确避障。选来选去夏普的GP2Y0A02YK0F这款红外测距传感器成了我的首选它价格合适测量范围也正好满足需求。但拿到手后发现它的输出是模拟电压而且电压和距离的关系还不是线性的直接用ADC读个电压值可不行。今天我就把在梁山派GD32F470开发板上驱动这款传感器的完整过程从原理到代码手把手分享给大家。如果你也在用GD32做类似的项目这篇教程应该能帮你省下不少折腾的时间。1. 认识你的传感器GP2Y0A02YK0F在写代码之前咱们先得搞清楚要驱动的对象是个啥。夏普GP2Y0A02YK0F是一款基于三角测量法的红外测距传感器。简单来说它内部有一个红外发射管IRED和一个位置敏感探测器PSD。发射管发出红外光打到物体上反射回来被PSD接收。物体距离不同反射光在PSD上成像的位置就不同从而产生不同的电压信号。这种三角测量法有个很大的优点被测物体的材质、环境温度和时间对测量精度的影响很小。也就是说不管是测白墙还是黑布结果都比较可靠这对于机器人避障来说非常关键。它的核心参数如下参数项规格工作电压3.3V - 5V工作电流约33mA测量范围20cm - 150cm输出信号模拟电压 (0 ~ 3.3V)接口3 Pin (VCC, GND, AO)注意传感器上可能还有一个DO引脚那是数字输出用于阈值报警。我们这里只用模拟输出AO引脚来获取连续的距离信息。模块接线非常简单VCC- 接梁山派的3.3V或5V模块兼容GND- 接梁山派的GNDAO- 接梁山派的任意一个ADC输入引脚我们后面选PC22. 核心难点非线性电压与距离换算拿到传感器第一件事就是看它的输出特性曲线。从官方资料里可以找到下面这张图这张图揭示了两个重要信息也是驱动这款传感器的关键非线性关系输出电压和距离不是简单的比例关系。在有效测量范围20-150cm内电压随距离增加而降低但变化率不一致。“盲区”现象当物体距离小于15cm时输出电压会急剧下降。这会导致一个严重问题你的机器人靠近障碍物时读到的距离值反而会突然变大程序可能误判为障碍物消失然后加速撞上去避坑指南针对这个“盲区”一个实用的工程技巧是调整传感器的安装位置。不要让传感器的探测头与机器人最前端的距离小于15cm。比如你可以把传感器向后安装或者加一个向前延伸的支架确保即使传感器读到最小距离机器人本体离障碍物还有缓冲空间。那么怎么把读到的电压值转换成真实的距离呢我们需要一个换算公式。这个公式夏普没有直接给在手册里但是开源社区已经有人通过实测数据拟合出来了。我们直接使用经过验证的公式对于GP2Y0A02YK0F型号测量距离 15cm时距离 (厘米) 60.374 × (电压值) ^ (-1.16)这个公式就是我们后面代码里的核心算法。电压单位是伏特(V)。3. 硬件连接与ADC通道选择梁山派GD32F470的ADC资源很丰富我们随便选一个带有ADC功能的引脚就行。我习惯先查数据手册。根据《GD32F450xx_Datasheet_Rev2.2.pdf》第28页的引脚定义表可以看到PC2引脚具有ADC012_IN12功能。意思是它可以作为ADC0、ADC1或ADC2的第12个输入通道。我们计划使用ADC0。所以硬件连接就确定了传感器AO引脚 - 梁山派的PC2引脚。传感器VCC、GND分别接电源和地。4. 软件驱动设计ADCDMA连续采集我们的目标是让距离测量在后台自动、连续地进行不占用CPU太多时间。最好的办法就是使用ADC配合DMA。思路是这样的ADC配置为连续扫描模式自动不停地转换PC2引脚上的电压。每转换完成一次就通过DMA直接存储器访问把结果自动存到一个数组里。CPU只需要偶尔去处理这个数组里的数据比如求平均、换算距离完全不用操心数据怎么搬过来的。这样做的好处是效率高代码也清晰。下面我们来看具体代码实现。4.1 代码文件与宏定义首先我们创建两个文件bsp_irdistance.c和bsp_irdistance.h把红外测距相关的代码都放在里面。在头文件bsp_irdistance.h里我们先把用到的引脚、外设、参数用宏定义好这样以后修改起来方便。#ifndef _BSP_IRDISTANCE_H_ #define _BSP_IRDISTANCE_H_ #include gd32f4xx.h // 时钟宏定义 #define RCU_IRDISTANCE_GPIO RCU_GPIOC // PC2引脚时钟 #define RCU_IRDISTANCE_ADC RCU_ADC0 // ADC0时钟 #define RCU_IRDISTANCE_DMA RCU_DMA1 // DMA1时钟 // 外设宏定义 #define PORT_DMA DMA1 // 使用DMA1 #define CHANNEL_DMA DMA_CH0 // 使用DMA1的通道0 #define PORT_ADC ADC0 // 使用ADC0 #define CHANNEL_ADC ADC_CHANNEL_12 // 使用第12通道 (对应PC2) // GPIO宏定义 #define PORT_IRDISTANCE GPIOC // 端口C #define GPIO_IRDISTANCE GPIO_PIN_2 // 引脚2 // 采样参数 #define SAMPLES 100 // 每个通道采样100次用于求平均滤波 #define CHANNEL_NUM 1 // 我们只用了1个ADC通道 // 声明DMA缓冲区在.c文件中定义 extern uint16_t gt_adc_val[SAMPLES][CHANNEL_NUM]; // 函数声明 void ADC_DMA_Init(void); float Get_Adc_Dma_Value(char CHx); double Get_IRdistance_Distance(void); #endif4.2 ADC与DMA初始化这是最核心的配置函数ADC_DMA_Init我把它拆解成几个部分方便你理解。#include bsp_irdistance.h #include systick.h #include stdio.h #include math.h // DMA缓冲区用于存储ADC采样值 uint16_t gt_adc_val[SAMPLES][CHANNEL_NUM]; void ADC_DMA_Init(void) { dma_single_data_parameter_struct dma_single_data_parameter; // 第一部分开启所有需要的时钟 rcu_periph_clock_enable(RCU_IRDISTANCE_GPIO); // 打开GPIOC时钟 rcu_periph_clock_enable(RCU_IRDISTANCE_ADC); // 打开ADC0时钟 rcu_periph_clock_enable(RCU_IRDISTANCE_DMA); // 打开DMA1时钟 // 配置ADC时钟为PCLK2的4分频根据系统时钟调整保证ADC时钟不超过36MHz adc_clock_config(ADC_ADCCK_PCLK2_DIV4); // 第二部分配置GPIO引脚为模拟输入模式 // 对于ADC输入引脚必须设置为模拟模式关闭上下拉 gpio_mode_set(PORT_IRDISTANCE, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO_IRDISTANCE); // 第三部分配置ADC0基本工作模式 adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT); // ADC独立模式 adc_special_function_config(PORT_ADC, ADC_CONTINUOUS_MODE, ENABLE); // 使能连续转换 adc_special_function_config(PORT_ADC, ADC_SCAN_MODE, ENABLE); // 使能扫描模式虽然我们只有1个通道 adc_data_alignment_config(PORT_ADC, ADC_DATAALIGN_RIGHT); // 数据右对齐 // 第四部分配置ADC规则组通道 adc_channel_length_config(PORT_ADC, ADC_REGULAR_CHANNEL, CHANNEL_NUM); // 规则组通道数为1 // 配置第0个扫描序列为通道12PC2采样周期为15个时钟周期 adc_regular_channel_config(PORT_ADC, 0, CHANNEL_ADC, ADC_SAMPLETIME_15); adc_resolution_config(PORT_ADC, ADC_RESOLUTION_12B); // 12位分辨率 // 第五部分配置ADC触发与DMA adc_external_trigger_config(PORT_ADC, ADC_REGULAR_CHANNEL, EXTERNAL_TRIGGER_DISABLE); // 禁用外部触发使用软件触发 adc_dma_request_after_last_enable(PORT_ADC); // 使能规则组转换完成后产生DMA请求 adc_dma_mode_enable(PORT_ADC); // 使能ADC的DMA传输 // 第六部分使能ADC并校准 adc_enable(PORT_ADC); delay_1ms(1); // 等待ADC稳定 adc_calibration_enable(PORT_ADC); // ADC自校准非常重要 // 第七部分配置DMA dma_deinit(PORT_DMA, CHANNEL_DMA); // 先复位DMA通道 // 设置DMA传输参数 dma_single_data_parameter.periph_addr (uint32_t)(ADC_RDATA(PORT_ADC)); // 外设地址ADC数据寄存器 dma_single_data_parameter.periph_inc DMA_PERIPH_INCREASE_DISABLE; // 外设地址固定 dma_single_data_parameter.memory0_addr (uint32_t)(gt_adc_val); // 内存地址我们的数组 dma_single_data_parameter.memory_inc DMA_MEMORY_INCREASE_ENABLE; // 内存地址自增 dma_single_data_parameter.periph_memory_width DMA_PERIPH_WIDTH_16BIT; // 数据宽度16位ADC是12位对齐到16位 dma_single_data_parameter.direction DMA_PERIPH_TO_MEMORY; // 传输方向外设到内存 dma_single_data_parameter.number SAMPLES * CHANNEL_NUM; // 传输数据量100个 dma_single_data_parameter.priority DMA_PRIORITY_HIGH; // 高优先级 dma_single_data_mode_init(PORT_DMA, CHANNEL_DMA, dma_single_data_parameter); // 第八部分选择DMA通道的外设映射并启动 // 根据数据手册ADC0对应DMA_SUBPERI0 dma_channel_subperipheral_select(PORT_DMA, CHANNEL_DMA, DMA_SUBPERI0); dma_circulation_enable(PORT_DMA, CHANNEL_DMA); // 使能循环模式缓冲区满了从头开始实现连续采集 dma_channel_enable(PORT_DMA, CHANNEL_DMA); // 使能DMA通道 // 第九部分启动ADC转换 adc_software_trigger_enable(PORT_ADC, ADC_REGULAR_CHANNEL); // 软件触发开始转换 }关键点提示adc_calibration_enable这一步绝对不能少否则ADC采样值会不准。DMA配置为循环模式这样当它把100个数据传完后会自动回到数组开头继续传形成一个不间断的数据流。一旦调用adc_software_trigger_enableADC就会开始连续转换并通过DMA自动填充gt_adc_val数组整个过程无需CPU干预。4.3 数据读取与距离换算函数初始化完成后gt_adc_val数组里就实时存放着最新的100个ADC原始值0-4095。我们写两个函数来处理这些数据。第一个函数Get_Adc_Dma_Value用于获取指定通道的平均电压值。float Get_Adc_Dma_Value(char CHx) { unsigned char i 0; unsigned int AdcValue 0; double ret 0; // 对SAMPLES次采样值求和 for(i0; i SAMPLES; i) { AdcValue gt_adc_val[i][CHx]; } // 求平均值并转换为电压值 (V) ret (double)AdcValue / SAMPLES; // 得到平均ADC原始值 ret (ret / 4095) * 3.3; // 转换为电压值 (假设参考电压为3.3V) // 注意这里原文代码有一个“手动减去电压误差 0.64”的注释。 // 在实际应用中你可能需要根据自己板子的实际情况测量并校准这个误差。 // 如果不需要可以去掉这行。我这里先按不加误差处理。 // ret ret - 0.64; return (float)ret; }第二个函数Get_IRdistance_Distance调用上面的函数得到电压然后套用公式计算距离。double Get_IRdistance_Distance(void) { double adc_voltage 0; double Distance 0; // 1. 获取ADC通道0的平均电压值 adc_voltage Get_Adc_Dma_Value(0); // 2. 应用GP2Y0A02YK0F的电压-距离换算公式 // 公式距离(cm) 60.374 * (电压)^(-1.16) // 使用math.h中的pow函数进行幂运算 Distance 60.374 * pow(adc_voltage, -1.16); return Distance; }5. 在主函数中测试最后我们在main.c里把整个流程跑起来。代码非常简单就是初始化后在循环里打印距离值。#include gd32f4xx.h #include systick.h #include bsp_usart.h #include stdio.h #include bsp_irdistance.h // 包含我们刚写的驱动头文件 int main(void) { // 设置中断优先级分组 nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2); // 初始化系统滴答定时器用于delay systick_config(); // 初始化串口用于打印数据到电脑 usart_gpio_config(115200U); // 初始化红外测距传感器ADCDMA ADC_DMA_Init(); printf(红外测距传感器 demo 启动\r\n); while(1) { // 获取并打印距离值 double dist Get_IRdistance_Distance(); printf(距离 %.2f cm\r\n, dist); // 延时1秒 delay_1ms(1000); } }将代码编译下载到梁山派开发板连接好传感器打开串口助手波特率115200你应该能看到每秒输出一次的距离信息。拿着物体在传感器前移动观察距离值的变化是否合理。6. 调试心得与注意事项电压校准Get_Adc_Dma_Value函数里提到的电压误差0.64这个值因板而异。最准确的方法是用万用表测量ADC参考电压的实际值通常是3.3V并测量一个已知电压比如用梁山派的3.3V引脚看看ADC读出的电压和实际电压差多少然后修正公式。公式适用范围记住换算公式60.374 * pow(voltage, -1.16)只在距离大于15cm时比较准确。小于15cm是盲区读数会混乱。务必通过物理安装避开这个区域。采样滤波代码中采样100次求平均是为了抑制干扰。如果对实时性要求高可以减小SAMPLES的值但可能会增加读数波动。对象材质虽然三角测量法受材质影响小但极度光滑镜面或吸光黑色绒布的物体仍然会影响测量结果在实际应用中需要测试验证。好了整个驱动过程就是这样。代码我已经在实际项目里跑过稳定可靠。如果你在移植过程中遇到问题可以先检查硬件连接、ADC引脚配置以及最重要的——那个电压换算公式里的参数是否与你手上的传感器型号完全匹配。祝你的机器人项目顺利