远程台灯功能 原创 精华

发布于 2022-6-15 17:41
浏览
3收藏

简介
碰一碰特性是HarmonyOS具备的多终端业务协同技术。通过碰一碰的交互方式,可以将手机和全场景设备连接起来。再通过手机端的原子化服务能力,快速完成配网、远程控制。解决了应用与设备之间接续慢、配网复杂、传输难的问题,为用户带来无缝切换的流畅体验。

本篇Codelab将指导大家如何开发一个模拟的“远程台灯”案例。在本案例中,通过手机碰一碰NFC标签,可以从HAG获取到关联意图信息。通过获取到的关联意图信息,可以拉起对应的原子化服务。该原子化服务通过调用hilink接口,并结合设备侧代码实现,可以完成开发板与手机间的配网并建立通信通道。完成此步骤后,即可通过手机控制Hi3861开发版中LED灯的开关了。
远程台灯功能-开源基础软件社区

通过该案例,大家将会学会:

通过碰一碰能力,拉起手机端原子化服务。

快速完成手机与设备的配网。

通过手机对设备进行控制。

说明: 本指导仅用于个人开发者体验HarmonyOS碰一碰特性,不能作为商用方案进行碰一碰特性的开发和上架。

实物简介
Hi3861开发板

华为手机,系统版本为HarmonyOS 2.0.0.168及以上,手机具体型号为Mate 40 Pro。将手机上智慧生活基础服务升级至12.0.0.306及以上版本。具体操作步骤如下:

查看“智慧生活基础服务”版本,打开手机“设置>应用服务>应用管理”,搜索“智慧生活基础服务”。
升级“智慧生活基础服务”,打开手机“智慧生活”App,点击“我的 > 设置 > 检查应用更新”,更新“智慧生活基础服务”。
Hi3861开发板
本样例基于Hi3861开发板开发,请准备Hi3861开发板(HiSpark Wi-Fi IoT智能家居套件)。包含开发板主板、底板和OLED板。

远程台灯功能-开源基础软件社区

HarmonyOS原子化服务开发
创建工程
设备配网原子化服务(entry)
设备控制原子化服务(control)
本案例将要实现“碰一碰-拉起原子化服务-设备配网-设备控制”的完整流程,整个流程都要基于手机端的原子化服务实现。开发原子化服务使用的工具为DevEco Studio 3.0 Beta2,关于工具配置请查看官方指导文档搭建开发环境流程。

打开创建工程向导界面,选择“Empty Ability”模板创建原子化服务,用于设备配网。

远程台灯功能-开源基础软件社区
在工程配置中,Project type选择“Atomic Service”,并打开“Show in Service Center”选项,点击Finish按钮即可完成创建设备配网原子化服务。

远程台灯功能-开源基础软件社区
在已创建好的“entry”目录上右击,选择“Empty Ability”模板新建一个Module,用于设备控制。
远程台灯功能-开源基础软件社区
在模块配置界面,“Module type”中选择的“Feature”,点击“Next”。
远程台灯功能-开源基础软件社区
配置Module的“Page ability name”,点击“Finish”完成创建。
远程台灯功能-开源基础软件社区
设备配网原子化服务(entry)
配网过程需要依赖hilink的接口,因此首先需要在entry\build.gradle中加入对hilink的依赖。

dependencies {
    ...
    ohosTestImplementation 'com.huawei.ohos.testkit:runner:2.0.0.200'
}

手机碰一碰nfc标签,将会拉起用于配网的原子化服务(entry模块)。在服务的入口MainAbility中,完成了对nfc中的产品信息的读取,以及将“abilityContext”和从意图中获取的“nanSessionId”注册到用于配网的NetConfigAbility中。

// 读取产品信息
Object productInfo = Objects.requireNonNull(intent.getParams()).getParam("productInfo");
if (productInfo != null) {
    productId = (String) productInfo;
}

// 从intent中读取的nanSessionId用于配网,同时需要将abilityContext和sessionId注册到NetConfigAbility中
String sessionId = intent.getStringParam("nanSessionId");
if ("null".equals(sessionId) || "".equals(sessionId)) {
    NetConfigAbility.register(this, null);
} else {
    NetConfigAbility.register(this, sessionId);
}

