OpenHarmony3.0上采用ets开发HAP控制LED灯

时间:2021-10-05 12:02:49

OpenHarmony3.0上采用ets开发HAP控制LED灯

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 。

OpenHarmony3.0上采用ets开发HAP控制LED灯

开发语言选择 “eTS”,可以注意到API Version仅支持7,说明是在OpenHarmony3中新支持的,也仅在OpenHarmony3中支持,这些功能实际上都是测试版本,稳定了之后就会在HarmonyOS中使用了,但目前还没有发布。

OpenHarmony3.0上采用ets开发HAP控制LED灯

工程创建完毕后,我直接在pages目录结构下右击新建了一个ets page,取名led。

OpenHarmony3.0上采用ets开发HAP控制LED灯

我们页面的样式、布局和控制全都在led.ets这个文件里了,不再像js分为css、hml和js三个文件。

Led.ets 文件内容

  1. import led from '@ohos.led'
  2. @Entry
  3. @Component
  4. struct Led {
  5. @State private imgpath: string = 'app.media.ledoff'
  6. @State private isShow: boolean= false
  7. build() {
  8. Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
  9. Text('LED 灯控制')
  10. .fontSize(25)
  11. .fontWeight(FontWeight.Bold)
  12. .margin({bottom: 30})
  13. Image($r('app.media.ledoff'))
  14. .objectFit(ImageFit.Contain)
  15. .width(150)
  16. .height(150)
  17. .visibility(this.isShow ? Visibility.None : Visibility.Visible)
  18. Image($r('app.media.ledon'))
  19. .objectFit(ImageFit.Contain)
  20. .width(150)
  21. .height(150)
  22. .visibility(this.isShow ? Visibility.Visible : Visibility.None)
  23. Flex({ alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceEvenly }) {
  24. Button('关闭', { type: ButtonType.Capsule, stateEffect: true }).backgroundColor(0x317aff).width(150).height(50).backgroundColor("#aaaaaa")
  25. .onClick((event: ClickEvent) => {
  26. this.isShow = false
  27. led.switchLed(19, 0);
  28. })
  29. Button('打开', { type: ButtonType.Capsule, stateEffect: true }).backgroundColor(0x317aff).width(150).height(50)
  30. .onClick((event: ClickEvent) => {
  31. this.isShow = true
  32. led.switchLed(19, 1);
  33. })
  34. }.width("100%")
  35. .margin({ top: 50 })
  36. }
  37. .width('100%')
  38. .height('100%')
  39. .padding(10)
  40. }
  41. }

放了两个图片,表示LED灯状态的,放在了代码的entry\src\main\resources\phone\media目录。

OpenHarmony3.0上采用ets开发HAP控制LED灯

导入的ohos.led 库,是自己添加的NAPI层的动态库,后面会继续介绍。

在config.json文件中,记得把led.ets放到js部分pages数组的第一位,因为它是要显示的首页面。

代码中使用了两个Button组件,一个打开,一个关闭,因为在ets中还没有类似js中的switch的组件,页面中有两个image组件,分别显示打开和关闭的图像,通过设置visibility属性来切换状态,本来想通过动态设置image的源来改变图像内容,但没找到有效的方法,应该是支持的,只是自己还没了解怎么用。

编译前记得一定要设置签名,否则编译出来的程序无法安装。

OpenHarmony3.0上采用ets开发HAP控制LED灯

最后可以编译程序了,

OpenHarmony3.0上采用ets开发HAP控制LED灯

生成的最终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,里面的文件也相应的修改名字,注意文件里调用也相应的修改成正确的名字,否则编译会报错。

OpenHarmony3.0上采用ets开发HAP控制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文件:

  1. import("//build/ohos.gni")
  2. ohos_shared_library("led") {
  3. include_dirs = [
  4. "//third_party/node/src",
  5. "//foundation/ace/napi/interfaces/kits",
  6. ]
  7. sources = [
  8. "led_javascript_class.cpp",
  9. "native_module_led.cpp",
  10. ]
  11. deps = [ "//foundation/ace/napi:ace_napi" ]
  12. relative_install_dir = "module"
  13. external_deps = [ "hiviewdfx_hilog_native:libhilog" ]
  14. subsystem_name = "ace"
  15. part_name = "napi"
  16. }

目录native_module_led下native_module_led.cpp文件修改部分摘要:

包含的头文件和宏定义,

  1. #include // standard library 标准库函数头文件
  2. #include // standard input output 标准输入输出函数
  3. #include // 定义了扩展的整数类型和宏
  4. #include // POSIX 系统 API 访问功能的头文件
  5. #include // unix标准中通用的头文件 define O_WRONLY and O_RDONLY
  6. // #include
  7. #define GPIO_DIR_IN (char*)"in"
  8. #define GPIO_DIR_OUT (char*)"out"
  9. #define GPIO_VAL_LOW 0
  10. #define GPIO_VAL_HIGH 1

