[技术讨论]

剑池产测工具概述

2022-3-9 07:12:43 3036 芯片接口

1. 概述

剑池产测工具是一款由阿里巴巴集团平头哥半导体有限公司开发的生产测试工具（支持Windows7/10 32/64位系统），能够支持多产品、多工位、多路并发的产测需求。
剑池产测工具包含产测管理系统和工位程序两部分。提供了可配置化界面，可快速完成产测配置。集成了日志系统，生产数据可按时间戳记录，方便生产数据的统计分析和产品故障定位。

2. 架构和功能特性

2.1 架构

剑池产测工具是通过工位程序来适配不同芯片产品的产测，通过工位配置文件来设计产品产测内容。

2.2 主要功能

可动态配置最多16路的并发产测测试

支持工位程序定制化

支持手动、自动测试模式切换

支持配置产测测试项，以及工位合并和拆分

支持在执行测试前启动后台服务程序（如ftp、http等服务）

支持生产数据加密

3. 开发

开发分为工位程序和工位配置文件两种。

3.1 工位程序

工位程序上层接口和剑池产测工具对接，下层接口和下位机对接；其中与剑池工具对接需要按照约定的格式实现，包括剑池产测工具调用工位程序以及工位程序返回结果两部分。

3.1.1 调用接口

格式为：

工位程序+"taskid和timeout"+cmd内容

其中taskid为并发id号（从1开始编号），timeout为工位配置配置文件中设置的超时时间，cmd内容为工位配置文件中配置的命令。

参考例子如下：

BLE_Production/Ble_Isp/Ble_Isp.exe --taskid 1 --timeout 3000 flash -P COM1 -F 115200 -w image.hexf

其中的"BLE_Production/Ble_Isp/Ble_Isp.exe"为工位程序的名称及路径，taskid后面的1为第1路并发，timeout后面的3000为超时时间3000ms，“flash -P COM1 -F 115200 -w image.hexf”为cmd的配置内容，传递给工位程序做处理。
注意：路径分割使用"/"

3.1.2 结果返回

工位程序通过标准输出口stdout返回测试结果以及打印信息。
测试结果为json格式（result、reason和extra为关键字，其中的reason和extra可选），如下：

{"result":"xxx", "reason":"xxx", "extra":[自定义对象列表]}

参考例子如下：

{"result":"SUCCESS"}
{"result":"FAIL", "reason":"BLE disconnect"}
{"result":"SUCCESS", "extra":[{"SN":"SN00001"}]}
{"result":"FAIL", "extra":[{"rx_cur":"2.5mA", "tx_cur":"6.0mA"}, {"rx_cur":"2.51mA", "tx_cur":"6.01mA"}]}

其中的SN、rx_cur、tx_cur在工位配置文件中定义。

注意：

工位程序自定义打印信息不能包含字符"{"和"}"。

打印信息和结果不建议使用中文字符，如确有需要需以UTF-8编码格式防止显示乱码。

3.2 工位配置文件

工位配置文件中最主要的是json配置的编写。
下面将通过继电器复位演示简单介绍下工位配置json文件，控制继电器先断开，再耦合两个步骤实现芯片的复位。

{
"version": "1.0.0",
"name": "继电器复位演示",
"fileVersion": "0.0.1",
"mode": "manual",
"program": "T-Head_CH340_Relay/T-Head_CH340_Relay.exe",
"tasks": 1,
"configurable": [
      {
         "key": "COMRELAY",
         "name": "继电器串口",
         "value": "COM3"
      }
],
"cases": [
      {
         "ordernum": 6,
         "name": "模组复位",
         "program": "T-Head_CH340_Relay/T-Head_CH340_Relay.exe",
         "steps": [
            {
                  "seq": 1,
                  "name": "模组进入复位",
                  "cmd": "$COMRELAY$ wakeupon",
                  "timeout": 2000,
                  "result": "SUCCESS"
            },
            {
                  "seq": 2,
                  "name": "模组退出复位",
                  "cmd": "$COMRELAY$ wakeupoff",
                  "timeout": 3000,
                  "delay": 3000,
                  "result": "SUCCESS"
            }
         ]
      }
]
}
3.2.1 字段介绍

字段	说明
version	固定字段，内容为 1.0.0
name	必选项，内容为用户自定义，一般用于说明这个配置文件的用途
fileVersion	必选项，格式为x.y.z，具体内容为用户自定义，一般用于说明文件的修改版本，方便查看和分发
mode	必选项，内容为 auto 或 manual；其中auto为自动测试模式，manual为手动测试模式
program	指定使用那一个工位程序，需要带相对路径或绝对路径信息
tasks	配置默认的路数测试，最多为16路；该参数可以通过界面更改
configurable	可选项，可配置参数设置指定了里面的内容可通过界面修改，内容格式为key、name、value(s)。这里设置了一个COMRELAY=COM3，在case的cmd中所有的$COMRELAY$ 都会被替换为COM3；注意如果这个值通过界面修改后，替换时会使用新的值）
cases	必选项，用于配置测试项和步骤

3.2.2 cases内部字段介绍

字段	说明
ordernum	必选项，定义测试项的执行顺序；测试过程是安装从最小到最大的顺序执行
name	必选项，内容为用户自定义，并会显示在测试界面上；一般用于概况整个测试项的用途
program	可选项，指定工位程序；如果定义了，在这个测试项中覆盖3.2.1 中定义的program内容
steps	必选项，定义测试项的测试步骤
seq	必选项，测试步骤编号，测试过程是安装编号从最小到最大的顺序执行步骤
name	必选项，测试步骤名称，一般用于描述该步骤的内容
cmd	必选项，测试命令参数，用于传递给工位程序的参数
timeout	必选项，测试超时时间；如果在给定的时间内工位程序没有返回结果则剑池产测工具认为这次测试失败，并退强制退出工位程序；同时这个值也会传递给工位程序，参见3.1.1 节
result	必选项，用户自定义内容，用于判断工位程序返回的结果是否成功；如果result定义的内容和3.1.2中返回的result内容一致，则认为工位程序执行成功