[FFH]標準系統HDF平臺驅動(三)——ADC應用實現

作者：FFH杞人 2023-03-24 14:47:24

系統 OpenHarmony

結合之前學的一些知識，設計一個基于NAPI框架和HDF框架讀取溫度傳感器數據的程序應用。

??想了解更多關于開源的內容，請訪問：??

??51CTO 開源基礎軟件社區??

??https://ost.51cto.com??

前言

前面兩篇文章已經實現了ADC的HDF框架接入，現在已經可以正常調用HDF提供的ADC統一驅動接口進行應用開發。結合之前學的一些知識，設計一個基于NAPI框架和HDF框架讀取溫度傳感器數據的程序應用。

#創作者激勵# [FFH]標準系統HDF平臺驅動(三)——ADC應用實現-開源基礎軟件社區

參考

??平臺驅動使用??標準系統HDF平臺驅動(一)——ADC驅動適配
 標準系統HDF平臺驅動(二)——ADC平臺驅動使用

環境

OpenHarmony-3.2-Beta5
九聯UnionPi-Tiger開發板
Visual Studio Code（版本需1.62.0及以上）
USB_Burning_Tool燒錄工具
napi_generator工具可執行文件或vs code插件
Deveco Studio（API 9 ）
LM35線性模擬溫度傳感器

概述

開發步驟

一、編譯構建實現

添加子系統。

"napisubsys":{
    "path":"vendor/unionman/unionpi_tiger/sample/napi/napisubsys",
    "name":"napisubsys"
  }

添加組件，打開unionpi_tiger/sample/napi/napisubsys/ohos.build文件，在"parts":中添加下列語句。

"adc_hdf": {
            "variants": [
                "phone"
            ],
            "module_list": [
                "http://vendor/unionman/unionpi_tiger/sample/napi/napisubsys/adc_hdf:adc_hdf"
            ]
        }

添加產品定義，打開vendor/unionman/unionpi_tiger/config.json文件，在"subsystems":中添加下列語句。

{
      "subsystem": "napisubsys",
      "components": [
        {
          "component": "adc_hdf",
          "features": []
        }
      ]
    },

二、NAPI接口設計及NAPI框架生成

編寫ts文件，新建文件@ohos.adc_hdf.d.ts于vendor/unionman/unionpi_tiger/sample/napi/napisubsys/adc_hdf目錄下,聲明應用接口函數get_adc_value，傳入參數為通道號，返回值為ADC采樣值，北向應用通過調用該接口獲取的ADC采樣值計算溫度。

declare namespace adc_hdf {
    function get_adc_value(channel: number): number;
}

export default adc_hdf;

生成NAPI框架，使用napi_generator可執行程序或者vscode插件生成NAPI框架。

生成框架路徑也選擇當前路徑，number類型選擇uint32_t。

三、NAPI接口實現

實現adc_hdf.cpp接口，文件生成結束后，我們定義的北向應用接口需要在adc_hdf.cpp中實現，具體代碼如下：

#include "adc_hdf.h"
#include "adc_if.h"
#include "hdf_log.h"
#include <cstdio>

namespace adc_hdf {
bool get_adc_value(NUMBER_TYPE_1& channel, NUMBER_TYPE_2& out)
{
    int32_t ret;
    DevHandle adcHandle = NULL;
    uint32_t read_val = 0;

    /* 打開ADC設備 */ 
    adcHandle = AdcOpen(ADC_DEVICE_NUM);
    if (adcHandle == NULL) {
        printf("%s: Open ADC%u fail!", __func__, ADC_DEVICE_NUM);
        return false;
    }
    /* 讀取ADC采樣值 */ 
    ret = AdcRead(adcHandle, (uint32_t)channel, &read_val);
    if (ret != HDF_SUCCESS) {
        printf("%s: ADC read fail!:%d", __func__, ret);
        AdcClose(adcHandle);
        return false;
    }
    /* 結果返回值 */ 
    out = (NUMBER_TYPE_2)read_val;
    printf("ADC read:%d\r\n",read_val);
    /* 訪問完畢關閉ADC設備 */ 
    AdcClose(adcHandle);
    return true;
}
}

修改BUILD.gn文件，主要添加了ADC平臺驅動所需依賴及頭文件路徑，并且修改目標子系統及所屬部件，編譯后會生成相應的.so共享庫文件，存放在/system/lib/module目錄下。

import("http://build/ohos.gni")

ohos_shared_library("adc_hdf")
{
    sources = [
        "adc_hdf_middle.cpp",
        "adc_hdf.cpp",
        "tool_utility.cpp",
    ]
    include_dirs = [
        ".",
        "http://third_party/node/src",
        "http://drivers/hdf_core/framework/include/platform"
    ]
    deps=[
        "http://foundation/arkui/napi:ace_napi",
        "http://drivers/hdf_core/adapter/uhdf2/platform:libhdf_platform"
    ]
    external_deps = [
    "hdf_core:libhdf_utils",
    "hiviewdfx_hilog_native:libhilog",
    ]

    remove_configs = [ "http://build/config/compiler:no_rtti" ]
    cflags=[
    ]
    cflags_cc=[
        "-frtti",
    ]
    ldflags = [
    ]
    
    relative_install_dir = "module"
    part_name = "adc_hdf"
    subsystem_name = "napisubsys"
}

四、編譯打包燒錄

進入源碼根目錄，執行如下命令進行編譯：

./build.sh --product-name unionpi_tiger

