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