添加函数SwitchLed的具体实现,

  1. static napi_value SwitchLed(napi_env env, napi_callback_info info)
  2. {
  3. HILOG_INFO("hey, SwitchLed - 0");
  4. size_t requireArgc = 2;
  5. size_t argc = 2;
  6. napi_value args[2] = { nullptr };
  7. NAPI_CALL(env, napi_get_cb_info(env, info, &argc, args, nullptr, nullptr));
  8. NAPI_ASSERT(env, argc >= requireArgc, "Wrong number of arguments");
  9. napi_valuetype valuetype0;
  10. NAPI_CALL(env, napi_typeof(env, args[0], &valuetype0));
  11. napi_valuetype valuetype1;
  12. NAPI_CALL(env, napi_typeof(env, args[1], &valuetype1));
  13. NAPI_ASSERT(env, valuetype0 == napi_number && valuetype1 == napi_number, "Wrong argument type. Numbers expected.");
  14. uint32_t gpio;
  15. NAPI_CALL(env, napi_get_value_uint32(env, args[0], &gpio));
  16. uint32_t val;
  17. NAPI_CALL(env, napi_get_value_uint32(env, args[1], &val));
  18. char direction[100] = {0};
  19. sprintf(direction,"echo out > /sys/class/gpio/gpio%d/direction", gpio);
  20. system(direction);
  21. char value[100] = {0};
  22. sprintf(value,"echo %d > /sys/class/gpio/gpio%d/value", val, gpio);
  23. system(value);
  24. napi_value sum;
  25. NAPI_CALL(env, napi_create_double(env, 1.0f, &sum));
  26. return sum;
  27. }

初始化部分,

  1. EXTERN_C_START
  2. /*
  3. * function for module exports
  4. */
  5. static napi_value Init(napi_env env, napi_value exports)
  6. {
  7. /*
  8. * Properties define
  9. */
  10. napi_property_descriptor desc[] = {
  11. DECLARE_NAPI_FUNCTION("add", Add),
  12. DECLARE_NAPI_FUNCTION("minus", Minus),
  13. DECLARE_NAPI_FUNCTION("switchLed", SwitchLed),
  14. DECLARE_NAPI_FUNCTION("TestPromise", TestPromise),
  15. DECLARE_NAPI_FUNCTION("TestPromiseOrAsyncCallback", TestPromiseOrAsyncCallback),
  16. };
  17. NAPI_CALL(env, napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc));
  18. DemoJavascriptClassInit(env, exports);
  19. return exports;
  20. }
  21. EXTERN_C_END

模块定义及注册,

  1. /*
  2. * Module define
  3. */
  4. static napi_module ledModule = {
  5. .nm_version = 1,
  6. .nm_flags = 0,
  7. .nm_filename = nullptr,
  8. .nm_register_func = Init,
  9. .nm_modname = "led",
  10. .nm_priv = ((void*)0),
  11. .reserved = { 0 },
  12. };
  13. /*
  14. * Module register function
  15. */
  16. extern "C" __attribute__((constructor)) void RegisterModule(void)
  17. {
  18. napi_module_register(&ledModule);
  19. }

目录napi下BUILD.gn文件,

  1. group("napi_packages_test") {
  2. testonly = true
  3. deps = [
  4. "sample/native_module_demo:demo",
  5. "sample/native_module_netserver:netserver",
  6. "sample/native_module_storage:storage",
  7. "test/unittest:unittest",
  8. "sample/native_module_led:led",
  9. ]
  10. if (is_standard_system) {
  11. deps += [ "sample/native_module_ability:ability" ]
  12. }
  13. }

最后在源码根目录下执行编译命令,

  1. $./build.sh --product-name Hi3516DV300 --build-target make_test

生成的文件为:

  1. out/ohos-arm-release/ace/napi/libled.z.so

5. 系统设置

需要授予应用访问gpio下export文件的权限,

device/hisilicon/hi3516dv300/build/rootfs/init.Hi3516DV300.cfg

  1. "name" : "boot",
  2. "cmds" : [
  3. "write /sys/class/gpio/export 19",
  4. "chmod 777 /sys/class/gpio/gpio19/direction",
  5. "chmod 777 /sys/class/gpio/gpio19/value",

6. 系统部署

6.1 拷贝动态库

生成的.z.so动态库已经拷贝到PC上E:\libled.z.so

PC串口控制台:

  1. #mount -o remount,rw /

PC命令窗口cmd:

  1. E:>hdc_std file send E:\libled.z.so /system/lib/module/

PC串口控制台:

  1. #chmod 666 /system/lib/module/libled.z.so

6.2 安装应用

PC命令窗口cmd:

  1. E:>hdc_std install E:\Projects\HarmonyProject\MyLed\build\outputs\hap\debug\phone\entry-debug-standard-ark-signed.hap

7. 应用测试

点击打开按钮,LED图标变绿,同时LED灯亮,

OpenHarmony3.0上采用ets开发HAP控制LED灯

点击关闭按钮,LED图标变灰,同时LED灯灭。

OpenHarmony3.0上采用ets开发HAP控制LED灯

8. 动图展示

OpenHarmony3.0上采用ets开发HAP控制LED灯

原文链接:https://harmonyos.51cto.com