NV 使用方法

NV 使用方法

NV 简单介绍

NV是Nonvolatile(非失忆的)的简称，手机里与电源无关需要永久存储的(如系统有关的)数据由NV来管理。

在REX（Real-time Executive System）里，NV是由MC(Main Control)起的一个task(进程), 并依靠EFS(Embedded File system)为其他DMSS的成员提供服务。

NV 是干什么的

手机需要永久保存(手机无开机时也存在，在非失意性介质上)的数据一般以下两种：一种是内容比较大，一般以文件为单位的，数据无规律性，如：声音文件，图片等多媒体文件。另一种是数据量比较小，一般已变量为单位的，数据结构已定的，如标记手机状态的一些变量，通话记录，短信等有规则的大小不变的比较零碎性的数据（一般是系统数据）。

NV 是针对第二种数据

为什么引进NV？

（1）简单化文件操作

首先NV是基于EFS上的，NV是对文件操作的又一次封装，它为DMSS提供统一的数据存储接口，从这角度看NV简化了各task的文件操作,只要发一个命令给NV Task 就行。同时使程序更条理清晰，易于维护和理解。NV就是REX的存储相关模块，与文件操作或数据存储相关的这部分交给NV来处理。

（2）使各task 存储数据更加将灵活方便

有了NV以后，各task 存储数据更加灵活，无论多么复杂的数据(数据结构)，只要把这个数据结构告诉NV Task以后，就按照自己的结构来读写就行，不需考虑数据存储相关的事情，也不需要做文件操作。如下图：每个nv项在fs里对应着一块存储空间。

怎么用NV

因为NV是一个task，操作系统服务层的动西，所以读写nv 需要有个task的支持，因为nv操作需要给nv task 发读写信号，并等待nv task 的恢复信号等等。

对于底层（如驱动，其他task）的各task都自己的nv 操作函数。

对于上层的如sms下面专门task 支持，在task里面有NV操作接口。这些模块可以从app 层可以跟到自己的task和nv操作接口（如SMSNV_Get）。其他Setting、BT 之类的（这具体在哪nv操作各模块自己来决定）公用OEMNV 来做nv操作，就是OEMNV_Get() OEMNV_Put() 这两个接口。OEMNV 是专门为读写NV设计的，基于OEM task。上层很多应用都通过它来NV操作。

所以用到nv 操作的模块要找到自己的nv操作接口。不过所有nv 读写接口基本上都一样的。下面OEMNV为例看看怎么做NV操作。

读NV项

// 定义一个公用缓冲区

nv_item_type nvi;

// 读nv项NV_RINGER_ LEVEL _I

OEMNV_Get( NV_RINGER_ LEVEL _I, &nvi );

然后可以用自己的数据了

int a ＝nvi.ringer_level; 写数据也一样，

写NV项

nv_item_type nvi; // 定义一个公用缓冲区

nvi.ringer_level = 10000; // 填缓冲区

// 写数据

OEMNV_Put( NV_RINGER_ LEVEL _I, &nvi );

下面以NV_RINGER_LVL_I这个nv项为例说明用户怎么添加一个自己的nv项。

假设你要存储一个铃声大小的值，类型为byte

那么你给nv manager 提供以下信息（自己不需要定义任何东西）：

（1）NV_RINGER_LEVEL_I你要用的nv项名字，或者说你要存储数据的名称，以后通过这个枚举你可以得到自己需要的数据。这个枚举是nv这边定义，你不需

要定义只负责提出。这个枚举起名规则一般NV_aaaaaa_I(aaaaa 是你自己

的，起的时候尽量能够说明你数据的含义)

（2 要存储的数据类型（关于nv需求模版另有文档说明）

这里byte 型的，不需要新的数据类型。所以只提供：

byte ringer_level; 就可以了

nv manager 按你的需求添加完这个NV项后，然后就可以用这个NV项了。

写数据

nv_item_type nvi;

nvi. ringer_level = 1000;

OEMNV_Put( NV_RINGER_ LEVEL _I, &nvi );

读数据

nv_item_type nvi;

OEMNV_Get( NV_RINGER_ LEVEL _I, &nvi );

然后nvi. ringer_level 就是你需要的数据

就这么简单，读数据get 写数据put就行了。

再看一个用到新数据类型的

按模板填好的需求为

Purpose：ringer volume

T ype Enum：NV_STS_ITEM_VOL_RINGER_I

Variable Name: sts_item_vol_ringer

Structure Define：

需求表明：需要存储一个nv_V olumeInfo_type结构的数据。

Struct {

Int nV olLevel;

Boolean bAlwaysVibrate;

Boolean bRingerOff;

Boolean bV ibrateAll;

Boolean bSilenceAll;

Boolean bV ibrateAll;

}nv_V olumeInfo_type；

nv项名为NV_STS_ITEM_VOL_RINGER_I，

变量名为sts_item_vol_ringer（nv_V olumeInfo_type类型的）

写数据

nv_item_type nvi;

nvi. sts_item_vol_ringer.nV olLevel = 3;

nvi. sts_item_vol_ringer.bAlwaysVibrate _ = FALSE;

nvi. sts_item_vol_ringer.bRingerOff _ = FALSE;

OEMNV_Put( NV_RINGER_ LEVEL _I, &nvi );

读数据

nv_item_type nvi;

OEMNV_Get( NV_RINGER_ LEVEL _I, &nvi );

Nvi. sts_item_vol_ringer是自己的数据

这里稍说明一下nv_item_type，nv_item_type是nv定义的一个联合体，就是为了给用户提供一个统一接口。代码里可以看到typedef PACKED union {

/* NV Poke Operation */

nv_poke_type poke;

/* NV Peek Operation */

nv_peek_type peek;

……………………

byte ringer_level;

nv_VolumeInfo_type sts_item_vol_ringer；

} nv_item_type；