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个区域,依次为:环境变量区、日志区及在线升级区。分区方式如下图所示
在配置时需要注意以下几点:
- 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
宏即可