雨滴传感器 | 立创开发板技术文档中心

雨滴传感器主要是用来检测是否下雨及雨量的大小。主要用于汽车智能灯光（AFS）系统、汽车自动雨刷系统、智能车窗系统。

该雨滴传感器基本上是一块板，上面以线形形式涂覆镍。雨滴传感器常见的工作原理是通过检测水滴的导电性来判断是否下雨。它是利用两个电极之间的电导性变化来测量水滴的存在。这两个电极之间会有一个空气间隙，正常状态下是断路状态。当水滴接触到电极上时，水滴的导电性会导致电流通过水滴形成电流回路，从而改变电极之间的电阻值。也就改变了其两端的压降。

一、模块来源

采购链接：

雨滴感应模块雨水传感器下雨感知模块天气模块水位显示模块水滴

资料下载链接：

https://pan.baidu.com/s/10bjbsmcOh2N7YGDS3PquPw

资料提取码：psfm

二、规格参数

工作电压：3.3V-5V

探测距离：1米

输出方式: DO接口为数字量输出 AO接口为模拟量输出

读取方式：ADC与数字量（0和1）

管脚数量：4 Pin（2.54mm间距排针）

以上信息见厂家资料文件

三、移植过程

我们的目标是将例程移植至MSPM0G3507开发板上【判断当前雨水采集板上是否有水的功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。

1、查看资料

该模块基于LM393运算放大器。它包括电子模块和“收集”雨滴的印刷电路板。当雨滴积聚在电路板上时，它们会形成并联电阻路径，该路径可通过运算放大器进行测量。

控制板上有两个指示灯，电源指示灯PWR-LED和输出信号指示灯DO-LED。电源指示灯在通电后常亮，没有雨的时候出信号指示灯不亮；雨滴上去，候出信号指示灯亮。雨滴板和控制板是分开的，方便将线引出，大面积的雨滴板，更有利于检测到雨水。

控制板上有两个输出，数字输出DO，模拟输出AO。接上5V电源电源灯亮，感应板上没有水滴时，DO输出为高电平，滴上一滴水，DO输出为低电平，刷掉上面的水滴，又恢复到输出高电平状态，灵敏度可以通过蓝色的可变电阻调节。

AO模拟输出，连接到单片机的的模拟输入口，通过比对模拟值转化为的数字值大小，可以检测滴在上面的雨量大小，雨水越大，电阻值越小，模拟值转化为的数字值越大。不同的值对应是降雨量的多少毫米，则需要实体测量，雨滴板的放置方式不同结果都不同，这里不作研究。

其对应的原理图，AO输出为雨滴传感器直接输出的电压，所以为模拟量；DO为经过LM393进行电压比较后，输出高低电平，所以为数字量。具体原理见光敏电阻光照传感器章节的资料。

因此DO引脚可以配置为GPIO的输入模式，AO引脚需要配置为ADC模拟输入模式。

2、引脚选择

当前只有AO引脚需要使用到ADC接口，所以DO引脚可以使用开发板上其他的GPIO。这里选择使用PA27的附加ADC功能。

模块	开发板
VCC	5V0
GND	GND
DO	PA26
AO	PA27

接下来我们配置 SYSCONFIG

双击 empty.syscfg 文件，打开它。

点击 ADD 添加GPIO配置

配置GPIO

添加ADC

配置ADC

Ctrl + S 保存配置文件
然后点击编译（可能会报错，我们不用管！）

然后我们所有设定的引脚和功能就会在 ti_msp_dl_config.h 中定义。因为这个文件我们包含进了 board.h 所以我们只需要引用 board.h 即可。【这里的 board.h 就充当了芯片头文件的作用】

3、代码编写

我们在 BSP文件夹 中新建inc和src文件夹，新建两个文件 bsp_raindrop.c 和 bsp_raindrop.h，并且将头文件路径添加到编译器中。

新建文件夹、新建文件以及添加头文件路径，在DHT11章节已经讲过了，可以移步进行查看。

DHT11章节跳转 : （点击跳转🚀）

