在實(shí)際的應(yīng)用中,我們經(jīng)常需要使用片外flash來保存一些數(shù)據(jù),比如設(shè)備的一些配置參數(shù),但是如果每個(gè)數(shù)據(jù)都按固定地址和長度讀寫,就要先把所有數(shù)據(jù)的地址和長度都分配好,數(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ū)
我們在實(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)容,請參考我另外一篇博客。
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ì)非常簡單。
如果沒有使用上面的驅(qū)動(dò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
五、測試用例
驅(qū)動(dòng)移植好之后就可以正常運(yùn)行easyflash了,這個(gè)時(shí)候可以寫一個(gè)簡單的測試用例來測試數(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