一、簡(jiǎn)介

智能金屬探測(cè)器是基于 OpenAtom OpenHarmony（以下簡(jiǎn)稱“OpenHarmony”）操作系統(tǒng)，利用電磁感應(yīng)原理來探測(cè)周圍的金屬物體。該樣例采用多設(shè)備協(xié)同的方式，兼容 OpenHarmony 設(shè)備開發(fā)與應(yīng)用開發(fā)，整個(gè)樣例體現(xiàn)了 OpenHarmony 的 NAPI、eTS UI、UI 管理狀態(tài) @state 和音頻播放等技術(shù)特性。

本項(xiàng)目由 Geek_Lite_Board 開發(fā)板和潤(rùn)和 RK3568 開發(fā)板構(gòu)成，Geek_Lite_Board 開發(fā)板主控芯片為 STM32F427IIH6，作為設(shè)備端檢測(cè)磁場(chǎng)強(qiáng)度的變化，使用的是 OpenHarmony 3.0 LTS 版本。潤(rùn)和 RK3568 開發(fā)板是由潤(rùn)和軟件研發(fā)，采用瑞芯微 RK3568 芯片，作為應(yīng)用端顯示金屬探測(cè)信息，使用的是 OpenHarmony 3.1 Release 版本。

二、運(yùn)行效果

當(dāng)周圍有金屬靠近時(shí)，設(shè)備端蜂鳴器會(huì)發(fā)出警報(bào)并把檢測(cè)信息通過 Wi-Fi 模組發(fā)送給應(yīng)用端。在應(yīng)用端收到檢測(cè)信息之后，會(huì)通過屏幕顯示檢測(cè)狀態(tài)并語音播報(bào)檢測(cè)結(jié)果。

三、功能實(shí)現(xiàn)

Geek_Lite_Board 開發(fā)板通過 AK8963 電子羅盤芯片獲取地球磁場(chǎng)強(qiáng)度。通常地球的磁場(chǎng)強(qiáng)度是 0.4-0.6 高斯，當(dāng)金屬靠近電子羅盤芯片時(shí)，根據(jù)電磁感應(yīng)原理，金屬在磁場(chǎng)中的感應(yīng)會(huì)引起磁場(chǎng)信號(hào)的變化。Geek_Lite_Board 開發(fā)板通過 Wi-Fi 與潤(rùn)和 RK3568 開發(fā)板實(shí)時(shí)通信，把檢測(cè)到的信息實(shí)時(shí)上傳。

潤(rùn)和 RK3568 開發(fā)板作為應(yīng)用端，采用方舟開發(fā)框架（ArkUI）基于 eTS 擴(kuò)展的聲明式開發(fā)范式編寫頁(yè)面，通過 NAPI 接口接收設(shè)備端 Geek_Lite_Board 開發(fā)板的檢測(cè)信息，使用 OpenHarmony 媒體子系統(tǒng)中的音頻播放功能實(shí)現(xiàn)語音播報(bào)金屬檢測(cè)狀態(tài)。

磁場(chǎng)數(shù)據(jù)獲取

AK8963 一款具有高靈敏度霍爾傳感器技術(shù)的三軸電子羅盤集成芯片，內(nèi)部包含磁力傳感器，可以在 x 軸、y 軸、z 軸檢測(cè)地球磁場(chǎng)強(qiáng)度。

● 通過Mpu_Read_Bytes()函數(shù)讀芯片數(shù)據(jù)寄存器的值。

uint8_t Mpu_Read_Bytes(uint8_t const regAddr, uint8_t *pData, uint8_t len)

● 獲取 AK8963 的磁場(chǎng)原始數(shù)據(jù)。

Mpu_Data.mag_x = (MPU_BUFF[16] << 8) | MPU_BUFF[15]; // x軸磁場(chǎng)數(shù)據(jù)Mpu_Data.mag_y = (MPU_BUFF[18] << 8) | MPU_BUFF[17]; // y軸磁場(chǎng)數(shù)據(jù)Mpu_Data.mag_z=(MPU_BUFF[20]<8)|MPU_BUFF[19];//z軸磁場(chǎng)數(shù)據(jù)

● 對(duì) AK8963 原始磁場(chǎng)數(shù)據(jù)進(jìn)行轉(zhuǎn)化，得到磁場(chǎng)強(qiáng)度，單位高斯。

Gauss_Mag_z = Mpu_Calc.mag_z * 0.15f * 0.01f;

檢測(cè)金屬信息

