使用python+qt编写的自动化测试工具，具有xml读写，xmodem下载，串口收发，文件写入，界面交互功能.zip

# kl3-autotest-tool ## 概述 kl3dtest自动化测试工具（以下简称“软件”）的前身是为了测试kl3计量功能而设计的一个python脚本，后来为了方便对kl3的各个功能进行自动化测试，将该脚本拓展为python+qt的一个软件。 该软件主要包含如下亮点： * xml文件的读取、解析、保存 * 界面可勾选dtest和dtest对应的case * xmodem下载固件 * 串口数据显示，可对关键字进行统计和设置颜色 * 可拓展串口数据处理模块 * 调试日志、串口日志文件记录 程序启动后的界面如下图所示  ## 程序逻辑 程序为交互式执行，因此当程序在初始化完成后，会一直等到交互动作产生特定信号，来触发指定的流程。其大体的程序框架如下图所示：  ### xml加载 存在一个默认的xml文件，其路径在与软件（或python脚本）同级目录下，名称固定为”dtest.xml”，件在启动后会尝试读取默认的xml文件，并将xml的内容显示到界面。xml内容和界面的对应关系如下： #### 调试界面使能 在xml中对应<debug_interface>节点，包含“true”或者“false”文本节点，如下图所示：  在界面中对应调试日志区域，当文本节点为“false”时，隐藏调试日志区域，当文本节点为“true”时，显示调试区域。 当隐藏调试区域时，调试区域上方的界面自动填充，如下图所示：  ___【注】：隐藏界面时，调试日志仍然记录在界面中。___ #### 串口配置 在xml中对应\<port id="x">节点，该节点包含id属性，用于标识是第几个串口（从0开始计数，最多定义4个串口）；该节点包含5个子节点，其解释如下： * \<com>子节点，用于标识PC上的串口对应的com号，使用一个文本子节点记录； * \<buad>子节点，用于标识串口对应的波特率，使用一个文本子节点记录； * \<data>子节点，用于标识串口对应的数据位，使用一个文本子节点记录； * \<parity>子节点，用于标识串口对应的校验位，使用一个文本子节点记录； * \<stop>子节点，用于标识串口对应的停止位，使用一个文本子节点记录； 完整的节点定义如下图所示：  在界面中对应配置界面COM口区域，配置界面需要在主界面点击“配置”按钮打开，配置界面如下如所示：  从上到下，com口编号为0~3，对应xml文件中的id0~id3，界面中的波特率等参数均来自xml文件中定义的参数值。 #### 固件路径 在xml文件中对应\<dir>节点，该节点包含id属性，当id为0时表示是主模式固件路径，id为1时表示是从模式固件路径。固件路径的文本储存在该节点下的文本子节点中。  在界面中对应配置界面固件路径区域，“主固件路径1”对应id为0的文本节点，“从固件路径2”对应id为1的文本节点。如下图所示：  #### dtest信息 在xml中表现为\<dtest>节点，该节点包含id属性，用于标识是第几个dtest。\<dtest>节点包含5个子节点，其解释如下： * \<name>子节点，用于标识dtest名称，使用文本子节点记录内容； * \<note>子节点，用于标识dtest说明信息，使用文本子节点记录内容； * \<enable>子节点，用于标识dtest是否使能，使用文本子节点记录内容（true或者false）； * \<slave_mode>子节点，用于标识dtest是否支持从模式，使用文本子节点记录内容； * \<case>子节点，用于标识dtest具有的case信息，包含id属性，用于标识当前case编号。\<case>子节点下存在3个子节点。 * \<name>子节点，用于标识case名称，使用文本子节点记录内容； * \<note>子节点，用于标识case说明信息，使用文本子节点记录内容； * \<enable>子节点，用于标识case是否使能，使用文本子节点记录内容；  在界面中对应测试用例配置区域，该区域分为两部分，分别为dtest列表和case列表，以dtest id+dtest名称形成一行，分别加入2个列表中（但是选择动作不同步），case id+case名称形成一行，加入到case列表中当前case所属dtest下。如下图所示：  #### 关键字规则 在xml中对应\<rule>节点，该节点包含id属性，用于标识当前规则的编号，\<rule>节点包含3个子节点，其解释如下： * \<keyword>子节点，用于标识关键字信息，使用文本子节点记录内容； * \<color>子节点，用于标识关键字颜色，使用文本子节点记录内容，其格式为#RRGGBB * \<enable>子节点，用于标识关键字是否使能，使用文本子节点记录内容  在界面中对应关键字规则区域，\<enable>节点转换为复选框，节点内容为“true”时选中，为“false”时取消选中，\<color>节点转换为颜色框，\<keyword>节点内容显示到关键字列，从上到下，每一行分别对应\<rule>节点id0~idx（目前限定x最大为20）  ## 状态机 在最初的设计中，dtest测试流程、串口数据的接收由子线程完成，并且在子线程中处理关键字以及将数据更新到界面，主线程负责界面的交互。然而在调试过程中发现以下几个问题： * 由于python的GIL限制，多线程无法做到真正的并行。 * 负责更新界面的进程不能被阻塞，也不能休眠，否则会导致界面出现卡死的现象。 * pyqt使用的时候如果非界面线程直接访问控件元素会有问题 因此，设计方案改为仅采用一个线程，配合定时器+状态机完成界面更新和dtest测试。 dtest的测试可以简化为以下4个步骤： * 连接模块 * xmodem方式下载固件 * 发送case组合 * 接收串口数据，并等待dtest测试完毕（收到RESULT关键字） 步骤相对简单，且几乎没有额外的分支，因此状态机的设计也相对简单，如下图所示  ## 交互动作 ### xml导入、保存、另存 xml文件的导入，保存和另存动作，触发方式为选中菜单栏中“文件”菜单下对应的动作选项，如下图所示：  导入和另存动作均会触发文件选择对话框，在弹出的选择框中，默认为当前软件（或python脚本）所在目录。 ![image](https://user-images.githubus