NVRAM学习笔记

### NVRAM学习笔记 #### 一、NVRAM定义与结构 **1.1 NVRAM概述** NVRAM，即非易失性随机访问存储器（Non-Volatile Random Access Memory），是一种特殊的RAM类型，其特点在于即使电源关闭也能保留数据。这种特性使得NVRAM成为嵌入式设备中存储关键数据的理想选择。例如，在安卓系统中，用于控制开机音效、待机画面等配置的数据通常存储于NVRAM中。 **1.2 数据安全性与完整性** 在嵌入式系统中，如智能手机或平板电脑，一些重要的属性值如用户界面设置、系统偏好等都需要持久化存储，确保即使在系统重启或崩溃的情况下也不会丢失。NVRAM通过提供数据的读写保护机制，确保了这些重要配置的安全性和完整性。 **1.3 与文件存储比较** 相较于传统的文件存储方法，NVRAM具有明显的优势： - **可靠性**：文件可能会因意外删除或损坏而导致系统故障，而NVRAM中的数据更加可靠稳定。 - **可修改性**：用户通常希望个性化修改一些配置选项，使用NVRAM可以更灵活地实现这一点。 - **性能**：在读写速度方面，NVRAM比文件存储更快，提高了整体性能。 #### 二、NVRAM的结构与管理 **2.1 NVRAM结构** NVRAM的管理主要由DataItemManagementSystem (DIMS)负责。该系统通过一个查询表（lookup table）来获取各个数据项的详细信息。查询表分为四个区域： 1. **MTReign**：用于存放项目无关的数据项。 2. **MPReign**：用于MTK/PMT通用应用程序的数据项。 3. **CTReign**：供客户使用的数据项，这部分是用户经常操作的部分。 4. **CVReign**：供供应商使用的数据项。 **2.2 NVRAM定制文件布局** NVRAM中定义LID (Location ID)的部分分布在多个文件中，每个文件负责不同类型的配置： - `nvram_data_items.h` 和 `nvram_data_items.c`：适用于MT使用的定义。 - `nvram_common_defs.h` 和 `nvram_common_config.c`：适用于MP使用的定义。 - `nvram_user_defs.h` 和 `nvram_user_config.c`：适用于CT使用的定义。 - `nvram_cust_pack.c`：适用于CustPack使用的定义。 - `nvram_vendor_config.c` 和 `nvram_vendor_defs.h`：适用于CV使用的定义。 **2.3 METAtool介绍** METAtool是用于管理和编辑NVRAM配置的工具。相关的头文件和源文件包括： - `nvram_editor_data_item.h`：适用于MT使用的定义。 - `common_nvram_editor_data_item.h`：适用于MP使用的定义。 - `custom_nvram_editor_data_item.h`：适用于CT使用的定义。 - `vendor_nvram_editor_data_item.h`：适用于CV使用的定义。 #### 三、新增NVRAM条目示例 **3.1 新增条目示例** 为了向NVRAM中添加新的条目，我们需要定义一个数据结构。例如，假设我们要添加一个名为`PRODUCT_INFO`的新条目，可以按照以下格式定义： ```c { "/data/nvram/APCFG/APRDEB/PRODUCT_INFO", VER(AP_CFG_REEB_PRODUCT_INFO_LID), CFG_FILE_PRODUCT_INFO_SIZE, CFG_FILE_PRODUCT_INFO_TOTAL, SIGNLE_DEFUALT_REC, (char *)&stPRODUCT_INFOConfigDefault, DataReset, NULL } ``` **3.2 数据结构解析** 每个新条目的数据结构如下所示： ```c typedef struct { char cFileName[FILENAMELENGTH]; // 文件名 char cFileVer[FILEVERLENGTH]; // NVRAM文件版本信息 int i4RecSize; // 记录大小 int i4RecNum; // 记录总数 FILE_DEFAULT_TYPE stDefualType;// 默认记录类型 } NVRAM_ITEM; ``` 其中，`cFileName`表示文件名，`cFileVer`为文件版本信息，`i4RecSize`和`i4RecNum`分别代表单个记录的大小和记录总数，`stDefualType`则定义了默认记录的类型。 通过这种方式，我们可以有效地管理和更新NVRAM中的各项配置，确保系统稳定运行的同时，还能够根据需求进行灵活调整。