一、简介

智能金属勘探器是基于 OpenAtom OpenHarmony（以下简称“OpenHarmony”）操作系统，运用电磁感应原理来勘探周围的金属物体。该样例选用多设备协同的方法，兼容 OpenHarmony 设备开发与运用开发，整个样例体现了 OpenHarmony 的 NAPI、eTS UI、UI 办理状况 @state 和音频播映等技能特性。

基于OpenHarmony的智能金属探测器

本项目由 Geek_Lite_Board 开发板和润和 RK3568 开发板构成，Geek_Lite_Board 开发板主控芯片为 STM32F427IIH6，作为设备端检测磁场强度的改变，运用的是 OpenHarmony 3.0 LTS 版本。润和 RK3568 开发板是由润和软件研制，选用瑞芯微 RK3568 芯片，作为运用端显现金属勘探信息，运用的是 OpenHarmony 3.1 Release 版本。

二、运转效果

当周围有金属靠近时，设备端蜂鸣器会发出警报并把检测信息经过 Wi-Fi 模组发送给运用端。在运用端收到检测信息之后，会经过屏幕显现检测状况并语音播报检测结果。

基于OpenHarmony的智能金属探测器

三、功用完结

Geek_Lite_Board 开发板经过 AK8963 电子罗盘芯片获取地球磁场强度。一般地球的磁场强度是 0.4-0.6 高斯，当金属靠近电子罗盘芯片时，根据电磁感应原理，金属在磁场中的感应会引起磁场信号的改变。Geek_Lite_Board 开发板经过 Wi-Fi 与润和 RK3568 开发板实时通信，把检测到的信息实时上传。润和 RK3568 开发板作为运用端，选用方舟开发框架（ArkUI）基于 eTS 扩展的声明式开发范式编写页面，经过 NAPI 接口接纳设备端 Geek_Lite_Board 开发板的检测信息，运用 OpenHarmony 媒体子系统中的音频播映功用完结语音播报金属检测状况。

基于OpenHarmony的智能金属探测器

磁场数据获取

AK8963 一款具有高灵敏度霍尔传感器技能的三轴电子罗盘集成芯片，内部包含磁力传感器，能够在 x 轴、y 轴、z 轴检测地球磁场强度。

基于OpenHarmony的智能金属探测器

● 经过Mpu_Read_Bytes()函数读芯片数据寄存器的值。

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

● 获取 AK8963 的磁场原始数据。

Mpu_Data.mag_x = (MPU_BUFF[16] << 8) | MPU_BUFF[15]; // x轴磁场数据
Mpu_Data.mag_y = (MPU_BUFF[18] << 8) | MPU_BUFF[17]; // y轴磁场数据
Mpu_Data.mag_z = (MPU_BUFF[20] << 8) | MPU_BUFF[19]; // z轴磁场数据

● 对 AK8963 原始磁场数据进行转化，得到磁场强度，单位高斯。

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

检测金属信息

首先采集 100 组 z 轴磁场强度基准数据，然后对这些数据做平均处理，由此得到 z 轴磁场强度的零点数据。

const uint16_t calibrateCount = 1000; // 丈量最大次数为1000
const uint16_t calibrateFrequency = 5; // 每丈量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<calibrateAverageCount;k++){
                origin_mag_z += Mag_z_buff[k];
            }
            origin_mag_z = origin_mag_z / calibrateAverageCount;
            // 校准完结，蓝灯亮，发送给运用端 "CalibrateOK"
            BLUE_LED_ON();
            memset(buff,0x00,sizeof(buff));
            sprintf(buff,"angle:%s","CalibrateOK");
            ESP8266_send_data(buff,strlen(buff));
        }
    }
}

以 origin_mag_z 作为零点，把获取到的磁场数据与它进行对比，以此来判断是否检测到金属。

NAPI获取数据

NAPI（Native API）是 OpenHarmony 规范系统的一种 JS API 完结机制，适合封装 IO、CPU 密集型、OS 底层等才干并对外露出 JS 接口，经过 NAPI 能够完结 JS 与 C/C++ 代码相互拜访。润和 RK3568 运用端经过 NAPI 来承受设备端发出的检测信息。

●底层 NAPI 模块封装

封装模块名为 tcpserverapi，下载至 tcpservermodule 文件夹。

