學(xué)好 4G 模組 fskv 開發(fā)示例，開啟通信輝煌篇章原創(chuàng)

發(fā)布于 2024-10-30 15:26

瀏覽

0收藏

今天我們要學(xué)習(xí)的是4G模組 fskv 開發(fā)示例，以低功耗4G模組Air780EP為例，從程序介紹，流程，問題等方面入手，讓我們更好掌握G模組 fskv 開發(fā)。

1、簡(jiǎn)介

兼容fdb的函數(shù)
使用fdb的flash空間,啟用時(shí)也會(huì)替代fdb庫
功能上與EEPROM是類似的

fskv與fdb的實(shí)現(xiàn)機(jī)制導(dǎo)致的差異

功能	fskv	fdb
value長(zhǎng)度	4096	255
key長(zhǎng)度	63	64
空間利用率(對(duì)比)	較低	較高
讀取速度	恒定	臟數(shù)據(jù)影響速度,非恒定
寫入數(shù)據(jù)	恒定	臟數(shù)據(jù)影響速度,非恒定
均衡擦除	自動(dòng)	自動(dòng)

2、環(huán)境準(zhǔn)備

2.1 Air780EP開發(fā)板一套

3、程序介紹

3.1 API介紹

詳細(xì)API介紹見：fskv-API

3.2 初始化kv數(shù)據(jù)庫

fskv.init()

參數(shù)

無

返回值

返回值類型	解釋
boolean	成功返回true,否則返回false

3.3 設(shè)置一對(duì)kv數(shù)據(jù)

fskv.set(key, value)

參數(shù)

傳入值類型	解釋
string	key的名稱,必填,不能空字符串
string	用戶數(shù)據(jù),必填,不能nil, 支持字符串/數(shù)值/table/布爾值, 數(shù)據(jù)長(zhǎng)度最大4095字節(jié)

返回值

返回值類型	解釋
boolean	成功返回true,否則返回false

3.4 設(shè)置table內(nèi)的鍵值對(duì)數(shù)據(jù)

fskv.sett(key, skey, value)

參數(shù)

傳入值類型	解釋
string	key的名稱,必填,不能空字符串
string	table的key名稱, 必填, 不能是空字符串
string	用戶數(shù)據(jù),必填,支持字符串/數(shù)值/table/布爾值, 數(shù)據(jù)長(zhǎng)度最大4095字節(jié)

返回值

返回值類型	解釋
boolean	成功返回true,否則返回false/nil

3.5 根據(jù)key獲取對(duì)應(yīng)的數(shù)據(jù)

fskv.get(key, skey)

參數(shù)

傳入值類型	解釋
string	key的名稱,必填,不能空字符串
string	可選的次級(jí)key,僅當(dāng)原始值為table時(shí)有效,相當(dāng)于 fskv.get(key)[skey]

返回值

返回值類型	解釋
any	存在則返回?cái)?shù)據(jù),否則返回nil

3.6 根據(jù)key刪除數(shù)據(jù)

fskv.del(key)

參數(shù)

傳入值類型	解釋
string	key的名稱,必填,不能空字符串

返回值

返回值類型	解釋
bool	成功返回true,否則返回false

3.7 清空整個(gè)kv數(shù)據(jù)庫

fskv.clear()

參數(shù)

無

返回值

返回值類型	解釋
bool	成功返回true,否則返回false

3.8 kv數(shù)據(jù)庫迭代器

fskv.iter()

參數(shù)

無

返回值

返回值類型	解釋
userdata	成功返回迭代器指針,否則返回nil

3.9 kv迭代器獲取下一個(gè)key

fskv.next(iter)

參數(shù)

傳入值類型	解釋
userdata	fskv.iter()返回的指針

返回值

返回值類型	解釋
string	成功返回字符串key值, 否則返回nil

3.10 獲取kv數(shù)據(jù)庫狀態(tài)

fskv.status()

參數(shù)

無

返回值

返回值類型	解釋
int	已使用的空間,單位字節(jié)
int	總可用空間, 單位字節(jié)
int	總kv鍵值對(duì)數(shù)量, 單位個(gè)