EasyFlash 配置

ef_cfg.h     配置文件

点击(此处)折叠或打开

1. #ifndef EF_CFG_H_
   
2. #define EF_CFG_H_
   
3. 
   
4. /* using ENV function */
   
5. #define EF_USING_ENV
   
6. /* using wear leveling mode for ENV */
   
7. /* #define EF_ENV_USING_WL_MODE */
   
8. /* using power fail safeguard mode for ENV */
   
9. /* #define EF_ENV_USING_PFS_MODE */
   
10. 
    
11. /* using IAP function */
    
12. #define EF_USING_IAP
    
13. 
    
14. /* using save log function */
    
15. /* #define EF_USING_LOG */
    
16. 
    
17. /* the minimum size of flash erasure */
    
18. #define EF_ERASE_MIN_SIZE /* @note you must define it for a value */
    
19. 
    
20. /**
    
21.  *
    
22.  * This all Backup Area Flash storage index. All used flash area configure is under here.
    
23.  * |----------------------------| Storage Size
    
24.  * | Environment variables area | ENV area size @see ENV_AREA_SIZE
    
25.  * | 1.system section | ENV_SYSTEM_SIZE
    
26.  * | 2:data section | ENV_AREA_SIZE - ENV_SYSTEM_SIZE
    
27.  * |----------------------------|
    
28.  * | Saved log area | Log area size @see LOG_AREA_SIZE
    
29.  * |----------------------------|
    
30.  * |(IAP)Downloaded application | IAP already downloaded application, unfixed size
    
31.  * |----------------------------|
    
32.  *
    
33.  * @note all area size must be aligned with EF_ERASE_MIN_SIZE
    
34.  * @note EasyFlash will use ram to buffered the ENV. At some time flash's EF_ERASE_MIN_SIZE is so big,
    
35.  * and you want use ENV size is less than it. So you must defined ENV_USER_SETTING_SIZE for ENV.
    
36.  * @note ENV area size has some limitations in different modes.
    
37.  * 1.Normal mode: no more limitations
    
38.  * 2.Wear leveling mode: system section will used an flash section and the data section will used at least 2 flash sections
    
39.  * 3.Power fail safeguard mode: ENV area will has an backup. It is twice as normal mode.
    
40.  * 4.wear leveling and power fail safeguard mode: The required capacity will be 2 times the total capacity in wear leveling mode.
    
41.  * For example:
    
42.  * The EF_ERASE_MIN_SIZE is 128K and the ENV_USER_SETTING_SIZE: 2K. The ENV_AREA_SIZE in different mode you can define
    
43.  * 1.Normal mode: 1*EF_ERASE_MIN_SIZE
    
44.  * 2.Wear leveling mode: 3*EF_ERASE_MIN_SIZE (It has 2 data section to store ENV. So ENV can erase at least 200,000 times)
    
45.  * 3.Power fail safeguard mode: 2*EF_ERASE_MIN_SIZE
    
46.  * 4.Wear leveling and power fail safeguard mode: 6*EF_ERASE_MIN_SIZE
    
47.  * @note the log area size must be more than twice of EF_ERASE_MIN_SIZE
    
48.  */
    
49. /* backup area start address */
    
50. #define EF_START_ADDR /* @note you must define it for a value */
    
51. /* the user setting size of ENV, must be word alignment */
    
52. #define ENV_USER_SETTING_SIZE /* @note you must define it for a value if you used ENV */
    
53. /* ENV area total bytes size in normal mode. */
    
54. #define ENV_AREA_SIZE /* @note you must define it for a value if you used ENV */
    
55. /* saved log area size */
    
56. #define LOG_AREA_SIZE /* @note you must define it for a value if you used log */
    
57. 
    
58. /* print debug information of flash */
    
59. #define PRINT_DEBUG
    
60. 
    
61. #endif /* EF_CFG_H_ */

从上图可以看出，存储分为了三个区，环境变量区（包含了系统区和数据区）、日志区和在线升级区。
可选择宏（注释掉就表示关闭对应的功能）：
PRINT_DEBUG /* print debug information of flash */ 使用调试功能
EF_USING_IAP /* using IAP function */              使用IAP 功能
EF_USING_LOG /* using save log function */       使用日志功能


EF_USING_ENV  /* using ENV function */使用环境功能  
EF_ENV_USING_WL_MODE /* using wear leveling mode for ENV */ 使用损坏均衡环境功能
EF_ENV_USING_PFS_MODE /* using power fail safeguard mode for ENV */使用掉电保护环境功能
上面三者之间的区别：
 *       1.Normal mode: no more limitations
 *       2.Wear leveling mode: system section will used an flash section and the data section will used at least 2 flash sections
 *       3.Power fail safeguard mode: ENV area will has an backup. It is twice as normal mode.
 *       4.wear leveling and power fail safeguard mode: The required capacity will be 2 times the total capacity in wear leveling mode.
1.EF_USING_ENV：  属于普通的模式，没有太多的限制
2.EF_ENV_USING_WL_MODE ：使用损坏均衡模式，系统区会使用一个flash扇区，数据区会至少使用两个flash扇区
3.EF_ENV_USING_PFS_MODE && EF_ENV_USING_WL_MODE ：flash使用是EF_ENV_USING_WL_MODE 模式下的两倍容量



注释为 /* @note you must define it for a value if you used ENV */ 是必须定义值的宏：
/* the minimum size of flash erasure */
#define EF_ERASE_MIN_SIZE        擦除的最小值

/* backup area start address */
#define EF_START_ADDR    备份区的开始地址
       
/* the user setting size of ENV, must be word alignment */
#define ENV_USER_SETTING_SIZE     用户环境区大小

/* ENV area total bytes size in normal mode. */
#define ENV_AREA_SIZE         环境区大小
   
/* saved log area size */
#define LOG_AREA_SIZE          日志区大小


    本文乃黎社林原创文章，如有错误，请联系[email protected]