README.md
1# BearPi-HM_Nano开发板基础外设开发——ADC采样
2本示例将演示如何在BearPi-HM_Nano开发板上通过按下按键改变GPIO口的电压，并使用ADC读取GPIO的电压值。
3
4## ADC API分析
5本案例主要使用了以下API完成ADC采样的功能。
6### IoTAdcRead()
7```c
8unsigned int IoTAdcRead(unsigned int channel, unsigned short *data, IotAdcEquModelSel equModel, IotAdcCurBais curBais, unsigned short rstCnt);
9```
10 **描述：**
11
12根据输入参数从指定的ADC通道读取一段采样数据。
13
14
15**参数：**
16
17|参数名|描述|
18|:--|:------|
19| channel | 表示ADC通道。 |
20| data | 表示读取的ADC数据保存地址。 |
21| equModel | 表示平均算法模式。 |
22| curBais | 表示模拟电源控制。 |
23| rstCnt | 表示从配置采样到启动采样的延时时间计数，一次计数是334ns，其值需在0~0xFF0之间。|
24
25
26## 硬件设计
27本案例将使用板载用户按键F1来模拟GPIO口电压的变化。通过查看芯片手册可知GPIO_11对应的是 ADC Channel 5，所以需要编写软件去读取ADC Channel 5的电压，程序设计时先将GPIO_11上拉，使GPIO_11的电压一直处于高电平，当按键按下时GPIO_11接地，此时GPIO_11的电压变为 0 V。
28
29
30
31## 软件设计
32
33**主要代码分析**
34
35 ADC测试任务，主要的功能实现函数为GetVoltage()，
36该函数通过使用IoTAdcRead()函数来读取 ADC Channel 5 的数值并存储在data中， `IOT_ADC_EQU_MODEL_8` 表示8次平均算法模式，`IOT_ADC_CUR_BAIS_DEFAULT` 表示默认使用自动识别模式，最后通过算式 `data * 1.8 * 4 / 4096.0` 计算出实际的电压值。
37```c
38/**
39 * @brief get ADC sampling value and convert it to voltage
40 *
41 */
42static float GetVoltage(void)
43{
44 unsigned int ret;
45 unsigned short data;
46
47 ret = IoTAdcRead(ADC_CHANNEL, &data, IOT_ADC_EQU_MODEL_8, IOT_ADC_CUR_BAIS_DEFAULT, 0xff);
48 if (ret != IOT_SUCCESS) {
49 printf("ADC Read Fail\n");
50 }
51
52 return (float)data * ADC_VREF_VOL * ADC_COEFFICIENT / ADC_RATIO;
53}
54```
55
56
57## 编译调试
58
59### 修改 BUILD.gn 文件
60
61
62修改`device\board\bearpi\bearpi_hm_nano\app` 路径下 BUILD.gn 文件，指定 `adc_example` 参与编译。
63
64```r
65#"B1_basic_led_blink:led_example",
66#"B2_basic_button:button_example",
67# "B3_basic_pwm_led:pwm_example",
68"B4_basic_adc:adc_example",
69#"B5_basic_i2c_nfc:i2c_example",
70# "B6_basic_uart:uart_example",
71```
72
73
74### 运行结果
75
76示例代码编译烧录后，按下开发板的RESET按键，通过串口助手查看日志，当F1按键未按下时采集到的电压为3.3V左右，当按键按下时，电压变为0.2V左右。
77```c
78=======================================
79*************ADC_example***********
80=======================================
81vlt:3.371V
82=======================================
83*************ADC_example***********
84=======================================
85vlt:3.371V
86=======================================
87*************ADC_example***********
88=======================================
89vlt:3.373V
90=======================================
91*************ADC_example***********
92=======================================
93vlt:0.248V
94=======================================
95*************ADC_example***********
96=======================================
97vlt:0.244V
98```
99
