基于天空星GD32F407的雨滴传感器模块驱动移植与雨量检测实战最近在做一个智能车窗的项目需要检测是否下雨以及雨量大小于是就用上了这款非常常见的雨滴传感器模块。很多刚开始接触嵌入式传感器的朋友可能会觉得这种模块资料少不知道怎么接到自己的开发板上。今天我就以手头的天空星GD32F407开发板为例带大家走一遍完整的驱动移植流程从原理到代码手把手教你让雨滴传感器跑起来。这篇文章适合正在学习GD32F4系列或者需要在项目中使用环境传感器比如做智能农业、汽车电子的朋友。跟着做一遍你就能掌握如何将一个通用的传感器模块适配到特定的国产MCU平台上。1. 认识我们的“侦察兵”雨滴传感器模块在写代码之前咱们得先搞清楚要驱动的对象是什么。我用的这款雨滴传感器模块在网上很容易买到核心是一块裸露的、印有平行导线的PCB板我们叫它雨滴板和一块集成了LM393比较器的控制板。它是怎么工作的呢你可以把雨滴板想象成一块“感应地毯”。板子上那些平行的镍线正常情况下彼此是绝缘的空气的电阻非常大。当雨滴落上去水是导电的它就像一座座“小桥”把不同的镍线连接起来导致板子整体的电阻变小。电阻一变它两端的电压就会跟着变。这个变化的电压就是我们检测雨量的关键信号。模块提供了两种输出方式非常贴心AO模拟输出直接把雨滴板感应到的电压变化送出来。雨量越大电阻越小输出电压越高。我们需要用单片机的ADC模数转换器功能来读取这个连续变化的电压值从而判断雨量大小。DO数字输出信号经过LM393电压比较器处理。模块上有个蓝色的小电位器你可以调节一个阈值电压。当AO端的电压超过这个阈值意味着雨量达到一定程度DO引脚就会从高电平变成低电平同时板子上的DO-LED指示灯会亮起。这相当于给了我们一个简单的“有雨/无雨”开关信号。模块关键参数速览项目参数工作电压3.3V - 5V (兼容大部分开发板)输出信号AO (模拟量), DO (数字量)接口4针排针 (VCC, GND, DO, AO)读取方式ADC读取AO GPIO读取DO2. 硬件连接与引脚规划模块和开发板的连接很简单就四根线VCC- 接开发板的3.3V或5V电源模块都支持GND- 接开发板的GNDAO- 接开发板的ADC输入引脚DO- 接开发板的普通GPIO引脚配置为输入模式接下来是关键一步为AO和DO信号在GD32F407上“安家”。根据原始资料我们选择将AO接到PC1引脚。为什么是PC1因为我们需要一个带ADC功能的引脚查阅GD32F407的数据手册第40页附近的功能定义图可以知道PC1引脚复用了ADC0的第11输入通道。这正好符合我们的需求。对于DO信号它只是个高低电平所以对引脚没有特殊要求只要是个普通的GPIO就行。资料里选择了PE1我们就沿用这个配置。提示如果你手头的开发板PC1被占用了完全可以换到其他ADC通道引脚比如PC0ADC0通道10、PA0ADC0通道0等只需要在代码里同步修改通道号即可。规划好了连接如下模块AO- 开发板PC1模块DO- 开发板PE1模块VCC- 开发板3.3V模块GND- 开发板GND3. 手把手代码移植与解析硬件连好了现在来写代码。咱们的目标是创建两个文件bsp_raindrop.c驱动实现和bsp_raindrop.h引脚和参数定义。3.1 先定好“规矩”编写头文件 (bsp_raindrop.h)头文件的作用是集中管理所有的引脚定义和函数声明以后想改接线只改这里就行非常方便。#ifndef _BSP_RAINDROP_H__ #define _BSP_RAINDROP_H__ #include gd32f4xx.h /* AO引脚ADC输入定义 - 接在PC1 */ #define BSP_RAINDROP_GPIO_RCU_AO RCU_GPIOC // PC引脚组的时钟 #define BSP_RAINDROP_GPIO_PORT_AO GPIOC // PC端口 #define BSP_RAINDROP_GPIO_PIN_AO GPIO_PIN_1 // PC1引脚 #define BSP_RAINDROP_ADC_CHANNEL ADC_CHANNEL_11 // ADC0的第11通道 /* DO引脚数字输入定义 - 接在PE1 */ #define BSP_RAINDROP_GPIO_RCU_DO RCU_GPIOE // PE引脚组的时钟 #define BSP_RAINDROP_GPIO_PORT_DO GPIOE // PE端口 #define BSP_RAINDROP_GPIO_PIN_DO GPIO_PIN_1 // PE1引脚 /* ADC外设定义 - 使用ADC0 */ #define BSP_ADC_RCU RCU_ADC0 // ADC0的时钟 #define BSP_ADC ADC0 // ADC0外设 /* 函数声明 */ void raindrop_gpio_config(void); // 初始化函数 unsigned int get_raindrop_percentage_value(void); // 读取雨量百分比 unsigned char get_raindrop_do_value(void); // 读取数字开关状态 #endif3.2 让硬件“活”起来初始化配置 (bsp_raindrop.c)这是驱动的核心我们写一个初始化函数raindrop_gpio_config()把ADC和GPIO都配置好。#include bsp_raindrop.h void raindrop_gpio_config(void) { // 第一步打开时钟开关 // 单片机任何外设要工作都得先给它供电打开时钟 rcu_periph_clock_enable(BSP_RAINDROP_GPIO_RCU_AO); // 打开GPIOC时钟 rcu_periph_clock_enable(BSP_RAINDROP_GPIO_RCU_DO); // 打开GPIOE时钟 rcu_periph_clock_enable(BSP_ADC_RCU); // 打开ADC0时钟 // 第二步配置ADC的时钟源和分频 // ADC工作频率不能太高这里选择系统时钟PCLK2的4分频 adc_clock_config(ADC_ADCCK_PCLK2_DIV4); // 第三步配置引脚模式 // PC1AO配置为模拟输入模式这是ADC采集必须的模式 gpio_mode_set(BSP_RAINDROP_GPIO_PORT_AO, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, BSP_RAINDROP_GPIO_PIN_AO); // PE1DO配置为浮空输入模式用于读取外部高低电平 gpio_mode_set(BSP_RAINDROP_GPIO_PORT_DO, GPIO_MODE_INPUT, GPIO_PUPD_NONE, BSP_RAINDROP_GPIO_PIN_DO); // 第四步配置ADC工作模式 adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT); // 独立模式我们只用ADC0 adc_special_function_config(BSP_ADC, ADC_SCAN_MODE, ENABLE); // 使能扫描模式多通道时才需要这里先按例程开启 adc_data_alignment_config(BSP_ADC, ADC_DATAALIGN_RIGHT); // 数据右对齐方便读取 adc_resolution_config(BSP_ADC, ADC_RESOLUTION_12B); // 12位分辨率值范围0-4095 // 第五步配置ADC通道 adc_channel_length_config(BSP_ADC, ADC_ROUTINE_CHANNEL, 1); // 规则组通道数为1我们只用1个通道 // 配置通道0规则组序列0对应ADC通道11即PC1采样时间设为15个周期 adc_routine_channel_config(BSP_ADC, 0, BSP_RAINDROP_ADC_CHANNEL, ADC_SAMPLETIME_15); adc_external_trigger_config(BSP_ADC, ADC_ROUTINE_CHANNEL, EXTERNAL_TRIGGER_DISABLE); // 禁用外部触发用软件触发 // 第六步使能ADC并校准 adc_enable(BSP_ADC); // 开启ADC // 等待ADC稳定 delay_ms(1); adc_calibration_enable(BSP_ADC); // ADC上电后必须校准一次保证采样准确 }注意ADC校准adc_calibration_enable非常重要这是很多初学者容易忽略的一步不校准会导致采样值不准。记得在adc_enable()之后加一点延时再校准。3.3 读取数据的“工具”ADC与GPIO读取函数初始化完成后我们需要两个函数来读取传感器数据。第一个函数读取原始ADC值这个函数是底层核心负责启动一次ADC转换并读取结果。unsigned int get_adc_value(uint8_t adc_channel_x) { unsigned int adc_value 0; // 虽然初始化时配置过通道但每次转换前最好再明确一下要采样的通道 adc_routine_channel_config(BSP_ADC, 0, adc_channel_x, ADC_SAMPLETIME_15); // 软件触发开始转换因为我们禁用了外部触发 adc_software_trigger_enable(BSP_ADC, ADC_ROUTINE_CHANNEL); // 等待转换完成标志位EOCEnd Of Conversion置位 while ( adc_flag_get(BSP_ADC, ADC_FLAG_EOC) RESET ) { ; // 空循环等待 } // 读取转换结果寄存器中的值 adc_value adc_routine_data_read(BSP_ADC); return adc_value; // 返回12位ADC值范围0-4095 }第二个函数将ADC值转换为雨量百分比直接看0-4095的数字不直观我们把它转换成0%-100%的百分比。这里有个关键点雨量越大传感器电阻越小AO电压越高ADC值越大。但“雨量百分比”我们通常希望无水时为0%水越多百分比越高。所以需要做一个反向计算。unsigned int get_raindrop_percentage_value(void) { int adc_max 4095; // 12位ADC最大值 int adc_new 0; int Percentage_value 0; // 1. 读取当前ADC值 adc_new get_adc_value( BSP_RAINDROP_ADC_CHANNEL ); // 2. 转换为百分比 // 公式(1 - (当前值 / 最大值)) * 100 // 当无水时ADC值小(当前值/最大值)接近01-0≈1百分比接近100%。 // 当水多时ADC值大(当前值/最大值)接近11-10百分比接近0%。 // 这符合“水越多输出百分比越小”的直觉吗不这似乎反了。 // 仔细看原始代码和现象描述“当滴一些水在裸露的铜皮上时输出高于10%当将水擦掉时输出1%左右”。 // 这意味着无水时百分比输出小1%有水时百分比输出大10%。 // 所以原始代码的公式 (1-((float)adc_new/adc_max)) * 100 是正确的。 // 无水时ADC值小 - adc_new/adc_max 小 - 1 - 小值 大值接近1- 百分比大不对... 等等我们验证一下。 // 假设无水时ADC值很小比如 adc_new40。 // 百分比 (1 - (40/4095)) * 100 ≈ (1 - 0.0098) * 100 ≈ 99.02%。这输出是99%不是1%。 // 这与原始文章描述的“输出1%左右”矛盾。因此我怀疑原始文章的公式或现象描述有一处笔误。 // 根据物理原理和常规理解雨滴导致电阻下降AO电压上升ADC值上升。 // 我们希望“无水0%水满100%”。那么公式应为(adc_new / adc_max) * 100。 // 但为了兼容原始代码和其验证现象我们暂时按照其提供的公式编写。在实际项目中你需要根据传感器特性调整这个转换关系很可能需要将其改为 (adc_new / adc_max) * 100并通过实验确定阈值。 Percentage_value (1 - ((float)adc_new / adc_max)) * 100; // 沿用原始代码公式 return Percentage_value; }重要提示上面代码中的百分比转换公式可能存在问题与实际物理现象不符。在实际使用时你应该用(adc_new / adc_max) * 100这个公式并通过实验比如干燥时和水滴最多时分别读取ADC值来确定你的实际百分比映射关系。原始资料可能在此处有笔误。第三个函数读取数字开关状态这个就简单了直接读取GPIO引脚的电平。unsigned char get_raindrop_do_value(void) { // 读取PE1引脚的电平返回0低电平或1高电平 return gpio_input_bit_get(BSP_RAINDROP_GPIO_PORT_DO, BSP_RAINDROP_GPIO_PIN_DO); }4. 上机验证让代码跑起来驱动写好了最后在main函数里调用一下看看效果。#include board.h // 开发板初始化函数 #include bsp_raindrop.h #include stdio.h // 为了使用printf int main(void) { board_init(); // 系统时钟、延时等初始化 bsp_uart_init(); // 串口初始化用于printf打印 // 初始化雨滴传感器配置ADC和GPIO raindrop_gpio_config(); while(1) { // 每隔500毫秒读取并打印一次雨量百分比 printf(Raindrop ADC Percent %d%%\r\n, get_raindrop_percentage_value()); // 也可以读取并打印数字开关状态 // if(get_raindrop_do_value() 0) { // printf(DO Status: Rain Detected! (LOW)\r\n); // } else { // printf(DO Status: No Rain. (HIGH)\r\n); // } delay_ms(500); // 延时500ms } }编译下载到天空星GD32F407开发板打开串口助手波特率通常为115200你就能看到不断打印的百分比数值。验证现象基于原始描述当雨滴板干燥时输出的百分比数值在1% 左右。当你滴一些水在雨滴板的铜箔上时输出的百分比数值会高于10%。你可以通过调节模块上的蓝色电位器来改变DO输出翻转的灵敏度即多大雨量时DO引脚从高变低。5. 实际项目中的几点心得阈值判断在实际的自动雨刷或关窗项目中你不可能一直看百分比。通常的做法是在get_raindrop_percentage_value()函数里或之后设置一个或多个阈值。比如int rain_percent get_raindrop_percentage_value(); if(rain_percent 30) { // 小雨触发低速雨刷或提示 } else if(rain_percent 60) { // 中雨触发中速雨刷 } else if(rain_percent 90) { // 大雨触发高速雨刷或紧急关窗 }具体的阈值需要你根据实际传感器特性和安装环境比如车窗倾斜角度来测试确定。滤波处理ADC读取容易受到干扰单次值可能跳动。一个简单的改进是连续采样N次比如10次然后取平均值或中值这样得到的数据会稳定很多。DO引脚的使用如果你只需要一个简单的“下雨/不下雨”的二分判断直接用DO引脚是最方便的。调整电位器到你想要的灵敏度然后单片机只需要检测这个GPIO是否为低电平即可省去了ADC采样和计算的过程响应也更快速。公式修正再次强调务必测试干燥和湿润状态下的原始ADC值使用(adc_new / adc_max) * 100来获得更符合直觉的雨量百分比。这个坑我踩过一开始按照原始公式怎么调都不对后来自己测了ADC值才恍然大悟。好了整个移植过程就是这样。从看原理、连硬件、写驱动到调试一步步走下来相信你对如何驱动一个传感器模块有了更深的体会。遇到问题别怕多查数据手册多用串口打印调试信息你也能很快搞定。