用Python脚本实现GD32F303串口自动化测试的工程实践
在嵌入式开发中，串口通信是最基础也最常用的调试手段之一。传统方式下，工程师需要手动操作串口助手发送测试数据、记录返回结果，这种重复劳动不仅效率低下，还容易因人为因素导致测试结果不准确。本文将介绍如何用Python脚本替代手动操作，构建一套完整的GD32F303串口自动化测试方案。
1. 自动化测试的价值与实现思路
嵌入式开发中的串口测试往往需要验证多种场景：不同波特率下的通信稳定性、大数据量传输的正确性、异常情况的处理能力等。手动测试这些场景需要频繁修改参数、发送数据、核对结果，整个过程耗时且容易出错。
Python的pyserial库为我们提供了完美的解决方案。通过编写脚本，我们可以实现：
- 自动发送预设的测试向量（如递增序列、随机数据等）
- 实时接收并解析设备返回的数据
- 自动比对预期结果与实际结果
- 生成详细的测试报告
这种自动化方式特别适合以下场景：
- 固件迭代开发中的回归测试
- 批量生产时的功能验证
- 长时间稳定性压力测试
# 基础测试流程示例 import serial # 初始化串口 ser = serial.Serial('COM3', 115200, timeout=1) # 发送测试数据 test_data = bytes([0x15]) ser.write(test_data) # 接收并验证结果 response = ser.read(1) expected = bytes([0x16]) assert response == expected, f"测试失败，预期{expected}，实际收到{response}" ser.close()2. 测试环境搭建与基础配置
2.1 硬件连接准备
实现自动化测试需要确保：
- GD32F303开发板通过USB转串口模块与PC连接
- 确认设备管理器中的COM端口号
- 检查跳线帽是否正确连接（CH340_TX→USART0_RX，CH340_RX→USART0_TX）
常见连接问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法识别COM口 | 驱动未安装 | 安装CH340G驱动 |
| 通信数据乱码 | 波特率不匹配 | 检查双方波特率设置 |
| 无返回数据 | 接线错误 | 确认TX/RX交叉连接 |
2.2 Python环境配置
推荐使用conda创建专用环境：
conda create -n uart_test python=3.8 conda activate uart_test pip install pyserial pytest基础串口操作类封装：
class GD32UARTTester: def __init__(self, port, baudrate=115200): self.ser = serial.Serial(port, baudrate, timeout=0.5) def send_hex(self, data: bytes): """发送HEX格式数据""" self.ser.write(data) def receive_hex(self, length=1) -> bytes: """接收指定长度的HEX数据""" return self.ser.read(length) def close(self): self.ser.close()3. 进阶测试方案实现
3.1 多场景测试用例设计
完整的测试应该覆盖各种边界情况：
test_cases = [ {'input': b'\x00', 'expected': b'\x01'}, # 最小值测试 {'input': b'\xFF', 'expected': b'\x00'}, # 溢出测试 {'input': b'\x7F', 'expected': b'\x80'}, # 符号位变化 {'input': b'\x0A', 'expected': b'\x0B'}, # 常规值测试 ]3.2 自动化测试脚本实现
结合unittest框架构建完整测试套件：
import unittest class TestGD32UART(unittest.TestCase): @classmethod def setUpClass(cls): cls.tester = GD32UARTTester('COM3') def test_single_byte(self): """单字节加1功能测试""" for case in test_cases: with self.subTest(case=case): self.tester.send_hex(case['input']) response = self.tester.receive_hex() self.assertEqual(response, case['expected']) def test_continuous_mode(self): """连续发送压力测试""" pattern = bytes(range(256)) # 0x00到0xFF的全模式 self.tester.send_hex(pattern) received = bytearray() while len(received) < 256: received.extend(self.tester.receive_hex(1)) expected = bytes((x+1)%256 for x in range(256)) self.assertEqual(bytes(received), expected) @classmethod def tearDownClass(cls): cls.tester.close() if __name__ == '__main__': unittest.main()3.3 测试报告生成
使用HTMLTestRunner生成可视化报告：
from HTMLTestRunner import HTMLTestRunner suite = unittest.TestLoader().loadTestsFromTestCase(TestGD32UART) with open('report.html', 'wb') as f: runner = HTMLTestRunner(f, title='GD32串口测试报告') runner.run(suite)报告内容通常包括：
- 测试用例通过率
- 失败用例的详细差异
- 执行耗时统计
- 系统资源使用情况
4. 工程实践中的优化技巧
4.1 稳定性增强措施
长时间运行测试时需要考虑：
def robust_receive(tester, expected_length, max_retry=3): """带重试机制的接收函数""" received = bytearray() retry_count = 0 while len(received) < expected_length and retry_count < max_retry: chunk = tester.receive_hex(expected_length - len(received)) if chunk: received.extend(chunk) retry_count = 0 else: retry_count += 1 time.sleep(0.1) return bytes(received)4.2 性能测试扩展
除了功能测试，还可以进行性能评估：
def test_throughput(self): """吞吐量测试""" test_data = bytes([0x55]*1024) # 1KB测试数据 start_time = time.time() self.tester.send_hex(test_data) received = self.tester.receive_hex(len(test_data)) elapsed = time.time() - start_time throughput = len(test_data) / elapsed # bytes/sec print(f"吞吐量: {throughput/1024:.2f} KB/s") self.assertEqual(len(received), len(test_data))4.3 异常情况模拟
测试异常处理能力：
def test_error_handling(self): """异常数据测试""" # 发送非法长度数据 with self.assertRaises(AssertionError): self.tester.send_hex(b'\x01\x02') # 设备设计应处理单字节 # 测试超时情况 response = self.tester.receive_hex(1) self.assertEqual(response, b'') # 应返回超时空响应5. 与CI/CD流程集成
将自动化测试整合到开发流程中：
- 本地预提交检查：通过git hook运行基础测试
- 持续集成服务器：Jenkins或GitHub Actions自动执行完整测试
- 生产烧录验证：与烧录工具链结合进行出厂测试
示例GitHub Actions配置：
name: GD32 UART Test on: [push, pull_request] jobs: test: runs-on: windows-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v2 with: python-version: '3.8' - name: Install dependencies run: | python -m pip install --upgrade pip pip install pyserial pytest - name: Run tests run: | python -m pytest tests/ -v实际项目中，我们通过这种自动化方案将串口测试时间从原来手动操作的30分钟缩短到2分钟，且测试覆盖率从70%提升到95%以上。一个特别实用的技巧是在测试脚本中添加硬件状态检测功能，比如通过LED闪烁模式来直观显示测试进度，这在批量生产测试时尤其有用。
