µã»÷´ËÁ´½Ó¼´¿ÉÖ±½ÓÏÂÔØÎ»ÓÚGithubÉϵÄ×îÐÂÔ´Âë¡£
½¨Ò飺µã»÷ÏîÄ¿Ö÷Ò³ https://github.com/armink/EasyFlash ÓÒÉÏ½Ç Watch & Star£¬ÕâÑùÏîÄ¿ÓиüÐÂʱ£¬»á¼°Ê±ÒÔÓʼþÐÎʽ֪ͨÄã¡£
Èç¹ûGithubÏÂÔØÌ«Âý£¬Ò²¿ÉÒÔµã»÷ÏîĿλÓڵĹúÄÚ²Ö¿âÏÂÔØµÄÁ´½Ó(OSChina|Coding)¡£
ÔÚµ¼Èëµ½ÏîĿǰ£¬ÏÈ´ò¿ª\demo\Îļþ¼Ð£¬¼ì²éÏÂÓÐûÓÐÓëÏîÄ¿Flash¹æ¸ñÒ»ÖµÄDemo¡£Èç¹ûÓÐÔòÏÈÖ±½ÓÌø¹ý2¡¢3¡¢4Õ½ڣ¬°´ÕÕµÚ5ÕµÄÒªÇóÉèÖòÎÊý£¬²¢ÔËÐС¢ÑéÖ¤Demo¡£Ñé֤ͨ¹ýÔÙ°´ÕÕÏÂÃæµÄµ¼ÈëÏîĿҪÇ󣬽«DemoÖеÄÒÆÖ²ÎļþÖ±½Óµ¼Èëµ½ÏîÄ¿Öм´¿É¡£
| Ô´Îļþ | ÃèÊö |
|---|---|
| \easyflash\src\ef_env.c | Env£¨³£¹æÄ£Ê½£©Ïà¹Ø²Ù×÷½Ó¿Ú¼°ÊµÏÖÔ´Âë |
| \easyflash\src\ef_iap.c | IAP Ïà¹Ø²Ù×÷½Ó¿Ú¼°ÊµÏÖÔ´Âë |
| \easyflash\src\ef_log.c | Log Ïà¹Ø²Ù×÷½Ó¿Ú¼°ÊµÏÖÔ´Âë |
| \easyflash\src\ef_utils.c | EasyFlash³£ÓÃС¹¤¾ß£¬ÀýÈ磺CRC32 |
| \easyflash\src\easyflash.c | Ŀǰֻ°üº¬EasyFlash³õʼ»¯·½·¨ |
| \easyflash\port\ef_port.c | ²»Í¬Æ½Ì¨ÏµÄEasyFlashÒÆÖ²½Ó¿Ú |
| \demo\env\stm32f10x\non_os | stm32f10xÂã»úƬÄÚFlashµÄEnv demo |
| \demo\env\stm32f10x\non_os_spi_flash | stm32f10xÂã»úSPI FlashµÄEnv demo |
| \demo\env\stm32f10x\rtt | stm32f10x»ùÓÚRT-ThreadµÄƬÄÚFlash Env demo |
| \demo\env\stm32f4xx | stm32f4xx»ùÓÚRT-ThreadµÄƬÄÚFlash Env demo |
| \demo\iap\ymodem+rtt.c | ʹÓÃRT-Thread+YmodemµÄIAP Demo |
| \demo\log\easylogger.c | »ùÓÚEasyLoggerµÄLog Demo |
\easyflash\£¨ÀïÃæ°üº¬inc¡¢src¼°portµÄÄǸö£©Îļþ¼Ð¿½±´µ½ÏîÄ¿ÖУ»\easyflash\src\easyflash.c¡¢\easyflash\src\ef_utils.c¼°\easyflash\port\ef_port.cÕâЩÎļþµ½ÏîÄ¿µÄ±àÒë·¾¶ÖУ»\easyflash\src\ÖÐµÄÆäËûÔ´ÂëÎļþµ½ÏîÄ¿µÄ±àÒë·¾¶ÖУ»\easyflash\inc\Îļþ¼Ðµ½±àÒëµÄÍ·ÎļþĿ¼ÁбíÖУ»ÔÚÒÆÖ²Ê±Îñ±ØÏÈÒªÁ˽âÏîÄ¿µÄFlash¹æ¸ñ£¬ÕâÀïÐèÒªÁ˽âÊǹæ¸ñÊÇ ²Á³ýÁ£¶È£¨²Á³ý×îСµ¥Ôª£© ¡¢Ð´ÈëÁ£¶È¼° ÄÚ²¿´æ´¢½á¹¹ £¬¸÷¸ö³§¼ÒµÄFlash¹æ¸ñ¶¼ÓвîÒ죬ͬһ³§¼Ò²»Í¬ÏµÁеĹæ¸ñÒ²ÓвîÒì¡£ÒÔÏÂÊÇһЩ³£¼û Flash µÄ¹æ¸ñ
| Flash ÀàÐÍ | дÈëÁ£¶È | ²Á³ýÁ£¶È | ÄÚ²¿´æ´¢½á¹¹ |
|---|---|---|---|
| STM32F1 ƬÄÚ Flash | 4bytes | 1K/2K | ¾ùÔÈ·Ö²¼ |
| STM32F2/F4 ƬÄÚ Flash | 1byte | 16K/64K/128K | ×î´óµÄÓÐ128K£¬×îСµÄÓÐ16K |
| Nor Flash£¨SPI-Flash£© | 1bit | 4K | ¾ùÔÈ·Ö²¼ |
×¢Òâ £º
- 1¡¢Îñ±Ø±£Ö¤ÊìϤFlash¹æ¸ñºó£¬ÔÙ¼ÌÐøÏÂÕ½ڣ»
- 2¡¢V4.0 ÐÂģʽÔÝʱÎÞ·¨Ê¹ÓÃÔÚ STM32L4 ƬÄÚ Flash ÉÏ£¬L4 Ö»ÄÜʹÓà V3.0 °æ±¾»òÕß V4.0 µÄ EF_ENV_USING_LEGACY_MODE ģʽ
EasyFlashÒÆÖ²³õʼ»¯¡£¿ÉÒÔ´«µÝĬÈÏ»·¾³±äÁ¿£¬³õʼ»¯EasyFlashÒÆÖ²ËùÐèµÄ×ÊÔ´µÈµÈ¡£
EfErrCode ef_port_init(ef_env const **default_env, size_t *default_env_size)
| ²ÎÊý | ÃèÊö |
|---|---|
| default_env | ĬÈϵĻ·¾³±äÁ¿ |
| default_env_size | ĬÈÏ»·¾³±äÁ¿µÄÊýÁ¿ |
×îСµ¥Î»Îª4¸ö×Ö½Ú¡£
EfErrCode ef_port_read(uint32_t addr, uint32_t *buf, size_t size)
| ²ÎÊý | ÃèÊö |
|---|---|
| addr | ¶ÁÈ¡ÆðʼµØÖ·£¨4×Ö½Ú¶ÔÆë£© |
| buf | ´æ·Å¶ÁÈ¡Êý¾ÝµÄ»º³åÇø |
| size | ¶ÁÈ¡Êý¾ÝµÄ´óС£¨×Ö½Ú£© |
EfErrCode ef_port_erase(uint32_t addr, size_t size)
| ²ÎÊý | ÃèÊö |
|---|---|
| addr | ²Á³ýÆðʼµØÖ· |
| size | ²Á³ýÊý¾ÝµÄ´óС£¨×Ö½Ú£© |
×îСµ¥Î»Îª4¸ö×Ö½Ú¡£
EfErrCode ef_port_write(uint32_t addr, const uint32_t *buf, size_t size)
| ²ÎÊý | ÃèÊö |
|---|---|
| addr | дÈëµÄÆðʼµØÖ·£¨4×Ö½Ú¶ÔÆë£© |
| buf | Ô´Êý¾ÝµÄ»º³åÇø |
| size | дÈëÊý¾ÝµÄ´óС£¨×Ö½Ú£© |
ΪÁ˱£Ö¤RAM»º³åÇøÔÚ²¢·¢Ö´ÐеݲȫÐÔ£¬ËùÒÔÐèÒª¶ÔÆä½øÐмÓËø£¨Èç¹ûÏîÄ¿µÄʹÓó¡¾°²»´æÔÚ²¢·¢Çé¿ö£¬Ôò¿ÉÒÔºöÂÔ£©¡£ÓвÙ×÷ϵͳʱ¿ÉÒÔʹÓûñÈ¡ÐźÅÁ¿À´¼ÓËø£¬Âã»úʱ¿ÉÒÔͨ¹ý¹Ø±ÕÈ«¾ÖÖжÏÀ´¼ÓËø¡£
void ef_port_env_lock(void)
ÓвÙ×÷ϵͳÊÇ¿ÉÒÔʹÓÃÊÍ·ÅÐźÅÁ¿À´½âËø£¬Âã»úʱ¿ÉÒÔͨ¹ý¿ªÆôÈ«¾ÖÖжÏÀ´½âËø¡£
void ef_port_env_unlock(void)
ÔÚ¶¨ÒåPRINT_DEBUGºêºó£¬´òÓ¡µ÷ÊÔÈÕÖ¾ÐÅÏ¢¡£
void ef_log_debug(const char *file, const long line, const char *format, ...)
| ²ÎÊý | ÃèÊö |
|---|---|
| file | µ÷Óø÷½·¨µÄÎļþ |
| line | µ÷Óø÷½·¨µÄÐкŠ|
| format | ´òÓ¡¸ñʽ |
| ... | ²»¶¨²Î |
void ef_log_info(const char *format, ...)
| ²ÎÊý | ÃèÊö |
|---|---|
| format | ´òÓ¡¸ñʽ |
| ... | ²»¶¨²Î |
¸Ã·½·¨Êä³öÎ޹̶¨¸ñʽµÄ´òÓ¡ÐÅÏ¢£¬Îªef_print_env·½·¨ËùÓã¨Èç¹û²»Ê¹ÓÃef_print_envÔò¿ÉÒÔºöÂÔ£©¡£¶øef_log_debug¼°ef_log_info¿ÉÒÔÊä³ö´øÖ¸¶¨Ç°×º¼°¸ñʽµÄ´òÓ¡ÈÕÖ¾ÐÅÏ¢¡£
void ef_print(const char *format, ...)
| ²ÎÊý | ÃèÊö |
|---|---|
| format | ´òÓ¡¸ñʽ |
| ... | ²»¶¨²Î |
ÔÚ ef_port.c Îļþ¶¥²¿¶¨ÒåÓÐ static const ef_env default_env_set[] £¬ÎÒÃÇ¿ÉÒÔ½«²úÆ·ÉÏÐèÒªµÄĬÈÏ»·¾³±äÁ¿¼¯Öж¨ÒåÔÚÕâÀï¡£µ± flash µÚÒ»´Î³õʼ»¯Ê±»á½«Ä¬ÈϵĻ·¾³±äÁ¿Ð´Èë¡£
ĬÈÏ»·¾³±äÁ¿ÄÚ²¿²ÉÓà void * ÀàÐÍ£¬ËùÒÔÖ§³ÖÈÎÒâÀàÐÍ£¬¿É²Î¿¼ÈçÏÂʾÀý£º
static uint32_t boot_count = 0;
static time_t boot_time[10] = {0, 1, 2, 3};
static const ef_env default_env_set[] = {
// { key , value, value_len }£¬
{"username", "armink", 0}, //ÀàÐÍΪ×Ö·û´®µÄ»·¾³±äÁ¿¿ÉÒÔÉ趨ֵµÄ³¤¶ÈΪ 0 £¬´Ëʱ»áÔÚ³õʼ»¯Ê±»á×Ô¶¯¼ì²âÆä³¤¶È
{"password", "123456", 0},
{"boot_count", &boot_count, sizeof(boot_count)}, //ÕûÐÎ
{"boot_time", &boot_time, sizeof(boot_time)}, //Êý×éÀàÐÍ£¬ÆäËûÀàÐÍʹÓ÷½Ê½ÀàËÆ
};
ÅäÖÃʱÐèÒªÐÞ¸ÄÏîÄ¿ÖеÄef_cfg.hÎļþ£¬¿ªÆô¡¢¹Ø±Õ¡¢Ð޸ĶÔÓ¦µÄºê¼´¿É¡£
EF_USING_ENVºê¼´¿É¿ÉÒÔ¶Ô ENV ÉèÖð汾ºÅ£¨²ÎÕÕ 5.1.2£©¡£µ± ENV ³õʼ»¯Ê±£¬Èç¹û¼ì²âµ½²úÆ·´æ´¢µÄ°æ±¾ºÅÓëÉ趨°æ±¾ºÅ²»Ò»Ö£¬»á×Ô¶¯×·¼ÓĬÈÏ»·¾³±äÁ¿¼¯ºÏÖÐÐÂÔöµÄ»·¾³±äÁ¿¡£
¸Ã¹¦Äܷdz£ÊÊÓÃÓÚ¾³£Éý¼¶µÄ²úÆ·ÖУ¬µ±²úÆ·¹¦Äܱä¸üʱ£¬ÓпÉÄÜ»áÐÂÔö»·¾³±äÁ¿£¬´ËʱֻÐèÒªÔö´óµ±Ç°É趨µÄ ENV °æ±¾ºÅ£¬Ï´ι̼þÉý¼¶ºó£¬ÐÂÔöµÄ»·¾³±äÁ¿½«»á×Ô¶¯×·¼ÓÉÏÈ¥¡£
EF_ENV_AUTO_UPDATEºê¼´¿É¸ÃÅäÖÃÒÀÀµÓÚ 5.1.1 ÅäÖá£ÉèÖõĻ·¾³±äÁ¿°æ±¾ºÅΪÕûÐÎÊýÖµ£¬¿ÉÒÔ´Ó 0 ¿ªÊ¼¡£Èç¹ûÔÚĬÈÏ»·¾³±äÁ¿±íÖÐÔö¼ÓÁË»·¾³±äÁ¿£¬´ËʱÐèÒª¶Ô¸ÃÅäÖýøÐÐÐ޸ģ¨Í¨³£¼Ó 1 £©¡£
EF_ENV_VER_NUMºê¶ÔÓ¦Öµ¼´¿ÉEF_USING_IAPºê¼´¿ÉEF_USING_LOGºê¼´¿ÉEF_ERASE_MIN_SIZEºê¶ÔÓ¦Öµ¼´¿É£¬µ¥Î»£ºbyteEF_WRITE_GRANºê¶ÔÓ¦Öµ¼´¿É£¬µ¥Î»£ºbit£¬½öÖ§³Ö£º1/8/32±¸·ÝÇø¹²¼Æ°üº¬3¸öÇøÓò£¬ÒÀ´ÎΪ£º»·¾³±äÁ¿Çø¡¢ÈÕÖ¾Çø¼°ÔÚÏßÉý¼¶Çø¡£·ÖÇø·½Ê½ÈçÏÂͼËùʾ
ÔÚÅäÖÃʱÐèҪעÒâÒÔϼ¸µã£º
EF_ERASE_MIN_SIZE¶ÔÆë£»EF_ERASE_MIN_SIZE£»EF_START_ADDRºê¶ÔÓ¦Öµ¼´¿ÉENV_AREA_SIZEºê¶ÔÓ¦Öµ¼´¿É×¢Ò⣺²»Ê¹Óû·¾³±äÁ¿¹¦ÄÜʱ£¬¿ÉÒÔ²»¶¨Òå´Ëºê¡£
LOG_AREA_SIZEºê¶ÔÓ¦Öµ¼´¿É×¢Ò⣺²»Ê¹ÓÃÈÕÖ¾¹¦ÄÜʱ£¬¿ÉÒÔ²»¶¨Òå´Ëºê¡£
¿ªÆôºó£¬½«»á¿âÔËÐÐʱ×Ô¶¯Êä³öµ÷ÊÔÈÕÖ¾
PRINT_DEBUGºê¼´¿ÉÈç¹û\demo\Îļþ¼ÐÏÂÓÐÓëÏîÄ¿Flash¹æ¸ñÒ»ÖµÄDemo£¬ÔòÖ±½Ó±àÒëÔËÐУ¬¹Û²ì²âÊÔ½á¹û¼´¿É¡£ÎÞÐè¹Ø×¢ÏÂÃæµÄ²½Öè¡£
ÿ´ÎʹÓÃǰ£¬Îñ±ØÏÈÖ´ÐÐeasyflash_init()·½·¨¶ÔEasyFlash¿â¼°ËùʹÓõÄFlash½øÐгõʼ»¯£¬±£Ö¤³õʼ»¯Ã»ÎÊÌâºó£¬ÔÙʹÓø÷¹¦ÄܵÄAPI·½·¨¡£Èç¹û³öÏÖ´íÎó»ò¶ÏÑÔ£¬Ðè¸ù¾ÝÌáʾÐÅÏ¢¼ì²éÒÆÖ²ÅäÖü°½Ó¿Ú¡£
²é¿´\demo\env\×ÓÎļþ¼ÐÖÐÀý×ÓµÄREADME.md˵Ã÷Îĵµ¡£²âÊÔʱ¿ÉÒÔ½«\demo\env\stm32f10x\non_os\app\src\app.cÖеÄstatic void test_env(void)·½·¨Ì叴֯µ½ÏîÄ¿ÖУ¬È»ºóÔËÐвâÊÔ¡£
²é¿´\demo\iap\README.md˵Ã÷Îĵµ¡£
²é¿´\demo\log\README.md˵Ã÷Îĵµ¡£
×¢Ò⣺
easylogger.cÊÇʹÓÃEasyLoggerÓëEasyFlashµÄÎÞ·ì½Ó¿ÚµÄÀý×Ó£¬EasyLoggerÌṩÕë¶ÔÈÕÖ¾µÄºÜ¶à³£Óù¦ÄÜ·â×°£¬Ïêϸ¹¦ÄÜ¿ÉÒԲ鿴Æä½éÉÜ¡£Ê¹ÓÃÕâ¸öÀý×Óʱ£¬Îñ±Ø¼ÇµÃ½«EasyLoggerÒ»²¢µ¼Èëµ½ÏîÄ¿ÖС£