统一动态库工具使用说明

《统一动态库工具使用说明》由会员分享，可在线阅读，更多相关《统一动态库工具使用说明（10页珍藏版）》请在装配图网上搜索。

1、统一动态库工具使用说明目录统一动态库工具使用说明1简介1设置工具的语言1如何使工具认到以MSC功能连接电脑的设备?2读写序列号3读写 Mac、BT 和 IMEI 4读写自定义数据5MAC 和 VendorID6常见错误处理7Kernel 中读取 512 自定义空间数据 8简介统一动态库工具可以将一些重要数据写入设备并且保护这部分数据在后续升级过程中不会丢失。目前实现序列号、Mac地址、BT地址、 Imei 号和自定义数据的读写功能,可以支持 RK28，RK29 和 RK30 系列芯片。设置工具的语言打开工具目录下config.ini配置文件，修改Language下的Selected 项,Sel

2、ected=1 （中文界面）,Selected=2（英文界面）,保存配置文件，重 启工具.注意：当在非中文系统下设置成英文时,需要保证工具所在 路径上没有中文字符.如何使工具认到以MSC功能连接电脑的设备?当烧过固件的设备直接连接电脑时，一般会被认为Msc单功能设 备或者复合设备。由于每种Msc设备的Vid和Pid各不相同，所 以需要通过配置工具来达到搜索特定Msc设备那如何知道Msc设 备的Vid和Pid?下面以xp为例子，其他系统大致相同：将Msc设备连接电脑，电脑成功认到Msc设备后，在我的电脑或 者”计算机”中确认已经出现这个设备的可移动磁盘打开”设备管理器，在”通用串行总线控制器”下

3、找到”USB MassStorage Device” 设备，如下图：亦川甲1 I乏疋T7応再匚色 HUAWEI filobila 亡az亡配TnteL CR3 TCHLO Family Txl t L CBC：1 ICHL U ri ly TnteL tR ICHLD Family Til t c：L QO ICHL U F-jt. i ly Tnt-L CR3 ICHLO FamiZL Tn t eL i：JL：i ICHL U Faniily TntaL CR ICHLO Family TnteL CR 工匚HLD Family US王 C omp o s i X E: D 右*i 亡&B

4、 E-IsrsIsrs.Js后J5JHH H H H H c .-.I 3 L- H 三五 n rl-rrrr Ecaelle 皆 pv苗wv- i i - a i i i nrLdnnnA VI IZAC oikt r -z-Ll cr C OXkt r Kj_1 s2-t C il troll r t C :-ri_ti_ c-11 -r L IZ an.-Ek- al 1 hx- t C :-rLtr口 11 t CdlLtlTDllfiir t C c-TLtr ol 1 亡iUS万芸晦 Dsvi.ce1JST； R-：.：. KibUSB Rqq-L KUL1JST； R-：.：.

5、Kib 查看”USB Mass Storage Device 的属性，在弹出窗口的详细信息页中，找到设备实例ID,在其中会发现Vid和Pid的值，如下图:后保存，重启工具即可。读写序列号注意：序列号支持的最大长度 30 个字符如何限制序列号输入的最大长度：打开config.ini文件，找到 SN_LENGTH 项进行设置 如何设置序列号字符的宽度，让序列号刚好填满输入框，不至 于 空 太 多 也 不 至 于 超 出 . 打 开 config.ini 文 件 , 找 到 SN_CHAR_WIDTH 项进行设置 在人工模式下，如何在写入序列号后自动清空输入框内容 ：打 开 config.ini 文

6、件，找到 CLEAR_AFTER_WRITE 项，设置为1 .此 种模式适用于通过扫描方式进行输入的情况 在自动增长模式下,如何控制前导的某些字符不参与进位：打开 config.ini 文件，找到 SN_AUTO_PREFIX_LEN 项，设置成前导固 件字符的长度，假设设备成5,则输入的序列号前5个字符不 参与进位 在自动增加模式下，进位支持十进制和十六进制 ,通过界面上 的单项按钮进行选择。一般在选择自动增加模式后就要确认进 位模式 人工模式和自动增加模式区别：人工模式序列号由人为进行输 入，自动增加模式是每次序列号写入成功后都会自动增加。使 用自动增加模式时，要先在人工模式下输入起始序列

7、号，然后点选自动增加模式写序列号步骤：1 连接设备，确认工具界面上发现设备2 输入序列号，选择人工模式还是自动增加模式3 写序列号 读序列号步骤：1 连接设备，确认工具界面上发现设备2 读序列号读写 Mac、BT 和 IMEI 有一个地址段，希望按顺序将这个地址段中的地址写入设备，如何实现？1 首先在界面上选择”文件导入”2 .在工具目录下有对应的Mac.ini,BT.ini,lmei.ini三个文件，将地址段按如下方式填入，保存。|ADDRESSSTART=00-80-00-00-00-00END=FF-FF-FF-FF-FF-FFCURRENT=0O-00-Q0-0Q-O1-0H3 点击文

