启动恢复

简介

启动恢复负责在内核启动之后，应用启动之前的操作系统中间层的启动。涉及以下模块：

  • init启动引导

支持使用LiteOS-A内核的平台，当前包括：Hi3516DV300平台和Hi3518EV300平台。

负责处理从内核加载第一个用户态进程开始，到第一个应用程序启动之间的系统服务进程启动过程。启动恢复子系统除负责加载各系统关键进程之外，还需在启动的同时设置其对应权限，并在子进程启动后对指定进程实行保活（若进程意外退出要重新启动），对于特殊进程意外退出时，启动恢复子系统还要执行系统复位操作。

  • appspawn应用孵化

    支持使用LiteOS-A内核的平台，当前包括：Hi3516DV300平台和Hi3518EV300平台。

    负责接受应用程序框架的命令孵化应用进程，设置其对应权限，并调用应用程序框架的入口。

  • bootstrap启动服务模块

    支持使用LiteOS-M内核的平台，当前包括：Hi3861平台。

    提供了各服务和功能的启动入口标识。在SAMGR启动时，会调用boostrap标识的入口函数，并启动系统服务。

  • 系统属性

    支持使用LiteOS-M内核和LiteOS-A内核的平台，包括：Hi3861平台，Hi3516DV300平台，Hi3518EV300平台。

    负责提供获取与设置操作系统相关的系统属性。

    系统属性包括：默认系统属性、OEM厂商系统属性和自定义系统属性。OEM厂商部分仅提供默认值，具体值需OEM产品方按需进行调整，详见“使用”部分。

目录

表 1 启动恢复源代码目录结构

名称

描述

适配平台

base/startup/services/appspawn_lite

应用孵化模块，appspawn进程，负责通过轻量级IPC机制接收AMS消息，然后根据消息解析结果启动应用进程并赋予其对应权限。

Hi3516DV300

Hi3518EV300

base/startup/services/bootstrap_lite

服务启动模块，启动系统核心服务外的其他服务。

Hi3861

base/startup/services/init_lite

启动引导模块，init进程，内核完成初始化后加载的第一个用户态进程，启动后解析/etc/init.cfg配置文件，并根据解析结果拉起其他系统关键进程，同时分别赋予其对应权限。

Hi3516DV300

Hi3518EV300

base/startup/interfaces

服务启动模块对外接口，由main函数来调用，启动服务框架。

Hi3861

Hi3516DV300

Hi3518EV300

base/startup/frameworks/syspara_lite

系统属性模块。提供获取设备信息接口，如：产品名、品牌名、品类名、厂家名等。

 
  1. base
  2. ├──startup    启动恢复子系统根目录
  3. ├──── frameworks
  4. │     └── syspara_lite
  5. │         ├── LICENSE     开源LICENSE文件
  6. │         ├── parameter   系统属性模块源文件目录
  7. │         │   ├── BUILD.gn
  8. │         │   └── src
  9. │         │       ├── BUILD.gn
  10. │         │       ├── param_impl_hal     系统属性模块基于LiteOS-M核实现
  11. │         │       └── param_impl_posix   系统属性模块基于LiteOS-A核实现
  12. │         └── token
  13. │             ├── BUILD.gn
  14. │             └── src
  15. │                 ├── token_impl_hal
  16. │                 └── token_impl_posix
  17. ├──── hals         
  18. │     └── syspara_lite       系统属性模块硬件抽象层头文件目录   
  19. ├──── interfaces
  20. │     └── kits
  21. │         └── syspara_lite   系统属性模块对外接口目录
  22. └──── services
  23.       ├── appspawn_lite    应用孵化模块
  24.       │   ├── BUILD.gn    应用孵化模块编译配置
  25.       │   ├── include     应用孵化模块头文件目录
  26.       │   ├── LICENSE     开源LICENSE文件
  27.       │   ├── moduletest  应用孵化模块自测试代码目录
  28.       │   └── src         应用孵化木块源文件目录
  29.       ├── bootstrap_lite   启动服务模块
  30.       │   ├── BUILD.gn    启动服务模块编译配置
  31.       │   ├── LICENSE     开源LICENSE文件
  32.       │   └── source      启动服务模块源文件目录
  33.       └── init_lite       启动引导模块
  34.           ├── BUILD.gn    启动引导模块编译配置
  35.           ├── include     启动引导模块头文件目录
  36.           ├── LICENSE     开源LICENSE文件
  37.           ├── moduletest  启动引导模块自测试代码目录
  38.           └── src         启动引导模块源文件目录
  39. vendor
  40. └──huawei
  41.         └──camera
  42.                 └──init_configs  启动引导模块配置文件目录（json格式，部署于/etc/目录下）

