低功耗4G模组：Air780EP之fskv开发示例

​今天我们学习合宙低功耗4G模组Air780EP的fskv开发示例。

一、简介

• 兼容fdb的函数
• 使用fdb的flash空间,启用时也会替代fdb库
• 功能上与EEPROM是类似的

fskv与fdb的实现机制导致的差异

功能	fskv	fdb
value长度	4096	255
key长度	63	64
空间利用率(对比)	较低	较高
读取速度	恒定	脏数据影响速度,非恒定
写入数据	恒定	脏数据影响速度,非恒定
均衡擦除	自动	自动

二、环境准备

2.1 Air780EP开发板一套

三、程序介绍

3.1 API介绍

详细API介绍见：fskv-API

3.2 初始化kv数据库

fskv.init()

参数

无

返回值

返回值类型	解释
boolean	成功返回true,否则返回false

3.3 设置一对kv数据

fskv.set(key, value)

参数

传入值类型	解释
string	key的名称,必填,不能空字符串
string	用户数据,必填,不能nil, 支持字符串/数值/table/布尔值, 数据长度最大4095字节

返回值

返回值类型	解释
boolean	成功返回true,否则返回false

3.4 设置table内的键值对数据

fskv.sett(key, skey, value)

参数

传入值类型	解释
string	key的名称,必填,不能空字符串
string	table的key名称, 必填, 不能是空字符串
string	用户数据,必填,支持字符串/数值/table/布尔值, 数据长度最大4095字节

返回值

返回值类型	解释
boolean	成功返回true,否则返回false/nil

3.5 根据key获取对应的数据

fskv.get(key, skey)

参数

传入值类型	解释
string	key的名称,必填,不能空字符串
string	可选的次级key,仅当原始值为table时有效,相当于 fskv.get(key)[skey]

返回值

返回值类型	解释
any	存在则返回数据,否则返回nil

3.6 根据key删除数据

fskv.del(key)

参数

传入值类型	解释
string	key的名称,必填,不能空字符串

返回值

返回值类型	解释
bool	成功返回true,否则返回false

3.7 清空整个kv数据库

fskv.clear()

参数

无

返回值

返回值类型	解释
bool	成功返回true,否则返回false

3.8 kv数据库迭代器

fskv.iter()

参数

无

返回值

返回值类型	解释
userdata	成功返回迭代器指针,否则返回nil

3.9 kv迭代器获取下一个key

fskv.next(iter)

参数

传入值类型	解释
userdata	fskv.iter()返回的指针

返回值

返回值类型	解释
string	成功返回字符串key值, 否则返回nil

3.10 获取kv数据库状态

fskv.status()

参数

无

返回值

返回值类型	解释
int	已使用的空间,单位字节
int	总可用空间, 单位字节
int	总kv键值对数量, 单位个

四、实现流程

4.1 使用luatools工具下载固件和脚本到开发板中

4.2 通过luatools打印查看效果：

​

由上图可以看出，fskv支持存放布尔，数值，小数，字符串，等均可。还可以存放table类型的值。但不能存放nil, function, userdata, task类型的值。

五、常见问题

NVM坏了的话会不会影响fskv存储？

不同的flash互不影响。

​审核编辑 黄宇