8、件导入旁边的选择文件按钮，选择对应的文件，如果加载成功，界面会有如下显示:地址段开始地址：00-00- 00-03-00-00貉束地址：FF-FF-FF-FF-PF-FF当前地址：0000_0 0_000104 读写 Mac、BT 和 lMEl 的步骤同序列号读写自定义数据注意:自定义数据空间和前面的序列号、Mac、BT、IMEI等数据共用一 个空间,所以当使用自定义数据进行写入时，会覆盖掉之前写入的序 列号等数据。自定义数据空间最大支持 512 字节，因此当使用自定义 数据时,请将序列号等数据也组织在自定义数据中，一并写入。如何配置自定义数据：在配置区域内右击鼠标，会出现如下菜 单：1. 增

9、加:增加自定义项，在写入前，工具会合并所有自定义项 到 512 字节的自定义空间并写入.2. 删除:删除自定义项3. 清空:删除所有自定义项4. 上移:将选中的自定义项上移一个位置5. 下移: 将选中的自定义项下移一个位置6. 导入配置:加载之前保存的配置文件7. 导出配置: 当所有自定义项都配置好后，可以使用此功能 将配置信息保存成文件，方便以后使用 如何编辑自定义项:偏移名字值类型值1. 偏移:自定义数据项写入的起始位置，取值范围(0-511),双击进行输入2. 名字:自定义数据项的名字,只是标识不进行写入，双击进行输入3. 值类型:有三种类型:文件,字符串和数值，字符串和数值都 在值那一

10、列进行输入，当选择文件时，可以点击进亍选择, 字符串时数据项的长度为字符串长度加 1,数值长度则根据 数值的大小决定，在 1-4 字节范围。文件则根据文件实际 长度决定读写自定义数据步骤同读写序列号MAC 和 VendorID注意:MAC和VendorlD烧写只支持通过读取ini文件配置。配置示例：ADDRESSSTART=00-00-00-00-00-00师二FF-FF-FF-FF-FF-FFCURRENT二00-00-00-00-01-54CUSTOMVALUE=02 EC DIini 文件格式详细说明： ADDRESS为MAC地址分配区域：MAC 地址分配区域包含以下三部分： START

11、 部分是起始 Mac 地址； END部分是结束MAC地址；CURRENT部分是当前分配到的地址。 CUSTOM为 VendorlD 分配区域：VALUE为 VendorID 的值：第一个字节表示自定义数据的个数，用16进制表示，比如02；第一 个字节之后的数据为用户在自定义数据，数据用16进制表示，每个 数据之间用空格隔开数据个数不能超过96个（不包括第一个数据）。1.读取设备a）连接设备，确认工具界面上发现设备b）勾选需要读取的设备信息（注意：勾选对应选项烧写勾选框）c）点击读取设备按钮进行读取设备信息2. 文件导入选择配置好ini文件导入3. 烧写a）连接设备，确认工具界面上发现设备b）勾

12、选需要烧写的设备信息选项c）点击烧写按钮进行设备信息烧写4. 自动烧写勾选“自动烧录”选项后，只要识别到设备就自动烧录；中途可以去除勾选“自动烧录”停止自动化烧录。常见错误处理序列号无效:在自动增加模式下，注意输入的序列号是否满足自动进位要求,也是说当选择十进制进位时,所有序列号必须是数 字,当选择十六进制进位时,所有序列号必须是 0-F 的字符 Mac地址无效:Mac地址只支持两种格式:00-11-22-33-44-55-66或者 ，检查输入的字符是否都是 0-A 字符,当 在文件模式下,当前地址是否超出地址段范围. Bt地址无效:原因和处理方式同上 Imei地址无效:lmei的长度是否为1

13、5,lmei是否都是0-9数字,在文件模式下,当前地址是否超出地址段范围. 合并自定义数据失败:计算一下每个自定义项的长度范围,检 查是否存在重叠,每个自定义项的结束位置不能超出512,文 件类型时,文件是否存在或者被占用写入序列号失败丨写入Mac地址失败|写入Bt地址失败|写入Imei 失败|写入自定义数据失败:截个图,同时将工具所在目录中的log目录下当天的日志文件发给RK的接口人进行处理Kernel中读取512自定义空间数据 调用 GetSNSectorInfo(pbuf)注：GetSNSectorlnfo 在文件driversmtdrknandapi_flash.h 里 面定义,需要在

14、 flash 驱动加载后才能调用, pbuf 参数大小需要大 于等于 512 bytes通过序列号、Mac、Bt和Imei功能进入写入的数据按以下结构进行解析前面读取到的 pBuf 数据SECT0R30-1SN Size序列号长度2-31SN序列号数据32-127BIDWendorlDBoard id 或者 Vendor id 数据128-450Reserved自定义数据区451IMEI SizeIMEI长度(固定为15)452-466IMEI Data手机设备识别码467UID SizeUID长度（固定为30）468-497UID Data唯一识别码498BT Size蓝牙地址长度（固定为6）499-504BlueTooth蓝牙地址505Mac Size网卡地址长度（固定为6）506-511Mac网卡地址1. 序列号和 Imei 都是以字符串的形式保存,不包括结束字符 NULL2. M ac和Bt按每两个字符的数值进行保存，例 如：0011-22-33-44-55-66 , 被保存成6个字节数值 为:0,17,34,51,68,85通过自定义功能写入的数据:按自己定义的格式进行解析 打开 config.ini 文件,找到 Msc_Vid 项和 Msc_Pid 项,这边设置使用上图设备的值.Msc Vid=0x0BB4,Msc Pid=0x0C02.设置完成