entry模块的主界面在初始化时,会将产品信息和“nanSessionId”在应用中保存传递。

onInit() {
    this.deviceName = this.$t('strings.device-name');
    this.deviceImg = '/common/images/LED.png';
    getApp(this).Product.productName = this.productName;
    getApp(this).Product.productId = this.productId;
    getApp(this).ConfigParams.sessionId = this.sessionId;
}

点击主界面的“配网”按钮,会默认进行配网操作。主要分为5个步骤,均依赖hilink接口实现,具体代码可查看netconfig.js。

通过NAN广播服务搜索设备。

getApp(this).NetConfig.discoveryByNAN(scanInfo, (result) => {
    if (result.code == 0) {
       // 成功发现设备
    } else {
       ...
    }
});

连接设备。

getApp(this).NetConfig.connectDevice(connectInfo, (result) => {
    if (result.code === 0) {
        // 设备连接成功
    } else {
        ...
    }
});

获取wifi信息。

getApp(this).NetConfig.getWifiList((result) => {
    if (result.code == 0 && result.data && result.data.length > 0) {
        // 获取wifi信息成功
    } else {
        ...
    }
});

对设备进行网络配置。

getApp(this).NetConfig.configDeviceNet('deviceInfo', 'accountInfo', netConfigInfo, (result) => {
    if (result.code == 0) {
        // 设备网络配置成功
    } else {
        ...
    }
});

配网成功,跳转至设备控制模块。

goToControl() {
    let target = {
        bundleName: 'com.huawei.smartlamp.hmservice',
        abilityName: 'com.huawei.smartlamp.ControlMainAbility',
        deviceType: 1,// 从本地设备中拉起原子化服务
        data: {
            session_id: getApp(this).ConfigParams.deviceInfo.sessionId,
            product_id: getApp(this).Product.productId,
            product_name: getApp(this).Product.productName
        }
    }
    FeatureAbility.startAbility(target);
    app.terminate()
}

设备控制原子化服务(control)
通过control模块控制开发版led灯的开关,依赖hilink的接口发送指令,因此需要在control\build.gradle添加对应依赖。

dependencies {    ...    implementation(group: 'com.huawei.hilink', name: 'ailifeability', version: '1.0.0.1', ext: 'har')}

当成功完成设备配网后,手机会自动拉起设备控制原子化服务(control)。在控制服务界面点击开关按钮时,会利用FeatureAbility模块(JS端SDK接口)的能力,调用PA向开发板发送指令,NetConfigApi由引入的hilink模块提供。

private void sendMessage(String message, HashMap<String, Object> tmpMap) {    CommonInfo commonInfo = new CommonInfo();    commonInfo.setSessionId(sessionId);    HiLog.error(LABEL_LOG, "sessionId " + sessionId);    NetConfigApi.getInstance().sendMessage(commonInfo, message, (code, controlMessage, str) -> {        ...    });}

Hi3861开发环境准备
Hi3861支持多种开发环境的搭建:

搭建Windows开发环境

搭建Windows+Ubuntu混合开发环境

搭建Ubuntu开发环境

开发者可以根据自身的情况搭建合适的开发环境。

源码下载与编译前准备
代码下载
编译前准备

本案例将使用Ubuntu开发环境,基于OpenHarmony-3.0-LTS源码进行开发。

代码下载
通过repo工具下载OpenHarmony-3.0-LTS的源码:

repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.0-LTS --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

编译前准备
编译前,需要调整OpenHarmony源码,并添加设备侧代码,以实现设备配网与设备控制的功能。

修改device/hisilicon/hispark_pegasus/sdk_liteos/build/config/usr_config.mk文件,开启对I2C的支持。

CONFIG_I2C_SUPPORT=y

修改device/hisilicon/hispark_pegasus/hi3861_adapter/hals/communication/wifi_lite/wifiservice/source/wifi_hotspot.c文件,在EnableHotspot函数中注释如下代码。

//if (SetHotspotIpConfig() != WIFI_SUCCESS) {
//    return ERROR_WIFI_UNKNOWN;
//}

修改device/hisilicon/hispark_pegasus/hi3861_adapter/hals/communication/wifi_lite/wifiservice/source/wifi_device.c文件,在DispatchConnectEvent函数中注释StaSetWifiNetConfig相关代码。