约束

启动恢复使用C语言开发。

  • 系统属性：OEM厂商相关仅提供默认值，具体值需产品方按需进行调整。

使用

  • init启动引导的配置文件

启动引导模块配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他属性信息，该文件位于代码仓库/vendor/huawei/camera/init_configs/目录，部署在/etc/下，文件名称为init.cfg，采用json格式，文件大小目前限制在10KB以内。

init进程启动后首先读取/etc/init.cfg，然后解析其json内容，并根据解析结果依次加载系统服务。配置文件格式和内容说明如下所示：

  1. {
  2.     "jobs" : [{
  3.             "name" : "pre-init",      -------- 在init之前执行的job，可以放置一些启动进程之前的预操作（如新建文件夹等）
  4.             "cmds" : [
  5.                 "mkdir /testdir",      -------- 创建文件夹命令，mkdir和目标文件夹之间有且只能有一个空格
  6.                 "chmod 0700 /testdir", -------- 修改权限命令，chmod 权限 目标  之间间隔有且仅有一个空格，权限必须为0xxxx格式
  7.                 "chown 99 99 /testdir",-------- 修改属组命令，chown uid gid 目标  之间间隔有且仅有一个空格
  8.                 "mkdir /testdir2",
  9.                 "mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" -------- mount命令，格式为：mount 文件系统类型 source target flags data
  10.                                                                     -------- flags当前仅支持nodev、noexec、nosuid和 rdonly，各项均以一个空格分开
  11.             ]
  12.         }, {
  13.             "name" : "init",          -------- init进程支持的job名称，如扩展请确保job名称不超过32字节
  14.             "cmds" : [                -------- 当前job支持的命令集合，命令名称（10字节以内）和后面参数（32字节以内）之间有且只能有一个空格
  15.                 "start service1",     -------- 当前job的第一条命令
  16.                 "start service2"      -------- 当前job的第二条命令（可以根据需要调整命令在数组中的顺序，init进程将根据解析顺序依次执行）
  17.              ]
  18.         }, {
  19.              "name" : "post-init",    -------- 在init之后执行的 job，可以放置一些启动进程之后的操作
  20.              "cmds" : []
  21.         }
  22.     ],
  23.     "services" : [{                         -------- service集合（数组形式），包含了init进程需要启动的所有系统服务
  24.             "name" : "service1",            -------- 当前服务的服务名，须确保非空且长度在32字节以内
  25.             "path" : "/bin/process1"        -------- 当前服务的可执行文件全路径，须确保非空且长度在64字节以内
  26.             "uid" : 1,                      -------- 当前服务进程的uid值
  27.             "gid" : 1,                      -------- 当前服务进程的gid值
  28.             "once" : 0,                     -------- 当前服务进程是否为一次性进程
  29.                                                      0 --- 当前服务非一次性进程，当进程因任何原因退出时，init收到SIGCHLD信号后将重新启动该服务进程
  30.                                                    非0 --- 当前服务为一次性进程，当进程因任何原因退出时，init不会重新启动该服务进程
  31.             "importance" : 1,               -------- 当前服务是否为关键系统进程
  32.                                                      0 --- 当前服务非关键系统进程，当进程因任何原因退出时，init不会做系统复位操作
  33.                                                    非0 --- 当前服务为关键系统进程，当进程因任何原因退出时，init收到SIGCHLD信号后进行系统复位重启
  34.             "caps" : [0, 1, 2, 5]           -------- 当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置
  35.     }, {
  36.             "name" : "service2",            -------- 下一个需要init启动的服务。此处服务的顺序与启动顺序无关，启动顺序取决于上面job中的cmd顺序。
  37.             "path" : "/bin/process2",
  38.             "uid" : 2,
  39.             "gid" : 2,
  40.             "once" : 1,
  41.             "importance" : 0,
  42.             "caps" : [ ]
  43.         }
  44.     ]
  45. }