首先采集 100 組 z 軸磁場(chǎng)強(qiáng)度基準(zhǔn)數(shù)據(jù)，然后對(duì)這些數(shù)據(jù)做平均處理，由此得到 z 軸磁場(chǎng)強(qiáng)度的零點(diǎn)數(shù)據(jù)。

const uint16_t calibrateCount = 1000; // 測(cè)量最大次數(shù)為1000const uint16_t calibrateFrequency = 5; // 每測(cè)量5次取一次有效值const uint16_t calibrateAverageCount = 100; // 取100次有效值if(i < calibrateCount){    i++;    if(i%calibrateFrequency == calibrateFrequency){       Mag_z_buff[j++] = Gauss_Mag_z;        if(j >= calibrateAverageCount){            i = calibrateCount;            Mag_z_Flag = true;            for(k=0;k                origin_mag_z += Mag_z_buff[k];            }            origin_mag_z = origin_mag_z / calibrateAverageCount;            // 校準(zhǔn)完成，藍(lán)燈亮，發(fā)送給應(yīng)用端 "CalibrateOK"            BLUE_LED_ON();            memset(buff,0x00,sizeof(buff));            sprintf(buff,"angle:%s","CalibrateOK");            ESP8266_send_data(buff,strlen(buff));        }    }}

以 origin_mag_z 作為零點(diǎn)，把獲取到的磁場(chǎng)數(shù)據(jù)與它進(jìn)行對(duì)比，以此來判斷是否檢測(cè)到金屬。

NAPI獲取數(shù)據(jù)

NAPI（Native API）是 OpenHarmony 標(biāo)準(zhǔn)系統(tǒng)的一種 JS API 實(shí)現(xiàn)機(jī)制，適合封裝 IO、CPU 密集型、OS 底層等能力并對(duì)外暴露 JS 接口，通過 NAPI 可以實(shí)現(xiàn) JS 與 C/C++ 代碼互相訪問。潤(rùn)和 RK3568 應(yīng)用端通過 NAPI 來接受設(shè)備端發(fā)出的檢測(cè)信息。 ●底層 NAPI 模塊封裝封裝模塊名為 tcpserverapi，下載至 tcpservermodule 文件夾。下載完成后放到 3.1Release 源碼根目錄，并配置編譯腳本；第一次編譯完成需要燒寫整個(gè)鏡像，后面修改模塊源碼，只需將庫(kù) send 到板子里面。命令如下：

// 先掛載，再sendhdc_std shell mount -oremount,rw /   hdc_stdfilesendlibtcpserverapi.z.sosystem/lib/module/libtcpserverapi.z.so

●應(yīng)用端導(dǎo)入 NAPI 模塊

import tcpserverapi from '@ohos.tcpserverapi'

●應(yīng)用端 NAPI 接口調(diào)用

// 調(diào)用initServer接口 初始化 TCP 服務(wù)器tcpserverapi.initServer() // 調(diào)用recvMsg 獲取并解析Geek_Lite_Board開發(fā)板發(fā)送過來的角度tcpserverapi.recvMsg().then((result) => {      var resultAngle = result.angle;})

UI狀態(tài)顯示與管理

如上圖所示為檢測(cè)中頁(yè)面，整體布局分為文字標(biāo)題和檢測(cè)狀態(tài)示意圖。

文字標(biāo)題由 Flex 布局容器 text 組件實(shí)現(xiàn)，用于呈現(xiàn)一段信息，如下為 text 接口相關(guān)屬性。

●檢測(cè)狀態(tài)示意圖包括頁(yè)面背景圖，檢測(cè)狀態(tài)圖，檢測(cè)結(jié)果說明文字，具體功能由 Flex 彈性布局組件實(shí)現(xiàn)。接口原型如下所示：

Flex(options?: { direction?: FlexDirection, wrap?: FlexWrap, justifyContent?: FlexAlign, alignItems?: ItemAlign, alignContent?: FlexAlign })

●通過調(diào)用 recvMsg 接口接送金屬探測(cè)器的消息，并修改首頁(yè)展示狀態(tài)，關(guān)鍵實(shí)現(xiàn)代碼描述如下：

