FSKV是LuatOS系統(tǒng)專為嵌入式設(shè)備設(shè)計(jì)的鍵值對（Key-Value）存儲庫，其作用是在Flash存儲器中持久化存儲鍵值對數(shù)據(jù)，允許開發(fā)者以鍵值對的形式存儲和檢索數(shù)據(jù)，并且這些數(shù)據(jù)會被持久化存儲在Flash存儲器上，確保設(shè)備斷電后數(shù)據(jù)不會丟失。

目前，F(xiàn)SKV核心庫已全面支持合宙基于LuatOS開發(fā)的產(chǎn)品。

一、FSKV核心庫主要特性

相比于傳統(tǒng)的FDB庫，F(xiàn)SKV在性能方面有顯著提升，同時保持了API的簡潔易用。通過均衡擦寫機(jī)制，F(xiàn)SKV還能有效延長Flash存儲器的使用壽命，確保在設(shè)備整個生命周期內(nèi)數(shù)據(jù)的可靠存儲。

1.1 核心特點(diǎn)：

持久化存儲：
數(shù)據(jù)寫入Flash，斷電后不丟失；

功能豐富：
提供初始化、設(shè)置、獲取、刪除等完整API，如：
fskv.init()：初始化
fskv.set(key, value)：存儲數(shù)據(jù)
fskv.get(key)：讀取數(shù)據(jù)
fskv.del(key)：刪除數(shù)據(jù)

穩(wěn)定高效：
讀寫速度恒定，不受 “臟數(shù)據(jù)” 影響，最高10萬次均衡擦寫；

優(yōu)化數(shù)據(jù)長度限制：
如value最大4096字節(jié)，key最大63字節(jié)。

1.2 實(shí)現(xiàn)原理：

FSKV核心庫原理是在模組片上Flash單獨(dú)開辟了一個總可用空間是64K的小區(qū)域，跑了個小文件系統(tǒng)，單獨(dú)操作，實(shí)現(xiàn)類似于微型數(shù)據(jù)庫的功能，只支持操作芯片自身的Flash文件系統(tǒng)，不支持操作通過IF核心庫或者SFUD核心庫掛載的文件系統(tǒng)。

簡單來說——FSKV核心庫就是一個 “嵌入式設(shè)備里的小數(shù)據(jù)庫”，專門用來安全、穩(wěn)定地存放配置或業(yè)務(wù)數(shù)據(jù)，斷電也不會丟。

▼ 關(guān)于KV鍵值對數(shù)量 ▼

FSKV一共64K，16個塊，每塊大小4K。

初始化時會分配2個塊用于小型數(shù)據(jù)，所以大型數(shù)據(jù)最多只能存儲14對，每對KV數(shù)據(jù)占據(jù)一個塊。

小型數(shù)據(jù)（Value ≤ 255 字節(jié)）

當(dāng)Value長度≤ 255字節(jié)時，所有KV對會復(fù)用初始分配的8192字節(jié)空間，極限最多存儲812對，此時V值只有1字節(jié)。

大型數(shù)據(jù)（Value ≥ 256 字節(jié)）

當(dāng)Value長度 ≥ 256字節(jié)時，每次寫入都會觸發(fā)新塊分配（4096字節(jié)），每對KV數(shù)據(jù)占據(jù)一個塊，所以大型數(shù)據(jù)最多存儲14對。

1.3 FSKV與其他存儲區(qū)域的區(qū)別：

與其他掉電不丟失的存儲區(qū)域（如OTP、IMEI、SN）不同，F(xiàn)SKV具有其獨(dú)特的適用場景和操作特性：

FSKV：
可以在LuaTools燒錄程序時進(jìn)行清除，輕量快速，適合零散配置，頻繁讀寫效率高，比如存儲串口波特率、服務(wù)器IP等用戶的應(yīng)用數(shù)據(jù)。

OTP：
加鎖后不可篡改，安全性高，適合固定關(guān)鍵數(shù)據(jù),比如存儲射頻校準(zhǔn)數(shù)據(jù)、密鑰等。

IMEI：
國際移動設(shè)備識別碼，每個設(shè)備全球唯一，永久只讀不可修改，是設(shè)備入網(wǎng)的 “身份證”,用于蜂窩模組入網(wǎng)、合規(guī)認(rèn)證等需求。

SN：
設(shè)備序列號，合宙內(nèi)部唯一，默認(rèn)只讀，可快速關(guān)聯(lián)生產(chǎn)/售后信息，方便設(shè)備管理，常用于設(shè)備售后報(bào)修、生產(chǎn)追溯等。具體使用可以參考mobile核心庫。

1.4 特別說明

針對社群工程師朋友應(yīng)用開發(fā)中的疑問，這里特別說明一下10萬次均衡擦寫的相關(guān)問題。

▼10萬次均衡擦寫 ▼

10萬次均衡擦寫——是指Flash存儲的單個單元最多能承受10萬次 “擦除 - 寫入” 循環(huán)，再通過均衡擦寫技術(shù)將數(shù)據(jù)分散到所有單元，避免個別單元提前損壞，從而延長整體設(shè)備壽命。從原理上來說，依靠均衡擦寫技術(shù)，設(shè)備能持續(xù)的穩(wěn)定使用。

社群工程師朋友提問：
均衡2個詞如何解讀?
另外, 讀是不限次數(shù)的，對吧？

簡要解答：
就是同一個地址，只能擦寫10萬次；

讀的次數(shù)不限制。

你每次寫fskv，不一定是在同一個地址，fskv的實(shí)現(xiàn)，會盡量在不同的地址擦寫，提升你的使用次數(shù)，這就叫做擦寫均衡。

二、FSKV核心庫應(yīng)用示例

提供了FSKV核心庫API的參考示例及demo實(shí)操教程，幫助開發(fā)者快速上手，實(shí)際應(yīng)用中可結(jié)合具體業(yè)務(wù)需求靈活調(diào)整。

核心示例代碼如下，完整demo詳見源碼倉庫最新文件。

審核編輯 黃宇