公共基础

简介

公共基础库存放OpenHarmony通用的基础组件。这些基础组件可被OpenHarmony各业务子系统及上层应用所使用。

公共基础库在不同平台上提供的能力：

  • LiteOS-M平台：KV存储、文件操作、定时器、IoT外设控制
  • LiteOS-A平台：KV存储、定时器、ACE JS API

目录

  1. utils/native/lite/          # 公共基础库根目录
  2. ├── file            # 文件接口实现
  3. ├── hals            # HAL目录
  4. │   └── file       # 文件操作硬件抽象层头文件
  5. ├── include         # 公共基础库对外接口文件
  6. ├── js                          # ACE JS API目录                 
  7. │   └── builtin                    
  8. │       ├── common
  9. │       ├── deviceinfokit       # 设备信息Kit
  10. │       ├── filekit             # 文件Kit
  11. │       └── kvstorekit          # KV存储Kit
  12. ├── kal             # KAL目录
  13. │   └── timer      # Timer的KAL实现
  14. ├── kv_store           # KV存储实现
  15. │   ├── innerkits   # KV存储内部接口
  16. │   └── src            # KV存储源文件
  17. └── timer_task       # Timer实现
  19. base/iot_hardware          #IoT外设控制
  20. ├── frameworks          
  21. │   └── wifiiot_lite   #IoT外设控制模块实现
  22. ├── hals
  23. │   └── wifiiot_lite   #HAL适配层接口
  24. └── interfaces
  25.     └── kits            #IoT外设控制模块接口
  27. vendor/hisi/hi3861/hi3861_adapter/hals/iot_hardware  #IoT外设控制HAL层
  28. └── wifiiot_lite       #HAL适配层接口实现

约束

公共基础库使用C语言开发。

表 1 公共基础库功能及约束

组件

平台支持

说明

约束

KV存储

LiteOS-M平台、LiteOS-A平台

为应用程序提供KV存储机制。

-

文件操作

LiteOS-M平台

提供统一的文件操作接口，屏蔽对底层不同芯片组件的差异。

-

定时器

LiteOS-M平台、LiteOS-A平台

提供统一的定时器操作接口，屏蔽对底层不同芯片组件的差异。

-

IoT外设控制

LiteOS-M平台

IoT外设控制模块提供对外围设备的操作能力。

   

使用

  • KV存储

    获取接口

    1. char key1[] = "rw.sys.version";
    2. char value1[32] = {0};
    3. int ret = UtilsGetValue(key1, value1, 32);
    4. 设置接口
    5. char key14[] = "key_14";
    6. ret = UtilsSetValue(key14, defValue);

  • 文件操作

    1. // open && write
    2. char fileName[] = "testfile";
    3. int fd = UtilsFileOpen(fileName, O_RDWR_FS | O_CREAT_FS | O_TRUNC_FS, 0);
    4. printf("file handle = %d\n", fd);
    5. int ret = UtilsFileWrite(fd, def, strlen(def));
    6. printf("write ret = %d\n", ret);
    7. // stat
    8. int fileLen = 0;
    9. ret = UtilsFileStat(fileName, &fileLen);
    10. printf("file size = %d\n", fileLen);
    11. // seek
    12. int fd1 = UtilsFileOpen(fileName, O_RDWR_FS, 0);
    13. ret = UtilsFileSeek(fd1, 5, SEEK_SET_FS);
    14. printf("lseek ret = %d\n", ret);
    15. char buf[32] = {0};
    16. int readLen = UtilsFileRead(fd1, buf, 32);
    17. ret = UtilsFileClose(fd1);
    18. printf("read len = %d : buf = %s\n", readLen, buf);
    19. // delete
    20. ret = UtilsFileDelete(fileName);
    21. printf("delete ret = %d\n", ret);

涉及仓

iothardware_frameworks_wifiiot_lite

iothardware_hals_wifiiot_lite

iothardware_interfaces_kits_wifiiot_lite

utils_native_lite