README.md
1# BearPi-HM_Nano开发板传感器驱动开发——E53_IS1人体红外感应
2本示例将演示如何在BearPi-HM_Nano开发板上使用E53_IS1实现人体红外感应，当检测到有人走动时，蜂鸣器发出报警，设备安装如下图所示。
3
4
5
6## E53_IS1 API分析
7本案例主要使用了以下API完成人体红外感应。
8
9### E53IS1Init()
10```C
11void E53IS1Init(void);
12```
13 **描述：**
14
15初始化E53_IS1。
16
17### E53IS1ReadData()
18```C
19void E53IS1ReadData(E53IS1CallbackFunc func);
20```
21 **描述：**
22
23设置人体感应触发的回调函数。
24
25
26
27
28## 硬件设计
29本案例将用到 E53_IS1 红外感应扩展板与 BearPi-HM_Nano 开发板，其中E53_IS1扩展板原理图如下，当检测到人时，传感器会输出高电平，通过对GPIO_7的监测就能判断是否有人走动。
30
31
32
33
34
35E53_IS1 红外感应扩展板与 BearPi-HM_Nano 开发板安装如下图所示
36
37
38## 软件设计
39
40**主要代码分析**
41
42
43首先调用 `E53IS1Init()` 函数初始化E53_SC1所接的引脚的功能，然后调用 `E53IS1ReadData()` 设置回调函数`BeepAlarm()`，系统启动后会通过osEventFlagsWait()函数让ExampleTask任务一直等待事件标志位`FLAGS_MSK1`。当检测到人后，回调函数`BeepAlarm()`会设置事件标志位`FLAGS_MSK1`，ExampleTask任务检测到事件标志位`FLAGS_MSK1`后继续运行开启蜂鸣器报警3秒钟 然后关闭蜂鸣器继续等待下一次触发事件。
44```C
45static void BeepAlarm(char *arg)
46{
47 (void)arg;
48 osEventFlagsSet(g_eventFlagsId, FLAGS_MSK1);
49}
50
51static void ExampleTask(void)
52{
53 int ret;
54 E53IS1Init();
55 ret = E53IS1ReadData(BeepAlarm);
56 if (ret != 0) {
57 printf("E53_IS1 Read Data failed!\r\n");
58 return;
59 }
60 while (1) {
61 osEventFlagsWait(g_eventFlagsId, FLAGS_MSK1, osFlagsWaitAny, osWaitForever);
62 BeepStatusSet(ON);
63 osDelay(TASK_DELAY_3S);
64 BeepStatusSet(OFF);
65 }
66}
67```
68
69
70## 编译调试
71
72### 修改 BUILD.gn 文件
73修改`device\board\bearpi\bearpi_hm_nano\app`路径下 BUILD.gn 文件，指定 `e53_is1_example` 参与编译。
74```r
75#"C1_e53_sf1_mq2:e53_sf1_example",
76#"C2_e53_ia1_temp_humi_pls:e53_ia1_example",
77#"C3_e53_sc1_pls:e53_sc1_example",
78#"C4_e53_sc2_axis:e53_sc2_example",
79"C5_e53_is1_infrared:e53_is1_example",
80```
81
82
83### 运行结果
84
85示例代码编译烧录后，按下开发板的RESET按键，人员靠近开发板，蜂鸣器开始报警并持续3秒。
86
87
88