//StaSetWifiNetConfig(HI_WIFI_EVT_CONNECTED);
//StaSetWifiNetConfig(HI_WIFI_EVT_DISCONNECTED);

修改base/security/huks/interfaces/innerkits/huks_lite/BUILD.gn文件,注释如下代码。

#sources += [ “hks_tmp_client.c” ]
在OpenHarmony源码的third_party目录下,添加IoTDA平台SDK。

远程台灯功能-开源基础软件社区
在vendor目录下,添加设备侧代码team_x。目录结构如下图所示。
远程台灯功能-开源基础软件社区
“common”中主要包含本样例依赖的头文件和类库文件。“smart_lamp”中则包含了本样例中设备侧的核心代码。“smart_lamp”目录结构如下图所示。
远程台灯功能-开源基础软件社区
样例入口文件iot_main.c位于demo_smartlamp/src目录下,当启动开发板时,会启动入口线程任务。在该任务中,开发板会完成I2C初始化、OLED初始化,进入配网状态并注册网络监听事件。

static void *LampTask(const char *arg)
{
    (void)arg;
    WINDBG("LampTask Enter! \n");
    LampInit();
    (void)memset_s(&g_lamp, sizeof(g_lamp), 0x00, sizeof(g_lamp));

    NetCfgRegister(LampNetEventHandler);  // 进入配网状态并注册网络监听事件
    LampShowInfo();       // 显示LED初始状态
}

配网成功,并成功注册网络监听事件后,手机端每次发送指令,都会触发监听事件,从而对开发板设备上LED灯进行开关控制。

static int LampNetEventHandler(NET_EVENT_TYPE event, void *data)
{
    switch (event) {
        case NET_EVENT_RECV_DATA: // 接收到网络信息(FA发送的消息)
            LampProcessAppMessage((const char *)data, strlen(data)); // 处理对应的信息
            break;
        default:
            break;
    }
    return 0;
}

编译和烧录
编译

进入源码根目录,首次编译,输入编译命令“hb set”。随后在Input code path命令行中键入“.”,指定OpenHarmony工程编译根目录后回车。

远程台灯功能-开源基础软件社区

选择智能台灯“smart_lamp”并回车,输入“hb build”命令进行编译,屏幕出现:BUILD SUCCESS字样,说明编译成功。
远程台灯功能-开源基础软件社区

烧录
将编译生成文件下载至本地Windows环境。
远程台灯功能-开源基础软件社区

将Hi3861通过TypeC数据线与电脑连接。

使用Hiburn工具进行烧录:

点击“Refresh”按钮,更新com端口信息。在“COM”处选择Hi3861开发板对应的COM口。选择编译生成的二进制文件,勾选“Auto burn”,随后点击“connect”按钮。此时点击Hi3861开发板上的“RST”键,进行烧录。

远程台灯功能-开源基础软件社区

查看烧录进度,等待进度跑完,则烧录完成。可点击“Disconnect”断开连接。

远程台灯功能-开源基础软件社区

源码下载与编译前准备
代码下载
编译前准备

本案例将使用Ubuntu开发环境,基于OpenHarmony-3.0-LTS源码进行开发。

代码下载
通过repo工具下载OpenHarmony-3.0-LTS的源码:

repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.0-LTS --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

编译前准备
编译前,需要调整OpenHarmony源码,并添加设备侧代码,以实现设备配网与设备控制的功能。

修改device/hisilicon/hispark_pegasus/sdk_liteos/build/config/usr_config.mk文件,开启对I2C的支持。

CONFIG_I2C_SUPPORT=y

修改device/hisilicon/hispark_pegasus/hi3861_adapter/hals/communication/wifi_lite/wifiservice/source/wifi_hotspot.c文件,在EnableHotspot函数中注释如下代码。

//if (SetHotspotIpConfig() != WIFI_SUCCESS) {
//    return ERROR_WIFI_UNKNOWN;
//}

修改device/hisilicon/hispark_pegasus/hi3861_adapter/hals/communication/wifi_lite/wifiservice/source/wifi_device.c文件,在DispatchConnectEvent函数中注释StaSetWifiNetConfig相关代码。

