5、设置参数

配置时需要修改项目中的ef_cfg.h文件,开启、关闭、修改对应的宏即可。

5.1 环境变量功能

  • 默认状态:开启
  • 操作方法:开启、关闭EF_USING_ENV宏即可

5.1.1 自动更新(增量更新)

可以对 ENV 设置版本号(参照 5.1.2)。当 ENV 初始化时,如果检测到产品存储的版本号与设定版本号不一致,会自动追加默认环境变量集合中新增的环境变量。

该功能非常适用于经常升级的产品中,当产品功能变更时,有可能会新增环境变量,此时只需要增大当前设定的 ENV 版本号,下次固件升级后,新增的环境变量将会自动追加上去。

  • 默认状态:关闭
  • 操作方法:开启、关闭EF_ENV_AUTO_UPDATE宏即可

5.1.2 环境变量版本号

该配置依赖于 5.1.1 配置。设置的环境变量版本号为整形数值,可以从 0 开始。如果在默认环境变量表中增加了环境变量,此时需要对该配置进行修改(通常加 1 )。

  • 操作方法:修改EF_ENV_VER_NUM宏对应值即可

5.2 在线升级功能

  • 默认状态:开启
  • 操作方法:开启、关闭EF_USING_IAP宏即可

5.3 日志功能

  • 默认状态:开启
  • 操作方法:开启、关闭EF_USING_LOG宏即可

5.4 Flash 擦除粒度(最小擦除单位)

  • 操作方法:修改EF_ERASE_MIN_SIZE宏对应值即可,单位:byte

5.5 Flash 写入粒度

  • 操作方法:修改EF_WRITE_GRAN宏对应值即可,单位:bit,仅支持:1/8/32/64

5.5 备份区

备份区共计包含3个区域,依次为:环境变量区、日志区及在线升级区。分区方式如下图所示

backup_area_partiton

在配置时需要注意以下几点:

  • 1、所有的区域必须按照EF_ERASE_MIN_SIZE对齐;
  • 2、环境变量分区大少至少为两倍以上 EF_ERASE_MIN_SIZE
  • 3、从 V4.0 开始 ENV 的模式命名为 NG 模式,V4.0 之前的称之为 LEGACY 遗留模式;
    • 遗留模式已经被废弃,不再建议继续使用;
    • 如果需要继续使用遗留模式,请 EasyFlash 的 V3.X 版本。

5.5.1 备份区起始地址

  • 操作方法:修改EF_START_ADDR宏对应值即可

5.5.2 环境变量区总容量

  • 操作方法:修改ENV_AREA_SIZE宏对应值即可

注意:不使用环境变量功能时,可以不定义此宏。

5.5.3 日志区总容量

  • 操作方法:修改LOG_AREA_SIZE宏对应值即可

注意:不使用日志功能时,可以不定义此宏。

5.6 调试日志

开启后,将会库运行时自动输出调试日志

  • 默认状态:开启
  • 操作方法:开启、关闭PRINT_DEBUG宏即可