远程台灯功能

Posted 润和HiHope社区

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了远程台灯功能相关的知识，希望对你有一定的参考价值。

简介
碰一碰特性是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 
        ...
    
);

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

设备控制原子化服务（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灯进行开关操作。

以上是关于远程台灯功能的主要内容，如果未能解决你的问题，请参考以下文章

多功能智能感应台灯设计（FAQ）

多功能智能感应台灯实物（展示）

多功能智能感应台灯设计（嵌入式）

基于单片机工业生产现场的光照强度控制系统设计-基于单片机多功能智能台灯设计-基于单片机多功能智能台灯控制系统设计-资料转发分享

[资料分享]基于单片机智能多功能自动窗帘定时光照强度检测系统设计基于单片机多功能台灯自动调节光亮强度系统设计

WiFi 无线拉起执行 APP 稳定性 / 压力测试，免 USB 连线