//StaSetWifiNetConfig(HI_WIFI_EVT_CONNECTED);
//StaSetWifiNetConfig(HI_WIFI_EVT_DISCONNECTED);

修改device/hisilicon/hispark_pegasus/sdk_liteos/BUILD.gn文件,在deps中添加如下代码。

deps = [
    ...
    "//build/lite:product",
  ]

修改base/security/huks/interfaces/innerkits/huks_lite/BUILD.gn文件,注释如下代码。

#sources += [ "hks_tmp_client.c" ]

在OpenHarmony源码的third_party目录下,添加IoTDA平台SDK。

远程台灯功能-开源基础软件社区
在vendor目录下,添加设备侧代码team_x。目录结构如下图所示。
远程台灯功能-开源基础软件社区

“common”中主要包含本样例依赖的头文件和类库文件。“smart_lamp”中则包含了本样例中设备侧的核心代码。“smart_lamp”目录结构如下图所示。
远程台灯功能-开源基础软件社区

static void *LampTask(const char *arg)
{
    (void)arg;
    WINDBG("LampTask Enter! \n");
    LampInit();
    (void)memset_s(&g_lamp, sizeof(g_lamp), 0x00, sizeof(g_lamp));

    NetCfgRegister(LampNetEventHandler);  // 进入配网状态并注册网络监听事件
    LampShowInfo();       // 显示LED初始状态
}

配网成功,并成功注册网络监听事件后,手机端每次发送指令,都会触发监听事件,从而对开发板设备上LED灯进行开关控制。

static int LampNetEventHandler(NET_EVENT_TYPE event, void *data)
{
    switch (event) {
        case NET_EVENT_RECV_DATA: // 接收到网络信息(FA发送的消息)
            LampProcessAppMessage((const char *)data, strlen(data)); // 处理对应的信息
            break;
        default:
            break;
    }
    return 0;
}

编译
进入源码根目录,首次编译,输入编译命令“hb set”。随后在Input code path命令行中键入“.”,指定OpenHarmony工程编译根目录后回车。
远程台灯功能-开源基础软件社区

选择智能台灯“smart_lamp”并回车,输入“hb build”命令进行编译,屏幕出现:BUILD SUCCESS字样,说明编译成功。
远程台灯功能-开源基础软件社区

烧录
将编译生成文件下载至本地Windows环境。

远程台灯功能-开源基础软件社区

将Hi3861通过TypeC数据线与电脑连接。

使用Hiburn工具进行烧录:

点击“Refresh”按钮,更新com端口信息。在“COM”处选择Hi3861开发板对应的COM口。选择编译生成的二进制文件,勾选“Auto burn”,随后点击“connect”按钮。此时点击Hi3861开发板上的“RST”键,进行烧录。

远程台灯功能-开源基础软件社区
查看烧录进度,等待进度跑完,则烧录完成。可点击“Disconnect”断开连接。

远程台灯功能-开源基础软件社区

设备配网
使用应用调测助手App,在NFC标签中写入对应的标签信息,具体请参考写入NFC标签信息。

通过在HAG上配置原子化关联意图,在手机碰一碰NFC标签后,即可获取需要拉取的原子化服务信息,具体请参考配置服务关联意图。

在手机上安装开发好的原子化服务。注意该项目包含两个模块,签名需要使用项目级签名。

远程台灯功能-开源基础软件社区

打开Run > Edit Configurations, 勾选entry模块下的“Deploy Multi Hap Packages”选项,表示在运行entry模块(设备配网原子化服务)时,同时会在手机中安装control模块(设备控制原子化服务)。

远程台灯功能-开源基础软件社区
打开手机NFC功能,确认手机已经接入WLAN无线网络。使用手机背部接触NFC标签,手机会弹出以下页面。

远程台灯功能-开源基础软件社区

点击Hi3861开发板的RST复位按键,点击手机上的配网按钮,即开始手机与开发板的配网过程。配网成功后,手机应用将自动跳转至控制界面,如下图。

远程台灯功能-开源基础软件社区

操作体验
配网成功后,即可通过手机对Hi3861开发板LED灯进行开关操作。
远程台灯功能-开源基础软件社区

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
3
收藏 3
回复
举报
回复
添加资源
添加资源将有机会获得更多曝光,你也可以直接关联已上传资源 去关联
    相关推荐