1 2# Combo解决方案之W800芯片移植案例 3 4本方案基于OpenHarmony LiteOS-M内核，使用联盛德W800芯片的润和软件海王星系列[Neptune100开发板](https://gitee.com/openharmony-sig/device_board_hihope)，进行开发移植。移植架构采用`Board`与`SoC`分离方案，支持通过Kconfig图形化配置编译选项，增加玄铁`ck804ef`架构移植，实现了`HDF`、`XTS`等子系统及组件的适配。 5 6## 适配准备 7 8准备ubuntu20.04系统环境，安装[csky-abiv2-elf-gcc](https://occ.t-head.cn/community/download?id=3885366095506644992)交叉编译工具链。 9 10## 编译构建 11 12### 目录规划 13 14本方案的目录结构使用[Board和Soc解耦的思路](https://gitee.com/openharmony-sig/sig-content/blob/master/devboard/docs/board-soc-arch-design.md)： 15 16芯片适配目录规划为： 17 ``` 18 device 19 ├── board --- 单板厂商目录 20 │ └── hihope --- 单板厂商名字：HiHope 21 │ └── neptune100 --- 单板名：Neptune100 22 └── soc --- SoC厂商目录 23 └── winnermicro --- SoC厂商名字：联盛德 24 └── wm800 --- SoC Series名：w800系列芯片 25 ``` 26 27产品样例目录规划为： 28 29 ``` 30 vendor 31 └── hihope --- 开发产品样例厂商目录，润和软件的产品样例 32 ├── neptune_iotlink_demo --- 产品名字：Neptune100产品样例代码 33 └── ... 34 ``` 35 36### 产品定义 37 38`vendor/hihope/neptune_iotlink_demo/config.json`文件下，描述了产品使用的内核、单板、子系统等信息。其中，内核、单板型号、单板厂商需提前规划好，是预编译指令`hb set`关注的。例如： 39 40 ``` 41 { 42 "product_name": "neptune_iotlink_demo", --- 产品名 43 "ohos_version": "OpenHarmony 3.1", --- 使用的OS版本 44 "type":"mini", --- 系统类型: mini 45 "version": "3.0", --- 系统版本: 3.0 46 "device_company": "hihope", --- 单板厂商：hihope 47 "board": "neptune100", --- 单板名：neptune100 48 "kernel_type": "liteos_m", --- 内核类型：liteos_m 49 "kernel_version": "3.0.0", --- 内核版本：3.0.0 50 "subsystems": [] --- 子系统 51 } 52 ``` 53填入的信息与规划的目录相对应，其中`device_company`和`board`用于关联出`device/board/<device_company>/`目录。 54 55### 单板配置 56 57关联到的<board>目录下，在`device/board/hihope/neptune100/liteos_m`目录下放置`config.gni`文件，该配置文件用于描述该单板信息，包括CPU型号、交叉编译工具链及全局编译、链接参数等重要信息： 58 59``` 60# Kernel type, e.g. "linux", "liteos_a", "liteos_m". 61kernel_type = "liteos_m" 62 63# Kernel version. 64kernel_version = "3.0.0" 65 66# Board CPU type, e.g. "cortex-a7", "riscv32". 67board_cpu = "ck804ef" 68 69# Board arch, e.g. "armv7-a", "rv32imac". 70board_arch = "ck803" 71 72# Toolchain name used for system compiling. 73# E.g. gcc-arm-none-eabi, arm-linux-harmonyeabi-gcc, ohos-clang, riscv32-unknown-elf. 74# Note: The default toolchain is "ohos-clang". It's not mandatory if you use the default toolchain. 75board_toolchain = "csky-elfabiv2-gcc" 76 77#use_board_toolchain = true 78 79# The toolchain path installed, it's not mandatory if you have added toolchain path to your ~/.bashrc. 80board_toolchain_path = "" 81 82# Compiler prefix. 83board_toolchain_prefix = "csky-elfabiv2-" 84 85# Compiler type, "gcc" or "clang". 86board_toolchain_type = "gcc" 87 88# config.json parse 89if (product_path != "") { 90 product_conf = read_file("${product_path}/config.json", "json") 91 product_name = product_conf.product_name 92 bin_list = product_conf.bin_list 93} 94 95# Board related common compile flags. 96board_cflags = [ 97 "-mcpu=ck804ef", 98 "-mhard-float", 99 "-DGCC_COMPILE=1", 100 "-DTLS_CONFIG_CPU_XT804=1", 101 "-DNIMBLE_FTR=1", 102 "-D__CSKY_V2__=1", 103 "-DCPU_CK804", 104 "-O2", 105 "-g3", 106 "-Wall", 107 "-ffunction-sections", 108 "-MMD", 109 "-MP", 110] 111 112board_cxx_flags = board_cflags 113 114board_asmflags = [ 115 "-mcpu=ck804ef", 116 "-DCPU_CK804", 117] 118 119board_ld_flags = [] 120 121# Board related headfiles search path. 122board_include_dirs = [] 123 124# Board adapter dir for OHOS components. 125board_adapter_dir = "" 126 127# Sysroot path. 128board_configed_sysroot = "" 129 130# Board storage type, it used for file system generation. 131storage_type = "" 132``` 133 134### 预编译 135 136在工程根目录下输入预编译指令`hb set`可显示相关产品信息，如下： 137 138``` 139hb set 140OHOS Which product do you need? (Use arrow keys) 141 142hihope 143 > neptune_iotlink_demo 144 145OHOS Which product do you need? neptune_iotlink_demo 146``` 147 148执行`hb set`后，会在根目录下自动生成`ohos_config.json`文件，文件中会列出待编译的产品信息。 149 150通过`hb env`可以查看选择出来的预编译环境变量。 151 152``` 153[OHOS INFO] root path: /home/xxxx/openharmony_w800 154[OHOS INFO] board: neptune100 155[OHOS INFO] kernel: liteos_m 156[OHOS INFO] product: neptune_iotlink_demo 157[OHOS INFO] product path: /home/xxxx/openharmony_w800/vendor/hihope/neptune_iotlink_demo 158[OHOS INFO] device path: /home/xxxx/openharmony_w800/device/board/hihope/neptune100/liteos_m 159[OHOS INFO] device company: hihope 160``` 161 162至此，预编译适配完成，但工程还不能执行hb build进行编译，还需要准备好后续的LiteOS-M内核移植。 163 164## 内核移植 165 166### Kconfig适配 167 168在`kernel/liteos_m`的编译中，需要在相应的单板以及SoC目录下使用`Kconfig`文件进行索引。 169 1701. 在`vendor/hihope/neptune_iotlink_demo`目录下创建kernel_configs目录，并创建`debug.config`空文件。 171 1722. 打开`kernel/liteos_m/Kconfig`文件，可以看到在该文件通过orsource命令导入了`device/board`和`device/soc`下多个`Kconfig`文件，后续需要创建并修改这些文件： 173 174 ``` 175 orsource "../../device/board/*/Kconfig.liteos_m.shields" 176 orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.defconfig.boards" 177 orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.boards" 178 orsource "../../device/soc/*/Kconfig.liteos_m.defconfig" 179 orsource "../../device/soc/*/Kconfig.liteos_m.series" 180 orsource "../../device/soc/*/Kconfig.liteos_m.soc" 181 ``` 182 1833. 在`device/board/hihope`下创建相应的的`Kconfig`文件： 184 185 ``` 186 ├── neptune100 --- neptune100单板配置目录 187 │ ├── Kconfig.liteos_m.board --- 单板的配置选项 188 │ ├── Kconfig.liteos_m.defconfig.board --- 单板的默认配置项 189 │ └── liteos_m 190 │ └── config.gni --- 单板的配置文件 191 ├── Kconfig.liteos_m.boards --- 单板厂商下Boards配置信息 192 └── Kconfig.liteos_m.defconfig.boards --- 单板厂商下Boards默认配置信息 193 ``` 194 1954. 修改`Board`目录下`Kconfig`文件内容： 196 197 在 `neptune100/Kconfig.liteos_m.board`中添加， 198 199 ``` 200 config BOARD_NEPTUNE100 201 bool "select board neptune100" 202 depends on SOC_WM800 203 ``` 204 205 配置只有SOC_WM800被选后，BOARD_NEPTUNE100才可被选。 206 207 在 `neptune100/Kconfig.liteos_m.defconfig.board`中添加， 208 209 ``` 210 if BOARD_NEPTUNE100 211 212 endif #BOARD_NEPTUNE100 213 ``` 214 215 用于添加 BOARD_NEPTUNE100默认配置 216 2175. 在`device/soc/winnermicro`下创建相应的的`Kconfig`文件： 218 219 ``` 220 ├── wm800 --- W800系列 221 │ ├── Kconfig.liteos_m.defconfig.wm800 --- W800芯片默认配置 222 │ ├── Kconfig.liteos_m.defconfig.series --- W800系列默认配置 223 │ ├── Kconfig.liteos_m.series --- W800系列配置 224 │ └── Kconfig.liteos_m.soc --- W800芯片配置 225 ├── Kconfig.liteos_m.defconfig --- SoC默认配置 226 ├── Kconfig.liteos_m.series --- Series配置 227 └── Kconfig.liteos_m.soc --- SoC配置 228 ``` 229 2306. 修改`Soc`目录下`Kconfig`文件内容： 231 232 在`wm800/Kconfig.liteos_m.defconfig.wm800`中添加： 233 234 ``` 235 config SOC 236 string 237 default "wm800" 238 depends on SOC_WM800 239 ``` 240 241 在`wm800/Kconfig.liteos_m.defconfig.series`中添加： 242 243 ``` 244 if SOC_SERIES_WM800 245 246 rsource "Kconfig.liteos_m.defconfig.wm800" 247 248 config SOC_SERIES 249 string 250 default "wm800" 251 252 endif 253 ``` 254 255 在 `wm800/Kconfig.liteos_m.series`中添加： 256 257 ``` 258 config SOC_SERIES_WM800 259 bool "winnermicro 800 Series" 260 select ARM 261 select SOC_COMPANY_WINNERMICRO --- 选择 SOC_COMPANY_WINNERMICRO 262 select CPU_XT804 263 help 264 Enable support for winnermicro 800 series 265 ``` 266 267 在选择了 SOC_SERIES_WM800之后，才可选 `wm800/Kconfig.liteos_m.soc`文件中的 SOC_WM800： 268 269 ``` 270 choice 271 prompt "Winnermicro 800 series SoC" 272 depends on SOC_SERIES_WM800 273 274 config SOC_WM800 --- 选择 SOC_WM800 275 bool "SoC WM800" 276 277 endchoice 278 ``` 279 280 综上所述，要编译单板BOARD_NEPTUNE100，则要分别选中：SOC_COMPANY_WINNERMICRO、SOC_SERIES_WM800、SOC_WM800 2817. 在`kernel/liteos_m`中执行`make menuconfig`进行选择配置,能够对SoC Series进行选择： 282 283  284 285 配置后的文件会默认保存在`vendor/hihope/neptune_iotlink_demo/kernel_configs/debug.config`,也可以直接填写`debug.config`： 286 287 ``` 288 LOSCFG_PLATFORM_QEMU_CSKY_SMARTL=y 289 LOSCFG_SOC_SERIES_WM800=y 290 ``` 291 292### 模块化编译 293 294`Board`和`SoC`的编译采用模块化的编译方法，从`kernel/liteos_m/BUILD.gn`开始逐级向下递增。本方案的适配过程如下： 295 2961. 在`device/board/hihope`中新建文件`BUILD.gn`，新增内容如下： 297 298 ``` 299 if (ohos_kernel_type == "liteos_m") { 300 import("//kernel/liteos_m/liteos.gni") 301 module_name = get_path_info(rebase_path("."), "name") 302 module_group(module_name) { 303 modules = [ 304 "neptune100", --- 单板模块 305 "shields", 306 ] 307 } 308 } 309 ``` 310 311 在上述`BUILD.gn`中，neptune100以及shields即是按目录层级组织的模块名。 312 3132. 在`device/soc/winnermicro`中，新建文件`BUILD.gn`，按目录层级组织，新增内容如下： 314 315 ``` 316 if (ohos_kernel_type == "liteos_m") { 317 import("//kernel/liteos_m/liteos.gni") 318 module_name = get_path_info(rebase_path("."), "name") 319 module_group(module_name) { 320 modules = [ 321 "hals", 322 "wm800", 323 ] 324 } 325 } 326 ``` 327 3283. 在`device/soc/winnermicro`各个层级模块下，同样新增文件`BUILD.gn`，将该层级模块加入编译。以`device/soc/winnermicro/wm800/board/platform/sys/BUILD.gn`为例： 329 330 ``` 331 import("//kernel/liteos_m/liteos.gni") 332 module_name = get_path_info(rebase_path("."), "name") 333 kernel_module(module_name) { --- 编译的模块 334 sources = [ --- 编译的源文件 335 "wm_main.c", 336 ] 337 include_dirs = [ --- 模块内使用到的头文件 338 ".", 339 ] 340 } 341 342 ``` 343 3444. 为了组织链接以及一些编译选项，在`device/soc/winnermicro/wm800/board/BUILD.gn`下的`config("board_config")`填入了相应的参数： 345 346 ``` 347 config("board_config") { 348 ldflags = [] --- 链接参数，包括ld文件 349 libs = [] --- 链接库 350 include_dirs = [] --- 公共头文件 351 ``` 352 353 3545. 为了组织一些产品侧的应用，需要强制链接到产品工程中来，本方案在vendor相应的`config.json`加入了相应的list来组织，在`vendor/hihope/neptune_iotlink_demo/config.json`增加对应的list： 355 356 ``` 357 "bin_list": [ --- demo list 358 { 359 "elf_name": "hihope", 360 "enable": "false", --- list开关 361 "force_link_libs": [ 362 "bootstrap", 363 "broadcast", 364 ... 365 ] 366 } 367 ``` 368 369 将demo应用作为模块库来管理，开启/关闭某个demo，在bin_list中增减相应库文件即可。bin_list在gn中可以直接被读取，在`device/board/hihope/neptune100/liteos_m/config.gni`新增内容： 370 371 ``` 372 # config.json parse 373 if (product_path != "") { 374 product_conf = read_file("${product_path}/config.json", "json") 375 product_name = product_conf.product_name 376 bin_list = product_conf.bin_list 377 } 378 ``` 379 380 读取list后即可在相应的链接选项上加入相关的组件库，在`//device/soc/winnermicro/wm800/BUILD.gn`添加内容： 381 382 ``` 383 foreach(bin_file, bin_list) { 384 build_enable = bin_file.enable 385 ... 386 if(build_enable == "true") 387 { 388 ... 389 foreach(force_link_lib, bin_file.force_link_libs) { 390 ldflags += [ "-l${force_link_lib}" ] 391 } 392 ... 393 } 394 } 395 ``` 396 397### 内核子系统适配 398 399在`vendor/hihope/neptune_iotlink_demo/config.json`添加内核子系统及相关配置，如下： 400 401 ``` 402 "subsystems": [ 403 { 404 "subsystem": "kernel", 405 "components": [ 406 { 407 "component": "liteos_m", "features":[] 408 } 409 ] 410 }, 411 ``` 412 413### 内核启动适配 414 415由于Neptune100开发板的芯片架构为OpenHarmony不支持的ck804ef架构，需要进行ck804ef架构移植。适配 `kernel\liteos_m\arch\include`中定义的通用的文件以及函数列表，并放在了 `kernel\liteos_m\arch\csky\v2\ck804\gcc`文件夹下。 416 417内核初始化示例如下: 418 419 ``` 420 osStatus_t ret = osKernelInitialize(); --- 内核初始化 421 if(ret == osOK) 422 { 423 threadId = osThreadNew((osThreadFunc_t)sys_init,NULL,&g_main_task); --- 创建init线程 424 if(threadId!=NULL) 425 { 426 osKernelStart(); --- 线程调度 427 } 428 } 429 ``` 430 431board_main在启动OHOS_SystemInit之前，需要初始化必要的动作，如下： 432 433 ``` 434 ... 435 UserMain(); --- 启动OpenHarmony OHOS_SystemInit的之前完成驱动的初始化 436 ... 437 OHOS_SystemInit(); --- 启动OpenHarmony服务，以及组件初始化 438 ... 439 ``` 440 441UserMain函数在`device/soc/winnermicro/wm800/board/app/main.c`文件中，如下： 442 443 ``` 444 ... 445 if (DeviceManagerStart()) { --- HDF初始化 446 printf("[%s] No drivers need load by hdf manager!",__func__); 447 } 448 ... 449 ``` 450 451### HDF驱动框架适配 452 453HDF驱动框架提供了一套应用访问硬件的统一接口，可以简化应用开发，添加HDF组件需要在`//vendor/hihope/neptune_iotlink_demo/kernel_configs`添加： 454 455 ``` 456 LOSCFG_DRIVERS_HDF=y 457 LOSCFG_DRIVERS_HDF_PLATFORM=y 458 ``` 459 460驱动适配相关文件放置在`drivers/adapter/platform`中，对应有gpio，i2c，pwm，spi，uart，watchdog，都是通过HDF机制加载，本章节以GPIO和UART为例进行详细说明。 461 462#### GPIO适配 463 4641. 芯片驱动适配文件位于`drivers/adapter/platform`目录，在gpio目录增加`gpio_wm.c`文件，在`BUILD.gn`文件中，描述了W800驱动的编译适配。如下： 465 466 ``` 467 ... 468 if (defined(LOSCFG_SOC_COMPANY_WINNERMICRO)) { 469 sources += [ "gpio_wm.c" ] 470 } 471 ... 472 ``` 473 4742. `gpio_wm.c`中驱动描述文件如下： 475 476 ``` 477 /* HdfDriverEntry definitions */ 478 struct HdfDriverEntry g_GpioDriverEntry = { 479 .moduleVersion = 1, 480 .moduleName = "WM_GPIO_MODULE_HDF", 481 .Bind = GpioDriverBind, 482 .Init = GpioDriverInit, 483 .Release = GpioDriverRelease, 484 }; 485 HDF_INIT(g_GpioDriverEntry); 486 ``` 487 4883. 在`device/board/hihope/shields/neptune100/neptune100.hcs`添加gpio硬件描述信息, 添加内容如下： 489 490 ``` 491 root { 492 platform { 493 gpio_config { 494 match_attr = "gpio_config"; 495 groupNum = 1; 496 pinNum = 48; 497 } 498 } 499 } 500 ``` 501 5024. 在GpioDriverInit获取hcs参数进行初始化，如下： 503 504 ``` 505 ... 506 gpioCntlr = GpioCntlrFromHdfDev(device); --- gpioCntlr节点变量获取具体gpio配置 507 if (gpioCntlr == NULL) { 508 HDF_LOGE("GpioCntlrFromHdfDev fail\r\n"); 509 return HDF_DEV_ERR_NO_DEVICE_SERVICE; 510 } 511 ... 512 ``` 513 514#### UART适配 515 5161. 芯片驱动适配文件位于`drivers/adapter/platform`目录，在uart目录增加`uart_wm.c`文件，在`BUILD.gn`文件中，描述了W800驱动的编译适配。如下： 517 518 ``` 519 ... 520 if (defined(LOSCFG_SOC_COMPANY_WINNERMICRO)) { 521 sources += [ "uart_wm.c" ] 522 } 523 ... 524 ``` 525 5262. `uart_wm.c`中驱动描述文件如下： 527 528 ``` 529 /* HdfDriverEntry definitions */ 530 struct HdfDriverEntry g_UartDriverEntry = { 531 .moduleVersion = 1, 532 .moduleName = "W800_UART_MODULE_HDF", 533 .Bind = UartDriverBind, 534 .Init = UartDriverInit, 535 .Release = UartDriverRelease, 536 }; 537 538 /* Initialize HdfDriverEntry */ 539 HDF_INIT(g_UartDriverEntry); 540 ``` 541 5423. 在`device/board/hihope/shields/neptune100/neptune100.hcs`添加uart硬件描述信息, 添加内容如下： 543 544 ``` 545 root { 546 platform { 547 uart_config { 548 /* 549 uart0 { 550 match_attr = "uart0_config"; 551 num = 0; 552 baudrate = 115200; 553 parity = 0; 554 stopBit = 1; 555 data = 8; 556 }*/ 557 uart1 { 558 match_attr = "uart1_config"; 559 num = 1; 560 baudrate = 115200; 561 parity = 0; 562 stopBit = 1; 563 data = 8; 564 } 565 } 566 } 567 } 568 ``` 569 5704. 在UartDriverInit获取hcs参数进行初始化，如下： 571 572 ``` 573 ... 574 host = UartHostFromDevice(device); 575 if (host == NULL) { 576 HDF_LOGE("%s: host is NULL", __func__); 577 return HDF_ERR_INVALID_OBJECT; 578 } 579 ... 580 ``` 581 582## OpenHarmony子系统适配 583 584子系统的编译选项入口在相应产品`config.json`下，如：`vendor/hihope/neptune_iotlink_demo/config.json`。 585 586### wifi_lite组件 587 588首先，在`config.json`文件中，增加`communication`子系统的`wifi_lite`部件，如下： 589 590 ``` 591 { 592 "subsystem": "communication", 593 "components": [ 594 { 595 "component": "wifi_lite", 596 "optional": "true" 597 } 598 ] 599 }, 600 ``` 601 602`wifi_lite`部件在 `build/lite/components/communication.json`文件中，描述如下： 603 604 ``` 605 { 606 "component": "wifi_lite", 607 "targets": [ 608 "//foundation/communication/wifi_lite:wifi" --- wifi_lite的编译目标 609 ] 610 }, 611 ``` 612 613在本案例中，`wifi`适配源码可见`device/soc/winnermicro/wm800/board/src/wifi/wm_wifi.c`,如下： 614 615 ``` 616 int tls_wifi_netif_add_status_event(tls_wifi_netif_status_event_fn event_fn) ---用于增加wifi事件功能 617 { 618 u32 cpu_sr; 619 struct tls_wifi_netif_status_event *evt; 620 //if exist, remove from event list first. 621 tls_wifi_netif_remove_status_event(event_fn); 622 evt = tls_mem_alloc(sizeof(struct tls_wifi_netif_status_event)); 623 if(evt==NULL) 624 return -1; 625 memset(evt, 0, sizeof(struct tls_wifi_netif_status_event)); 626 evt->status_callback = event_fn; 627 cpu_sr = tls_os_set_critical(); 628 dl_list_add_tail(&wifi_netif_status_event.list, &evt->list); 629 tls_os_release_critical(cpu_sr); 630 631 return 0; 632 } 633 ``` 634 635### 系统服务管理子系统适配 636系统服务管理子系统适配添加`samgr_lite`部件，直接在`config.json`配置，如下： 637 638 ``` 639 { 640 "subsystem": "systemabilitymgr", 641 "components": [ 642 { 643 "component": "samgr_lite" 644 } 645 ] 646 }, 647 ``` 648 649### 公共基础库子系统适配 650 651公共基础库子系统适配添加了`kv_store、file`部件，直接在`config.json`配置，如下： 652 653 ``` 654 { 655 "subsystem": "utils", 656 "components": [ 657 { 658 "component": "kv_store", 659 "features": [ 660 "enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true" 661 ] 662 }, 663 { "component": "file", "features":[] } 664 ] 665 }, 666 ``` 667 668适配`kv_store`部件时，键值对会写到文件中。在轻量系统中，文件操作相关接口有`POSIX`接口与`HalFiles`接口这两套实现。 669因为对接内核的文件系统，采用`POSIX`相关的接口，所以`features`需要增加`enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true`。 670 671### 启动恢复子系统适配 672 673启动恢复子系统适配添加了`bootstrap_lite、syspara_lite`部件，直接在`config.json`配置，如下： 674 675 ``` 676 { 677 "subsystem": "startup", 678 "components": [ 679 { 680 "component": "bootstrap_lite" 681 }, 682 { 683 "component": "syspara_lite", 684 "features": [ 685 "enable_ohos_startup_syspara_lite_use_posix_file_api = true", 686 "config_ohos_startup_syspara_lite_data_path = \"/data/\"" 687 ] 688 } 689 ] 690 }, 691 ``` 692 693适配bootstrap_lite部件时，需要在链接脚本文件`device/soc/winnermicro/wm800/board/ld/w800/gcc_csky.ld`中手动新增如下段： 694 695 ``` 696 .zinitcall_array : 697 { 698 . = ALIGN(0x4) ; 699 PROVIDE_HIDDEN (__zinitcall_core_start = .); 700 KEEP (*(SORT(.zinitcall.core*))) 701 KEEP (*(.zinitcall.core*)) 702 PROVIDE_HIDDEN (__zinitcall_core_end = .); 703 . = ALIGN(0x4) ; 704 PROVIDE_HIDDEN (__zinitcall_device_start = .); 705 KEEP (*(SORT(.zinitcall.device*))) 706 KEEP (*(.zinitcall.device*)) 707 PROVIDE_HIDDEN (__zinitcall_device_end = .); 708 . = ALIGN(0x4) ; 709 PROVIDE_HIDDEN (__zinitcall_bsp_start = .); 710 KEEP (*(SORT(.zinitcall.bsp*))) 711 KEEP (*(.zinitcall.bsp*)) 712 PROVIDE_HIDDEN (__zinitcall_bsp_end = .); 713 . = ALIGN(0x4) ; 714 PROVIDE_HIDDEN (__zinitcall_sys_service_start = .); 715 KEEP (*(SORT(.zinitcall.sys.service*))) 716 KEEP (*(.zinitcall.sys.service*)) 717 PROVIDE_HIDDEN (__zinitcall_sys_service_end = .); 718 . = ALIGN(0x4) ; 719 PROVIDE_HIDDEN (__zinitcall_app_service_start = .); 720 KEEP (*(SORT(.zinitcall.app.service*))) 721 KEEP (*(.zinitcall.app.service*)) 722 PROVIDE_HIDDEN (__zinitcall_app_service_end = .); 723 . = ALIGN(0x4) ; 724 PROVIDE_HIDDEN (__zinitcall_sys_feature_start = .); 725 KEEP (*(SORT(.zinitcall.sys.feature*))) 726 KEEP (*(.zinitcall.sys.feature*)) 727 PROVIDE_HIDDEN (__zinitcall_sys_feature_end = .); 728 . = ALIGN(0x4) ; 729 PROVIDE_HIDDEN (__zinitcall_app_feature_start = .); 730 KEEP (*(SORT(.zinitcall.app.feature*))) 731 KEEP (*(.zinitcall.app.feature*)) 732 PROVIDE_HIDDEN (__zinitcall_app_feature_end = .); 733 . = ALIGN(0x4) ; 734 PROVIDE_HIDDEN (__zinitcall_run_start = .); 735 KEEP (*(SORT(.zinitcall.run*))) 736 KEEP (*(.zinitcall.run*)) 737 PROVIDE_HIDDEN (__zinitcall_run_end = .); 738 . = ALIGN(0x4) ; 739 PROVIDE_HIDDEN (__zinitcall_test_start = .); 740 KEEP (*(SORT(.zinitcall.test*))) 741 KEEP (*(.zinitcall.test*)) 742 PROVIDE_HIDDEN (__zinitcall_test_end = .); 743 . = ALIGN(0x4) ; 744 PROVIDE_HIDDEN (__zinitcall_exit_start = .); 745 KEEP (*(SORT(.zinitcall.exit*))) 746 KEEP (*(.zinitcall.exit*)) 747 PROVIDE_HIDDEN (__zinitcall_exit_end = .); 748 } > REGION_RODATA 749 ``` 750 751需要新增上述段是因为`bootstrap_init`提供的对外接口，见`utils/native/lite/include/ohos_init.h`文件，采用的是灌段的形式，最终会保存到上述链接段中。主要的服务自动初始化宏如下表格所示： 752 753| 接口名 | 描述 | 754| ---------------------- | -------------------------------- | 755| SYS_SERVICE_INIT(func) | 标识核心系统服务的初始化启动入口 | 756| SYS_FEATURE_INIT(func) | 标识核心系统功能的初始化启动入口 | 757| APP_SERVICE_INIT(func) | 标识应用层服务的初始化启动入口 | 758| APP_FEATURE_INIT(func) | 标识应用层功能的初始化启动入口 | 759 760 761 762通过上面加载的组件编译出来的lib文件需要手动加入强制链接。 763 764如在 `vendor/hihope/neptune_iotlink_demo/config.json` 中配置了`bootstrap_lite` 部件 765 766 ``` 767 { 768 "subsystem": "startup", 769 "components": [ 770 { 771 "component": "bootstrap_lite" 772 }, 773 ... 774 ] 775 }, 776 ``` 777 778`bootstrap_lite`部件会编译`base/startup/bootstrap_lite/services/source/bootstrap_service.c`，该文件中，通过`SYS_SERVICE_INIT`将`Init`函数符号灌段到`__zinitcall_sys_service_start`和`__zinitcall_sys_service_end`中，由于`Init`函数是没有显式调用它，所以需要将它强制链接到最终的镜像。如下： 779 780 ``` 781 static void Init(void) 782 { 783 static Bootstrap bootstrap; 784 bootstrap.GetName = GetName; 785 bootstrap.Initialize = Initialize; 786 bootstrap.MessageHandle = MessageHandle; 787 bootstrap.GetTaskConfig = GetTaskConfig; 788 bootstrap.flag = FALSE; 789 SAMGR_GetInstance()->RegisterService((Service *)&bootstrap); 790 } 791 SYS_SERVICE_INIT(Init); --- 通过SYS启动即SYS_INIT启动就需要强制链接生成的lib 792 ``` 793 794在`base/startup/bootstrap_lite/services/source/BUILD.gn`文件中，描述了在`out/neptune100/neptune_iotlink_demo/libs` 生成 `libbootstrap.a`，如下： 795 796 ``` 797 static_library("bootstrap") { 798 sources = [ 799 "bootstrap_service.c", 800 "system_init.c", 801 ] 802 ... 803 ``` 804 805 806适配`syspara_lite`部件时，系统参数会最终写到文件中进行持久化保存。在轻量系统中，文件操作相关接口有POSIX接口与HalFiles接口这两套实现。 807 808因为对接内核的文件系统，采用POSIX相关的接口，所以features字段中需要增加`enable_ohos_startup_syspara_lite_use_posix_file_api = true`。 809 810### XTS子系统适配 811 812XTS子系统的适配，直接在`config.json`中加入组件选项： 813 814 ``` 815 { 816 "subsystem": "xts", 817 "components": [ 818 { 819 "component": "xts_acts", 820 "features": 821 [ 822 "config_ohos_xts_acts_utils_lite_kv_store_data_path = \"/data\"", 823 "enable_ohos_test_xts_acts_use_thirdparty_lwip = true" 824 ] 825 }, 826 { "component": "xts_tools", "features":[] } 827 ] 828 } 829 ``` 830 831另外，XTS功能也使用了list来组织，在`config.json`文件中增减相应模块： 832 833 ``` 834 "bin_list": [ 835 { 836 "enable": "true", 837 "force_link_libs": [ 838 "module_ActsParameterTest", 839 "module_ActsBootstrapTest", 840 "module_ActsDfxFuncTest", 841 "module_ActsHieventLiteTest", 842 "module_ActsSamgrTest", 843 "module_ActsUtilsFileTest", 844 "module_ActsKvStoreTest", 845 "module_ActsWifiServiceTest" 846 ] 847 } 848 ], 849 ``` 850 851其它组件的适配过程与官方以及其它厂商的过程类似，不再赘述。 852
