OpenHarmony 平头哥玄铁架构 轻量系统移植—润和W800移植分享 - HarmonyOS技术社区 - 电子技术william hill官网 - 广受欢迎的专业电子william hill官网 - 威廉希尔官方网站
分享 收藏 返回

[文章]

OpenHarmony 平头哥玄铁架构 轻量系统移植—润和W800移植分享

本方案基于OpenHarmony LiteOS-M内核,使用联盛德W800芯片的润和软件海王星系列Neptune100开发板,进行开发移植。移植架构采用Board与SoC分离方案,支持通过Kconfig图形化配置编译选项,增加玄铁ck804ef架构移植,实现了HDF、XTS等子系统及组件的适配。

适配准备

准备ubuntu20.04系统环境,安装csky-abiv2-elf-gcc交叉编译工具链。

编译构建目录规划
本方案的目录结构使用Board和Soc解耦的思路:
芯片适配目录规划为:
  1. device
  2. ├── board                                --- 单板厂商目录
  3. │   └── hihope                           --- 单板厂商名字:HiHope
  4. │       └── neptune100                   --- 单板名:Neptune100
  5. └── soc                                  --- SoC厂商目录
  6.     └── winnermicro                      --- SoC厂商名字:联盛德
  7.         └── wm800                        --- SoC Series名:w800系列芯片
产品样例目录规划为:
  1. vendor
  2. └── hihope                               --- 开发产品样例厂商目录,润和软件的产品样例
  3.     ├── neptune_iotlink_demo             --- 产品名字:Neptune100产品样例代码
  4.     └── ...
产品定义
vendor/hihope/neptune_iotlink_demo/config.json文件下,描述了产品使用的内核、单板、子系统等信息。其中,内核、单板型号、单板厂商需提前规划好,是预编译指令hb set关注的。例如:

  1. {
  2.   "product_name": "neptune_iotlink_demo",   --- 产品名
  3.   "ohos_version": "OpenHarmony 3.1",        --- 使用的OS版本
  4.   "type":"mini",                            --- 系统类型: mini
  5.   "version": "3.0",                         --- 系统版本: 3.0
  6.   "device_company": "hihope",               --- 单板厂商:hihope
  7.   "board": "neptune100",                    --- 单板名:neptune100
  8.   "kernel_type": "liteos_m",                --- 内核类型:liteos_m
  9.   "kernel_version": "3.0.0",                --- 内核版本:3.0.0
  10.   "subsystems": []                          --- 子系统
  11. }



填入的信息与规划的目录相对应,其中device_company和board用于关联出device/board//目录。

