统一动态库工具使用说明

统一动态库工具使用说明

目录

统一动态库工具使用说明 ............................................................................................................... 1

简介........................................................................................................................................... 1 设置工具的语言 ....................................................................................................................... 1 如何使工具认到以MSC功能连接电脑的设备? .................................................................... 2 读写序列号 ............................................................................................................................... 3 读写Mac、BT和IMEI ............................................................................................................. 4 读写自定义数据 ....................................................................................................................... 5 MAC和VendorID ...................................................................................................................... 6 常见错误处理 ........................................................................................................................... 7 Kernel中读取512自定义空间数据 ....................................................................................... 8

简介

统一动态库工具可以将一些重要数据写入设备并且保护这部分数据在后续升级过程中不会丢失。目前实现序列号、Mac地址、BT地址、Imei号和自定义数据的读写功能,可以支持RK28，RK29和RK30系列芯片。

设置工具的语言

打开工具目录下config.ini配置文件,修改[Language]下的Selected项,Selected=1(中文界面), Selected=2(英文界面),保存配置文件,重启工具.注意：当在非中文系统下设置成英文时,需要保证工具所在路径上没有中文字符.

如何使工具认到以MSC功能连接电脑的设备?

当烧过固件的设备直接连接电脑时，一般会被认为Msc单功能设备或者复合设备。由于每种Msc设备的Vid和Pid各不相同，所以需要通过配置工具来达到搜索特定Ｍsc设备.那如何知道Msc设备的Vid和Pid？下面以xp为例子,其他系统大致相同:

? 将Msc设备连接电脑,电脑成功认到Msc设备后,在”我的电脑”或者”计算机”中确认已经出现这个设备的可移动磁盘

? 打开”设备管理器”,在”通用串行总线控制器”下找到”USB Mass Storage Device”设备，如下图:

? 查看”USB Mass Storage Device”的属性,在弹出窗口的详细信息页中，找到设备实例ID,在其中会发现Vid和Pid的值，如下图:

? 打开config.ini文件,找到Msc_Vid项和Msc_Pid项,这边设置使用上图设备的值.Msc_Vid=0x0BB4,Msc_Pid=0x0C02.设置完成

后保存，重启工具即可。

读写序列号

注意：序列号支持的最大长度30个字符

? 如何限制序列号输入的最大长度:打开config.ini文件，找到SN_LENGTH项进行设置

? 如何设置序列号字符的宽度，让序列号刚好填满输入框，不至于空太多也不至于超出.打开config.ini文件,找到SN_CHAR_WIDTH项进行设置

? 在人工模式下，如何在写入序列号后自动清空输入框内容:打开config.ini文件，找到CLEAR_AFTER_WRITE项，设置为１.此种模式适用于通过扫描方式进行输入的情况

? 在自动增长模式下,如何控制前导的某些字符不参与进位:打开config.ini文件，找到SN_AUTO_PREFIX_LEN项，设置成前导固件字符的长度，假设设备成５，则输入的序列号前５个字符不参与进位

? 在自动增加模式下，进位支持十进制和十六进制,通过界面上的单项按钮进行选择。一般在选择自动增加模式后就要确认进位模式

? 人工模式和自动增加模式区别：人工模式序列号由人为进行输入，自动增加模式是每次序列号写入成功后都会自动增加。使用自动增加模式时，要先在人工模式下输入起始序列号，然后

点选自动增加模式 ? 写序列号步骤：

１. 连接设备，确认工具界面上发现设备 ２. 输入序列号，选择人工模式还是自动增加模式 ３. 写序列号 ? 读序列号步骤：

１. 连接设备，确认工具界面上发现设备 ２. 读序列号

读写Mac、BT和IMEI

? 有一个地址段，希望按顺序将这个地址段中的地址写入设备，如何实现？

１. 首先在界面上选择”文件导入”

２. 在工具目录下有对应的Mac.ini,BT.ini,Imei.ini三个文件，将地址段按如下方式填入，保存。

３. 点击文件导入旁边的选择文件按钮，选择对应的文件，如果加载成功，界面会有如下显示:

? 读写Mac、BT和IMEI的步骤同序列号

读写自定义数据

注意:自定义数据空间和前面的序列号、Mac、BT、IMEI等数据共用一个空间,所以当使用自定义数据进行写入时，会覆盖掉之前写入的序列号等数据。自定义数据空间最大支持512字节，因此当使用自定义数据时,请将序列号等数据也组织在自定义数据中，一并写入。 ? 如何配置自定义数据：在配置区域内右击鼠标，会出现如下菜

单：

