参数配置

主系统详细配置流程如下所示：

1. 配置 SWUpdate 包参数
   注： 如果需要重新配置 SWUpdate 参数，必须先关掉 SWUpdate 预编译功能，修改的 SWUpdate 配置才能够生效。关于预编译相关说明，可参考。
   1. 执行下列命令进入主系统 SDK 生产环境：

      • eMMC

        lunch d211_demo

      • SPI NAND

        lunch d211_demo128_nand

   2. 在 Luban SDK 根目录下执行下列命令，进入功能配置界面：

      make m

   3. 在 Luban SDK 功能配置中，按如下选择：

      Third-party packages  --->
          -*- libubootenv  --->
          -*- libconfig  --->
          -*- libcurl  --->
          [*] swupdate  --->
      
          [*] mtd, jffs2 and ubi/ubifs tools  --->        //仅 SPINAND 平台需要

   4. 查看并修改 SWUpdate 库相关配置。

      关于 SWUpdate 包的参数描述，可查看。

      示例如下：

      [*]   use prebuilt binary instead of building from source
      (package/third-party/swupdate/luban_swupdate.config) swupdate configuration file
      [*]   swupdate webserver

      1. 取消勾选下列选项，关闭 SWUpdate 预编译功能：

         [ ]   use prebuilt binary instead of building from source

      2. 执行下列命令查看和修改 SWUpdate 相关配置：

         make swupdate-menuconfig

2. 增加 recovery 分区并烧录系统镜像程序
   在 image_cfg.json 中增加 recovery 分区，烧录 Recovery 系统镜像：

   1. 添加 recovery 分区：

      "kernel":   { "size": "12m" },
      + "recovery": { "size": "16m" },          //在 kernel 分区后面增加 recovery 分区

   2. 确保 kernel.its 和 recovery.its 文件存在并正确配置：

      "kernel": {
              "file": "kernel.itb",
              "attr": ["mtd", "required"],      //在 kernel 镜像烧录配置后面添加 recovery 镜像烧录配置
              "part": ["kernel"]
      },
      + "recovery": {
      +    "file": "recovery.itb",              //将 recovery.itb 镜像文件烧录到 recovery 分区里面
      +    "attr": ["mtd", "required"],
      +    "part": ["recovery"]
      + },
      
      "kernel.itb": {
              "its": "kernel.its"               //在 kernel 镜像生成方法后面增加 recovery 镜像生成方法
      
      },
      + "recovery.itb": {
      +    "its": "recovery.its"                //配置 recovery.itb 文件通过 recovery.its 指导编译完成
      + },

   3. 在 image 目录中检查 recovery.itb 文件是否生成。

      通过升级信息判断 recovery.itb 是否烧录到 recovery 分区。

3. 增加 OTA 分区烧录 OTA 升级包，用于验证本地 OTA 使用。

   如使用网络 OTA 或 SD 卡 OTA，可略过此步。

   1. 在 target/d211/demo128_nand/image_cfg.json 文件中，增加 OTA 分区配置和相应修改：

      "ubiroot":  {
          "size": "40m",                                 //适当裁剪主系统文件系统大小，确保不超总 FLASH 的大小
          "ubi": { // Volume in UBI device
              "rootfs": { "size": "-" },
          },
      },
      "ubisystem": {
          "size": "-",
          "ubi": { // Volume in UBI device
          +   "ota":   { "size": "60m" },                //ubisystem 分区上增加 ota 分区
              "user":   { "size": "-" },
          },
      },
      "rootfs": {
              "file": "rootfs*.ubifs",
              "attr": ["ubi", "required"],
              "part": ["ubiroot:rootfs"]                 //在根文件系统烧录之后增加 ota 分区烧录
      },
      +   "ota": {
      +          "file": "ota*.ubifs",
      +          "attr": ["ubi", "optional"],
      +          "part": ["ubisystem:ota"]               //将 ota*.ubifs 文件烧录到 ota 分区里面
      +  },
      

      注：

      剪裁主系统文件大小后，需同步修改 BR2_TARGET_ROOTFS_UBIFS_MAX_SIZE 宏，具体操作如下。

   2. 执行 make m :

      Filesystem images  --->
          RootFS images  --->
          (0x2800000) ubifs size(Should be aligned to MB)
      

   3. 主系统配置生成 ota*.ubifs 目标文件

      将 OTA 升级包下载到 ota 分区 中，方便测试 OTA 本地升级功能。

      ota 分区 如下所示：

      
      

      

      
      

      1. 进入主系统 SDK 生产环境：

         lunch d211_demo128_nand

      2. 在 Luban 根目录下执行配置命令：

         make m

      3. 配置如下：

         [*] UserFS 1  --->
             (ota) Name
                 FS Type (UBIFS)  --->
             (0x3C00000) ubifs size(Should be aligned to MB)
                 ubifs runtime compression (no compression)  --->
                 Compression method (no compression)  --->
             ()    Additional mkfs.ubifs options
             (target/$(LUBAN_CHIP_NAME)/$(LUBAN_BOARD_NAME)/ota) Overlay directory
         

      4. 将 target/$(LUBAN_CHIP_NAME)/$(LUBAN_BOARD_NAME)/ota 目录里的内容生成 ota_page_2k_block_128k.ubifs 镜像文件，之后会将整个文件烧录到 ota 分区 中。