在文件bsp_raindrop.c中，编写如下代码。

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */
#include "bsp_raindrop.h"
#include "stdio.h"


/**********************************************************
 * 函 数 名 称：ADC_GET
 * 函 数 功 能：读取一次ADC数据
 * 传 入 参 数：无
 * 函 数 返 回：无
 * 作       者：LCKFB
 * 备       注：LP
**********************************************************/
static uint32_t ADC_GET(void)
{
    unsigned int gAdcResult = 0;

    //使能ADC转换
    DL_ADC12_enableConversions(ADC12_0_INST);
    //软件触发ADC开始转换
    DL_ADC12_startConversion(ADC12_0_INST);

    //如果当前状态 不是 空闲状态
    while (DL_ADC12_getStatus(ADC12_0_INST) != DL_ADC12_STATUS_CONVERSION_IDLE );

    //清除触发转换状态
    DL_ADC12_stopConversion(ADC12_0_INST);
    //失能ADC转换
    DL_ADC12_disableConversions(ADC12_0_INST);

    //获取数据
    gAdcResult = DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_CH0);

    return gAdcResult;
}


/**********************************************************
 * 函 数 名 称：get_raindrop_value
 * 函 数 功 能：读取ADC值
 * 传 入 参 数：
 * 函 数 返 回：测量到的值
 * 作       者：LCKFB
 * 备       注：无
**********************************************************/
unsigned int get_raindrop_value(void)
{
    uint32_t Data = 0;

    for(int i = 0; i < SAMPLES; i++)
    {
        Data += ADC_GET();

        delay_ms(5);
    }

    Data = Data / SAMPLES;

    return Data;
}

/******************************************************************
 * 函 数 名 称：get_raindrop_percentage_value
 * 函 数 说 明：读取雨滴AO值，并且返回百分比
 * 函 数 形 参：无
 * 函 数 返 回：返回百分比
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
unsigned int get_raindrop_percentage_value(void)
{
    int adc_max = 4095;
    int adc_new = 0;
    int Percentage_value = 0;

    adc_new = get_raindrop_value();

    Percentage_value = ((float)adc_new / (float)adc_max) * 100.f;
    return Percentage_value;
}

/******************************************************************
 * 函 数 名 称：get_raindrop_do_value
 * 函 数 说 明：读取雨滴DO值，返回0或者1
 * 函 数 形 参：无
 * 函 数 返 回：
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
unsigned char get_raindrop_do_value(void)
{
    return GET_DO;
}

在文件bsp_raindrop.h中，编写如下代码。

#ifndef _BSP_RAINDROP_H__
#define _BSP_RAINDROP_H__

#include "board.h"

/* 采集次数 */
#define SAMPLES 10

#define GET_DO   ( ( DL_GPIO_readPins( GPIO_PORT, GPIO_DO_PIN ) & GPIO_DO_PIN ) ? 1 : 0 )

unsigned int get_raindrop_value(void);
unsigned int get_raindrop_percentage_value(void);
unsigned char get_raindrop_do_value(void);

#endif

四、移植验证

在empty.c中输入代码如下:

#include "ti_msp_dl_config.h"
#include "board.h"
#include "bsp_raindrop.h"


int main(void)
{
    SYSCFG_DL_init();

    while (1)
    {
        lc_printf("\n");
        lc_printf("RainDrop Value      = %d\r\n",  get_raindrop_value());
        lc_printf("RainDrop Percentage = %d%%\r\n",get_raindrop_percentage_value());
        lc_printf("RainDrop DO Value   = %d\r\n",  get_raindrop_do_value());
        delay_ms(500);
    }
}

【代码下载】

跳转到下载中心去下载CCS模块移植代码：【点击跳转🚀】

开发板keil环境入门手册

开发板CCS-Theia入门手册

常见模块移植手册CCS

显示类

传感器类

无线通信类

控制类

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、代码编写

四、移植验证

​

一、模块来源 ​

二、规格参数 ​

三、移植过程 ​

1、查看资料 ​

2、引脚选择 ​

3、代码编写 ​

四、移植验证 ​

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、代码编写

四、移植验证