aboutToAppear() {    var intervalID = setInterval(() => {        tcpserverapi.recvMsg().then((result) => {       }   }}

其中 “ var intervalID = setInterval(() => ” 使用了定時(shí)器，定時(shí)調(diào)用 “recvMsg” 方法，通過 NAPI 獲取金屬檢測(cè)結(jié)果。

if (resultMetal.match("metal:")) {    this.metal = resultMetal.slice(6);    console.info('=======' + this.metal)    if (this.metal === 'Detected') {          this.detectionState = '發(fā)現(xiàn)金屬';          this.detection = $r("app.media.img_detected");          this.isDisplay = false;    }    else if (this.metal === 'UnDetected' || this.metal ==='CalibrateOK') {          this.detectionState = '檢測(cè)中';          this.detection = $r("app.media.img_detecting");          this.isDisplay = true;     }}

當(dāng)通過 NAPI 方式獲取到檢測(cè)信息為 “ metal:Detected ” 時(shí)，設(shè)置 detectionState 為發(fā)現(xiàn)金屬狀態(tài)，屏幕顯示檢測(cè)到金屬頁(yè)面；當(dāng)通過 NAPI 方式獲取到的檢測(cè)信息為 “ metal:UnDetected ” 時(shí)，此時(shí)并未檢測(cè)到任何金屬信息，設(shè)置 detectionState 為檢測(cè)中狀態(tài)，屏幕顯示檢測(cè)中狀態(tài)頁(yè)面。

語音播報(bào)檢測(cè)狀態(tài)

檢測(cè)到金屬后，RK3568 會(huì)播報(bào)已探測(cè)到金屬的語音信息，達(dá)到通知用戶的目的，通過 OpenHarmony 媒體子系統(tǒng)的音頻播放功能實(shí)現(xiàn)。OpenHarmony 媒體子系統(tǒng)為開發(fā)者提供一套簡(jiǎn)單且易于理解的接口，使得開發(fā)者能夠方便接入系統(tǒng)并使用系統(tǒng)的媒體資源。媒體子系統(tǒng)包含了音頻播放、視頻播放、音頻錄制和視頻錄制等常用功能。音頻播放的主要工作是將音頻數(shù)據(jù)轉(zhuǎn)碼為可聽見的音頻模擬信號(hào)并通過輸出設(shè)備進(jìn)行播放，同時(shí)對(duì)播放任務(wù)進(jìn)行管理。本樣例主要通過導(dǎo)入 media 模塊、創(chuàng)建音頻播放實(shí)例、實(shí)現(xiàn)音頻播放接口和實(shí)現(xiàn)暫停播放接口等流程實(shí)現(xiàn)。

●導(dǎo)入media模塊

import media from '@ohos.multimedia.media';

●創(chuàng)建音頻播放實(shí)例

// OH media對(duì)象privateplayer=media.createAudioPlayer();

●實(shí)現(xiàn)音頻播放接口

使用 play() 調(diào)用開始播放音頻資源，需在完成音頻數(shù)據(jù)加載后，即 src 屬性設(shè)置完成后才能調(diào)用。

play():void

四、總結(jié)

本文簡(jiǎn)述了如何使用 OpenHarmony 進(jìn)行多設(shè)備的開發(fā)，演示了 NAPI、eTS UI、UI 管理狀態(tài) @state 和音頻播放等技術(shù)特性的應(yīng)用，通過這些多元化的功能，我們最終實(shí)現(xiàn)了金屬探測(cè)器樣例。豐富多樣的 OpenHarmony 開發(fā)樣例離不開廣大合作伙伴和開發(fā)者的貢獻(xiàn)，如果你也想把自己開發(fā)的樣例分享出來，歡迎把樣例提交到 OpenHarmony 知識(shí)體系 SIG 倉(cāng)來，一起實(shí)現(xiàn)開發(fā)樣例共建。

五、參考鏈接

RK3568開發(fā)板上絲滑體驗(yàn)OpenHarmony標(biāo)準(zhǔn)系統(tǒng)

https://gitee.com/openharmony-sig/knowledge_demo_smart_home/tree/master/dev/docs/rk3568_quick_start

在Windows編譯OpenHarmony工程

https://gitee.com/Cruise2019/team_x/blob/master/homework/ohos_build_win/readme.md

OpenHarmony NAPI 學(xué)習(xí)文檔

https://gitee.com/javen678/hello-ohos-napi/tree/master/doc#/javen678/hello-ohos-napi/blob/master/doc/1.HelloNAPI.md

OpenHarmony基于eTS擴(kuò)展的聲明式開發(fā)范式

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md

音頻播放開發(fā)指導(dǎo)

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/audio-playback.md

從零開發(fā)金屬探測(cè)器應(yīng)用

https://gitee.com/openharmony-sig/knowledge_demo_temp/blob/master/docs/metal_detection/quick_develop.md

GEEKROS官網(wǎng)

https://www.geekros.com/