雨滴传感器主要是用来检测是否下雨及雨量的大小。主要用于汽车智能灯光（AFS）系统、汽车自动雨刷系统、智能车窗系统。
该雨滴传感器基本上是一块板，上面以线形形式涂覆镍。雨滴传感器常见的工作原理是通过检测水滴的导电性来判断是否下雨。它是利用两个电极之间的电导性变化来测量水滴的存在。这两个电极之间会有一个空气间隙，正常状态下是断路状态。当水滴接触到电极上时，水滴的导电性会导致电流通过水滴形成电流回路，从而改变电极之间的电阻值。也就改变了其两端的压降。
一、模块来源
采购链接：
雨滴感应模块 雨水传感器下雨感知模块天气模块 水位显示模块水滴
资料下载链接：
https://pan.baidu.com/s/10bjbsmcOh2N7YGDS3PquPw
资料提取码：psfm
二、规格参数
工作电压：3.3V-5V
探测距离：1米
输出方式: DO接口为数字量输出 AO接口为模拟量输出
读取方式：ADC与数字量（0和1）
管脚数量：4 Pin（2.54mm间距排针）
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至开发板上【判断当前雨水采集板上是否有水的功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。
1、查看资料
该模块基于LM393运算放大器。它包括电子模块和“收集”雨滴的印刷电路板。当雨滴积聚在电路板上时，它们会形成并联电阻路径，该路径可通过运算放大器进行测量。
控制板上有两个指示灯，电源指示灯PWR-LED和输出信号指示灯DO-LED。电源指示灯在通电后常亮，没有雨的时候出信号指示灯不亮；雨滴上去，候出信号指示灯亮。雨滴板和控制板是分开的，方便将线引出，大面积的雨滴板，更有利于检测到雨水。
控制板上有两个输出，数字输出DO，模拟输出AO。接上5V电源电源灯亮，感应板上没有水滴时，DO输出为高电平，滴上一滴水，DO输出为低电平，刷掉上面的水滴，又恢复到输出高电平状态，灵敏度可以通过蓝色的可变电阻调节。
AO模拟输出，连接到单片机的的模拟输入口，通过比对模拟值转化为的数字值大小，可以检测滴在上面的雨量大小，雨水越大，电阻值越小，模拟值转化为的数字值越大。 不同的值对应是降雨量的多少毫米，则需要实体测量，雨滴板的放置方式不同结果都不同，这里不作研究。
其对应的原理图，AO输出为雨滴传感器直接输出的电压，所以为模拟量；DO为经过LM393进行电压比较后，输出高低电平，所以为数字量。具体原理见光敏电阻光照传感器章节的资料。
因此DO引脚可以配置为GPIO的输入模式，AO引脚需要配置为ADC模拟输入模式。
2、引脚选择
3、移植至工程
移植步骤中的导入.c和.h文件与传感器章节的【DHT11温湿度传感器】相同，只是将.c和.h文件更改为bsp_raindrop.c与bsp_raindrop.h。这里不再过多讲述，移植完成后面修改相关代码。
在文件bsp_raindrop.c中，编写如下代码。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-03-29 LCKFB-LP first version
*/
#include "bsp_raindrop.h"
#include "board.h"
/******************************************************************
* 函 数 名 称：raindrop_gpio_config
* 函 数 说 明：初始化雨滴传感器引脚
* 函 数 形 参：无
* 函 数 返 回：无
* 作 者：LC
* 备 注：无
******************************************************************/
void raindrop_gpio_config(void)
{
RCC_APB2PeriphClockCmd (RCC_RAINDROP_GPIO, ENABLE); // 使能GPIOA时钟
RCC_APB2PeriphClockCmd (RCC_RAINDROP_ADC, ENABLE); // 使能ADC时钟
GPIO_InitTypeDef GPIO_InitStructure; // GPIO配置结构体
GPIO_InitStructure.GPIO_Pin = BSP_RAINDROP_GPIO_PIN_AO;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN; //模拟输入
GPIO_Init(BSP_RAINDROP_GPIO_PORT_AO, &GPIO_InitStructure); // 初始化GPIOC
GPIO_InitStructure.GPIO_Pin = BSP_RAINDROP_GPIO_PIN_DO;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; //输入
GPIO_Init(BSP_RAINDROP_GPIO_PORT_DO, &GPIO_InitStructure); // 初始化GPIOE
ADC_DeInit(BSP_ADC);//ADC复位
/* ADC特定配置 */
ADC_InitTypeDef ADC_InitStruct; // ADC特定配置结构体
// ADC 模式配置
ADC_InitStruct.ADC_Mode = ADC_Mode_Independent;// 只使用一个ADC，独立模式
ADC_InitStruct.ADC_ScanConvMode = DISABLE ;// 禁止扫描模式，单通道不需要扫描
ADC_InitStruct.ADC_ContinuousConvMode = ENABLE;// 连续转换模式
ADC_InitStruct.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None;// 软件触发转换
ADC_InitStruct.ADC_DataAlign = ADC_DataAlign_Right;// 数据右对齐
ADC_InitStruct.ADC_NbrOfChannel = 1;// 转换通道1个
// 初始化ADC
ADC_Init(BSP_ADC, &ADC_InitStruct);
// 配置ADC时钟PCLK2的6分频，即12MHz
RCC_ADCCLKConfig(RCC_PCLK2_Div6);
// 配置 ADC 通道转换顺序为1，第一个转换，采样时间为55.5个时钟周期
// 通道为5
ADC_RegularChannelConfig(BSP_ADC, BSP_RAINDROP_ADC_CHANNEL, 1, ADC_SampleTime_55Cycles5);
//ADC使能
ADC_Cmd(BSP_ADC, ENABLE);
// 初始化ADC 校准寄存器
ADC_ResetCalibration(BSP_ADC);
// 等待校准寄存器初始化完成
while (ADC_GetResetCalibrationStatus(BSP_ADC));
// ADC开始校准
ADC_StartCalibration(BSP_ADC);
// 等待校准完成
while (ADC_GetCalibrationStatus(BSP_ADC));
// 使用软件触发ADC转换
ADC_SoftwareStartConvCmd(BSP_ADC, ENABLE);
}
/**********************************************************
* 函 数 名 称：get_adc_value
* 函 数 功 能：读取ADC值
* 传 入 参 数：
* 函 数 返 回：测量到的值
* 作 者：LC
* 备 注：无
**********************************************************/
unsigned int get_adc_value(void)
{
uint32_t data = ADC_GetConversionValue(BSP_ADC);
delay_ms(20);
return data;
}
/******************************************************************
* 函 数 名 称：get_raindrop_percentage_value
* 函 数 说 明：读取雨滴AO值，并且返回百分比
* 函 数 形 参：无
* 函 数 返 回：返回百分比
* 作 者：LC
* 备 注：无
******************************************************************/
unsigned int get_raindrop_percentage_value(void)
{
int adc_max = 4095;
uint32_t adc_new = 0;
int Percentage_value = 0;
int i = 0;
int count = 3;
for( i = 0; i < count; i++)
{
adc_new += get_adc_value();
delay_1ms(100);
}
adc_new = adc_new / count;
delay_1ms(100);
Percentage_value = ( 1.0f - ( (float)adc_new / (float)adc_max ) ) * 100;
return Percentage_value;
}
/******************************************************************
* 函 数 名 称：get_raindrop_do_value
* 函 数 说 明：读取雨滴DO值，返回0或者1
* 函 数 形 参：无
* 函 数 返 回：
* 作 者：LC
* 备 注：无
******************************************************************/
unsigned char get_raindrop_do_value(void)
{
return GPIO_ReadInputDataBit(BSP_RAINDROP_GPIO_PORT_DO, BSP_RAINDROP_GPIO_PIN_DO);
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
在文件bsp_raindrop.h中，编写如下代码。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-03-29 LCKFB-LP first version
*/
#ifndef _BSP_RAINDROP_H__
#define _BSP_RAINDROP_H__
#include "stm32f10x.h"
#define RCC_RAINDROP_GPIO RCC_APB2Periph_GPIOA
#define RCC_RAINDROP_ADC RCC_APB2Periph_ADC1
#define BSP_RAINDROP_GPIO_PORT_AO GPIOA
#define BSP_RAINDROP_GPIO_PIN_AO GPIO_Pin_5
#define BSP_RAINDROP_GPIO_PORT_DO GPIOA
#define BSP_RAINDROP_GPIO_PIN_DO GPIO_Pin_6
#define BSP_ADC ADC1
#define BSP_RAINDROP_ADC_CHANNEL ADC_Channel_5
void raindrop_gpio_config(void);
unsigned int get_raindrop_percentage_value(void);
#endif1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
四、移植验证
在自己工程中的main主函数中，编写如下。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-03-29 LCKFB-LP first version
*/
#include "stm32f10x.h"
#include "board.h"
#include "bsp_uart.h"
#include <stdio.h>
#include "bsp_raindrop.h"
int main(void)
{
board_init();
uart1_init(115200);
//ADC接口初始化
raindrop_gpio_config();
while(1)
{
printf("雨水百分比 = %d%%\r\n", get_raindrop_percentage_value() );
delay_ms(500);
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
上电现象：输出检测雨滴大小程度的百分比。
可以调节电阻来控制灵敏度
移植成功案例代码下载链接：