参数配置

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

1. 在 target/d211/demo_folder/image_cfg.json 文件中，增加 OTA 分区配置：

   "partitions": { // Partition table apply to device
           "rootfs": { "size": "72m" },
   +       "ota": { "size": "96m" },
   },
   
   "rootfs": {
       "file": "rootfs.ext4",
       "attr": ["block", "required"],
       "part": ["rootfs"]
   },
   + "ota": {
   +    "file": "ota.ext4",
   +    "attr": ["block", "required"],
   +    "part": ["ota"]
   + },

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

   关于 ota 分区说明，可查看 方案介绍。

4. 在 Luban SDK 根目录下执行 make m 命令。

   配置如下：

   Filesystem images  --->
       [*] UserFS 1  --->
       (ota) Name
           FS Type (Ext4)  --->
       [*]   generate sparse format filesystem
       (96M) Size
       (0)   Number of inodes (leave at 0 for auto calculation)
       (5)   Reserved blocks percentage
       (-O ^64bit) Additional mke2fs options
       (target/$(LUBAN_CHIP_NAME)/$(LUBAN_BOARD_NAME)/ota) Overlay directory

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

执行 make um 进入功能配置界面，并按如下选择使能 Redundant Environment 机制：

Environment  --->
    [*] Enable redundant environment support
    (0x200000) Redundant environment offset

• 当升级过程中掉电时，其中一份环境变量如果被破坏，另外一份环境变量还能够继续引导启动。

• 用户可以手动擦除其中一份环境变量，测试系统能否正常启动，写入保存环境变量后，被擦除的环境变量是否能够恢复。

• CONFIG_ENV_OFFSET_REDUND 为 env_r 分区的偏移值，需要与分区表匹配。

Loading Environment from RAM... *** Warning - bad CRC, using default environment

    "uboot_env": {
        "env.bin": {
            "file": "env.txt",
            "size": "0x4000",
+           "redundant": "enable",
        },
    },

在 OTA 升级过程中，主系统和 Recovery 系统都使用到 SWUpdate 命令。SWUpdate 依赖 U-Boot 环境变量，需要在 Linux 中配置 U-Boot 环境变量索引路径。

1. 因为使用到了 env_r 备份分区，fw_env.config 需要包含 env 和 env_r 分区信息。如果修改了 env 和 env_r 分区信息，则需要同步更新下列 fw_env.config 文件：

   • Recovery 系统 SDK 生产环境所在的 fw_env.config 文件，默认路径如下：
     • eMMC：target/d211/ota_emmc/rootfs_overlay/etc/fw_env.config
     • SPI NAND：target/d211/ota/rootfs_overlay/etc/fw_env.config
   • 主系统 SDK 生产环境所在的 fw_env.config 文件，路径如下：
     • eMMC：target/d211/demo/rootfs_overlay/etc/fw_env.config
     • SPI NAND：target/d211/demo128_nand/rootfs_overlay/etc/fw_env.config
2. 在 Linux 环境下执行下列 命令，测试能够正常打印 U-Boot 环境变量信息。

   fw_env.config 和 fw_setenv 命令默认会读取 /etc/fw_env.config 文件来获取环境变量的分区信息。

   fw_printenv/fw_setenv

   • eMMC 的默认的配置信息如下：

     //device name   Device offset   Env. size
     /dev/mmcblk0    0x1C0000        0x4000
     /dev/mmcblk0    0x200000        0x4000
     

     • /dev/mmcblk0： eMMC 分区的设备号
     • Device offset：环境变量分区的偏移值
     • Env. size：实际环境变量的大小
   • SPINAND 的默认的配置信息如下：

     /dev/mtd4               0x0000          0x4000          0x20000
     /dev/mtd5               0x0000          0x4000          0x20000
     

     表 2. SPINAND 默认配置参数描述

     /dev/mtd4	env 分区 的设备号
     /dev/mtd5	env_r 分区的设备号
     第二列 0x0000	Device offset
     第三列 0x4000	Env. size
     第四列 0x20000	块擦除大小