表 2 cmds支持列表

命令名称

命令格式

命令说明

start

start ServiceName 间隔有且仅有一个空格

启动服务，服务名称与文件中services数组中服务名称相同

mkdir

mkdir /xxxx/xxx 间隔有且仅有一个空格

创建目录

chmod

chmod 0xxx /xxx/xx 间隔有且仅有一个空格

修改权限，权限值必须为0xxx格式，如0755，0600等，需要遵循权限最小原则配置

chown

chown uid gid /xxx/xx 间隔有且仅有一个空格

修改属组

mount

mount fileSysType source target flags data

间隔有且仅有一个空格

挂载命令，其中flags目前仅支持nodev、noexec、nosuid和rdonly，其它字串均判定为data项

需要注意的是，init.cfg文件的修改需要保持json格式不被破坏，否则init进程解析失败后不会启动任何服务。对于配置的服务权限（uid/gid/capability）需要符合安全子系统要求且遵循权限最小原则。另外，对于once和importance项均为0的服务，若其在4分钟内连续退出次数超过4次，则init将终止重新启动该服务的操作。

  • 系统参数

    • OEM厂商相关系统属性

    Hi3516DV300，Hi3518EV300开发板需要修改vendor/huawei/camera/hals/utils/sys_param目录下源文件：

    1. static const char HOS_PRODUCT_TYPE[] = {"****"};
    2. static const char HOS_MANUFACTURE[] = {"****"};
    3. static const char HOS_BRAND[] = {"****"};
    4. static const char HOS_MARKET_NAME[] = {"****"};
    5. static const char HOS_PRODUCT_SERIES[] = {"****"};
    6. static const char HOS_PRODUCT_MODEL[] = {"****"};
    7. static const char HOS_SOFTWARE_MODEL[] = {"****"};
    8. static const char HOS_HARDWARE_MODEL[] = {"****"};
    9. static const char HOS_HARDWARE_PROFILE[] = {"aout:true,display:true"};
    10. static const char HOS_BOOTLOADER_VERSION[] = {"bootloader"};
    11. static const char HOS_SECURE_PATCH_LEVEL[] = {"2020-6-5"};
    12. static const char HOS_ABI_LIST[] = {"****"};

    Hi3861开发板需要修改vendor/huawei/wifi-iot/hals/utils/sys_param目录下源文件：

    1. static const char HOS_PRODUCT_TYPE[] = {"****"};
    2. static const char HOS_MANUFACTURE[] = {"****"};
    3. static const char HOS_BRAND[] = {"****"};
    4. static const char HOS_MARKET_NAME[] = {"****"};
    5. static const char HOS_PRODUCT_SERIES[] = {"****"};
    6. static const char HOS_PRODUCT_MODEL[] = {"****"};
    7. static const char HOS_SOFTWARE_MODEL[] = {"****"};
    8. static const char HOS_HARDWARE_MODEL[] = {"****"};
    9. static const char HOS_HARDWARE_PROFILE[] = {"aout:true,display:true"};
    10. static const char HOS_BOOTLOADER_VERSION[] = {"bootloader"};
    11. static const char HOS_SECURE_PATCH_LEVEL[] = {"2020-6-5"};
    12. static const char HOS_ABI_LIST[] = {"****"};
    • 获取默认系统属性
    1. char* value1 = GetProductType();
    2. printf("Product type =%s\n", value1);
    3. free(value1);
    4. char* value2 = GetManufacture();
    5. printf("Manufacture =%s\n", value2);
    6. free(value2);
    7. char* value3 = GetBrand();
    8. printf("GetBrand =%s\n", value3);
    9. free(value3);
    • 设置获取自定义系统属性
    1. const char* defSysParam = "data of sys param ***...";
    2. char key[] = "rw.parameter.key";
    3. char value[] = "OEM-hisi-10.1.0";
    4. int ret = SetParameter(key, value);
    5. char valueGet[128] = {0};
    6. ret = GetParameter(key, defSysParam, valueGet, 128);
    7. printf("value = %s\n", valueGet);

涉及仓

startup_frameworks_syspara_lite

startup_hals_syspara_lite

startup_interfaces_kits_syspara_lite

startup_appspawn_lite

startup_services_bootstrap_lite

startup_init_lite