AmlScanKeyTool.doc

版本	日期	作者	修改
0.1	Jun 5, 2014	Jinkai.li	初稿
0.2	July 21,2014	pei.pei	添加本地文件获取Key的配置
0.3	March 5,2015	pei.pei	增加Keysprovider.dll从本地文件获取Key
0.4	June 2,2015	pei.pei	增加可烧录的Key类型为3个，初始化读取Key
0.5	Nov 18,2015	pei.pei	增加可烧录的Key类型为4个,增加对905的支持

简介

本工具主要用于产线量产KEY烧录，以扫描枪扫描标签纸条码或本地文件key为输入，然后把KEY以字符串的形式烧录到设备介质中，并在界面上直观显示烧录结果。工具支持以xml文件配置烧录的KEY的格式及长度。

1. 工位标配

PC要求：

l 2G以上主频

l 1G内存

l 主板需支持USB2.0高速模式或USB3.0主机控制器

操作系统要求：

l XP或WIN7

l 关闭杀毒类监控软件

DC：

l 5V/2.0A直流电源---为PCBA板供电。

2. 驱动安装

在烧录用PC上需要安装libusb驱动。

在没有安装libusb的PC上，当有新平台插入时，设备管理器会显示惊叹号，此时可右键－”更新设备驱动软件”－”浏览计算机以查找驱动程序软件”－选择工具安装目录“libusb-win32-bin-1.2.6.0”。安装驱动成功后设备显示为”WorldCup Device”。

3. 配置文件

工具目录下AmorchidConfig.xml配置了需要烧录的KEY，文件名不允许被修改。本文档以mac、usid为例描述配置文件的使用。如下图：

现工具支持扫描烧录三个KEY，如果需要支持三个以上的KEY则需要界面上做相应修改。name为要烧录的KEY的名称，名称必须与烧录导入的镜像包img里的KEY的配置一至。定制烧录镜像包请参考《客制化工具使用说明》by Pei Pei。

scan_format及scan_len用于对扫描获取到的条码进行格式及长度检验，这可以在一定程序上防止扫错条码。write_len表示实际烧录时的长度，因为存在这样的情况，比如：烧录mac时，扫描枪获取到的字符串为“AABBCCDDEEFF”，实际烧录到介质中是“AA:BB:CC:DD:EE:FF”，所以write_len与scan_len不同。

Algorithm则是用于从扫描字符串转化为烧录字符串的算法，“none”表示不需要转换，如果需要添加格式转换算法则需要修改工具代码。

Source是获取扫描Key的来源，当值为“scan”时，表明从工具控件读取，当值为“file”时，表明从license目录下的文件获取，不同的Key名称不同，如usid是./license/usid.ini中获取Key，deviceid是./license/deviceid.ini中获取Key，与Key文件名与二代烧录工具烧录的Key文件名相同。

注：对烧录mac，mac_bt，mac_wifi等Key，如果从文件中获取，即source=”file”时，license目录下烧录文件分别是mac_ether.ini，mac_bt.ini，mac_wifi.ini，并且需要在AmorchidConfig.xml配置中将Algorithm设置为”none”，因为从文件里读取的Key就是”AA:BB:CC:DD:EE:FF”形式，不需要工具再转化。