QuecPython产测工具こうぐ是ぜ专用于QuecPython项目模も块出厂测试的工具こうぐ，方便ほうべん对出厂前已やめ经烧录正式せいしき固かた件けん的てき模も块进行ぎょう相しょう关的功こう能のう测试，本文ほんぶん档主要よう介かい绍如何なん使用しよう该工具ぐ，在ざい电脑使用しよう以下いか任にん一种操作系统时，该工具こうぐ可か直接ちょくせつ使用しよう

• Windows7
• Windows10
• Windows11

适用模も块：

所有しょゆう使用しようQuecPython开发的てき模も块均可か使用しよう

git clone --recurse-submodules https://github.com/QuecPython/FactoryTool.git

菜さい单栏 包括ほうかつ配置はいち菜さい单和日び志こころざし菜さい单

配置はいち菜さい单 用よう于配置はいち自じ动检测串口こう以及测试脚本きゃくほん和わ测试结果文ぶん件けん

日にち志こころざし菜さい单 用よう于查看み测试日び志文しぶみ件けん和わ工具こうぐ运行日び志文しぶみ件けん

加か载栏 包括ほうかつ 加か载测试文件けん和わ配置はいち文ぶん件けん，其中测试文ぶん件けん为要测试的てき测试文ぶん件けん，配置はいち文ぶん件けん为测试完成かんせい之の后きさき要よう写うつし入いれ到いた模も块的配置はいち文ぶん件けん

测试区域くいき 包括ほうかつ 端はし口こう、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

测试脚本きゃくほん示しめせ例れい：

产测工具こうぐ利用りようpython脚本きゃくほん的てき形式けいしき来らい测试QuecPython产品的てき业务功こう能のう，通つう过CDC口こう来らい执行测试脚本きゃくほん，测试脚本きゃくほん根ね据すえ测试需求可か以自行ぎょう调整以达成なり完成かんせい生せい产测试的功こう能のう

1. 通つう过QuecPython的てきAPI接せっ口こう来らい获取模も组参数すう和わ运行状じょう态
2. 通つう过访问正在ざい运行的てき业务代だい码中的てき对象来らい获取业务运行情じょう况
3. 通つう过调用よう业务代だい码提供ていきょう的てき接せっ口才こうさい测试业务功こう能のう或ある者もの硬かた件けん功こう能のう
4. 通つう过QuecPython API接せっ口こう传输配置はいち文ぶん件けん或ある者もの写うつし入にゅう产品参さん数すう

步ふ骤一：编辑测试module_test.py代だい码，测试代だい码案例れい如上じょじょう图所示しめせ

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

步ふ骤三：如果测试完かん有ゆう需要じゅよう写うつし入いれ到いた模も块中的てき配置はいち文ぶん件けん，点てん击 **Load Json File **选择要よう写うつし入いれ的てき配置はいち文ぶん件けん，将しょう会かい在ざい测试成功せいこう之の后きさき将はた该配置はいち文ぶん件けん写うつし入にゅう模も块

步ふ骤四：点てん击 Start All 按钮开始测试所有しょゆう已やめ接せっ入いれ的てき模も块，也可以通过单独どく点てん击端口こう对应列れつ的てき Start 按钮来らい测试某ぼう一いち个模块,测试超ちょう时时间2min

步ふ骤五：测试完成かんせい后きさき可か在ざい测试结果栏位看み到いた测试结果，如果测试结果失しつ败，可か点てん击对应失败的那な一列的日志按钮来查看测试日志，从而可か定位ていい到いた具体ぐたい哪一项测试失败

步ふ骤六：测试完成かんせい后きさき会かい在ざい工具こうぐ同どう级目录下生成せいせいTest-Result.xlsx文ぶん件けん，包含ほうがん测试项目内容ないよう以及测试结果日び志こころざし

每まい一个模块的的测试结果会写入到excel中ちゅう导出，可か以通过菜单栏的てき 配置はいち 中なか的てき **测试结果文ぶん件けん **菜さい单打开该excel文ぶん件けん

每まい一いち次じ测试会かい在ざいexcel中ちゅう生成せいせい一いち条じょう测试记录（无论测试成功せいこう或ある者もの失しつ败），多た次つぎ测试会かい有ゆう多た条じょう记录，根ね据すえ测试设备的てきIMEI区分くぶん

该文件けん会かい保存ほぞん在ざい工具こうぐ同どう级目录下，测试过程中ちゅう自じ动追加ついか

同どう时测试结果はて会かい上じょう传到云うん端はし生成せいせい报表以供云うん端はし查看整体せいたい测试结果（开发中ちゅう）

安あん装そう依よ赖库

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 如果上面うわつら方式ほうしき安あん装そう失しつ败，可か以使用しよう单独安あん装そう的てき形式けいしき
pip install wxpython -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install pypubsub -i https://pypi.tuna.tsinghua.edu.cn/simple

运行代だい码

python main.py

编译成なり可か执行程こうてい序じょ

# 如果上面うわつら使用しよう单独安あん装そう的てき形式けいしき，需要じゅよう安あん装そう一いち下かpyinstaller库
pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple
# 编译成なりexe程ほど序じょ，输出exe目め录在./dist/下した
pyinstaller -F -w --win-private-assemblies --icon images/quectel.ico -w ./main.py