本文主要介绍基于openharmony 3.0来接入iotda,以bearpi-hm_nano开发板为例,使用huaweicloud_iot_link sdk对接华为云物联网平台的简单流程。
前提条件
· 已注册华为云官方帐号。未注册可单击注册页面完成注册。
· 已完成实名制认证。未完成可在华为云上单击实名认证完成认证,否则无法使用设备接入功能。
硬件环境
bearpi-hm_nano开发板、type-c数据线、pc。
软件环境
图1 软件环境创建步骤
说明:
(1)如使用deveco device tool参与调试的需要安装windows环境。
(2)获取源码:如果不使用docker方式(使用docker方式),强烈建议采用方式一获取。
(3)在安装开发板中的环境的安装gcc_riscv32步骤时,强烈建议直接下载gcc_riscv32镜像,否则可能出现某些插件下载或安装失败,具体操作如下图2所示。
须知:
开源代码量较大,下载时间可能较长,需预留好充足时间。
图2 直接下载gcc_riscv32镜像
创建产品
-
登录管理控制台,单击左侧导航栏“产品”,单击页面右上角的“创建产品”。
-
根据页面提示填写参数,然后单击“确认”,完成产品的创建。
① 所属资源空间:默认资源空间;
② 产品名称:自定义;
③ 协议类型:mqtt;
④ 数据格式:json;
⑤ 厂商名称:自定义;
⑥ 设备类型选择: 自定义类型;
⑦ 设备类型:自定义;
开发产品模型
-
找到新增的产品,单击“查看”进入产品界面。
-
在产品详情“模型定义”页面,直接上传模型文件 bearpi_agriculture.zip 。
注册设备
-
访问 设备接入服务,单击管理控制台进入设备接入控制台。
-
在左侧导航栏选择“ 设备 > 所有设备”,单击右上角“注册设备”,按照如下表格填写参数后,单击“确定”。
① 所属资源空间:默认资源空间;
② 所属产品:选择【创建产品】中已创建的产品;
③ 设备标识码:自定义;
④ 设备名称:自定义;
⑤ 设备认证类型:选择“密钥”;
⑥ 密钥/确认密钥:固定为12345678;
huaweicloud_iotlink sdk使用
-
将上述源码直接拷贝到openharmony源码的third-party文件目录下,此处需要注意的是openharmony和huaweicloud_iotlink sdk共同具备的三方库直接使用openharmony的库文件,如cjson和mbedtls。
-
在openharmony 3.0源码device\bearpi\bearpi_hm_nano\app\build.gn中添加如下代码,根据#是否注释来决定具体编译demo的选择。
“//third_party/hwcloud_iotlink/demos/test_iotlink:test_iotlink”, “//third_party/hwcloud_iotlink/demos/mqtt_tiny_v5_agriculture_demo:mqtt_tiny_v5_agriculture_demo”,
(图6 demo的选择)
说明:
图6中1为单元测试代码,可以根据修改test_main.c文件中最后一行代码中,app_feature_init()中的入口函数,来进行不同的测试用例的执行,分别测试osal层不同的组件适配,包括任务、互斥锁、信号量、队列、以及sdk本身队列等一系列验证,部分内容可以对比bearpi-hm_nano开发板的官方样例代码进行对比验证程序结果的正确性,具体如图7。
图6中2为使用mqtt对接华为云的demo,看一下该demo的build.gn文件,具体如图8所示,其中a区域包含开发板硬件和wifi相关的库文件,b区域包括mqtt对接华为云必须的一些库文件,如cjson,mqtt相关、osal相关以及配置库文件,c区域表示编译该文件时需要编译hwcloud_iotlink库,编译是会按照指定路径找到该文件所必要的库以及c文件进行编译。
(图7 单元测试)
(图8 代码编译文件)
(图9 demo的主函数文件)
说明:
图9中a区域表示mqtt对接华为云所必须的一些库文件以及dtls的库文件,入口函数iotmaintaskentry()中务必先调用link_main_task_entry()函数,来确保osal的安装以及其他配置的初始化。
- 设置参数。
(图10 参数修改)
注意:
如果需要对接上云需要根据自己的设备修改配网信息,wifi热点账号以及密码以及自己在云端注册的设备id和设备秘钥,设备仅支持2.4g频段的wifi。
设备接入平台
代码烧录到设备后重启设备(首次使用需重启两次,第一次烧录时可能需要配置一下内部信息),第二次设备重启之后可以正常对接华为云。
登录平台可以看见数据上报的具体信息,也可以进行命令下发等操作控制设备,具体如下图11-13。
(图11 数据上报)
(图12 命令下发)
(图13 日志信息)
物联网被称为继计算机和互联网之后的第三次信息技术革命,其应用无处不在。 鸿蒙的出现,让硬件、软件行业面临着变革与重构的洪流,但激流勇进中,也潜藏着巨大机遇。物联网设备与鸿蒙结合已成为社会发展的必然趋势。
发表评论