单板配置关联到的目录下,在device/board/hihope/neptune100/liteos_m目录下放置config.gni文件,该配置文件用于描述该单板信息,包括CPU型号、交叉编译工具链及全局编译、链接参数等重要信息:
  1. # Kernel type, e.g. "linux", "liteos_a", "liteos_m".
  2. kernel_type = "liteos_m"

  3. # Kernel version.
  4. kernel_version = "3.0.0"

  5. # Board CPU type, e.g. "cortex-a7", "riscv32".
  6. board_cpu = "ck804ef"

  7. # Board arch, e.g.  "armv7-a", "rv32imac".
  8. board_arch = "ck803"

  9. # Toolchain name used for system compiling.
  10. # E.g. gcc-arm-none-eabi, arm-linux-harmonyeabi-gcc, ohos-clang,  riscv32-unknown-elf.
  11. # Note: The default toolchain is "ohos-clang". It's not mandatory if you use the default toolchain.
  12. board_toolchain = "csky-elfabiv2-gcc"

  13. #use_board_toolchain = true

  14. # The toolchain path installed, it's not mandatory if you have added toolchain path to your ~/.bashrc.
  15. board_toolchain_path = ""

  16. # Compiler prefix.
  17. board_toolchain_prefix = "csky-elfabiv2-"

  18. # Compiler type, "gcc" or "clang".
  19. board_toolchain_type = "gcc"

  20. # config.json parse
  21. if (product_path != "") {
  22.   product_conf = read_file("${product_path}/config.json", "json")
  23.   product_name = product_conf.product_name
  24.   bin_list = product_conf.bin_list
  25. }

  26. # Board related common compile flags.
  27. board_cflags = [
  28.   "-mcpu=ck804ef",
  29.   "-mhard-float",
  30.   "-DGCC_COMPILE=1",
  31.   "-DTLS_CONFIG_CPU_XT804=1",
  32.   "-DNIMBLE_FTR=1",
  33.   "-D__CSKY_V2__=1",
  34.   "-DCPU_CK804",
  35.   "-O2",
  36.   "-g3",
  37.   "-Wall",
  38.   "-ffunction-sections",
  39.   "-MMD",
  40.   "-MP",
  41. ]

  42. board_cxx_flags = board_cflags

  43. board_asmflags = [
  44.   "-mcpu=ck804ef",
  45.   "-DCPU_CK804",
  46. ]

  47. board_ld_flags = []

  48. # Board related headfiles search path.
  49. board_include_dirs = []

  50. # Board adapter dir for OHOS components.
  51. board_adapter_dir = ""

  52. # Sysroot path.
  53. board_configed_sysroot = ""

  54. # Board storage type, it used for file system generation.
  55. storage_type = ""



预编译在工程根目录下输入预编译指令hb set可显示相关产品信息,如下:
  1. hb set
  2. OHOS Which product do you need?  (Use arrow keys)

  3. hihope
  4. > neptune_iotlink_demo

  5. OHOS Which product do you need?  neptune_iotlink_demo



执行hb set后,会在根目录下自动生成ohos_config.json文件,文件中会列出待编译的产品信息。

通过hb env可以查看选择出来的预编译环境变量。
  1. [OHOS INFO] root path: /home/xxxx/openharmony_w800
  2. [OHOS INFO] board: neptune100
  3. [OHOS INFO] kernel: liteos_m
  4. [OHOS INFO] product: neptune_iotlink_demo
  5. [OHOS INFO] product path: /home/xxxx/openharmony_w800/vendor/hihope/neptune_iotlink_demo
  6. [OHOS INFO] device path: /home/xxxx/openharmony_w800/device/board/hihope/neptune100/liteos_m
  7. [OHOS INFO] device company: hihope



至此,预编译适配完成,但工程还不能执行hb build进行编译,还需要准备好后续的LiteOS-M内核移植。


内核移植Kconfig适配在kernel/liteos_m的编译中,需要在相应的单板以及SoC目录下使用Kconfig文件进行索引。
  • 在vendor/hihope/neptune_iotlink_demo目录下创建kernel_configs目录,并创建debug.config空文件。
  • 打开kernel/liteos_m/Kconfig文件,可以看到在该文件通过orsource命令导入了device/board和device/soc下多个Kconfig文件,后续需要创建并修改这些文件:
  1. orsource "../../device/board/*/Kconfig.liteos_m.shields"
  2. orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.defconfig.boards"
  3. orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.boards"
  4. orsource "../../device/soc/*/Kconfig.liteos_m.defconfig"
  5. orsource "../../device/soc/*/Kconfig.liteos_m.series"
  6. orsource "../../device/soc/*/Kconfig.liteos_m.soc"




在device/board/hihope下创建相应的的Kconfig文件:

  1. ├──  neptune100                                  --- neptune100单板配置目录
  2. │   ├── Kconfig.liteos_m.board                   --- 单板的配置选项
  3. │   ├── Kconfig.liteos_m.defconfig.board         --- 单板的默认配置项
  4. │   └── liteos_m
  5. │       └── config.gni                           --- 单板的配置文件
  6. ├── Kconfig.liteos_m.boards                      --- 单板厂商下Boards配置信息
  7. └── Kconfig.liteos_m.defconfig.boards            --- 单板厂商下Boards默认配置信息
  • 修改Board目录下Kconfig文件内容:
在 neptune100/Kconfig.liteos_m.board中添加,
  1. config BOARD_NEPTUNE100
  2.     bool "select board neptune100"
  3.     depends on SOC_WM800



配置只有SOC_WM800被选后,BOARD_NEPTUNE100才可被选。
在 neptune100/Kconfig.liteos_m.defconfig.board中添加,
  1. if BOARD_NEPTUNE100

  2. endif #BOARD_NEPTUNE100
用于添加 BOARD_NEPTUNE100默认配置
  • 在device/soc/winnermicro下创建相应的的Kconfig文件:
  1. ├── wm800                                        --- W800系列
  2. │   ├── Kconfig.liteos_m.defconfig.wm800         --- W800芯片默认配置
  3. │   ├── Kconfig.liteos_m.defconfig.series        --- W800系列默认配置
  4. │   ├── Kconfig.liteos_m.series                  --- W800系列配置
  5. │   └── Kconfig.liteos_m.soc                     --- W800芯片配置
  6. ├── Kconfig.liteos_m.defconfig                   --- SoC默认配置
  7. ├── Kconfig.liteos_m.series                      --- Series配置
  8. └── Kconfig.liteos_m.soc                         --- SoC配置
  • 修改Soc目录下Kconfig文件内容:
在wm800/Kconfig.liteos_m.defconfig.wm800中添加:

  1. config SOC
  2.     string
  3.     default "wm800"
  4.     depends on SOC_WM800



在wm800/Kconfig.liteos_m.defconfig.series中添加:
  1. if SOC_SERIES_WM800

  2. rsource "Kconfig.liteos_m.defconfig.wm800"

  3. config SOC_SERIES
  4.     string
  5.     default "wm800"

  6. endif



在 wm800/Kconfig.liteos_m.series中添加:

  1. config SOC_SERIES_WM800
  2.     bool "winnermicro 800 Series"
  3.     select ARM
  4.     select SOC_COMPANY_WINNERMICRO              --- 选择 SOC_COMPANY_WINNERMICRO
  5.     select CPU_XT804
  6.     help
  7.         Enable support for winnermicro 800 series



在选择了 SOC_SERIES_WM800之后,才可选 wm800/Kconfig.liteos_m.soc文件中的 SOC_WM800:

  1. choice
  2.     prompt "Winnermicro 800 series SoC"
  3.     depends on SOC_SERIES_WM800

  4. config SOC_WM800                         --- 选择 SOC_WM800
  5.     bool "SoC WM800"

  6. endchoice



综上所述,要编译单板BOARD_NEPTUNE100,则要分别选中:SOC_COMPANY_WINNERMICRO、SOC_SERIES_WM800、SOC_WM800 7. 在kernel/liteos_m中执行make menuconfig进行选择配置,能够对SoC Series进行选择:

配置后的文件会默认保存在vendor/hihope/neptune_iotlink_demo/kernel_configs/debug.config,也可以直接填写debug.config:
  1. LOSCFG_PLATFORM_QEMU_CSKY_SMARTL=y
  2. LOSCFG_SOC_SERIES_WM800=y
模块化编译
Board和SoC的编译采用模块化的编译方法,从kernel/liteos_m/BUILD.gn开始逐级向下递增。本方案的适配过程如下:
  • 在device/board/hihope中新建文件BUILD.gn,新增内容如下:

  1. if (ohos_kernel_type == "liteos_m") {
  2.   import("//kernel/liteos_m/liteos.gni")
  3.   module_name = get_path_info(rebase_path("."), "name")
  4.   module_group(module_name) {
  5.     modules = [
  6.       "neptune100",                     --- 单板模块
  7.       "shields",
  8.     ]
  9.   }
  10. }



  • 在上述BUILD.gn中,neptune100以及shields即是按目录层级组织的模块名。
  • 在device/soc/winnermicro中,新建文件BUILD.gn,按目录层级组织,新增内容如下:

  1. if (ohos_kernel_type == "liteos_m") {
  2.   import("//kernel/liteos_m/liteos.gni")
  3.   module_name = get_path_info(rebase_path("."), "name")
  4.   module_group(module_name) {
  5.     modules = [
  6.      "hals",
  7.      "wm800",
  8.     ]
  9.   }
  10. }


