1、案例簡介

本案例主要講解如何在小凌派-RK2206開發板上使用IoT庫的ADC接口，進行ADC編程開發。

例程內容為創建一個任務，讀取按鍵的ADC值，并打印到串口。

例程源代碼：https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk2206-openharmony3.0lts/tree/master/vendor/lockzhiner/rk2206/samples/b17_iot_adc

2、基礎知識

ADC在日常設備中非常常見，以下我們將演示IoT庫的ADC接口如何進行讀取按鍵的ADC值，并打印到串口。

2.1、頭文件

base/iot_hardware/peripheral/interfaces/kits/iot_adc.h

2.2、初始化ADC設備：IoTAdcInit

unsignedintIoTAdcInit(unsignedintid);

描述：

初始化ADC設備。

參數：

ADC通道有7個，對應以下7個引腳：

返回值：

實現：

hal_iot_adc.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目錄下。

unsignedintIoTAdcInit(unsignedintid) {

unsignedintret=0;
uint32_t*pGrfSocCon29=(uint32_t*)(0x41050000U+0x274U);
uint32_tulValue;

if(id<0||id>7) {
PRINT_ERR("id(%d) > 7 or id(%d) < 0\n",id,id);
returnIOT_FAILURE;
}

m_adcKey.ctrl1.gpio=GPIO0_PC0+id;

ret=DevIoInit(m_adcKey);
if(ret!=LZ_HARDWARE_SUCCESS) {
PRINT_ERR("%s, %s, %d: ADC Key IO Init fail\n",__FILE__,__func__,
__LINE__);
returnIOT_FAILURE;
}

/* LzSaradcInit 接口只要初始化一次 */
if(!init_adc_cnt) {
ret=LzSaradcInit();
if(ret!=LZ_HARDWARE_SUCCESS) {
PRINT_ERR("%s, %s, %d: ADC Init fail\n",__FILE__,__func__,__LINE__);
returnIOT_FAILURE;
}
}

/* 記錄調用該接口次數 */
init_adc_cnt++;

/* 設置saradc的電壓信號，選擇AVDD */
ulValue=*pGrfSocCon29;
ulValue&=~(0x1<<4);
ulValue|=((0x1<<4)<<16);
*pGrfSocCon29=ulValue;

returnIOT_SUCCESS;
}

2.3、取消初始化ADC設備：IoTAdcDeinit

unsignedintIoTAdcDeinit(unsignedintid);

描述：

取消初始化ADC設備。

ADC通道有7個，對應以下7個引腳：

返回值：

實現：

hal_iot_adc.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目錄下。

unsignedintIoTAdcDeinit(unsignedintid) {

unsignedintret=0;

if(id<0||id>7) {
PRINT_ERR("id(%d) > 7 or id(%d) < 0\n",id,id);
returnIOT_FAILURE;
}

m_adcKey.ctrl1.gpio=GPIO0_PC0+id;

LzGpioDeinit(m_adcKey.ctrl1.gpio);
init_adc_cnt--;

/* 當 init_adc_cnt 為 0 調用 LzSaradcDeinit 注銷 */
if(!init_adc_cnt) {
ret=LzSaradcDeinit();
if(ret!=LZ_HARDWARE_SUCCESS) {
PRINT_ERR("%s, %s, %d: ADC Deinit Fail\n",__FILE__,__func__,__LINE__);
returnIOT_FAILURE;
}
}

returnIOT_SUCCESS;
}

2.4、獲取ADC設備的值：IoTAdcGetVal

unsignedintIoTAdcGetVal(unsignedintid,unsignedint*val);

描述：

獲取ADC設備的值。

參數：

ADC通道有7個，對應以下7個引腳：

返回值：

實現：

hal_iot_adc.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目錄下。

unsignedintIoTAdcGetVal(unsignedintid,unsignedint*val) {

unsignedintret=0;

if(id<0||id>7) {
PRINT_ERR("id(%d) > 7 or id(%d) < 0\n",id,id);
returnIOT_FAILURE;
}

ret=LzSaradcReadValue(id,val);

if(ret!=LZ_HARDWARE_SUCCESS) {
PRINT_ERR("%s, %s, %d: ADC Read Fail\n",__FILE__,__func__,__LINE__);
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

3、程序設計

主要代碼分析

在adc_example函數中，創建一個任務。

voidadc_example()
{
unsignedintthread_id;
TSK_INIT_PARAM_Stask={0};
unsignedintret =LOS_OK;

task.pfnTaskEntry=(TSK_ENTRY_FUNC)adc_thread;
task.uwStackSize =2048;
task.pcName ="adc_thread";
task.usTaskPrio =24;
ret =LOS_TaskCreate(&thread_id,&task);
if(ret!=LOS_OK) {
printf("Falied to create adc_thread ret:0x%x\n",ret);
return;
}
}

adc_thread任務中調用IOT庫的ADC接口控制ADC。

voidadc_thread()
{
unsignedintdata=0;
floatvoltage =0;
unsignedintret =0;

/* 初始化adc設備 */
ret=IoTAdcInit(ADC_CHANNEL);
if(ret==IOT_FAILURE) {
printf("%s, %s, %d: ADC Key IO Init fail\n",__FILE__,__func__,__LINE__);
}

while(1) {
printf("***************Adc Example*************\r\n");
/*獲取電壓值*/
ret=IoTAdcGetVal(ADC_CHANNEL,&data);
if(ret==IOT_FAILURE) {
printf("%s, %s, %d: ADC Read Fail\n",__FILE__,__func__,__LINE__);
return0.0;
}
voltage=(float)(data*3.3/1024.0);
printf("vlt:%.3fV\n",voltage);

/* 睡眠1秒 */
LOS_Msleep(1000);
}
}

ADC模塊采用10位的ADC采集寄存器，可測試電壓范圍為0~3.3V，所以ADC采集數值換算為實際電壓計算公司為：

實際電壓=(ADC采集數值/1024)*3.3V

注意：實際電壓是float類型，源代碼計算要規范。具體源代碼如下所示：

return(float)(data*3.3/1024.0)

4、編譯調試

修改vendor/lockzhiner/rk2206/sample路徑下 BUILD.gn 文件，指定iot_adc_example參與編譯。

"./b17_iot_adc:iot_adc_example",

修改device/lockzhiner/rk2206/sdk_liteos路徑下 Makefile 文件，添加-liot_adc_example參與編譯。

hardware_LIBS=-lhal_iothardware-lhardware-lshellcmd-liot_adc_example

5、運行結果

示例代碼編譯燒錄代碼后，按下開發板的RESET按鍵，通過串口助手查看日志，顯示如下：

***************AdcExample*************
vlt:3.297V
***************AdcExample*************
vlt:3.297V
***************AdcExample*************
vlt:3.297V
***************AdcExample*************
vlt:3.297V
***************AdcExample*************
vlt:3.297V
***************AdcExample*************
vlt:3.297V