基于TI MSPM0的雨滴传感器模块驱动移植与ADC/GPIO双模式数据采集实战最近在做一个智能车窗的项目需要检测是否下雨以及雨量大小于是就用上了这个常见的雨滴传感器模块。很多刚开始接触MSPM0的朋友问我这种模块怎么接到开发板上、程序该怎么写。今天我就以TI的MSPM0系列微控制器用的是立创开发板为例带大家走一遍完整的驱动移植和数据采集流程。咱们这个实战的目标很明确把市面上那种通用的、几十块钱的雨滴传感器模块用起来既能通过它的数字输出DO引脚快速判断“有没有雨”也能通过模拟输出AO引脚测量“雨有多大”。整个过程从原理理解、引脚配置、代码编写到最终验证我会手把手教你保证你跟着做一遍就能掌握。1. 认识你的雨滴传感器模块在动手写代码之前咱们得先搞清楚手里这个传感器是怎么工作的。这能帮你理解后面为什么要那么配置出了问题也知道该往哪个方向排查。1.1 模块是怎么“看见”雨的你拿到手的雨滴传感器通常由两部分组成一块大的“感应板”和一块小的“控制板”。感应板就是那块绿色的、上面有好多条平行导线的电路板。它的表面是裸露的。当雨滴落在上面时水滴会桥接两条或多条导线。水是导电的虽然导电性不强这就相当于在原本断开的导线之间并联上了一个电阻。控制板核心是一颗LM393运算放大器芯片。它主要负责两件事处理感应板送来的微弱信号。提供两种输出方式给我们单片机读取。模块上有两个LED灯PWR-LED电源指示灯通电就常亮。DO-LED信号指示灯。没雨的时候不亮一旦检测到雨滴达到设定的阈值就会亮。这个灯的状态和DO引脚的输出是同步的调试的时候看它非常直观。1.2 两个关键输出引脚AO和DO这是本教程的核心一定要理解清楚。引脚名称输出类型信号含义连接到单片机的什么功能AO (Analog Output)模拟电压直接反映雨量大小。感应板越湿并联电阻越小这个引脚输出的电压值越高。ADC (模数转换器) 输入引脚DO (Digital Output)数字电平判断是否下雨。当雨量超过模块上蓝色电位器设定的阈值时输出从高电平(1)变为低电平(0)。GPIO 输入引脚简单来说AO引脚给你一个连续的“雨量计”。你想知道具体下了多少雨就用ADC去读这个电压值。DO引脚给你一个简单的“下雨开关”。你只关心“下没下雨”这个状态就直接读这个引脚的电平省事。模块工作电压是3.3V-5V和咱们的开发板兼容直接连接就行。2. 硬件连接与SYSCONFIG图形化配置硬件连接很简单关键是软件上的引脚功能配置。TI MSPM0的SDK提供了SYSCONFIG这个图形化配置工具用起来非常方便能自动生成底层初始化代码避免了我们手动查手册、算寄存器的麻烦。2.1 把传感器接到开发板上你需要4根杜邦线母对母。连接关系如下雨滴传感器引脚连接到立创开发板 (MSPM0)说明VCC3.3V 或 5V 引脚供电GNDGND 引脚共地AOPA27引脚这是我们为ADC功能选择的引脚DO任意一个GPIO引脚如PA25配置为输入模式用于读取高低电平注意为什么选PA27因为根据原文的移植过程作者选择了PA27的附加ADC功能。在MSPM0芯片上很多GPIO口都复用了ADC功能你需要查阅具体型号的数据手册来确认。这里我们遵循原文使用PA27。2.2 使用SYSCONFIG配置引脚功能这是TI开发环境的一大特色咱们一步步来打开工程在你的CCS或IAR工程里找到并双击empty.syscfg文件或其他类似的.syscfg文件它会打开图形化配置界面。添加ADC配置在界面中找到ADD或添加组件的按钮。搜索并添加ADC组件原文中是ADC12_0。在ADC组件的属性中将通道关联到我们硬件连接的引脚即PA27。工具会自动将其配置为ADC模拟输入模式。添加GPIO配置同样地添加一个GPIO组件。将其配置为我们连接DO引脚的GPIO口例如PA25并将方向设置为输入(Input)。保存并生成代码点击保存。这里有个非常重要的坑点如果弹出对话框询问是否更新工程一定要选择Yes to All确保所有配置文件都被更新。保存后点击编译工程。即使此时编译报错可能因为主函数还没写也先不用管它。这一步的目的是让SYSCONFIG工具根据你的图形化配置自动生成底层代码。完成这一步后工具会在ti_msp_dl_config.h等文件中为我们定义好ADC12_0_INSTADC实例、GPIO_PORT、GPIO_DO_PIN这些宏和初始化结构体。我们后续编程直接使用这些定义即可非常省心。3. 驱动代码编写与解析配置好硬件抽象层接下来就是编写应用层的传感器驱动了。我们将创建两个文件bsp_raindrop.c和bsp_raindrop.h。3.1 头文件定义 (bsp_raindrop.h)头文件主要做宏定义和函数声明。#ifndef _BSP_RAINDROP_H__ #define _BSP_RAINDROP_H__ #include board.h // 这个文件包含了 ti_msp_dl_config.h /* 读取DO引脚电平的宏 * 原理读取指定端口和引脚的状态通过与运算和三元运算符判断有雨(低电平)返回0无雨(高电平)返回1 */ #define GET_DO ( ( DL_GPIO_readPins( GPIO_PORT, GPIO_DO_PIN ) GPIO_DO_PIN ) ? 1 : 0 ) // 函数声明 void raindrop_config(void); // 初始化函数 unsigned int get_raindrop_percentage_value(void); // 获取雨量百分比 unsigned char get_raindrop_do_value(void); // 获取数字开关状态实际调用GET_DO宏 #endif3.2 核心驱动实现 (bsp_raindrop.c)这个文件包含了所有干货咱们分段解读。第一部分ADC采集与中断处理ADC转换需要一点时间我们采用“软件触发中断通知”的方式这样CPU在等待转换结果时不用死等效率更高。#include bsp_raindrop.h #include stdio.h volatile bool gCheckADC false; // ADC转换完成标志位用volatile修饰确保编译器不优化 // ADC中断服务函数 void ADC12_0_INST_IRQHandler(void) { // 检查是哪个ADC中断源触发了 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 如果是我们用的内存0对应通道0转换完成 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC true; // 置位标志位告诉主程序数据准备好了 break; default: break; } } // 初始化函数主要开启ADC中断 void raindrop_config(void) { NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); // 使能ADC12模块0的中断 } // 核心执行一次ADC转换并读取结果 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 Conversion Timeout! LINE:%d\r\n,__LINE__); return 0; // 返回一个错误值 } } // 3. 从ADC结果存储器中读取数据 // ADC12_0_ADCMEM_ADC_CH0 对应我们配置的通道0PA27 gAdcResult DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_ADC_CH0); // 4. 清除标志位为下一次转换做准备 gCheckADC false; return gAdcResult; }第二部分数据读取与处理函数这里提供了两个层次的接口一个是原始的ADC值另一个是处理成百分比的可读值。// 基础函数获取一次ADC原始值12位分辨率范围0-4095 unsigned int get_adc_value(void) { uint32_t data ADC_GET(); delay_ms(20); // 两次采集间稍作延时避免过于频繁 return data; } // 核心功能函数获取雨量百分比更直观 unsigned int get_raindrop_percentage_value(void) { int adc_max 4095; // MSPM0 ADC 12位分辨率最大值 uint32_t adc_sum 0; int Percentage_value 0; int i 0; int count 3; // 采样3次取平均减少偶然误差 // 1. 多次采样取平均值 for( i 0; i count; i) { adc_sum get_adc_value(); delay_1ms(100); } uint32_t adc_average adc_sum / count; // 2. 转换为百分比 // 原理感应板越干电阻越大AO电压越低ADC值越小。 // 我们希望“无雨0%” “完全浸湿100%”所以用1减去归一化值。 Percentage_value ( 1.0f - ( (float)adc_average / (float)adc_max ) ) * 100; return Percentage_value; } // 读取数字输出状态0表示有雨1表示无雨 unsigned char get_raindrop_do_value(void) { // 直接使用头文件中定义的宏 return GET_DO; }提示get_raindrop_percentage_value函数中的百分比转换公式(1.0f - (adc_value / adc_max)) * 100是关键。因为传感器特性是“越湿电压越高ADC值越大”。为了符合直觉湿度越大百分比越高我们用1去减。如果你的传感器特性相反可能需要调整这个公式。4. 在主程序中验证结果驱动写好了最后就是在主函数里调用它看看效果。我们在empty.c或你的主文件中这样写#include board.h #include stdio.h #include bsp_raindrop.h int main(void) { // 开发板初始化时钟、外设等 board_init(); // 雨滴传感器初始化主要是使能ADC中断 raindrop_config(); printf(Raindrop Sensor Test Start...\r\n); while(1) { // 读取并打印雨量百分比 printf(Raindrop Level %d%%\r\n, get_raindrop_percentage_value()); // 读取并打印数字开关状态 unsigned char do_state get_raindrop_do_value(); if(do_state 0) { printf(DO Status: RAINING!\r\n); } else { printf(DO Status: No Rain.\r\n); } printf(-------------------\r\n); delay_ms(1000); // 每秒读取一次 } }上电验证 将程序下载到立创开发板打开串口助手。你会看到类似这样的输出Raindrop Sensor Test Start... Raindrop Level 2% DO Status: No Rain. -------------------此时你可以尝试滴几滴水到感应板上观察“Raindrop Level”百分比数值会显著上升“DO Status”很可能变为“RAINING!”如果水量超过了蓝色电位器设定的阈值。调节模块上的蓝色电位器这是调节DO输出灵敏度的。顺时针旋转需要更多的水更高的湿度才会触发DO跳变逆时针旋转则更灵敏。5. 实际项目中的几点心得这个驱动已经可以稳定工作了但在实际项目中你还可以考虑以下几点阈值判断get_raindrop_percentage_value()返回的是一个连续值。你可以根据这个值设置多个阈值实现“小雨”、“中雨”、“大雨”的等级判断而不仅仅是DO的“有/无”。滤波算法现在的代码只是简单的3次平均。如果用在汽车雨刷上为了防止偶尔的水渍误触发可以加入更复杂的软件滤波比如滑动平均滤波或中值滤波。DO引脚的利用DO引脚非常适合用来触发单片机的外部中断。你可以配置GPIO中断当DO引脚电平变化下雨时立即进入中断处理函数响应速度最快非常适合做自动雨刷的即时触发。校准百分比转换公式是基于理论最大最小值0和4095的。如果你想更精确可以对传感器进行两点校准记录“完全干燥”和“完全浸湿”时的ADC值然后用这两个实际值去做映射。希望这篇教程能帮你顺利把雨滴传感器用起来。整个过程涵盖了从硬件原理、图形化配置、ADC/GPIO驱动编写到数据处理的核心步骤掌握了这个流程再移植其他类似的模拟/数字传感器模块就都是同样的思路了。
基于TI MSPM0的雨滴传感器模块驱动移植与ADC/GPIO双模式数据采集实战
基于TI MSPM0的雨滴传感器模块驱动移植与ADC/GPIO双模式数据采集实战最近在做一个智能车窗的项目需要检测是否下雨以及雨量大小于是就用上了这个常见的雨滴传感器模块。很多刚开始接触MSPM0的朋友问我这种模块怎么接到开发板上、程序该怎么写。今天我就以TI的MSPM0系列微控制器用的是立创开发板为例带大家走一遍完整的驱动移植和数据采集流程。咱们这个实战的目标很明确把市面上那种通用的、几十块钱的雨滴传感器模块用起来既能通过它的数字输出DO引脚快速判断“有没有雨”也能通过模拟输出AO引脚测量“雨有多大”。整个过程从原理理解、引脚配置、代码编写到最终验证我会手把手教你保证你跟着做一遍就能掌握。1. 认识你的雨滴传感器模块在动手写代码之前咱们得先搞清楚手里这个传感器是怎么工作的。这能帮你理解后面为什么要那么配置出了问题也知道该往哪个方向排查。1.1 模块是怎么“看见”雨的你拿到手的雨滴传感器通常由两部分组成一块大的“感应板”和一块小的“控制板”。感应板就是那块绿色的、上面有好多条平行导线的电路板。它的表面是裸露的。当雨滴落在上面时水滴会桥接两条或多条导线。水是导电的虽然导电性不强这就相当于在原本断开的导线之间并联上了一个电阻。控制板核心是一颗LM393运算放大器芯片。它主要负责两件事处理感应板送来的微弱信号。提供两种输出方式给我们单片机读取。模块上有两个LED灯PWR-LED电源指示灯通电就常亮。DO-LED信号指示灯。没雨的时候不亮一旦检测到雨滴达到设定的阈值就会亮。这个灯的状态和DO引脚的输出是同步的调试的时候看它非常直观。1.2 两个关键输出引脚AO和DO这是本教程的核心一定要理解清楚。引脚名称输出类型信号含义连接到单片机的什么功能AO (Analog Output)模拟电压直接反映雨量大小。感应板越湿并联电阻越小这个引脚输出的电压值越高。ADC (模数转换器) 输入引脚DO (Digital Output)数字电平判断是否下雨。当雨量超过模块上蓝色电位器设定的阈值时输出从高电平(1)变为低电平(0)。GPIO 输入引脚简单来说AO引脚给你一个连续的“雨量计”。你想知道具体下了多少雨就用ADC去读这个电压值。DO引脚给你一个简单的“下雨开关”。你只关心“下没下雨”这个状态就直接读这个引脚的电平省事。模块工作电压是3.3V-5V和咱们的开发板兼容直接连接就行。2. 硬件连接与SYSCONFIG图形化配置硬件连接很简单关键是软件上的引脚功能配置。TI MSPM0的SDK提供了SYSCONFIG这个图形化配置工具用起来非常方便能自动生成底层初始化代码避免了我们手动查手册、算寄存器的麻烦。2.1 把传感器接到开发板上你需要4根杜邦线母对母。连接关系如下雨滴传感器引脚连接到立创开发板 (MSPM0)说明VCC3.3V 或 5V 引脚供电GNDGND 引脚共地AOPA27引脚这是我们为ADC功能选择的引脚DO任意一个GPIO引脚如PA25配置为输入模式用于读取高低电平注意为什么选PA27因为根据原文的移植过程作者选择了PA27的附加ADC功能。在MSPM0芯片上很多GPIO口都复用了ADC功能你需要查阅具体型号的数据手册来确认。这里我们遵循原文使用PA27。2.2 使用SYSCONFIG配置引脚功能这是TI开发环境的一大特色咱们一步步来打开工程在你的CCS或IAR工程里找到并双击empty.syscfg文件或其他类似的.syscfg文件它会打开图形化配置界面。添加ADC配置在界面中找到ADD或添加组件的按钮。搜索并添加ADC组件原文中是ADC12_0。在ADC组件的属性中将通道关联到我们硬件连接的引脚即PA27。工具会自动将其配置为ADC模拟输入模式。添加GPIO配置同样地添加一个GPIO组件。将其配置为我们连接DO引脚的GPIO口例如PA25并将方向设置为输入(Input)。保存并生成代码点击保存。这里有个非常重要的坑点如果弹出对话框询问是否更新工程一定要选择Yes to All确保所有配置文件都被更新。保存后点击编译工程。即使此时编译报错可能因为主函数还没写也先不用管它。这一步的目的是让SYSCONFIG工具根据你的图形化配置自动生成底层代码。完成这一步后工具会在ti_msp_dl_config.h等文件中为我们定义好ADC12_0_INSTADC实例、GPIO_PORT、GPIO_DO_PIN这些宏和初始化结构体。我们后续编程直接使用这些定义即可非常省心。3. 驱动代码编写与解析配置好硬件抽象层接下来就是编写应用层的传感器驱动了。我们将创建两个文件bsp_raindrop.c和bsp_raindrop.h。3.1 头文件定义 (bsp_raindrop.h)头文件主要做宏定义和函数声明。#ifndef _BSP_RAINDROP_H__ #define _BSP_RAINDROP_H__ #include board.h // 这个文件包含了 ti_msp_dl_config.h /* 读取DO引脚电平的宏 * 原理读取指定端口和引脚的状态通过与运算和三元运算符判断有雨(低电平)返回0无雨(高电平)返回1 */ #define GET_DO ( ( DL_GPIO_readPins( GPIO_PORT, GPIO_DO_PIN ) GPIO_DO_PIN ) ? 1 : 0 ) // 函数声明 void raindrop_config(void); // 初始化函数 unsigned int get_raindrop_percentage_value(void); // 获取雨量百分比 unsigned char get_raindrop_do_value(void); // 获取数字开关状态实际调用GET_DO宏 #endif3.2 核心驱动实现 (bsp_raindrop.c)这个文件包含了所有干货咱们分段解读。第一部分ADC采集与中断处理ADC转换需要一点时间我们采用“软件触发中断通知”的方式这样CPU在等待转换结果时不用死等效率更高。#include bsp_raindrop.h #include stdio.h volatile bool gCheckADC false; // ADC转换完成标志位用volatile修饰确保编译器不优化 // ADC中断服务函数 void ADC12_0_INST_IRQHandler(void) { // 检查是哪个ADC中断源触发了 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 如果是我们用的内存0对应通道0转换完成 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC true; // 置位标志位告诉主程序数据准备好了 break; default: break; } } // 初始化函数主要开启ADC中断 void raindrop_config(void) { NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); // 使能ADC12模块0的中断 } // 核心执行一次ADC转换并读取结果 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 Conversion Timeout! LINE:%d\r\n,__LINE__); return 0; // 返回一个错误值 } } // 3. 从ADC结果存储器中读取数据 // ADC12_0_ADCMEM_ADC_CH0 对应我们配置的通道0PA27 gAdcResult DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_ADC_CH0); // 4. 清除标志位为下一次转换做准备 gCheckADC false; return gAdcResult; }第二部分数据读取与处理函数这里提供了两个层次的接口一个是原始的ADC值另一个是处理成百分比的可读值。// 基础函数获取一次ADC原始值12位分辨率范围0-4095 unsigned int get_adc_value(void) { uint32_t data ADC_GET(); delay_ms(20); // 两次采集间稍作延时避免过于频繁 return data; } // 核心功能函数获取雨量百分比更直观 unsigned int get_raindrop_percentage_value(void) { int adc_max 4095; // MSPM0 ADC 12位分辨率最大值 uint32_t adc_sum 0; int Percentage_value 0; int i 0; int count 3; // 采样3次取平均减少偶然误差 // 1. 多次采样取平均值 for( i 0; i count; i) { adc_sum get_adc_value(); delay_1ms(100); } uint32_t adc_average adc_sum / count; // 2. 转换为百分比 // 原理感应板越干电阻越大AO电压越低ADC值越小。 // 我们希望“无雨0%” “完全浸湿100%”所以用1减去归一化值。 Percentage_value ( 1.0f - ( (float)adc_average / (float)adc_max ) ) * 100; return Percentage_value; } // 读取数字输出状态0表示有雨1表示无雨 unsigned char get_raindrop_do_value(void) { // 直接使用头文件中定义的宏 return GET_DO; }提示get_raindrop_percentage_value函数中的百分比转换公式(1.0f - (adc_value / adc_max)) * 100是关键。因为传感器特性是“越湿电压越高ADC值越大”。为了符合直觉湿度越大百分比越高我们用1去减。如果你的传感器特性相反可能需要调整这个公式。4. 在主程序中验证结果驱动写好了最后就是在主函数里调用它看看效果。我们在empty.c或你的主文件中这样写#include board.h #include stdio.h #include bsp_raindrop.h int main(void) { // 开发板初始化时钟、外设等 board_init(); // 雨滴传感器初始化主要是使能ADC中断 raindrop_config(); printf(Raindrop Sensor Test Start...\r\n); while(1) { // 读取并打印雨量百分比 printf(Raindrop Level %d%%\r\n, get_raindrop_percentage_value()); // 读取并打印数字开关状态 unsigned char do_state get_raindrop_do_value(); if(do_state 0) { printf(DO Status: RAINING!\r\n); } else { printf(DO Status: No Rain.\r\n); } printf(-------------------\r\n); delay_ms(1000); // 每秒读取一次 } }上电验证 将程序下载到立创开发板打开串口助手。你会看到类似这样的输出Raindrop Sensor Test Start... Raindrop Level 2% DO Status: No Rain. -------------------此时你可以尝试滴几滴水到感应板上观察“Raindrop Level”百分比数值会显著上升“DO Status”很可能变为“RAINING!”如果水量超过了蓝色电位器设定的阈值。调节模块上的蓝色电位器这是调节DO输出灵敏度的。顺时针旋转需要更多的水更高的湿度才会触发DO跳变逆时针旋转则更灵敏。5. 实际项目中的几点心得这个驱动已经可以稳定工作了但在实际项目中你还可以考虑以下几点阈值判断get_raindrop_percentage_value()返回的是一个连续值。你可以根据这个值设置多个阈值实现“小雨”、“中雨”、“大雨”的等级判断而不仅仅是DO的“有/无”。滤波算法现在的代码只是简单的3次平均。如果用在汽车雨刷上为了防止偶尔的水渍误触发可以加入更复杂的软件滤波比如滑动平均滤波或中值滤波。DO引脚的利用DO引脚非常适合用来触发单片机的外部中断。你可以配置GPIO中断当DO引脚电平变化下雨时立即进入中断处理函数响应速度最快非常适合做自动雨刷的即时触发。校准百分比转换公式是基于理论最大最小值0和4095的。如果你想更精确可以对传感器进行两点校准记录“完全干燥”和“完全浸湿”时的ADC值然后用这两个实际值去做映射。希望这篇教程能帮你顺利把雨滴传感器用起来。整个过程涵盖了从硬件原理、图形化配置、ADC/GPIO驱动编写到数据处理的核心步骤掌握了这个流程再移植其他类似的模拟/数字传感器模块就都是同样的思路了。