下载完结后放到 3.1Release 源码根目录，并配置编译脚本；第一次编译完结需求烧写整个镜像，后边修正模块源码，只需将库 send 到板子里边。命令如下：

// 先挂载，再send
hdc_std shell mount -oremount,rw /   
hdc_std file send libtcpserverapi.z.so system/lib/module/libtcpserverapi.z.so

●运用端导入 NAPI 模块

import tcpserverapi from '@ohos.tcpserverapi'

●运用端 NAPI 接口调用

// 调用initServer接口 初始化 TCP 服务器
tcpserverapi.initServer() 
// 调用recvMsg 获取并解析Geek_Lite_Board开发板发送过来的视点
tcpserverapi.recvMsg().then((result) => {  
    var resultAngle = result.angle;
})

UI状况显现与办理

基于OpenHarmony的智能金属探测器

如上图所示为检测中页面，整体布局分为文字标题和检测状况示意图。

文字标题由 Flex 布局容器 text 组件完结，用于呈现一段信息，如下为 text 接口相关属性。

基于OpenHarmony的智能金属探测器

●检测状况示意图包含页面背景图，检测状况图，检测结果阐明文字，详细功用由 Flex 弹性布局组件完结。接口原型如下所示：

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

●经过调用 recvMsg 接口接送金属勘探器的消息，并修正首页展示状况，关键完结代码描绘如下：

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

其中 “ var intervalID = setInterval(() => ” 运用了定时器，定时调用 “recvMsg” 办法，经过 NAPI 获取金属检测结果。

if (resultMetal.match("metal:")) {
    this.metal = resultMetal.slice(6);
    console.info('=======' + this.metal)
    if (this.metal === 'Detected') {
          this.detectionState = '发现金属';
          this.detection = $r("app.media.img_detected");
          this.isDisplay = false;
    }
    else if (this.metal === 'UnDetected' || this.metal ==='CalibrateOK') {
          this.detectionState = '检测中';
          this.detection = $r("app.media.img_detecting");
          this.isDisplay = true;
     }
}

当经过 NAPI 方法获取到检测信息为 “ metal:Detected ” 时，设置 detectionState 为发现金属状况，屏幕显现检测到金属页面；当经过 NAPI 方法获取到的检测信息为 “ metal:UnDetected ” 时，此时并未检测到任何金属信息，设置 detectionState 为检测中状况，屏幕显现检测中状况页面。

语音播报检测状况

检测到金属后，RK3568 会播报已勘探到金属的语音信息，到达通知用户的目的，经过 OpenHarmony 媒体子系统的音频播映功用完结。

OpenHarmony 媒体子系统为开发者提供一套简略且易于了解的接口，使得开发者能够便利接入系统并运用系统的媒体资源。媒体子系统包含了音频播映、视频播映、音频录制和视频录制等常用功用。

音频播映的首要工作是将音频数据转码为可听见的音频模拟信号并经过输出设备进行播映，同时对播映任务进行办理。本样例首要经过导入 media 模块、创建音频播映实例、完结音频播映接口和完结暂停播映接口等流程完结。

●导入media模块

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

●创建音频播映实例

// OH media对象
privateplayer=media.createAudioPlayer();

●完结音频播映接口

运用 play() 调用开端播映音频资源，需在完结音频数据加载后，即 src 属性设置完结后才干调用。

play():void

四、总结

本文简述了如何运用 OpenHarmony 进行多设备的开发，演示了 NAPI、eTS UI、UI 办理状况 @state 和音频播映等技能特性的运用，经过这些多元化的功用，我们终究完结了金属勘探器样例。丰厚多样的 OpenHarmony 开发样例离不开广阔合作伙伴和开发者的贡献，如果你也想把自己开发的样例共享出来，欢迎把样例提交到 OpenHarmony 常识系统 SIG 仓来，一起完结开发样例共建。

五、参阅链接

RK3568开发板上丝滑体验OpenHarmony规范系统

gitee.com/openharmony…

在Windows编译OpenHarmony工程

gitee.com/Cruise2019/…

OpenHarmony NAPI 学习文档

gitee.com/javen678/he…

OpenHarmony基于eTS扩展的声明式开发范式

gitee.com/openharmony…

音频播映开发辅导

gitee.com/openharmony…

从零开发金属勘探器运用

gitee.com/openharmony…

GEEKROS官网

www.geekros.com/

基于OpenHarmony的智能金属探测器