一、背景
SNV（Simple Non-Volatile，简单的非易挥发），是从内部 flash 末尾划分大约 1~4K大小的一块专用于存储数据的存储空间。一般用于存储协议栈必要的存储数据、用户的应用数据。类似于 STM32 的片内 EEPROM。
NV（Non-Volatile，非易挥发） 是 16 位 ID，而 SNV 是简化版的 NV 只有 8 位 ID。
1.1 SNV大小
两页，共 4K（协议栈已使用一部分）。
1.2 可用SNV的ID号
在Bcomdef.h中
// Device NV Items - Range 0 - 0x1F
#define BLE_NVID_IRK 0x02 //!< The Device's IRK
#define BLE_NVID_CSRK 0x03 //!< The Device's CSRK
#define BLE_NVID_SIGNCOUNTER 0x04 //!< The Device's Sign Counter
#define BLE_LRU_BOND_LIST 0x05 //!< The Device's order of bond indexes in least recently used order
// Bonding NV Items - Range 0x20 - 0x5F - This allows for 10 bondings
#define BLE_NVID_GAP_BOND_START 0x20 //!< Start of the GAP Bond Manager's NV IDs
#define BLE_NVID_GAP_BOND_END 0x5f //!< End of the GAP Bond Manager's NV IDs Range
// GATT Configuration NV Items - Range 0x70 - 0x79 - This must match the number of Bonding entries
#define BLE_NVID_GATT_CFG_START 0x70 //!< Start of the GATT Configuration NV IDs
#define BLE_NVID_GATT_CFG_END 0x79 //!< End of the GATT Configuration NV IDs
// Customer NV Items - Range 0x80 - 0x8F - This must match the number of Bonding entries
#define BLE_NVID_CUST_START 0x80 //!< Start of the Customer's NV IDs
#define BLE_NVID_CUST_END 0x8F //!< End of the Customer's NV IDs
可见 0x80~0x8F 是用户可以用（包含 0x80、0x8F），每个 ID 号最多一次可写入 252 字节。
注：实际可以写几个 ID 取决于所剩余 SNV 空间，并不是说可以把所有 ID 号都写满 252字节。
1.3 工程中可选的SNV大小
可在编译器的预编译处写入三种宏，不同的宏表示不同 SNV 大小：
① OSAL_SNV = 0
0 个可写 SNV 页。工程中不使用 SNV，由于绑定信息时需要 SNV，该操作将导致无法使用绑定功能。
② OSAL_SNV = 1
1 个可写 SNV 页，共 2K。
③ OSAL_SNV = 2（默认）
2 个可写 SNV 页，共 4K。
注：如果没有在编译器中定义 OSAL_SNV，在协议栈代码中会自动被复制为 2，也就是默认用 4K的 SNV。
二、注意事项
1) 仿真时编译器会擦除 flash 全片数据，SNV 数据也会被擦除。
2) 写 1K 字节到 SNV，怎么写？
可以每个 ID 写 252 字节，一共需要 4 个 ID（1000/252=3.96）。
3) 为什么有些工程使用不了 SNV（比如组网的例程）？
因为组网例程所需 flash 较大，因此该工程的 SNV 部分被充分利用在了组网部分。
可以看工程的预编译中包含了“OSAL_SNV=0”。
4) 写 SNV 会耗时百毫秒级，尽可能在写的时候关闭中断。
5) 尽可能地少写 SNV，因为它耗时耗电。
6) 如果 SNV 的存储结构改变，或者协议栈版本升级了，有必要重新擦除和初始化 SNV 内存数据，否则读写时会出错。
7) 尽量不要把 SNV 的代码放到中断函数里，建议单独弄个事件处理 SNV。
8) 一次最多只能对一个 ID 写 252 个字节，写多时虽然返回值仍然是“SUCCESS”，但实测读出来的数据是错的。
三、移植文件
链接：https://pan.baidu.com/s/1fzlCQEthZHpK5qd3rr3JDA 提取码：3nbv
将 snv_flash.c 和 snv_flash.h 两个文件拖拽至CCS工程的Application文件夹下
添加文件过程中，选项选择如下
3.1 snv_flash.c
/*********************************************************************
* INCLUDES
*/
#include "osal_snv.h"
#include "snv_flash.h"
/*********************************************************************
* PUBLIC FUNCTIONS
*/
/**
@brief SNV读写内存操作
@param snvId NV页数
@param readWriteFlag 读写操作标志
@param pData 指向需要操作的数据
@param dataLen 数据长度
@return SUCCESS - 成功；FAILURE - 失败
*/
uint8 Snv_FlashContrl(uint8 snvId, uint8 readWriteFlag, uint8 *pData, uint8 dataLen)
{
if(readWriteFlag == SNV_READ) // 读取数据
{
return osal_snv_read(snvId, dataLen, pData);
}
else // 写入数据
{
return osal_snv_write(snvId, dataLen, pData);
}
}
/*************************************END OF FILE*************************************/
3.2 snv_flash.h
#ifndef _SNV_FLASH_H_
#define _SNV_FLASH_H_
/*********************************************************************
* DEFINITIONS
*/
#define SNV_READ 0x00
#define SNV_WRITE 0x01
#define CUSTOM_SNV_ID 0x80 // 使用的ID，用户可用0x80~0x8F
#define CUSTOM_SNV_NUM 252 // 此ID使用到的字节数
/*********************************************************************
* API FUNCTIONS
*/
uint8 Snv_FlashContrl(uint8 snvId, uint8 readWriteFlag, uint8 *pData, uint8 dataLen);
#endif /* _SNV_FLASH_H_ */
四、API调用
需包含头文件 snv_flash.h
Snv_FlashContrl
| 功能 | SNV读写内存操作 |
|---|---|
| 函数定义 | uint8 Snv_FlashContrl(uint8 snvId, uint8 readWriteFlag, uint8 *pData, uint8 dataLen) |
| 参数1 | snvId NV页数 |
| 参数2 | readWriteFlag 读写操作标志 |
| 参数3 | pData 指向需要操作的数据 |
| 参数4 | dataLen 数据长度 |
| 返回 | SUCCESS - 成功；FAILURE - 失败 |
五、使用例子
1）添加头文件（例 multi_role.c 中）
#include "snv_flash.h"
2）定义一个数据缓存区（例 multi_role.c 中）
// 数据缓冲区
static uint8 s_testData[256] = {0};
3）添加读取数据代码（multi_role.c 的 multi_role_init 函数末尾中）
// 读取保存在SNV中的数据
Snv_FlashContrl(CUSTOM_SNV_ID, SNV_READ, (uint8 *)s_testData, CUSTOM_SNV_NUM);
4）添加写入数据代码（在某个事件回调函数中）
// SNV写入内存
Snv_FlashContrl(CUSTOM_SNV_ID, SNV_WRITE, (uint8 *)s_testData, CUSTOM_SNV_NUM);
• 由 Leung 写于 2019 年 4 月 11 日
网友评论