QuecPython产测工具使用指导手册

文档历史

简介

QuecPython产测工具是专用于QuecPython项目模块出厂测试的工具，方便对出厂前已经烧录正式固件的模块进行相关的功能测试，本文档主要介绍如何使用该工具，在电脑使用以下任一种操作系统时，该工具可直接使用

• Windows7
• Windows10
• Windows11

适用模块：

所有使用QuecPython开发的模块均可使用

页面介绍

菜单栏 包括配置菜单和日志菜单

配置菜单 用于配置自动检测串口以及测试脚本和测试结果文件

日志菜单 用于查看测试日志文件和工具运行日志文件

加载栏 包括 加载测试文件和配置文件，其中测试文件为要测试的测试文件，配置文件为测试完成之后要写入到模块的配置文件

测试区域 包括 端口、IMEI、ICCID、测试时间、测试结果和测试日志，其中测试日志按钮可以查看测试脚本执行的日志结果，工具有八个测试栏位最多可一次性同时测试八个设备，也可以单独测试某个设备。

状态栏 包括欢迎标语和状态信息以及时间信息，其中状态信息会伴随工具运行状态进行切换，时间信息会跟随系统时间变化

注意：测试的模块需要保证交互口不处于堵塞状态，否则测试将失败

测试脚本

测试脚本编写时需要注意不得改动原有模板代码结构，建议编写完之后先在模块中手动运行测试，确认运行结果是否满足预期，测试脚本模板中需要改动的位置有两个

导入模块：导入测试中用到的python库

测试函数：自行编写测试函数，函数名可以自定义，但是需要是静态方法且无法传参，函数体内容根据测试需求自定义，函数需要有返回值，可以是bool或者其他类型（其他类型不会校验测试结果），返回值会在日志中体现，当测试结果不满足预期，需要将测试结果设置为失败时，只需返回布尔值False即可，测试函数案例如下：

# 检测sim卡状态正常并且驻网状态为LTE时测试成功，否则返回失败测试结果
@staticmethod
def det_signal():
	if sim.getStatus() == 1:
		if net.getConfig()[0] == 5:
			return True
     else:
     	return False

测试脚本示例：

测试步骤

步骤一：编辑测试module_test.py代码，测试代码案例如上图所示

步骤二：打开 Factory Tool，点击 Load Py File 按钮，选择上一步编辑好的测试代码

步骤三：如果测试完有需要写入到模块中的配置文件，点击 **Load Json File **选择要写入的配置文件，将会在测试成功之后将该配置文件写入模块

步骤四：点击 Start All 按钮开始测试所有已接入的模块，也可以通过单独点击端口对应列的 Start 按钮来测试某一个模块,测试超时时间2min

步骤五：测试完成后可在测试结果栏位看到测试结果，如果测试结果失败，可点击对应失败的那一列的日志按钮来查看测试日志，从而可定位到具体哪一项测试失败

步骤六：测试完成后会在工具同级目录下生成Test-Result.xlsx文件，包含测试项目内容以及测试结果日志

测试结果

每一个模块的的测试结果会写入到excel中导出，可以通过菜单栏的 配置 中的 **测试结果文件 **菜单打开该excel文件，该文件会保存在工具同级目录下

同时测试结果会上传到云端生成报表以供云端查看整体测试结果（开发中）

文件下载

使用Ymodem协议下载文件到模块中（开发中）

环境配置

安装依赖库

pip install -r requirements.txt

运行代码

python main.py

编译成exe程序

pyinstaller -F-w --win-private-assemblies --icon images/quectel.ico -w ./main.py