編譯完成后需要打包成可以給開發板燒錄的鏡像，執行一下命令：

./device/board/unionman/unionpi_tiger/common/tools/packer-unionpi.sh

固件打包完成，生成路徑為編譯根目錄下的out/unionpi_tiger/packages/phone/images/OpenHarmony.img,下載或映射到Windows上進行燒錄。

打開燒錄工具，連接PC與開發板OTG口并接通電源，導入燒錄包進行燒錄。

#創作者激勵# [FFH]標準系統HDF平臺驅動(三)——ADC應用實現-開源基礎軟件社區

或者使用hdc_std工具：

hdc_std shell mount -o remount,rw /
hdc_std file send libadc_hdf.z.so /system/lib/module/

五、NAPI應用實現

新建OpenHarmony工程(stage+ArkTs)。

導入外部接口，adc_hdf為上述定義NAPI接口生成的動態庫文件名字一致，直接導入會報找不到包，忽略即可，prompt為彈窗組件接口。

// @ts-ignore
import adc_hdf from '@ohos.adc_hdf';
import prompt from '@system.prompt'

ADC通道選擇組件（使用Swiper滑塊視圖容器實現）。新建滑塊視圖數據類。

class MyDataSource implements IDataSource {
  private list: string[] = []
  private listener: DataChangeListener

  constructor(list: string[]) {
    this.list = list
  }

  totalCount(): number {
    return this.list.length
  }

  getData(index: number): any {
    return this.list[index]
  }

  registerDataChangeListener(listener: DataChangeListener): void {
    this.listener = listener
  }

  unregisterDataChangeListener() {
  }
}

Swiper滑塊視圖容器組件，滑動或點擊可以切換ADC通道，點擊select進行數據采集。

//通道選擇組件實現
@Component
struct channel_chose {
  private swiperController: SwiperController = new SwiperController()
  private data: MyDataSource = new MyDataSource([])
  private channelNum: number = 2
  private tmp: number = 1
  @Link channel: number
//導入輪播內容
  aboutToAppear(): void {
    let list = []
    for (var i = 1; i <= this.channelNum; i++) {
      list.push('ADC_' + i.toString());
    }
    this.data = new MyDataSource(list)
  }

  build() {
    Column({ space: 5 }) {
      Swiper(this.swiperController) {
        LazyForEach(this.data, (item: string) => {
          Text(item)
            .borderRadius(10)
            .width('80%')
            .height(70)
            .fontColor('#ff1a5ea4')
            .fontWeight(FontWeight.Bolder)
            .textAlign(TextAlign.Center)
            .fontSize(30)
        }, item => item)
      }
      .cachedCount(2)
      .interval(4000)
      .indicator(false)
      .duration(1000)
      .itemSpace(10)
      .vertical(true)
      .curve(Curve.Linear)
      .onChange((index: number) => {
        this.tmp = index + 1
      })

      Row({ space: 12 }) {
        Button('Change').backgroundColor('#ff366fb1').fontSize(20).height(50).width(120)
          .onClick(() => {
            this.swiperController.showNext()
          })
        Button('Select').backgroundColor('#ff366fb1').fontSize(20).height(50).width(120)
          .onClick(() => {
            this.channel = this.tmp;
            prompt.showToast({ message: 'Select data From ADC_'+this.channel.toString() })
            console.info('Select data From Channel_'+this.channel.toString())
          })
      }.margin(20)
    }.width('50%')
  }
}

文本組件顯示溫度值。

@Component
struct show_temperature{
  @Link temperature: Number
  build(){
    Text(this.temperature.toFixed(1)+'°C')
      .width('50%')
      .fontSize(60)
      .fontColor(Color.White)
      .fontStyle(FontStyle.Italic)
      .textAlign(TextAlign.Center)
      .fontWeight(FontWeight.Bold)
  }
}

溫度計算及首頁內容組件，程序啟動時開啟定時器，每隔1s獲取一次ADC溫度值。

@Entry
@Component
struct Index {
  @State channel: number = 1
  @State adc_val: number = 0
  @State temperature: number = 0
  private  timerId: number = -1

  //獲取溫度傳感器ADC采樣值并計算溫度
  private get_adc_value() {
    let get_value = adc_hdf.get_adc_value(this.channel-1);
    if (get_value <= 1500) {
      this.adc_val = get_value;
      this.temperature = (this.adc_val / 4096) * 1.8 * 100;
    }
    else {
      this.temperature = 0
      prompt.showToast({
        message: "獲取失敗，請檢查連線", // 顯示文本
        duration: 1000, // 顯示時長
      })
    }
  }

  //程序運行時開啟定時器Interval，每隔一秒調用get_adc_value更新溫度值
  aboutToAppear(): void {
    this.timerId = setInterval(() => {
      this.get_adc_value()
    }, 1000)
  }
  //銷毀定時器
  aboutToDisappear() {
    if (this.timerId > 0) {
      clearTimeout(this.timerId)
      this.timerId = -1
    }
  }

  build() {
    Row() {
      show_temperature({temperature: $temperature})
      Column({space:0}){
        channel_chose({channel:$channel})
      }.height('80%')
    }.height('100%')
    .backgroundImage($r('app.media.bg')).backgroundImageSize(ImageSize.Cover)
  }
}

應用簽名。

安裝應用到開發板。

結果演示

https://ost.51cto.com/show/22186

文章相關附件可以點擊下面的原文鏈接前往下載：

https://ost.51cto.com/resource/2661