启动恢复

简介

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

  • 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当前仅支持nodevnoexecnosuid 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. staticconstchar HOS_PRODUCT_TYPE[]={"****"};
    2. staticconstchar HOS_MANUFACTURE[]={"****"};
    3. staticconstchar HOS_BRAND[]={"****"};
    4. staticconstchar HOS_MARKET_NAME[]={"****"};
    5. staticconstchar HOS_PRODUCT_SERIES[]={"****"};
    6. staticconstchar HOS_PRODUCT_MODEL[]={"****"};
    7. staticconstchar HOS_SOFTWARE_MODEL[]={"****"};
    8. staticconstchar HOS_HARDWARE_MODEL[]={"****"};
    9. staticconstchar HOS_HARDWARE_PROFILE[]={"aout:true,display:true"};
    10. staticconstchar HOS_BOOTLOADER_VERSION[]={"bootloader"};
    11. staticconstchar HOS_SECURE_PATCH_LEVEL[]={"2020-6-5"};
    12. staticconstchar HOS_ABI_LIST[]={"****"};

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

    1. staticconstchar HOS_PRODUCT_TYPE[]={"****"};
    2. staticconstchar HOS_MANUFACTURE[]={"****"};
    3. staticconstchar HOS_BRAND[]={"****"};
    4. staticconstchar HOS_MARKET_NAME[]={"****"};
    5. staticconstchar HOS_PRODUCT_SERIES[]={"****"};
    6. staticconstchar HOS_PRODUCT_MODEL[]={"****"};
    7. staticconstchar HOS_SOFTWARE_MODEL[]={"****"};
    8. staticconstchar HOS_HARDWARE_MODEL[]={"****"};
    9. staticconstchar HOS_HARDWARE_PROFILE[]={"aout:true,display:true"};
    10. staticconstchar HOS_BOOTLOADER_VERSION[]={"bootloader"};
    11. staticconstchar HOS_SECURE_PATCH_LEVEL[]={"2020-6-5"};
    12. staticconstchar 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. constchar* 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