Doc NVEditor User Guide

NVEditor User GuideVersion: 1.0.7DocCode: SW -BASE-UG -0004Date: 2011-08-29重要声明版权声明本文档中的任何内容受中华人民共和国著作权法的保护，版权所有 2008，展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。商标声明展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。不作保证声明展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。保密声明本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。前 言文档说明NVEditor主要是用来编辑并保存通讯模块中NV参数。它通过串口将模块中的NV参数读出，并提供一个界面可用于对参数进行添加和修改，并将修改后的结果重新写进模块中。本文档介绍了NVEditor软件工具的使用方法。阅读对象本文档适合相关人员使用。内容介绍本文档包括三个章节，分别为： 第一章：简要操作流程。简单介绍了NVEditor的运行环境和简要操作流程； 第二章：具体操作说明。介绍了NVEditor的详细使用方法； 第三章：相关文件。描述了NVEditor的一些相关文件。文档约定本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意：提醒操作中应注意的事项。说明：说明比较重要的事项。相关文档目 录第1章 概述1-11.1 系统概述1-11.2 文件组成1-11.3 运行环境1-2第2章 简要操作流程2-32.1 简要操作流程2-32.1.1 运行程序2-32.1.2 打开一个NVEditor工程文件2-32.1.3 从模块中读出参数值2-32.1.4 编辑相应的参数并保存结果2-32.1.5 将修改后的参数写回模块中2-32.1.6 保存工程文件并退出2-4第3章 具体操作说明3-13.1 主界面3-13.2 参数编辑窗口3-13.2.1 列表框3-13.2.2 编辑参数值3-33.2.3 添加参数项3-33.3 菜单3-63.3.1 文件3-63.3.2 工具3-103.4 工具栏3-133.5 命令行3-13第4章 相关文件4-14.1 工程文件4-14.2 参数模块文件4-14.3 参数映像文件4-14.4 可以修改的值4-14.5 注意4-1附录A Revision HistoryA-1-v-第3章 具体操作说明第1章 概述1.1 系统概述NVEditor工具用于编辑和保存NV参数，具体功能如下：l 通过串口，读手机中的NV参数l 为编辑NV参数，提供图形界面l 通过串口，写NV参数到手机1.2 文件组成本工具包含一个可执行文件，五个动态链接库文件和六个配置文件，如表 11所示。表 11 文件组成类型文件名称可执行文件NVEditor.exe动态链接库文件BMPlatform.dllChannel.dllChanMan.dllCommSock.dllCommUart.dll配置文件BMError.iniBMFileType.iniBMTimeout.iniChannel.iniFunctions.iniNVEditor.ini1.3 运行环境本软件运行于Windows 2000 平台下，并要求至少有一个可用的串口与模块通讯。第2章 简要操作流程2.1 简要操作流程2.1.1 运行程序运行NVEditor.exe程序。2.1.2 打开一个NVEditor工程文件可以通过下面三种方法： 选择菜单FileOpenProject； 单击工具栏图标“OpenProject”； 在File菜单项下有最近打开的工程列表，直接选择其中之一。2.1.3 从模块中读出参数值(1) 将模块正确连接到串口；(2) 选则菜单FileLoadFromPhone；(3) 在弹出的对话框中设置正确的串口参数。单击ok按钮，即可读出参数。2.1.4 编辑相应的参数并保存结果双击要修改的值或选择要修改的值按敲回车键，将出现一个编辑框，输入新的值即可。如图 21所示。图 21 编辑参数2.1.5 将修改后的参数写回模块中(1) 将模块正确连接到串口；(2) 选择菜单项FileSaveToPhone；(3) 在弹出的对话框中，设置正确的串口参数。单击按钮即可。2.1.6 保存工程文件并退出保存工程文件并退出。3-13第3章 具体操作说明3.1 主界面如图 31所示。图 31 NVEditor主界面3.2 参数编辑窗口3.2.1 列表框参数编辑窗口以树形列表的形式显示参数，如图 32所示。图 32 列表框列表一共分为七栏，下面分别进行介绍。 Item Name参数项的名称。如果该参数项有子项，在该项前会显示一个加号。单击加号或双击该项即可展开子项。 Item Value参数项的值。如果是工程项或模块项，则显示相应文件的全路径名。如果是参数项，则显示其数值。数值默认为十进制，如果要输入十六进制，请在数值前加上“0x”。双击该栏或选中该栏敲回车键即可编辑该数值。注意：由于参数错误可能会造成硬件损坏，所以一些重要的参数是不允许修改的。仅有部分参数可以修改。 Data Type参数项的数据类型，包括： Project：工程文件。最顶层的项，有且仅有一个； Module：一个参数模块； Struct：该参数项是一个结构，包含许多子项； Array：该参数项是一个数组； Char：该参数项是一个字符； Short：该参数项是一个16位整数； Long：该参数项是一个32位整数； ASTRING：该参数项是ANSI字符串； WSTRING：该参数是一个Unicode字符串； Item Description参数项的说明，用以描述该参数的含义等等。 Item ID参数项的识别码。所有的参数在Flash中是按数据块存放的，每一个识别码对应于一个Flash中数据块，具有相同识别码的参数存于同一个数据块中。 Item Type参数项的类型。目前全部为Item。 Item State参数项的状态。目前全部为Inactive。3.2.2 编辑参数值双击相应参数项的Item value栏，或先选中该栏再按回车键，即会出现一个编辑框，如图 33所示，输入新的值即可。如果是数值，默认为十进制。若输入十六进制，请在数值前加上“0x”前缀。图 33 编辑参数3.2.3 添加参数项用户可以添加自定义的参数项。 添加参数项菜单选中需添加参数项的位置，单击鼠标右键，弹出如图 34所示菜单，选择相应的命令。图 34 添加参数项菜单图 34各菜单项说明如表 21所示。表 31 添加参数项菜单说明菜单项说明Insert before在当前参数项前面插入新项。选择后将弹出对话框要求用户输入添加项的属性。请参见“ 新增项对话框”Insert after在当前参数项后面插入新项。选择后将弹出对话框要求用户输入添加项的属性。请参见“ 新增项对话框”Insert a child item插入项作为当前项的子项。选择后将弹出对话框要求用户输入添加项的属性。请参见“ 新增项对话框”注意：只有“Data type”为“struct”和“array”的项才能有子项Remove an item删除当前项。程序将要求用户确认删除操作Cut将当前选择的项放入剪贴板，粘贴后删除Copy将当前选择的项放入剪贴板Paste as child将剪贴板中的项作为当前选择的项的第一个子项粘贴Paste after将剪贴板中的项作为当前选择的项的后一个兄弟项粘贴 新增项对话框如图 35所示。图 35 新增项对话框图 35界面元素说明如表 22所示。表 32 新增项对话框说明菜单项说明“Name”文本输入框输入参数项的名字，对应于列表中的item name栏“ID”文本输入框输入参数项的辨识符。对应于列表中的Item ID栏“Type”下拉选择框在下拉框中选择参数项的类型。对应于列表中的Data type栏“Value”文本输入框输入参数项的值。对应于列表中的Item Value栏“String Length”文本输入框输入字符串类型（ASTRING，WSTRING）的长度“Element As Array”复选框勾选是否是数组“Array Size”文本输入框数组元素的个数“Description”文本输入框输入参数项的描述。对应于列表中的Item Description栏 粘贴设置对话框在粘贴某一项时会弹出一个对话框（如图 36所示），在此可以改变粘贴项的名字和ID（原始的项不会受影响）。如果不需要改动，请选中相应的选择框。图 36 粘贴设置对话框注意：如果粘贴的项如果有子项，那么修改名字只影响到待粘贴的项的最上层的那个，所有子项的名称仍保持不变；但如果修改ID的情况下，所有项（包括子项）的ID都会被修改。3.3 菜单3.3.1 文件文件菜单如图 37所示。图 37 文件菜单文件部分菜单项说明如表 23所示。表 33 文件部分菜单项说明菜单项说明Open Project打开工程文件，也可以选择打开NVM文件。Save Project保存工程文件Save Project As留原工程文件，将改动保存到另一个工程文件中。执行完毕后，程序将关闭当前的工程文件并打开新保存的工程文件Load Image从参数的映像文件中读取参数值Load From Phone通过串口从硬件中读出参数，并填入到当前打开的参数文件中。Load From Phone(Normal Mode)在硬件模块开机模式下读取参数；Load from Phone(Boot Mode)在硬件模块Boot模式下读取参数。在进行该项操作前，请确保正确设置了端口Save Image将参数值保存至参数映像文件。生成的参数映像文件文件名为NVItem.bin，存放在工程文件所在目录Save to Phone通过串口将参数写进硬件模块中。在进行该项操作前， 请确保正确设置了端口。注意：只有模块处于boot模式才能执行此功能。如何将模块转换到boot模式，请参见相关硬件说明。Close Project关闭当前打开的工程文件。如果有所改动，会提示保存Exit退出程序 New在当前工程文件中加入用户自定义的参数模块。如图 38所示。图 38 New菜单New菜单说明如表 24所示。表 34 New菜单说明菜单项说明New Project生产一个新的工程文件New Module在参数模块列表最后添加一个新的参数模块。要求输入新建参数模块的信息，参见图 39和表 25New Item在一个模块中生产新的项Insert Module把一个已生成的参数模块文件加入到当前工程中。新添加的模块名不能与已有模块名相同，否则无法加入。新加入的模块文件将被拷贝到工程文件所在目录图 39 New Module对话框表 35 New Module界面说明界面元素说明“Module Name”文本输入框参数模块的名字。不需要给路径，程序会自动在当前工程目录下建立相应的文件“Description”文本输入框参数模块的说明按钮单击该按钮将建立参数模块文件，并关闭对话框按钮单击该按钮将只创建参数模块文件而不关闭对话框，可以紧接着创建下一个文件按钮单击该按钮浏览前一个参数模块文件，也与之类似 Port Settings如图 310所示。图 310 Port Setting对话框图 310说明如表 26所示。表 36 Port Setting界面说明界面元素说明“Port”下拉选择框通讯模块连接的串口“Buadrate”下拉选择框串口通讯所用的波特率“FDL File”文本输入框FDL文件路径。FDL文件为用于将参数写入硬件模块的文件。将由Spreadtrum提供，随程序一起发布“FDL Base”文本输入框FDL文件下载地址。“Product Type”下拉选择框选择产品的类型。不同的产品对应不同的NV地址。如果所用的版本没有包含在列表中，请选择Customize，然后在下面的输入框中输入正确的地址“Second fdl”文本输入框当选择的产品使用的是NAND Flash时，这个编辑框和右边的按钮变成可使用状态，用法与选择FDL文件一样“Second fdl base ”文本输入框Second FDL文件下载地址。注意：FDL，Second FDL和NV的地址选项只影响Load from phone（Boot Mode）操作和Save to phone 操作。使用时确保地址的正确性。3.3.2 工具工具菜单如图 311所示。图 311 工具菜单工具部分菜单项说明如表 27所示。表 37 工具部分菜单项说明菜单项说明Read Flash(不再支持)针对Nor Flash的读功能。使用此功能时，“PortSettings”对话框中的“FDL”不能为空，“Second Fdl”为空Erase Flash针对Nand Flash的擦除功能。使用此功能时，“PortSettings”对话框中的“FDL”不能为空，“Second Fdl”为空Read Nand Flash(不再支持)针对Nand Flash的读功能，用法与Read Flash相同。使用此功能时，“PortSettings”对话框中的“Second Fdl”不能为空，否则会自动弹出“Port Settngs”对话框Erase Nand Flash针对Nand Flash的擦除功能，用法与Erase flash相同。使用此功能时，“PortSettings”对话框中的“Second Fdl”不能为空，否则会自动弹出“Port Settngs”对话框Load NV Values(不再支持)导入从Phonetester工具中导出的数据Import导入(*.nv)文件Mofiy Funcstions一些常用的修改NV值的方法。Find(F) Ctrl+F按名字查找项FindNext查找下一个 Read Flash读Flash的内容。如图 312所示。图 312 Read Flash对话框在弹出的对话框中填入准备读出的Flash空间的起始地址和长度，再给出存放文件的路径即可。注意：此处使用的串口设置是在“Port settings”中设置好的。如果没有设置过，会首先弹出串口设置的对话框。 Erase flash擦除Flash。如图 313所示。图 313 Erase Flash对话框在弹出的对话框中填入准备擦除的Flash空间的起始地址和长度。注意：此处使用的串口设置是在“Port settings”中设置好的。如果没有设置过，会首先弹出串口设置的对话框。 Modify Functions修改NV值的组合功能。如图 314所示：图 314 修改NV值的功能对话框在弹出的对话框中勾选需要修改NV的功能组合。点击Execute按钮，执行的结果在“Execute Result”中列出。 查找点击Find菜单项，或者按Ctrl+F，弹出如下对话框：图 315 查找对话框在弹出的对话框中设置查询内容，查找不区分大小写，如果勾选“Full Character Match”则进行全匹配查找。可以点击菜单FindNext，或责按F3，查找下一项。3.4 工具栏工具栏图标如图 316所示。图 316 工具栏图标工具栏图标说明如表 28所示。表 38 工具栏图标说明图标说明打开工程保存工程将参数值写入话机按下时，列表中的ItemContent列中，数值以十六进制显示，否则以十进制显示版本信息3.5 命令行工具支持命令行操作具体参数如下：NVEditor.exe. yyy.nv dsp.bin zzz.txt L W 其中，xxx.prj为prj文件，必须参数，其他为可选参数 yyy.nv 为工具导出的NV项文件 dsp.bin 写DSP文件到NV bin文件 zzz.txt 为工具运行出错的log文件 -L 如果有这选项，则表示生成的NV bin文件是little endian 否则默认为big endian W 由于命令行运行工具时，工具会另外创建一个控制台窗口，并且执行完后，就会关闭，该选项，表示让这个窗口等待，这样可以直接查看一些错误信息，而无需指定zzz.txt文件。举例： NVEditor.exe D:nvitem.prj D:IMEI.nv D:error.txt -L -W第4章 相关文件4.1 工程文件存放着参数模块文件的名称和数目的信息。后缀名为“.prj”。4.2 参数模块文件为了便于对NV参数进行管理，可以将NV参数进行分类，每一类的参数存为一个单独的文件，即参数模块文件，后缀名为“.nvm”，与工程文件在同一目录下。4.3 参数映像文件根据所有的NV参数值生成的二进制文件，存放着将要写入硬件Flash中的内容，与Flash中的格式是完全一样的。该文件将由程序自动生成。每次改动参数后，选择菜单FileSave Image程序就会创建该文件。执行菜单命令FileSave To