ADC采样
本示例将演示如何在BearPi-HM_Nano开发板上通过按下按键改变GPIO口的电压，并使用ADC读取GPIO的电压值。
一、准备工作
参考BearPi-HM_Nano十分钟上手教程完成开发环境搭建、代码获取等工作，以及熟悉代码的编译和烧录流程。
二、硬件设计
本案例将使用板载用户按键F1来模拟GPIO口电压的变化。通过查看芯片手册可知GPIO_11对应的是 ADC Channel 5 ,所以需要编写软件去读取ADC Channel 5的电压,程序设计时先将GPIO_11上拉，使GPIO_11的电压一直处于高电平，当按键按下时GPIO_11接地，此时GPIO_11的电压变为 0 V。
三、软件设计
主要代码分析
打开applications\BearPi\BearPi-HM_Nano\sample\B4_basic_adc\adc_example.c，该函数通过使用AdcRead()函数来读取 ADC_CHANNEL_5 的数值存储在data中， WIFI_IOT_ADC_EQU_MODEL_8 表示8次平均算法模式，WIFI_IOT_ADC_CUR_BAIS_DEFAULT 表示默认的自动识别模式，最后通过 data * 1.8 * 4 / 4096.0 计算出实际的电压值。
static float GetVoltage(void)
{
unsigned int ret;
unsigned short data;
ret = AdcRead(WIFI_IOT_ADC_CHANNEL_5, &data, WIFI_IOT_ADC_EQU_MODEL_8, WIFI_IOT_ADC_CUR_BAIS_DEFAULT, 0xff);
if (ret != WIFI_IOT_SUCCESS)
{
printf("ADC Read Fail\n");
}
return (float)data * 1.8 * 4 / 4096.0; /* data * 1.8 * 4 / 4096.0: Convert code into voltage */
}
ADC API分析
本案例主要使用了以下API完成ADC采样的功能。
AdcRead()
unsigned int AdcRead (WifiIotAdcChannelIndex channel, unsigned short * data, WifiIotAdcEquModelSel equModel, WifiIotAdcCurBais curBais, unsigned short rstCnt )
描述：
根据输入参数从指定的ADC通道读取一段采样数据。
参数：
| 名字 | 描述 |
|---|---|
| channel | 表示ADC通道. |
| data | 表示指向存储读取数据的地址的指针 |
| equModel | 表示平均算法的次数 |
| curBais | 表示模拟功率控制模式 |
| rstCnt | 指示从重置到转换开始的时间计数。一次计数等于334纳秒。值的范围必须从0到0xFF |
四、编译调试
修改 BUILD.gn 文件
修改applications\BearPi\BearPi-HM_Nano\sample 路径下 BUILD.gn 文件，指定 adc_example 参与编译。
#"B1_basic_led_blink:led_example",
#"B2_basic_button:button_example",
#"B3_basic_pwm_led:pwm_example",
"B4_basic_adc:adc_example",
#"B5_basic_i2c_nfc:i2c_example",
#"B6_basic_uart:uart_example",
运行结果
示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志，当F1按键未按下时采集到的电压为3.3V左右，当按键按下时，电压变为0.2V左右。
=======================================
*************ADC_example***********
=======================================
vlt:3.371V
=======================================
*************ADC_example***********
=======================================
vlt:3.371V
=======================================
*************ADC_example***********
=======================================
vlt:3.373V
=======================================
*************ADC_example***********
=======================================
vlt:0.248V
=======================================
*************ADC_example***********
=======================================
vlt:0.244V
