MQ-3气体传感器所使用的气敏材料是在清洁空气中电导率较低的二氧化锡(Sn0)。当传感器所处环境中存在酒精蒸气时，传感器的电导率随空气中酒精蒸气浓度的增加而增大。使用简单的电路即可将电导率的变化转换为与该气体浓度相对应的输出信号。
一、模块来源
二、规格参数
工作电压：3.3V ~ 5V
工作电流：150MA
输出方式: DO接口为数字量输出 AO接口为模拟量输出
读取方式：ADC
管脚数量：4 Pin（2.54mm间距排针）
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至开发板上【能够判断当前环境状况的功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。
1、查看资料
MQ-3气体传感器对酒精的灵敏度高，可以抵抗汽油、烟雾、水蒸气的干扰。这种传感器可检测多种浓度酒精气氛,是一款适合多种应用的低成本传感器。
其对应的原理图，AO输出为MQ传感器直接输出的电压，所以为模拟量；DO为经过LM393进行电压比较后，输出高低电平，所以为数字量。
因此DO引脚可以配置为GPIO的输入模式，AO引脚需要配置为ADC模拟输入模式。
2、引脚选择
当前只有AO引脚需要使用到ADC接口，所以DO引脚可以使用开发板上其他的GPIO。
3、移植至工程
移植步骤中的导入.c和.h文件与传感器章节的【DHT11温湿度传感器】相同，只是将.c和.h文件更改为bsp_mq3.c与bsp_mq3.h。这里不再过多讲述，移植完成后面修改相关代码。
在文件bsp_mq3.c中，编写如下代码。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*
Change Logs:
* Date Author Notes
* 2024-03-20 LCKFB-LP first version
*/
#include "bsp_mq3.h"
#include "board.h"
/******************************************************************
* 函 数 名 称：ADC_MQ3_Init
* 函 数 说 明：初始化ADC功能
* 函 数 形 参：无
* 函 数 返 回：无
* 作 者：LC
* 备 注：无
******************************************************************/
void ADC_MQ3_Init(void)
{
RCC_AHB1PeriphClockCmd (RCC_MQ3_GPIO_AO, ENABLE); // 使能时钟
RCC_AHB1PeriphClockCmd (RCC_MQ3_GPIO_DO, ENABLE); // 使能时钟
RCC_APB2PeriphClockCmd (RCC_MQ3_ADC, ENABLE); // 使能ADC时钟
GPIO_InitTypeDef GPIO_InitStructure; // GPIO配置结构体
GPIO_InitStructure.GPIO_Pin = GPIO_MQ3_AO;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AN; //模拟输入
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_Init(PORT_MQ3_AO, &GPIO_InitStructure); // 初始化GPIO
GPIO_InitStructure.GPIO_Pin = GPIO_MQ3_DO;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN; //输入
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_Init(PORT_MQ3_DO, &GPIO_InitStructure); // 初始化GPIO
/* ADC公共配置 */
ADC_CommonInitTypeDef ADC_CommonInitStruct; // ADC公共配置结构体
ADC_DeInit();//ADC复位
ADC_CommonInitStruct.ADC_DMAAccessMode=ADC_DMAAccessMode_Disabled;
ADC_CommonInitStruct.ADC_Mode=ADC_Mode_Independent;
ADC_CommonInitStruct.ADC_Prescaler=ADC_Prescaler_Div4;
ADC_CommonInitStruct.ADC_TwoSamplingDelay=ADC_TwoSamplingDelay_5Cycles;
ADC_CommonInit(&ADC_CommonInitStruct);
/* ADC特定配置 */
ADC_InitTypeDef ADC_InitStruct; // ADC特定配置结构体
ADC_InitStruct.ADC_ContinuousConvMode = DISABLE;
ADC_InitStruct.ADC_DataAlign=ADC_DataAlign_Right;
ADC_InitStruct.ADC_ExternalTrigConvEdge=ADC_ExternalTrigConvEdge_None;
ADC_InitStruct.ADC_NbrOfConversion=1;
ADC_InitStruct.ADC_Resolution=ADC_Resolution_12b;
ADC_InitStruct.ADC_ScanConvMode = DISABLE;
ADC_Init(PORT_ADC, &ADC_InitStruct);
//设置采集通道
ADC_RegularChannelConfig( PORT_ADC, CHANNEL_ADC, 1, ADC_SampleTime_480Cycles );
//ADC使能
ADC_Cmd(PORT_ADC, ENABLE);
}
/******************************************************************
* 函 数 名 称：Get_Adc_MQ3_Value
* 函 数 说 明：
* 函 数 形 参：
* 函 数 返 回：对应扫描的ADC值
* 作 者：LC
* 备 注：无
******************************************************************/
unsigned int Get_Adc_MQ3_Value(void)
{
uint32_t Data = 0;
//开始软件转换
ADC_SoftwareStartConv(PORT_ADC);
while(!ADC_GetFlagStatus(PORT_ADC, ADC_FLAG_EOC )); // 等待转换结束
for(int i = 0; i < SAMPLES; i++)
{
Data += ADC_GetConversionValue(PORT_ADC);
delay_ms(5);
}
Data = Data / SAMPLES;
return Data;
}
/******************************************************************
* 函 数 名 称：Get_MQ3_Percentage_value
* 函 数 说 明：读取MQ3值，并且返回百分比
* 函 数 形 参：无
* 函 数 返 回：返回百分比
* 作 者：LC
* 备 注：无
******************************************************************/
unsigned int Get_MQ3_Percentage_value(void)
{
int adc_max = 4095;
int adc_new = 0;
int Percentage_value = 0;
adc_new = Get_Adc_MQ3_Value();
Percentage_value = ((float)adc_new / (float)adc_max) * 100.f;
return Percentage_value;
}
/******************************************************************
* 函 数 名 称：Get_MQ3_DO_value
* 函 数 说 明：获取MQ3DO引脚的电平状态
* 函 数 形 参：无
* 函 数 返 回：0=未检测到高于灵敏度的酒精值 1=检测到高于灵敏度的酒精值
* 作 者：LC
* 备 注：调整模块上的滑动电阻即可调整灵敏度
******************************************************************/
char Get_MQ3_DO_value(void)
{
if( GPIO_ReadInputDataBit(PORT_MQ3_DO, GPIO_MQ3_DO) == RESET )
{
return 0;
}
else
{
return 1;
}
}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
138
139
140
141
142
143
144
145
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
138
139
140
141
142
143
144
145
在文件bsp_mq3.h中，编写如下代码。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*
Change Logs:
* Date Author Notes
* 2024-03-20 LCKFB-LP first version
*/
#ifndef _BSP_MQ3_H_
#define _BSP_MQ3_H_
#include "stm32f4xx.h"
#define RCC_MQ3_GPIO_AO RCC_AHB1Periph_GPIOC
#define RCC_MQ3_GPIO_DO RCC_AHB1Periph_GPIOA
#define RCC_MQ3_ADC RCC_APB2Periph_ADC1
#define PORT_ADC ADC1
#define CHANNEL_ADC ADC_Channel_11
#define PORT_MQ3_AO GPIOC
#define GPIO_MQ3_AO GPIO_Pin_1
#define PORT_MQ3_DO GPIOA
#define GPIO_MQ3_DO GPIO_Pin_1
//采样次数
#define SAMPLES 30
void ADC_MQ3_Init(void);
unsigned int Get_Adc_MQ3_Value(void);
unsigned int Get_MQ3_Percentage_value(void);
char Get_MQ3_DO_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
32
33
34
35
36
37
38
39
40
41
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
四、移植验证
在自己工程中的main主函数中，编写如下。
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
*
Change Logs:
* Date Author Notes
* 2024-03-20 LCKFB-LP first version
*/
#include "board.h"
#include "bsp_uart.h"
#include <stdio.h>
#include "bsp_mq3.h"
int main(void)
{
board_init();
uart1_init(115200U);
ADC_MQ3_Init();
printf("ADC Demo Start...\r\n");
while(1)
{
printf("酒精含量 = %d%%\r\n\n", Get_MQ3_Percentage_value() );
delay_ms(1000);
}
}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
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
上电效果：
移植成功案例代码下载链接：