RT-thread應(yīng)用講解——easyflash

在實(shí)際的應(yīng)用中，我們經(jīng)常需要使用片外flash來保存一些數(shù)據(jù)，比如設(shè)備的一些配置參數(shù)，但是如果每個(gè)數(shù)據(jù)都按固定地址和長(zhǎng)度讀寫，就要先把所有數(shù)據(jù)的地址和長(zhǎng)度都分配好，數(shù)據(jù)量大的話使用起來就很不方便，所以我們需要一個(gè)內(nèi)存管理的應(yīng)用。

easyflash是一款開源的輕量級(jí)嵌入式flash存儲(chǔ)器庫，方便開發(fā)者更加輕松的實(shí)現(xiàn)基于flash存儲(chǔ)器的常見應(yīng)用開發(fā)。

EasyFlash軟件包：http://packages.rt-thread.org/detail.html?package=EasyFlash

一、掛載FLASH

首先我們要把這個(gè)片外flash掛載上。這個(gè)我之前的教程已經(jīng)介紹過了，不知道的同學(xué)可以先看下我之前的博客：RT-thread應(yīng)用講解——norflash

二、配置分區(qū)

我們?cè)趯?shí)際的應(yīng)用中片外flash可能會(huì)同時(shí)使用多個(gè)功能，比如OTA，easyflash、文件系統(tǒng)等，這個(gè)時(shí)候?yàn)榱吮苊鈹?shù)據(jù)沖突，我們就要先把flash分成幾個(gè)區(qū)域。

關(guān)于FLASH分區(qū)的內(nèi)容，請(qǐng)參考我另外一篇博客。
RT-thread應(yīng)用講解——FLASH分區(qū)

提示：如果要把整個(gè)外置flash都作為easyflash的話可以不分區(qū)。

三、下載軟件包

env的使用我就不多說了，已經(jīng)說過很多次了，可以翻一下我之前的博客。

RT-thread官網(wǎng)上也有很詳細(xì)的說明。

env使用方法：https://www.rt-thread.org/document/site/programming-manual/env/env/#bsp-menuconfig

打開easyflash軟件包。

配置說明：

四、接口驅(qū)動(dòng)移植

easyflash軟件包不會(huì)直接把接口驅(qū)動(dòng)加入到你的工程，因?yàn)榭紤]到每個(gè)人的使用情況可能不同，所以只給了一些demo作為參考。我們要把這個(gè)demo加到我們的工程里面，這樣才是完整的。

1、移植驅(qū)動(dòng)

驅(qū)動(dòng)移植常用的方法有兩種。

1：基于fal，有分區(qū)。
2：基于SFUD，不分區(qū)。

如果你的Flash驅(qū)動(dòng)使用的是上面的其中一種，那么移植EasyFlash將會(huì)非常簡(jiǎn)單。

如果沒有使用上面的驅(qū)動(dòng)，請(qǐng)參考 EasyFlash 的 移植文檔 進(jìn)行移植。在 EasyFlash 官方倉庫 下有很多 demo，也可以參考。

我這里舉的例子的是第1種，基于fal分區(qū)，分區(qū)方法前面第二點(diǎn)已經(jīng)講過了，現(xiàn)在只要移植驅(qū)動(dòng)即可。

第一步：在項(xiàng)目工程文件里面找到EasyFlash軟件包下的ports文件夾，復(fù)制ef_fal_port.c文件。

第二步：把復(fù)制的ef_fal_port.c文件拷貝到EasyFlash軟件包下的src文件夾。

提示：如果用第2種方法(基于SFUD)，可以參考ports文件夾里面的README.md介紹的方法。

2、修改分區(qū)名

移植完驅(qū)動(dòng)之后還要根據(jù)實(shí)際情況修改easyflash使用的分區(qū)名稱。

打開src目錄下的ef_fal_port.c文件，修改分區(qū)名。

示例如下：

/* EasyFlash partition name on FAL partition table */
#define FAL_EF_PART_NAME               "easyflash"  // 分區(qū)名為easyflash

提示：分區(qū)名必須是有效的分區(qū)，分區(qū)表在fal_cfg.h文件里面FAL_PART_TABLE定義。

3、重新生成工程

在env輸入下面的命令，重新生成新的工程。

提示：會(huì)使用env的話應(yīng)該都知道這個(gè)操作，不多說了。

scons --target=mdk5

五、測(cè)試用例

驅(qū)動(dòng)移植好之后就可以正常運(yùn)行easyflash了，這個(gè)時(shí)候可以寫一個(gè)簡(jiǎn)單的測(cè)試用例來測(cè)試數(shù)據(jù)是否可以正常讀寫。

參考示例如下：

#include <rtdevice.h>
#include <rtthread.h>
#include <easyflash.h>

#define DBG_TAG "env"
#define DBG_LVL DBG_LOG
#include <rtdbg.h>

uint32_t i_boot_times = NULL;
static void env_boot(void);

int env_init(void)
{
    fal_init();

    if(easyflash_init() == EF_NO_ERR)
    {
        /* 演示環(huán)境變量功能 */
        env_boot();
    }
}
INIT_ENV_EXPORT(env_init);

static void env_boot(void)
{
    char *c_old_boot_times, c_new_boot_times[11] = {0};

    /* 從環(huán)境變量中獲取啟動(dòng)次數(shù) */
    c_old_boot_times = ef_get_env("boot_times");
    /* 獲取啟動(dòng)次數(shù)是否失敗 */
    if(c_old_boot_times == RT_NULL)
        c_old_boot_times[0] = '0';

    i_boot_times = atol(c_old_boot_times);
    /* 啟動(dòng)次數(shù)加 1 */
    i_boot_times++;
    LOG_D("===============================================");
    LOG_D("The system now boot %d times", i_boot_times);
    LOG_D("===============================================");
    /* 數(shù)字轉(zhuǎn)字符串 */
    sprintf(c_new_boot_times, "%d", i_boot_times);
    /* 保存開機(jī)次數(shù)的值 */
    ef_set_env("boot_times", c_new_boot_times);
    ef_save_env();
}

這個(gè)示例記錄了設(shè)備的重啟次數(shù)，每次啟動(dòng)的時(shí)候會(huì)先讀取上一次啟動(dòng)的記錄，并加1，然后再把啟動(dòng)次數(shù)保存到easyflash里面。

六、運(yùn)行

正常運(yùn)行的日志如下：

可以輸入以下命令來查看已保存的環(huán)境變量。

printenv

可以輸入以下命令來清除已保存的環(huán)境變量。

resetenv

七、結(jié)束語

好了，關(guān)于easyflash的介紹就到這里，如果還有什么問題，歡迎在評(píng)論區(qū)留言。如果這篇文章能夠幫到你，就給我點(diǎn)個(gè)贊吧，如果想了解更多RT-thread和單片機(jī)的內(nèi)容，可以關(guān)注一下博主，后續(xù)我還會(huì)繼續(xù)分享更多的經(jīng)驗(yàn)給大家。

教程相關(guān)源碼：https://pan.baidu.com/s/1N2D8dM31deKIqNqaIQfPiA
提取碼：7nsx