README.md
1# BearPi-HM_Nano开发板传感器驱动开发——MQ2读取烟雾浓度
2本示例将演示如何在BearPi-HM_Nano开发板上使用E53_SF1读取烟雾浓度，当烟雾浓度超标时蜂鸣器发出警报，设备安装如下图所示。
3
4
5## E53_SF1 API分析
6本案例主要使用了以下API完成烟雾浓度读取。
7### E53SF1Init()
8```C
9void E53SF1Init(void)
10```
11 **描述：**
12
13初始化E53_SF1。
14
15### MQ2PPMCalibration()
16```C
17void MQ2PPMCalibration(void)
18```
19 **描述：**
20
21MQ2传感器校准。
22### GetMQ2PPM()
23```C
24float GetMQ2PPM(void)
25```
26 **描述：**
27
28获取烟雾浓度ppm。
29
30
31## 硬件设计
32本案例将用到 E53_SF1 智慧烟感扩展板与 BearPi-HM_Nano 开发板，其中E53_SF1扩展板原理图如下，ADC输出引脚为第五脚，将E53_SF1扩展板插在 BearPi-HM_Nano 开发板上后，该ADC输出引脚与GPIO_13相连接，通过查看芯片手册可知GPIO_13对应的是 ADC Channel 6 ,所以需要编写软件去读取ADC Channel 6的电压实现对烟雾浓度的读取。
33
34
35
36
37
38E53_SF1 智慧烟感扩展板与 BearPi-HM_Nano 开发板安装如下图所示。
39
40
41
42## 软件设计
43
44**主要代码分析**
45
46
47首先调用 `E53SF1Init()` 函数初始化E53_SF1所接的引脚的功能，再等待1s后进行校准，获取正常环境下传感器的参数，然后循环调用 `GetMQ2PPM()` 函数读取ppm值并通过串口打印出来，当ppm大于100时触发蜂鸣器报警，小于100时关闭报警。
48
49```C
50static void ExampleTask(void)
51{
52 int ret;
53 float ppm;
54
55 E53SF1Init();
56 //Sensor calibration
57 usleep(TASK_DELAY_US);
58 MQ2PPMCalibration();
59
60 while (1) {
61 printf("=======================================\r\n");
62 printf("*************E53_SF1_example***********\r\n");
63 printf("=======================================\r\n");
64 //get mq2 ppm
65 ret = GetMQ2PPM(&ppm);
66 if (ret != 0) {
67 printf("ADC Read Fail\n");
68 return;
69 }
70 printf("ppm:%.3f \n", ppm);
71 if (ppm > MAX_PPM) {
72 BeepStatusSet(ON);
73 } else {
74 BeepStatusSet(OFF);
75 }
76 usleep(TASK_DELAY_1S);
77 }
78}
79```
80
81
82
83## 编译调试
84
85### 修改 BUILD.gn 文件
86修改`device\bearpi\bearpi_hm_nano\app`路径下 BUILD.gn 文件，指定 `e53_sf1_example` 参与编译。
87```r
88"C1_e53_sf1_mq2:e53_sf1_example",
89#"C2_e53_ia1_temp_humi_pls:e53_ia1_example",
90#"C3_e53_sc1_pls:e53_sc1_example",
91#"C4_e53_sc2_axis:e53_sc2_example",
92#"C5_e53_is1_infrared:e53_is1_example",
93```
94
95
96
97
98### 运行结果
99
100示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志，会打印以下信息，对着烟雾探头制作烟雾，ppm会升高蜂鸣器发出报警。
101```c
102=======================================
103*************E53_SF1_example***********
104=======================================
105ppm:19.094
106=======================================
107*************E53_SF1_example***********
108=======================================
109ppm:18.797
110```
111
112