基于TI TMS320F28P550的雨滴传感器模块驱动移植与ADC/GPIO应用实战最近在做一个智能车窗相关的项目需要检测是否下雨以及雨量大小于是就用上了常见的雨滴传感器模块。这类模块价格便宜、接口简单但第一次把它接到TI的C2000系列DSPTMS320F28P550上时还是遇到了一些配置上的小问题。今天我就把整个驱动移植的过程从原理到代码手把手地梳理一遍希望能帮到正在做类似项目的朋友特别是参加电子竞赛的同学。咱们这次的目标很明确把一款通用的、基于LM393比较器的雨滴传感器模块成功接到TI的开发板上并分别通过ADC读取模拟雨量值通过GPIO读取数字开关量是否下雨。我会详细讲解硬件连接、SysConfig图形化配置、以及驱动代码的每一行含义。1. 认识你的雨滴传感器模块在动手写代码之前咱们先得搞清楚手头的传感器是怎么工作的。我用的这款模块非常常见在网上很容易买到。模块工作原理 你可以把雨滴传感器的探测板想象成一块“画”了很多条平行导线的电路板。这些导线之间平时是断开的电阻非常大。当有雨水滴在上面时水特别是含有杂质的水是导电的它就像一座桥把两条导线连接起来了导致它们之间的电阻变小。模块的核心是一个叫LM393的芯片它是一个电压比较器。模块会输出两个信号AO模拟输出这个引脚直接输出探测板上的电压变化。雨滴越多、面积越大导电性越好电阻越小输出的电压就越高。这是一个连续的模拟量。DO数字输出这个信号是LM393比较器处理后的结果。模块内部有一个可调电阻蓝色的小旋钮用来设定一个阈值电压。当AO端的电压代表雨量超过这个阈值时DO引脚就会从高电平变成低电平表示“检测到下雨了”。同时模块上的DO-LED指示灯也会亮起。模块关键参数工作电压3.3V - 5V咱们的开发板有5V输出直接用它就行输出信号AO模拟量DO数字量0/1接口4个引脚VCC, GND, DO, AO标准的2.54mm排针简单来说AO告诉我们“雨有多大”DO告诉我们“有没有下雨”。2. 硬件连接与引脚规划现在我们需要把传感器的四个引脚正确地连接到TMS320F28P550开发板上。连线思路VCC接开发板的5V电源引脚给模块供电。GND接开发板的GND共地。DO这是一个数字信号要么是高电平3.3V/5V要么是低电平0V所以我们把它接到一个普通的GPIO引脚上并配置为输入模式用来读取高低电平状态。AO这是一个模拟信号电压在0V到VCC之间变化我们必须把它接到芯片的ADC输入引脚上这样才能进行模数转换把电压值变成我们程序里能处理的数字。根据开发板的资源我做了如下连接规划传感器模块引脚连接到开发板说明VCC5V0电源正极GNDGND电源地DOGPIO54数字输出接通用GPIOAOGPIO-A6模拟输出接ADC输入通道注意选择GPIO-A6是因为它在TMS320F28P550芯片上除了可以作为普通GPIO还复用了ADC功能。这一点至关重要只有带ADC功能的引脚才能正确读取模拟电压。3. 使用SysConfig图形化配置引脚TI的C2000系列现在推荐使用SysConfig工具进行图形化配置这比直接去翻寄存器手册方便太多了。咱们就来一步步配置刚才规划好的两个引脚。操作步骤在你的CCS工程中找到并双击c2000.syscfg文件系统配置工具会自动打开。我们需要添加两个配置ADC配置用于管理AO引脚GPIO-A6的模数转换。GPIO配置用于管理DO引脚GPIO54的数字输入。在界面中找到“ADD”按钮添加一个ADC配置模块。通常你需要选择对应的ADC模块例如ADC-A然后在通道配置里找到并启用SOC0采样序列0将其输入通道设置为A6。其他ADC参数如采样窗口大小可以先保持默认。再次点击“ADD”添加一个GPIO配置模块。找到GPIO54将其方向Direction设置为Input输入因为我们是读取传感器的DO输出信号。按下Ctrl S保存配置。按下Ctrl B编译一下工程。这里可能会弹出一些警告但通常不影响可以不用管。配置后的效果 保存并编译后SysConfig会自动生成代码并将引脚的定义更新到board.h这个头文件中。在我们的工程里board.h的內容又被汇总到了tjx_init.h里。所以之后我们在程序里只需要包含#include “tjx_init.h”就可以使用像GPIO_DO对应GPIO54和Module_ADC_BASE对应我们配置的ADC这样的预定义宏了非常方便。4. 手把手编写驱动代码配置好硬件接下来就是核心的软件部分了。我们在工程里新建一个module_driver的文件夹专门放各种传感器驱动。在里面创建两个文件bsp_raindrop.c和bsp_raindrop.h“bsp”意为板级支持包。4.1 头文件定义 (bsp_raindrop.h)头文件主要进行宏定义和函数声明。#ifndef _BSP_RAINDROP_H__ #define _BSP_RAINDROP_H__ #include tjx_init.h // 读取DO引脚状态的宏直接映射到GPIO读取函数 #define GET_DO GPIO_readPin( GPIO_DO ) // ADC采样次数通过多次采样取平均可以滤除一些偶然干扰 #define SAMPLES 5 // 函数声明 unsigned int get_raindrop_value(void); // 获取ADC原始值 unsigned int get_raindrop_percentage_value(void); // 获取雨量百分比 unsigned char get_raindrop_do_value(void); // 获取DO开关状态 #endif4.2 核心驱动实现 (bsp_raindrop.c)这里是干货最多的部分我们逐个函数来分析。首先是一个基础的ADC读取函数ADC_GET 这个函数负责触发一次ADC转换并等待转换完成返回结果。static uint16_t ADC_GET(void) { uint16_t gAdcResult 0; uint16_t timeOut 1000; // 超时计数器防止死等 // 1. 软件触发一次ADC转换SOC0是我们之前在SysConfig里配置的 ADC_forceMultipleSOC(Module_ADC_BASE, Module_ADC_FORCE_SOC0); // 2. 等待ADC转换完成 while(ADC_isBusy(Module_ADC_BASE) timeOut--) { delay_us(1); // 短暂延时 } // 3. 如果超时报错并返回0 if(!timeOut) { lc_printf(ADC_GET Failed!!!\r\n); return 0; } // 4. 读取ADC转换结果寄存器中的值 gAdcResult ADC_readResult(Module_ADC_RESULT_BASE, Module_ADC_SOC0); return gAdcResult; }提示Module_ADC_BASE、Module_ADC_FORCE_SOC0这些宏都是由SysConfig和board.h自动生成的代表了具体的硬件模块和通道这样写代码可移植性更好。接着是获取雨滴模拟量的函数get_raindrop_value 由于单次ADC采样可能受到噪声干扰我们通常采样多次然后取平均值。unsigned int get_raindrop_value(void) { uint32_t Data 0; int i; for(i 0; i SAMPLES; i) // 循环采样SAMPLES次这里是5次 { Data ADC_GET(); // 累加每次的采样值 delay_ms(5); // 每次采样间隔5ms让ADC有足够时间 } Data Data / SAMPLES; // 计算平均值 return Data; }然后是计算雨量百分比的函数get_raindrop_percentage_value ADC读到的原始值范围是0-409512位ADC这个函数将其转换为0-100%的百分比更直观。unsigned int get_raindrop_percentage_value(void) { int adc_max 4095; // 12位ADC的最大值 int adc_new 0; int Percentage_value 0; adc_new get_raindrop_value(); // 先获取原始ADC平均值 // 将ADC值转换为百分比(当前值 / 最大值) * 100% Percentage_value ((float)adc_new / (float)adc_max) * 100.f; return Percentage_value; }注意这个百分比是“导电性”的百分比并不直接等于“毫米降雨量”。要得到精确的降雨量需要在实际环境中用标准仪器进行标定。但用于判断“小雨、中雨、大雨”的等级或者作为触发自动关窗的阈值已经完全足够了。最后是读取数字输出的函数get_raindrop_do_value 这个最简单直接返回我们在头文件里定义的宏即可。当DO引脚为低电平时表示检测到雨水。unsigned char get_raindrop_do_value(void) { return GET_DO; // 实际上就是调用 GPIO_readPin(GPIO_DO) }5. 在主程序中测试与验证驱动写好了最后一步就是把它用起来。我们在主函数里循环读取传感器的值并通过串口打印出来同时让板载的RGB LED闪烁直观地看到程序在运行。#include driverlib.h #include device.h #include board.h #include tjx_init.h #include bsp_raindrop.h // 包含我们自己的驱动头文件 void main(void) { // 以下是CCS自动生成的芯片初始化代码 Device_init(); Device_initGPIO(); Interrupt_initModule(); Interrupt_initVectorTable(); Board_init(); EINT; ERTM; lc_printf(\r\n 雨滴传感器测试程序启动 \r\n); while(1) { // 1. 打印雨滴传感器的所有信息 lc_printf(\r\n); // 换行 lc_printf(ADC原始值 %d\r\n, get_raindrop_value()); lc_printf(雨量百分比 %d%%\r\n, get_raindrop_percentage_value()); lc_printf(DO状态(0有水) %d\r\n, get_raindrop_do_value()); // 2. 让RGB LED交替闪烁指示程序运行正常 GPIO_writePin(RGB_B, 0); // 蓝灯亮 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(200); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 0); // 绿灯亮 delay_ms(200); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(600); // 等待稍长时间再进行下一轮读取 } }实际测试 将代码编译下载到开发板打开串口助手。你会看到每秒打印一次数据。当雨滴板干燥时ADC原始值和百分比接近0DO状态为1高电平。用手指沾水涂抹在雨滴板导线上模拟雨水。你会看到ADC值和百分比迅速上升当超过模块上蓝色电位器设定的阈值时DO状态会变为0低电平同时模块上的DO-LED指示灯应该会亮起。擦干水渍数值会回落DO状态恢复为1。调试小技巧 如果DO状态变化不灵敏可以尝试调节模块上的蓝色电位器。顺时针旋转阈值提高需要更多雨水才会触发逆时针旋转阈值降低更敏感。
基于TI TMS320F28P550的雨滴传感器模块驱动移植与ADC/GPIO应用实战
发布时间：2026/7/5 2:49:22
基于TI TMS320F28P550的雨滴传感器模块驱动移植与ADC/GPIO应用实战最近在做一个智能车窗相关的项目需要检测是否下雨以及雨量大小于是就用上了常见的雨滴传感器模块。这类模块价格便宜、接口简单但第一次把它接到TI的C2000系列DSPTMS320F28P550上时还是遇到了一些配置上的小问题。今天我就把整个驱动移植的过程从原理到代码手把手地梳理一遍希望能帮到正在做类似项目的朋友特别是参加电子竞赛的同学。咱们这次的目标很明确把一款通用的、基于LM393比较器的雨滴传感器模块成功接到TI的开发板上并分别通过ADC读取模拟雨量值通过GPIO读取数字开关量是否下雨。我会详细讲解硬件连接、SysConfig图形化配置、以及驱动代码的每一行含义。1. 认识你的雨滴传感器模块在动手写代码之前咱们先得搞清楚手头的传感器是怎么工作的。我用的这款模块非常常见在网上很容易买到。模块工作原理 你可以把雨滴传感器的探测板想象成一块“画”了很多条平行导线的电路板。这些导线之间平时是断开的电阻非常大。当有雨水滴在上面时水特别是含有杂质的水是导电的它就像一座桥把两条导线连接起来了导致它们之间的电阻变小。模块的核心是一个叫LM393的芯片它是一个电压比较器。模块会输出两个信号AO模拟输出这个引脚直接输出探测板上的电压变化。雨滴越多、面积越大导电性越好电阻越小输出的电压就越高。这是一个连续的模拟量。DO数字输出这个信号是LM393比较器处理后的结果。模块内部有一个可调电阻蓝色的小旋钮用来设定一个阈值电压。当AO端的电压代表雨量超过这个阈值时DO引脚就会从高电平变成低电平表示“检测到下雨了”。同时模块上的DO-LED指示灯也会亮起。模块关键参数工作电压3.3V - 5V咱们的开发板有5V输出直接用它就行输出信号AO模拟量DO数字量0/1接口4个引脚VCC, GND, DO, AO标准的2.54mm排针简单来说AO告诉我们“雨有多大”DO告诉我们“有没有下雨”。2. 硬件连接与引脚规划现在我们需要把传感器的四个引脚正确地连接到TMS320F28P550开发板上。连线思路VCC接开发板的5V电源引脚给模块供电。GND接开发板的GND共地。DO这是一个数字信号要么是高电平3.3V/5V要么是低电平0V所以我们把它接到一个普通的GPIO引脚上并配置为输入模式用来读取高低电平状态。AO这是一个模拟信号电压在0V到VCC之间变化我们必须把它接到芯片的ADC输入引脚上这样才能进行模数转换把电压值变成我们程序里能处理的数字。根据开发板的资源我做了如下连接规划传感器模块引脚连接到开发板说明VCC5V0电源正极GNDGND电源地DOGPIO54数字输出接通用GPIOAOGPIO-A6模拟输出接ADC输入通道注意选择GPIO-A6是因为它在TMS320F28P550芯片上除了可以作为普通GPIO还复用了ADC功能。这一点至关重要只有带ADC功能的引脚才能正确读取模拟电压。3. 使用SysConfig图形化配置引脚TI的C2000系列现在推荐使用SysConfig工具进行图形化配置这比直接去翻寄存器手册方便太多了。咱们就来一步步配置刚才规划好的两个引脚。操作步骤在你的CCS工程中找到并双击c2000.syscfg文件系统配置工具会自动打开。我们需要添加两个配置ADC配置用于管理AO引脚GPIO-A6的模数转换。GPIO配置用于管理DO引脚GPIO54的数字输入。在界面中找到“ADD”按钮添加一个ADC配置模块。通常你需要选择对应的ADC模块例如ADC-A然后在通道配置里找到并启用SOC0采样序列0将其输入通道设置为A6。其他ADC参数如采样窗口大小可以先保持默认。再次点击“ADD”添加一个GPIO配置模块。找到GPIO54将其方向Direction设置为Input输入因为我们是读取传感器的DO输出信号。按下Ctrl S保存配置。按下Ctrl B编译一下工程。这里可能会弹出一些警告但通常不影响可以不用管。配置后的效果 保存并编译后SysConfig会自动生成代码并将引脚的定义更新到board.h这个头文件中。在我们的工程里board.h的內容又被汇总到了tjx_init.h里。所以之后我们在程序里只需要包含#include “tjx_init.h”就可以使用像GPIO_DO对应GPIO54和Module_ADC_BASE对应我们配置的ADC这样的预定义宏了非常方便。4. 手把手编写驱动代码配置好硬件接下来就是核心的软件部分了。我们在工程里新建一个module_driver的文件夹专门放各种传感器驱动。在里面创建两个文件bsp_raindrop.c和bsp_raindrop.h“bsp”意为板级支持包。4.1 头文件定义 (bsp_raindrop.h)头文件主要进行宏定义和函数声明。#ifndef _BSP_RAINDROP_H__ #define _BSP_RAINDROP_H__ #include tjx_init.h // 读取DO引脚状态的宏直接映射到GPIO读取函数 #define GET_DO GPIO_readPin( GPIO_DO ) // ADC采样次数通过多次采样取平均可以滤除一些偶然干扰 #define SAMPLES 5 // 函数声明 unsigned int get_raindrop_value(void); // 获取ADC原始值 unsigned int get_raindrop_percentage_value(void); // 获取雨量百分比 unsigned char get_raindrop_do_value(void); // 获取DO开关状态 #endif4.2 核心驱动实现 (bsp_raindrop.c)这里是干货最多的部分我们逐个函数来分析。首先是一个基础的ADC读取函数ADC_GET 这个函数负责触发一次ADC转换并等待转换完成返回结果。static uint16_t ADC_GET(void) { uint16_t gAdcResult 0; uint16_t timeOut 1000; // 超时计数器防止死等 // 1. 软件触发一次ADC转换SOC0是我们之前在SysConfig里配置的 ADC_forceMultipleSOC(Module_ADC_BASE, Module_ADC_FORCE_SOC0); // 2. 等待ADC转换完成 while(ADC_isBusy(Module_ADC_BASE) timeOut--) { delay_us(1); // 短暂延时 } // 3. 如果超时报错并返回0 if(!timeOut) { lc_printf(ADC_GET Failed!!!\r\n); return 0; } // 4. 读取ADC转换结果寄存器中的值 gAdcResult ADC_readResult(Module_ADC_RESULT_BASE, Module_ADC_SOC0); return gAdcResult; }提示Module_ADC_BASE、Module_ADC_FORCE_SOC0这些宏都是由SysConfig和board.h自动生成的代表了具体的硬件模块和通道这样写代码可移植性更好。接着是获取雨滴模拟量的函数get_raindrop_value 由于单次ADC采样可能受到噪声干扰我们通常采样多次然后取平均值。unsigned int get_raindrop_value(void) { uint32_t Data 0; int i; for(i 0; i SAMPLES; i) // 循环采样SAMPLES次这里是5次 { Data ADC_GET(); // 累加每次的采样值 delay_ms(5); // 每次采样间隔5ms让ADC有足够时间 } Data Data / SAMPLES; // 计算平均值 return Data; }然后是计算雨量百分比的函数get_raindrop_percentage_value ADC读到的原始值范围是0-409512位ADC这个函数将其转换为0-100%的百分比更直观。unsigned int get_raindrop_percentage_value(void) { int adc_max 4095; // 12位ADC的最大值 int adc_new 0; int Percentage_value 0; adc_new get_raindrop_value(); // 先获取原始ADC平均值 // 将ADC值转换为百分比(当前值 / 最大值) * 100% Percentage_value ((float)adc_new / (float)adc_max) * 100.f; return Percentage_value; }注意这个百分比是“导电性”的百分比并不直接等于“毫米降雨量”。要得到精确的降雨量需要在实际环境中用标准仪器进行标定。但用于判断“小雨、中雨、大雨”的等级或者作为触发自动关窗的阈值已经完全足够了。最后是读取数字输出的函数get_raindrop_do_value 这个最简单直接返回我们在头文件里定义的宏即可。当DO引脚为低电平时表示检测到雨水。unsigned char get_raindrop_do_value(void) { return GET_DO; // 实际上就是调用 GPIO_readPin(GPIO_DO) }5. 在主程序中测试与验证驱动写好了最后一步就是把它用起来。我们在主函数里循环读取传感器的值并通过串口打印出来同时让板载的RGB LED闪烁直观地看到程序在运行。#include driverlib.h #include device.h #include board.h #include tjx_init.h #include bsp_raindrop.h // 包含我们自己的驱动头文件 void main(void) { // 以下是CCS自动生成的芯片初始化代码 Device_init(); Device_initGPIO(); Interrupt_initModule(); Interrupt_initVectorTable(); Board_init(); EINT; ERTM; lc_printf(\r\n 雨滴传感器测试程序启动 \r\n); while(1) { // 1. 打印雨滴传感器的所有信息 lc_printf(\r\n); // 换行 lc_printf(ADC原始值 %d\r\n, get_raindrop_value()); lc_printf(雨量百分比 %d%%\r\n, get_raindrop_percentage_value()); lc_printf(DO状态(0有水) %d\r\n, get_raindrop_do_value()); // 2. 让RGB LED交替闪烁指示程序运行正常 GPIO_writePin(RGB_B, 0); // 蓝灯亮 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(200); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 0); // 绿灯亮 delay_ms(200); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(600); // 等待稍长时间再进行下一轮读取 } }实际测试 将代码编译下载到开发板打开串口助手。你会看到每秒打印一次数据。当雨滴板干燥时ADC原始值和百分比接近0DO状态为1高电平。用手指沾水涂抹在雨滴板导线上模拟雨水。你会看到ADC值和百分比迅速上升当超过模块上蓝色电位器设定的阈值时DO状态会变为0低电平同时模块上的DO-LED指示灯应该会亮起。擦干水渍数值会回落DO状态恢复为1。调试小技巧 如果DO状态变化不灵敏可以尝试调节模块上的蓝色电位器。顺时针旋转阈值提高需要更多雨水才会触发逆时针旋转阈值降低更敏感。