在device/soc/winnermicro各个层级模块下,同样新增文件BUILD.gn,将该层级模块加入编译。以device/soc/winnermicro/wm800/board/platform/sys/BUILD.gn为例:

  1. import("//kernel/liteos_m/liteos.gni")
  2. module_name = get_path_info(rebase_path("."), "name")
  3. kernel_module(module_name) {             --- 编译的模块
  4.   sources = [                            --- 编译的源文件
  5.     "wm_main.c",
  6.   ]
  7.   include_dirs = [                       --- 模块内使用到的头文件
  8.     ".",
  9.   ]
  10. }


为了组织链接以及一些编译选项,在device/soc/winnermicro/wm800/board/BUILD.gn下的config("board_config")填入了相应的参数:

  1. config("board_config") {
  2.   ldflags = []                            --- 链接参数,包括ld文件
  3.   libs = []                               --- 链接库
  4.   include_dirs = []                       --- 公共头文件


为了组织一些产品侧的应用,需要强制链接到产品工程中来,本方案在vendor相应的config.json加入了相应的list来组织,在vendor/hihope/neptune_iotlink_demo/config.json增加对应的list:

  1.  "bin_list": [                       --- demo list
  2.    {
  3.      "elf_name": "hihope",
  4.      "enable": "false",                 --- list开关
  5.      "force_link_libs": [
  6.        "bootstrap",
  7.        "broadcast",
  8.        ...
  9.      ]
  10.    }


将demo应用作为模块库来管理,开启/关闭某个demo,在bin_list中增减相应库文件即可。bin_list在gn中可以直接被读取,在device/board/hihope/neptune100/liteos_m/config.gni新增内容:

  1. # config.json parse
  2. if (product_path != "") {
  3.   product_conf = read_file("${product_path}/config.json", "json")
  4.   product_name = product_conf.product_name
  5.   bin_list = product_conf.bin_list
  6. }


读取list后即可在相应的链接选项上加入相关的组件库,在//device/soc/winnermicro/wm800/BUILD.gn添加内容:

  1. foreach(bin_file, bin_list) {
  2.    build_enable = bin_file.enable
  3.    ...
  4.    if(build_enable == "true")
  5.    {
  6.      ...
  7.      foreach(force_link_lib, bin_file.force_link_libs) {
  8.      ldflags += [ "-l${force_link_lib}" ]
  9.      }
  10.      ...
  11.    }
  12. }


内核子系统适配
在vendor/hihope/neptune_iotlink_demo/config.json添加内核子系统及相关配置,如下:

  1. "subsystems": [
  2. {
  3.    "subsystem": "kernel",
  4.    "components": [
  5.      { "component": "liteos_m", "features":[]
  6.      }
  7.    ]
  8. },


内核启动适配
由于Neptune100开发板的芯片架构为Openharmony不支持的ck804ef架构,需要进行ck804ef架构移植。适配 kernelliteos_marchinclude中定义的通用的文件以及函数列表,并放在了 kernelliteos_marchcskyv2ck804gcc文件夹下。
内核初始化示例如下:

  1. osStatus_t ret = osKernelInitialize();                    --- 内核初始化
  2. if(ret == osOK)
  3. {
  4. threadId = osThreadNew((osThreadFunc_t)sys_init,NULL,&g_main_task); --- 创建init线程
  5. if(threadId!=NULL)
  6. {
  7.      osKernelStart();                                          --- 线程调度
  8. }
  9. }


board_main在启动OHOS_SystemInit之前,需要初始化必要的动作,如下:
  1. ...
  2. UserMain();         --- 启动OpenHarmony  OHOS_SystemInit的之前完成驱动的初始化
  3. ...
  4. OHOS_SystemInit();  --- 启动OpenHarmony服务,以及组件初始化
  5. ...
UserMain函数在device/soc/winnermicro/wm800/board/app/main.c文件中,如下:

  1. ...
  2. if (DeviceManagerStart()) {                                      --- HDF初始化
  3.     printf("[%s] No drivers need load by hdf manager!",__func__);
  4. }
  5. ...


HDF驱动框架适配

HDF驱动框架提供了一套应用访问硬件的统一接口,可以简化应用开发,添加HDF组件需要在//vendor/hihope/neptune_iotlink_demo/kernel_configs添加:
  1. LOSCFG_DRIVERS_HDF=y
  2. LOSCFG_DRIVERS_HDF_PLATFORM=y
驱动适配相关文件放置在drivers/adapter/platform中,对应有gpio,i2c,pwm,spi,uart,watchdog,都是通过HDF机制加载,本章节以GPIO和UART为例进行详细说明。
GPIO适配
  • 芯片驱动适配文件位于drivers/adapter/platform目录,在gpio目录增加gpio_wm.c文件,在BUILD.gn文件中,描述了W800驱动的编译适配。如下:

  1. ...
  2. if (defined(LOSCFG_SOC_COMPANY_WINNERMICRO)) {
  3.   sources += [ "gpio_wm.c" ]
  4. }
  5. ...


gpio_wm.c中驱动描述文件如下:

  1. /* HdfDriverEntry definitions */
  2. struct HdfDriverEntry g_GpioDriverEntry = {
  3.     .moduleVersion = 1,
  4.     .moduleName = "WM_GPIO_MODULE_HDF",
  5.     .Bind = GpioDriverBind,
  6.     .Init = GpioDriverInit,
  7.     .Release = GpioDriverRelease,
  8. };
  9. HDF_INIT(g_GpioDriverEntry);


在device/board/hihope/shields/neptune100/neptune100.hcs添加gpio硬件描述信息, 添加内容如下:

  1. root {
  2.     platform {
  3.      gpio_config {
  4.          match_attr = "gpio_config";
  5.          groupNum = 1;
  6.          pinNum = 48;
  7.      }
  8.     }
  9. }


在GpioDriverInit获取hcs参数进行初始化,如下:

  1.  ...
  2. gpioCntlr = GpioCntlrFromHdfDev(device);        --- gpioCntlr节点变量获取具体gpio配置
  3. if (gpioCntlr == NULL) {
  4.      HDF_LOGE("GpioCntlrFromHdfDev fail
  5. ");
  6.      return HDF_DEV_ERR_NO_DEVICE_SERVICE;
  7. }
  8. ...


UART适配
  • 芯片驱动适配文件位于drivers/adapter/platform目录,在uart目录增加uart_wm.c文件,在BUILD.gn文件中,描述了W800驱动的编译适配。如下:


  1. ...
  2. if (defined(LOSCFG_SOC_COMPANY_WINNERMICRO)) {
  3.   sources += [ "uart_wm.c" ]
  4. }
  5. ...
uart_wm.c中驱动描述文件如下:
  1. /* HdfDriverEntry definitions */
  2. struct HdfDriverEntry g_UartDriverEntry = {
  3.     .moduleVersion = 1,
  4.     .moduleName = "W800_UART_MODULE_HDF",
  5.     .Bind = UartDriverBind,
  6.     .Init = UartDriverInit,
  7.     .Release = UartDriverRelease,
  8. };

  9. /* Initialize HdfDriverEntry */
  10. HDF_INIT(g_UartDriverEntry);
  • 在device/board/hihope/shields/neptune100/neptune100.hcs添加uart硬件描述信息, 添加内容如下:
  1. root {
  2.     platform {
  3.      uart_config {
  4.      /*
  5.          uart0 {
  6.              match_attr = "uart0_config";
  7.              num = 0;
  8.              baudrate = 115200;
  9.              parity = 0;
  10.              stopBit = 1;
  11.              data = 8;
  12.          }*/
  13.          uart1 {
  14.              match_attr = "uart1_config";
  15.              num = 1;
  16.              baudrate = 115200;
  17.              parity = 0;
  18.              stopBit = 1;
  19.              data = 8;
  20.          }
  21.       }
  22.    }
  23. }
在UartDriverInit获取hcs参数进行初始化,如下:
  1. ...
  2. host = UartHostFromDevice(device);
  3. if (host == NULL) {
  4.      HDF_LOGE("%s: host is NULL", __func__);
  5.      return HDF_ERR_INVALID_OBJECT;
  6. }
  7. ...
Openharmony子系统适配
子系统的编译选项入口在相应产品config.json下,如:vendor/hihope/neptune_iotlink_demo/config.json。

wifi_lite组件

首先,在config.json文件中,增加communication子系统的wifi_lite部件,如下:
  1. {
  2.   "subsystem": "communication",
  3.   "components": [
  4.     {
  5.       "component": "wifi_lite",
  6.       "optional": "true"
  7.     }
  8.   ]
  9. },
wifi_lite部件在 build/lite/components/communication.json文件中,描述如下:
  1. {
  2.   "component": "wifi_lite",
  3.   "targets": [
  4.     "//foundation/communication/wifi_lite:wifi"       --- wifi_lite的编译目标
  5.   ],
  6. },

在本案例中,wifi适配源码可见device/soc/winnermicro/wm800/board/src/wifi/wm_wifi.c,如下:
  1. int tls_wifi_netif_add_status_event(tls_wifi_netif_status_event_fn event_fn)   ---用于增加wifi事件功能
  2. {
  3.   u32 cpu_sr;
  4.   struct tls_wifi_netif_status_event *evt;
  5.   //if exist, remove from event list first.
  6.   tls_wifi_netif_remove_status_event(event_fn);
  7.   evt = tls_mem_alloc(sizeof(struct tls_wifi_netif_status_event));
  8.   if(evt==NULL)
  9.       return -1;
  10.   memset(evt, 0, sizeof(struct tls_wifi_netif_status_event));
  11.   evt->status_callback = event_fn;
  12.   cpu_sr = tls_os_set_critical();
  13.   dl_list_add_tail(&wifi_netif_status_event.list, &evt->list);
  14.   tls_os_release_critical(cpu_sr);

  15.   return 0;
  16. }
系统服务管理子系统适配

系统服务管理子系统适配添加samgr_lite部件,直接在config.json配置,如下:
  1. {
  2.   "subsystem": "distributedschedule",
  3.   "components": [
  4.     {
  5.       "component": "samgr_lite"
  6.     }
  7.   ]
  8. },
公共基础库子系统适配

公共基础库子系统适配添加了kv_store、file部件,直接在config.json配置,如下:
  1. {
  2.   "subsystem": "utils",
  3.   "components": [
  4.     {
  5.       "component": "kv_store",
  6.       "features": [
  7.         "enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true"
  8.       ]
  9.     },
  10.     { "component": "file", "features":[] }
  11.   ]
  12. },
适配kv_store部件时,键值对会写到文件中。在轻量系统中,文件操作相关接口有POSIX接口与HalFiles接口这两套实现。 因为对接内核的文件系统,采用POSIX相关的接口,所以features需要增加enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true。
启动恢复子系统适配

启动恢复子系统适配添加了bootstrap_lite、syspara_lite部件,直接在config.json配置,如下:
  1. {
  2.   "subsystem": "startup",
  3.   "components": [
  4.     {
  5.       "component": "bootstrap_lite"
  6.     },
  7.     {
  8.       "component": "syspara_lite",
  9.       "features": [
  10.         "enable_ohos_startup_syspara_lite_use_posix_file_api = true",
  11.         "config_ohos_startup_syspara_lite_data_path = "/data/""
  12.       ]
  13.     }
  14.   ]
  15. },
适配bootstrap_lite部件时,需要在链接脚本文件device/soc/winnermicro/wm800/board/ld/w800/gcc_csky.ld中手动新增如下段:
  1. .zinitcall_array :
  2. {
  3. . = ALIGN(0x4) ;
  4. PROVIDE_HIDDEN (__zinitcall_core_start = .);
  5. KEEP (*(SORT(.zinitcall.core*)))
  6. KEEP (*(.zinitcall.core*))
  7. PROVIDE_HIDDEN (__zinitcall_core_end = .);
  8. . = ALIGN(0x4) ;
  9. PROVIDE_HIDDEN (__zinitcall_device_start = .);
  10. KEEP (*(SORT(.zinitcall.device*)))
  11. KEEP (*(.zinitcall.device*))
  12. PROVIDE_HIDDEN (__zinitcall_device_end = .);
  13. . = ALIGN(0x4) ;
  14. PROVIDE_HIDDEN (__zinitcall_bsp_start = .);
  15. KEEP (*(SORT(.zinitcall.bsp*)))
  16. KEEP (*(.zinitcall.bsp*))
  17. PROVIDE_HIDDEN (__zinitcall_bsp_end = .);
  18. . = ALIGN(0x4) ;
  19. PROVIDE_HIDDEN (__zinitcall_sys_service_start = .);
  20. KEEP (*(SORT(.zinitcall.sys.service*)))
  21. KEEP (*(.zinitcall.sys.service*))
  22. PROVIDE_HIDDEN (__zinitcall_sys_service_end = .);
  23. . = ALIGN(0x4) ;
  24. PROVIDE_HIDDEN (__zinitcall_app_service_start = .);
  25. KEEP (*(SORT(.zinitcall.app.service*)))
  26. KEEP (*(.zinitcall.app.service*))
  27. PROVIDE_HIDDEN (__zinitcall_app_service_end = .);
  28. . = ALIGN(0x4) ;
  29. PROVIDE_HIDDEN (__zinitcall_sys_feature_start = .);
  30. KEEP (*(SORT(.zinitcall.sys.feature*)))
  31. KEEP (*(.zinitcall.sys.feature*))
  32. PROVIDE_HIDDEN (__zinitcall_sys_feature_end = .);
  33. . = ALIGN(0x4) ;
  34. PROVIDE_HIDDEN (__zinitcall_app_feature_start = .);
  35. KEEP (*(SORT(.zinitcall.app.feature*)))
  36. KEEP (*(.zinitcall.app.feature*))
  37. PROVIDE_HIDDEN (__zinitcall_app_feature_end = .);
  38. . = ALIGN(0x4) ;
  39. PROVIDE_HIDDEN (__zinitcall_run_start = .);
  40. KEEP (*(SORT(.zinitcall.run*)))
  41. KEEP (*(.zinitcall.run*))
  42. PROVIDE_HIDDEN (__zinitcall_run_end = .);
  43. . = ALIGN(0x4) ;
  44. PROVIDE_HIDDEN (__zinitcall_test_start = .);
  45. KEEP (*(SORT(.zinitcall.test*)))
  46. KEEP (*(.zinitcall.test*))
  47. PROVIDE_HIDDEN (__zinitcall_test_end = .);
  48. . = ALIGN(0x4) ;
  49. PROVIDE_HIDDEN (__zinitcall_exit_start = .);
  50. KEEP (*(SORT(.zinitcall.exit*)))
  51. KEEP (*(.zinitcall.exit*))
  52. PROVIDE_HIDDEN (__zinitcall_exit_end = .);
  53. } > REGION_RODATA
需要新增上述段是因为bootstrap_init提供的对外接口,见utils/native/lite/include/ohos_init.h文件,采用的是灌段的形式,最终会保存到上述链接段中。主要的服务自动初始化宏如下表格所示:

通过上面加载的组件编译出来的lib文件需要手动加入强制链接。
如在 vendor/hihope/neptune_iotlink_demo/config.json 中配置了bootstrap_lite 部件
  1. {
  2.   "subsystem": "startup",
  3.   "components": [
  4.     {
  5.       "component": "bootstrap_lite"
  6.     },
  7.     ...
  8.   ]
  9. },
​bootstrap_lite部件会编译base/startup/bootstrap_lite/services/source/bootstrap_service.c,该文件中,通过SYS_SERVICE_INIT将Init函数符号灌段到__zinitcall_sys_service_start和__zinitcall_sys_service_end中,由于Init函数是没有显式调用它,所以需要将它强制链接到最终的镜像。如下:

  1. static void Init(void)
  2. {
  3.     static Bootstrap bootstrap;
  4.     bootstrap.GetName = GetName;
  5.     bootstrap.Initialize = Initialize;
  6.     bootstrap.MessageHandle = MessageHandle;
  7.     bootstrap.GetTaskConfig = GetTaskConfig;
  8.     bootstrap.flag = FALSE;
  9.     SAMGR_GetInstance()->RegisterService((Service *)&bootstrap);
  10. }
  11. SYS_SERVICE_INIT(Init);   --- 通过SYS启动即SYS_INIT启动就需要强制链接生成的lib
​在base/startup/bootstrap_lite/services/source/BUILD.gn文件中,描述了在out/neptune100/neptune_iotlink_demo/libs 生成 libbootstrap.a,如下:
  1. static_library("bootstrap") {
  2.   sources = [
  3.     "bootstrap_service.c",
  4.     "system_init.c",
  5.   ]
  6.   ...

适配syspara_lite部件时,系统参数会最终写到文件中进行持久化保存。在轻量系统中,文件操作相关接口有POSIX接口与HalFiles接口这两套实现。

因为对接内核的文件系统,采用POSIX相关的接口,所以features字段中需要增加enable_ohos_startup_syspara_lite_use_posix_file_api = true。

XTS子系统适配

XTS子系统的适配,直接在config.json中加入组件选项:
  1. {
  2. "subsystem": "xts",
  3. "components": [
  4.    {
  5.      "component": "xts_acts",
  6.      "features":
  7.         [
  8.        "config_ohos_xts_acts_utils_lite_kv_store_data_path = "/data"",
  9.        "enable_ohos_test_xts_acts_use_thirdparty_lwip = true"
  10.      ]
  11.    },
  12.    { "component": "xts_tools", "features":[] }
  13. ]
  14. }
另外,XTS功能也使用了list来组织,在config.json文件中增减相应模块:
  1. "bin_list": [
  2.   {
  3.     "enable": "true",
  4.     "force_link_libs": [
  5.        "module_ActsParameterTest",
  6.        "module_ActsBootstrapTest",
  7.        "module_ActsDfxFuncTest",
  8.        "module_ActsHieventLiteTest",
  9.        "module_ActsSamgrTest",
  10.        "module_ActsUtilsFileTest",
  11.        "module_ActsKvStoreTest",
  12.        "module_ActsWifiServiceTest"
  13.     ]
  14.   }
  15. ],
其它组件的适配过程与官方以及其它厂商的过程类似,不再赘述。


回帖(3)

早知

2022-6-8 11:42:08
移植教程很详细,点个赞
1

北山独狼

2022-6-10 14:28:18
感谢楼主分享

早知

2022-6-22 17:38:54
很棒的内容,感谢分享

更多回帖

×
发帖