MTK-NVRAM研究（二）

zhiye1027

MTK之NVRAM研究[二]



二，再来看“透明逻辑数据元”

这样的数据项已经实现了的三个数据项：
     1，byte 数据项；
     2，short数据项；
     3，double数据项；

这些数据项都已经实现了数据项LID的定义，数据项的定义和值的定义；如：
LID: 在文件Nvram_user_defs.h中：

        NVRAM_EF_CACHE_BYTE _LID = NVRAM_LID_CUST_BEGIN,
        NVRAM_EF_CACHE_SHORT _LID,
        NVRAM_EF_CACHE_DOUBLE _LID,

size:custom_mmi_default_value.h中：
#define NVRAM_CACHE_SIZE                512         //很明显byte,short ,double的数据项都有512个记录，一个记录只有一个byte值 ；
#define NVRAM_CACHE_TOTAL               1      

新增数据项在文件：Nvram_user_config.h中
ltable_entry_struct logical_data_item_table_cust[] =
{
{
  NVRAM_EF_CACHE_BYTE_LID,
  NVRAM_CACHE_SIZE,                          // 512
  NVRAM_CACHE_TOTAL,                    //1
  NVRAM_EF_ZERO_DEFAULT,
  NVRAM_ATTR_AVERAGE,
  NVRAM_CATEGORY_USER | NVRAM_CATEGORY_CUSTPACK | NVRAM_CATEGORY_SHADOW_MS,
  "CT00",
  VER(NVRAM_EF_CACHE_BYTE_LID),
  "1-byte Setting\0",
  NVRAM_RESERVED_VALUE
}
,{
  NVRAM_EF_CACHE_SHORT_LID,
  NVRAM_CACHE_SIZE,                             // 512
  NVRAM_CACHE_TOTAL,                     // 1
  NVRAM_EF_ZERO_DEFAULT,
  NVRAM_ATTR_AVERAGE,
  NVRAM_CATEGORY_USER | NVRAM_CATEGORY_CUSTPACK | NVRAM_CATEGORY_SHADOW_MS,
  "CT01",
  VER(NVRAM_EF_CACHE_SHORT_LID),
  "2-byte Setting\0",
  NVRAM_RESERVED_VALUE
}
,{
  NVRAM_EF_CACHE_DOUBLE_LID,
  NVRAM_CACHE_SIZE,                            //512
  NVRAM_CACHE_TOTAL,                      //1
  NVRAM_EF_ZERO_DEFAULT,
  NVRAM_ATTR_AVERAGE,
  NVRAM_CATEGORY_USER | NVRAM_CATEGORY_CUSTPACK | NVRAM_CATEGORY_SHADOW_MS,
  "CT02",
  VER(NVRAM_EF_CACHE_DOUBLE_LID),
  "8-byte Setting\0",
  NVRAM_RESERVED_VALUE
}
...

默认值：
  kal_uint8 const NVRAM_EF_ZERO_DEFAULT[] = { 0x00 };
我们先来看一个条目的数据结构：


上图中显示，当total_records ＝＝ 1时，说明这个LID为透明数据元，size就表示这个逻辑数据项的大小；比如byte，那么就是size＝1*512；
如果 total_records != 1 时，说明这个LID为线性固定数据元，total_records 就是记录的个数，size就是每个记录的大小；
(    lzq注 ：我们从这两种数据元的特征中可以得出这样的结论：

                   透明数据元相当于一维数组；已经实现了的数据项LID就相当于一个数组byte record[ Record_ID ]; 其中数组个数512; Recodr_ID为枚举ID；
                                                                                                                                             short  record2[ Record_ID ];  //Record_ID由用户自己定义并初始化；
                                                                                                                                           double record3[ Recodr_ID ];

                  线性固定数据元相当于二维数组 ：已经实现了的数据项LID就相当于My_type_struct    records[  total_records ][ size  ];

）
由此分析，我们可以直接当做一个byte数据项的一个记录来直接添加到里面；即在数组record[]中的某个位置从新添加一个值；而不需要另外去实现一个新的byte的LID；大大的简化了操作；而且在byte，short，double的数据项里新添加一个数据很方便，具体只有两步骤：
1，定义menu_ID
            
           typedef enum
           {
               ......
                #ifdef __HQ_CLAMSHELL_TONE__CONTROL__                //参考yj的一个滑盖声音模块的LID；
                 NVRAM_CLAMSHELL_TONE_CONTROL_SETTING,           //定义一个Record_ID;
                 #endif
               ......
              
             NVRAM_LAST_BYTE_ELEMENT
           } BYTEDATA;


2，将这个数组值设置一个默认值；
                #ifdef __HQ_CLAMSHELL_TONE__CONTROL__
                 BYTE_ENTRY(    NVRAM_CLAMSHELL_TONE_CONTROL_SETTING   ,   0x01 ),  //默认值为0x01;
               #endif

Appendix:
一，当数据都已经定义完后剩下的就是怎么使用这个数据了；
对透明数据（一维数组）的读写操作有：
               WriteValue (NVRAM_CLAMSHELL_TONE_CONTROL_SETTING, &data, DS_BYTE, &error);
                ReadValue (NVRAM_CLAMSHELL_TONE_CONTROL_SETTING, &data, DS_BYTE, &error);

对线性固定数据元（二维数组）的读写操作有：
          ReadRecord (
                NVRAM_EF_TIMING_SMS_LIST_LID,                            //参考宏：__HQ_TIMING_SMS__
                (U16) (i + 1),
                (void*)&(g_timingsms_cntx.TaskList),
                NVRAM_TIMING_SMS_LIST_RECORD_SIZE,
                &error);
            WriteRecord (
                NVRAM_EF_TIMING_SMS_LIST_LID,
                (U16) (index + 1),
                (void*)&(g_timingsms_cntx.TaskList[index]),
                NVRAM_TIMING_SMS_LIST_RECORD_SIZE,
                &error);

二，现在来看下NVRAM的META工具中用到的‘位级别的注释’（bit_level description）；  
   也就是在上面的步骤6和步骤7中的操作；
先让我们来看个资料：NVRAM  LID脚本

　　　这个特殊的脚本能够用来描述NVRAM　LID;在编译的过程中，这个脚本会解析并且将信息保存到有cgen.exe生成的数据库中；PC工具（如META工具）可以利用这个数据库去解析这个LID的原始数据；这个脚本可以被保存在一个头文件中并将在由cgen.exe解析之前进行预处理；程序员可以利用标准c语言（,//注释）去编程，并且可以用宏　“#define”　去控制；
例如：
typedef struct {


kal_uint8 context_id;
kal_uint8 nsapi;
kal_uint8 pdp_addr_type;
kal_uint8 pdp_addr_len;
kal_uint8 addr_val[4];
qos_struct req_qos;
qos_struct min_qos;
kal_uint8 apn_len;
kal_uint8 apn[100];
kal_uint8 pcomp_algo;
kal_uint8 dcomp_algo;
kal_uint8 context_type;
kal_uint8 primary_context_id;
kal_uint8 is_sib_defined;


} nvram_ef_tcm_PDP_profile_record_struct;　　　　//lzq:第六步：定义META工具使用的数据结构 　　；

typedef struct {


kal_uint8 qos_length;
kal_uint8 unused1;
kal_uint8 delay_class;
kal_uint8 reliability_class;
kal_uint8 peak_throughput;
kal_uint8 unused2;
kal_uint8 precedence_class;
kal_uint8 unused3;
kal_uint8 mean_throughput;
kal_uint8 traffic_class;
kal_uint8 delivery_order;
kal_uint8 delivery_of_err_sdu;
kal_uint8 max_sdu_size;
kal_uint8 max_bitrate_up_lnk;
kal_uint8 max_bitrate_down_lnk;
kal_uint8 residual_bit_err_rate;
kal_uint8 sdu_err_ratio;
kal_uint8 transfer_delay;
kal_uint8 traffic_hndl_priority;
kal_uint8 guarntd_bit_rate_up_lnk;
kal_uint8 guarntd_bit_rate_down_lnk;


} qos_struct;                                                       //lzq:在这个例子中，有嵌入式结构体定义；实现原理一样，不过要用到'" 、"来获得子成员变量 ；

BEGIN_NVRAM_DATA
LID_BIT VER_LID(NVRAM_EF_TCM_PDP_PROFILE_LID) nvram_ef_tcm_PDP_profile_record_struct*1
{


context_id: "" {};　//lzq:这个是上面定义的数据结构（第６步中实现的）nvram_ef_tcm_PDP_profile_record_struct中的成员变量 ；
addr_val: "Statistic PDP address value, in MSB" {};//lzq:语法：　结构体成员变量名　："描述语"　{更多子项，可以为空 };
addr_val[0]
{
addr_v1:4 " Address Value 1" {};
addr_v2:4 " Address Value 2" {};
};
req_qos: "Requested QoS" {};
req_qos.qos_length: "Length of QoS" {};
req_qos.unused1: "Delay Class"
{
req_qos_identifier:3 " Request QoS Identifier"
{
0x0:"Req QoS Invaild";
0x2:"Req QoS Vaild";
0x4:"Req QoS Under Verifing";
};
req_qos_list:2
{
0x0:"Req QoS List 1";
0x1:"Req QoS List 2";
0x2:"Req QoS List 3";
};
};
req_qos.delay_class: "Delay Class" {};
req_qos.reliability_class: "Reliability Class"
{
reliablity_class:8
{
0x00: "Realiablity Class Zero";
0x01: "Realiablity Class Low";
0x02: "Realiablity Class Medium";
}
}
req_qos.peak_throughput: "Peak Throughput" {};
apn: "APN string" {} ;


};
END_NVRAM_DATA

再来看第二个例子，透明数据员bity的描述实现：
typedef struct
{
    kal_uint8 CacheByte[NVRAM_CACHE_SIZE];
} nvram_cache_byte_struct;

    LID_BIT VER_LID(NVRAM_EF_CACHE_BYTE_LID)
     nvram_cache_byte_struct *NVRAM_CACHE_TOTAL
     {
         CacheByte :"One-byte parameter setting";
         CacheByte [14]　　　　　　　　　　//lzq:这里表示在结构体成员变量CacheByte[]数组的第１４个数据项的描叙 ；
         {
           default_lang:8 "Default Language"　　　//default_lang: 8 ---表示直接显示这个串；　"Default Language"---表示对这个数据项的补充说明；
             {
             };
         };

         CacheByte[24]　　　　　　　　　　//lzq:这里表示在结构体成员变量CacheByte[]数组的第２４个数据项的描叙 ；　　　　
         {
           time_zone:8 "Time Zone (Current City)"
             {
             };
         };
         CacheByte[25]　　　　　　　//lzq:这里表示在结构体成员变量CacheByte[]数组的第２５个数据项的描叙 ；
         {
           date_format:8 "Time Format"
             {
             };
         };

         CacheByte[26]　　　　　//lzq:这里表示在结构体成员变量CacheByte[]数组的第２６个数据项的描叙 ；
         {
           date_format:8 "Date Format"
             {
             };
         };
   
更多的实现功能可以参考原程序中的定义实现，再结合META工具去查看该数据项的显示效果；

lzq自己添加的LID项，如下图；


在实现的过程中，遇到一个问题：
　　　　当我们完成所有的步骤（７步）后，当用META工具察看时却发现不了自己新添加的那个LID:NVRAM_EF_MY_NEW_DATA_LID;

分析原因：
　　　　没有看到LID说明两个问题：１，在实现的过程中有的地方出错；
                                                                   2，在用META工具查看时，选择了不对的datebase(数据库)，导致手机database和META工具的database版本不对；

操作：

              在检查了所有的原代码后，确认没有出错，再从新new了一遍后，重新用META工具查看时，出现如下图的错误：

               
说明在选择database时选择了错误的版本，因此用META工具看到的还是原来的老的版本的数据，因此看不到我们新添加的LID;



end  2009-7-17 下午 05:36:39