
#星光计划2.0# OpenHarmony3.0上采用ets开发HAP控制LED灯 原创 精华
【本文正在参与51CTO HarmonyOS技术社区创作者激励计划-星光计划2.0】
作者:周希元
目录
1. 开发环境
硬件:Hi3516DV300开发板
软件:OpenHarmony3.0系统
工具:DevEco Studio 3.0
2. 功能简介
OpenHarmony3.0采用了方舟开发框架arkUI,支持了基于TS扩展的声明式开发范式eTS,本文使用ets开发语言,构造一个应用程序,实现通过上层HAP控制底层LED灯的亮与灭。
3. 实现原理
如果在Android上实现,需要通过java调用jni实现对底层的访问。但是在OpenHarmony上,HAP采用ets语言开发,没有发现嵌入到HAP当中的类JNI语言,但是系统也提供了一个访问底层的机制,叫做NAPI,不过这部分是在系统层实现的,不随HAP一起发布。我们想要实现控制LED灯的功能,是在NAPI部分通过C语言实现的,然后编译为xxx.z.so动态库,它向上层提供了一个控制接口。绿色LED灯对应GPIO2_3,计算出编号:2*8+3=19,所以直接控制gpio19下的value值就可以控制LED灯亮灭了。
4. 具体实现
整个功能的实现分为了上层HAP应用开发和底层.z.so库的开发两部分。
4.1 应用的开发
1.在HUAWEI DevEco Studio中,创建一个 [Standard]Empty Ability ,
开发语言选择 “eTS”,可以注意到API Version仅支持7,说明是在OpenHarmony3中新支持的,也仅在OpenHarmony3中支持,这些功能实际上都是测试版本,稳定了之后就会在HarmonyOS中使用了,但目前还没有发布。
工程创建完毕后,我直接在pages目录结构下右击新建了一个ets page,取名led
我们页面的样式、布局和控制全都在led.ets这个文件里了,不再像js分为css、hml和js三个文件。
Led.ets 文件内容
放了两个图片,表示LED灯状态的,放在了代码的entry\src\main\resources\phone\media目录,
导入的ohos.led 库,是自己添加的NAPI层的动态库,后面会继续介绍。
在config.json文件中,记得把led.ets放到js部分pages数组的第一位,因为它是要显示的首页面。
代码中使用了两个Button组件,一个打开,一个关闭,因为在ets中还没有类似js中的switch的组件,
页面中有两个image组件,分别显示打开和关闭的图像,通过设置visibility属性来切换状态,本来想通过动态设置image的源来改变图像内容,但没找到有效的方法,应该是支持的,只是自己还没了解怎么用。
编译前记得一定要设置签名,否则编译出来的程序无法安装,
最后可以编译程序了,
生成的最终HAP在 build\outputs\hap\debug\phone\entry-debug-standard-ark-signed.hap
4.2 动态库的开发
动态库需要在OpenHarmony源码中添加和编译,本文使用的是OpenHarmony3.0源码,
在foundation/ace/napi/sample目录下,复制一份native_module_demo,重命名为native_module_led,里面的文件也相应的修改名字,注意文件里调用也相应的修改成正确的名字,否则编译会报错。
主要修改的文件有,
foundation/ace/napi/sample/native_module_led/BUILD.gn
foundation/ace/napi/sample/native_module_led/native_module_led.cpp
foundation/ace/napi/BUILD.gn
目录native_module_led下BUILD.gn文件:
目录native_module_led下native_module_led.cpp文件修改部分摘要:
包含的头文件和宏定义,
添加函数SwitchLed的具体实现,
初始化部分,
模块定义及注册,
目录napi下BUILD.gn文件,
最后在源码根目录下执行编译命令,
$./build.sh --product-name Hi3516DV300 --build-target make_test
生成的文件为
out/ohos-arm-release/ace/napi/libled.z.so
5. 系统设置
需要授予应用访问gpio下export文件的权限,
device/hisilicon/hi3516dv300/build/rootfs/init.Hi3516DV300.cfg
6. 系统部署
6.1 拷贝动态库
生成的.z.so动态库已经拷贝到PC上E:\libled.z.so
PC串口控制台:
#mount -o remount,rw /
PC命令窗口cmd:
E:>hdc_std file send E:\libled.z.so /system/lib/module/
PC串口控制台:
#chmod 666 /system/lib/module/libled.z.so
6.2 安装应用
PC命令窗口cmd:
E:>hdc_std install E:\Projects\HarmonyProject\MyLed\build\outputs\hap\debug\phone\entry-debug-standard-ark-signed.hap
7. 应用测试
点击打开按钮,LED图标变绿,同时LED灯亮,
点击关闭按钮,LED图标变灰,同时LED灯灭。
8. 动图展示