1. 增加:增加自定义项，在写入前，工具会合并所有自定义项到512字节的自定义空间并写入. 2. 删除:删除自定义项 3. 清空:删除所有自定义项

4. 上移:将选中的自定义项上移一个位置 5. 下移: 将选中的自定义项下移一个位置 6. 导入配置:加载之前保存的配置文件

7. 导出配置: 当所有自定义项都配置好后，可以使用此功能将配置信息保存成文件，方便以后使用 ? 如何编辑自定义项:

1. 偏移:自定义数据项写入的起始位置，取值范围(0-511),双击进行输入

2. 名字:自定义数据项的名字,只是标识不进行写入，双击进行

输入

3. 值类型:有三种类型:文件,字符串和数值，字符串和数值都在值那一列进行输入,当选择文件时，可以点击’…’进行选择，字符串时数据项的长度为字符串长度加1,数值长度则根据数值的大小决定，在1-4字节范围。文件则根据文件实际长度决定

? 读写自定义数据步骤同读写序列号

MAC和VendorID

注意：MAC和VendorID烧写只支持通过读取ini文件配置。配置示例：

ini文件格式详细说明：

? [ADDRESS] 为MAC地址分配区域：

MAC地址分配区域包含以下三部分：START部分是起始Mac地址；END部分是结束MAC地址；CURRENT部分是当前分配到的地址。 ? [CUSTOM]为VendorID分配区域: [VALUE]为VendorID的值：

第一个字节表示自定义数据的个数，用16进制表示，比如02；第一个字节之后的数据为用户在自定义数据，数据用16进制表示，每个数据之间用空格隔开数据个数不能超过96个（不包括第一个数据）。

1. .读取设备

a) 连接设备，确认工具界面上发现设备

b) 勾选需要读取的设备信息（注意：勾选对应选项烧写勾选框） c) 点击读取设备按钮进行读取设备信息 2. 文件导入

选择配置好ini文件导入 3. 烧写

a) 连接设备，确认工具界面上发现设备 b) 勾选需要烧写的设备信息选项 c) 点击烧写按钮进行设备信息烧写 4. 自动烧写

勾选“自动烧录”选项后，只要识别到设备就自动烧录；中途可以去除勾选“自动烧录”停止自动化烧录。

常见错误处理

? 序列号无效:在自动增加模式下,注意输入的序列号是否满足自动进位要求,也是说当选择十进制进位时,所有序列号必须是数字,当选择十六进制进位时,所有序列号必须是0-F的字符 ? Mac地址无效:Ｍac地址只支持两种格式:00-11-22-33-44-55-66或者00112233445566，检查输入的字符是否都是0-A字符,当在文件模式下,当前地址是否超出地址段范围. ? Ｂt地址无效:原因和处理方式同上

? Imei地址无效:Imei的长度是否为15,Imei是否都是0-9数字，在文件模式下,当前地址是否超出地址段范围.

? 合并自定义数据失败:计算一下每个自定义项的长度范围，检查是否存在重叠，每个自定义项的结束位置不能超出512，文件类型时，文件是否存在或者被占用

? 写入序列号失败｜写入Mac地址失败|写入Bt地址失败|写入Imei失败|写入自定义数据失败:截个图,同时将工具所在目录中的log目录下当天的日志文件发给RK的接口人进行处理

Kernel中读取512自定义空间数据

? 调用GetSNSectorInfo(pbuf)

注：GetSNSectorInfo在文件\\drivers\\mtd\\rknand\\api_flash.h里面定义，需要在flash 驱动加载后才能调用，pbuf参数大小需要大于等于512 bytes

? 通过序列号、Ｍac、Bt和Imei功能进入写入的数据按以下结构进行解析前面读取到的pBuf数据

SECTOR3 0-1 2-31 32-127 128-450 451 452-466 SN Size SN BID\\VendorID Reserved IMEI Size IMEI Data 序列号长度 序列号数据 Board id或者Vendor id 数据 自定义数据区 IMEI长度(固定为15) 手机设备识别码 467 468-497 498 499-504 505 506-511 UID Size UID Data BT Size BlueTooth Mac Size Mac UID长度(固定为30) 唯一识别码 蓝牙地址长度(固定为6) 蓝牙地址 网卡地址长度(固定为6) 网卡地址 1. 序列号和Imei都是以字符串的形式保存,不包括结束字符NULL 2. Ｍac和Bt按每两个字符的数值进行保存，例如:00—11-22-33-44-55-66，被保存成６个字节数值为:0,17,34,51,68,85

?

通过自定义功能写入的数据:按自己定义的格式进行解析

本文来源：https://www.bwwdw.com/article/i902.html