告别手动发送！用Python脚本自动化你的Proteus串口仿真测试（STM32为例）

嵌入式开发中，串口通信调试往往是耗时又繁琐的环节。想象一下这样的场景：你正在Proteus中仿真STM32的串口通信功能，每发送一个字符都需要点击"手动发送"按钮，重复几十次后不仅手指发酸，还容易出错。这种低效操作在真实项目中会拖慢整个开发进度——而今天，我将分享如何用Python脚本彻底解决这个问题。

1. 自动化测试的核心思路

传统手动测试最大的痛点在于交互的机械重复。当我们用Proteus虚拟终端测试STM32程序时，通常需要：

1. 在发送区输入测试字符
2. 点击"手动发送"按钮
3. 观察LCD或终端显示
4. 重复上述步骤数十次

这种模式存在三个致命缺陷： 操作耗时 、 容易遗漏 、 难以复现 。而自动化脚本可以：

• 批量发送预设字符串序列
• 自动捕获并解析返回数据
• 与预期结果进行智能比对
• 生成可视化测试报告

# 基础串口自动化测试流程示意
def automated_test(serial_port):
    test_cases = ["TEST1", "HELLO", "12345"]  # 定义测试用例
    for case in test_cases:
        serial_port.write(case.encode())  # 自动发送
        response = serial_port.read(32)   # 自动接收
        validate(response, case)         # 自动验证

2. 环境搭建与工具链配置

2.1 硬件仿真环境准备

在Proteus中搭建STM32串口仿真需要特别注意几个关键点：

配置项	推荐值	注意事项
虚拟串口驱动	VSPD或com0com	需成对创建COM端口
波特率	9600bps	Proteus对非标准速率兼容性更好
时钟源配置	HSI	必须添加RCC_SYSCLKConfig语句

虚拟串口连接示意图 ：

[Python脚本] <--> [COM3]---[Proteus虚拟串口]---[STM32 USART1]

2.2 Python依赖安装

创建隔离的Python环境并安装必要库：

python -m venv uart_test
source uart_test/bin/activate  # Linux/Mac
uart_test\Scripts\activate.bat  # Windows
pip install pyserial pytest numpy

核心库功能说明：

• pyserial ：提供跨平台串口通信能力
• pytest ：用于组织测试用例和断言
• numpy ：辅助数据分析（如时序测量）

3. 自动化脚本开发实战

3.1 基础通信框架搭建

首先实现最核心的串口封装类：

import serial
from serial.tools import list_ports

class UARTController:
    def __init__(self, port=None, baudrate=9600):
        if not port:
            port = self.detect_proteus_port()
        self.ser = serial.Serial(port, baudrate, timeout=1)
        
    @staticmethod
    def detect_proteus_port():
        """自动识别Proteus使用的虚拟串口"""
        for port in list_ports.comports():
            if 'USB-SERIAL' in port.description:
                return port.device
        raise Exception("未找到Proteus虚拟串口")
    
    def send_command(self, cmd, wait=0.1):
        """发送命令并等待响应"""
        self.ser.write(cmd.encode() + b'\r\n')
        time.sleep(wait)  # 留出STM32处理时间
        return self.ser.read_all().decode().strip()

3.2 测试用例设计策略

针对STM32串口程序的典型测试场景：

1. 边界值测试

   • 空字符串输入
   • 超长字符串截断（测试20字符限制）
   • 特殊字符（如\x00等）

2. 协议完整性测试

   • 终止字符'x'的识别
   • 中文字符支持
   • 混合大小写处理

3. 压力测试

   • 连续快速发送100条消息
   • 大数据量吞吐测试
   • 异常断电恢复测试

# 测试用例示例
test_matrix = [
    {"input": "hello", "expected": "HELLO"},
    {"input": "12345x", "expected": "12345"},
    {"input": "a"*25, "expected": "a"*20},  # 测试截断
    {"input": "", "expected": "EMPTY_INPUT"}
]

3.3 数据验证与报告生成

自动化测试的核心价值在于自动验证结果。我们可以扩展之前的类：

class TestReporter(UARTController):
    def run_test_suite(self, cases):
        results = []
        for case in cases:
            actual = self.send_command(case["input"])
            passed = (actual == case["expected"])
            results.append({
                "input": case["input"],
                "expected": case["expected"],
                "actual": actual,
                "passed": passed
            })
        self.generate_report(results)
    
    def generate_report(self, results):
        """生成HTML格式测试报告"""
        from jinja2 import Template
        # 此处省略模板渲染细节
        print(f"测试完成，通过率：{sum(r['passed'] for r in results)/len(results):.1%}")

4. 高级技巧与异常处理

4.1 时序问题解决方案

Proteus仿真与真实硬件的关键差异在于时序不确定性。我们可以：

1. 添加动态延迟补偿

   def smart_delay(self, last_char):
       """根据末字符动态调整等待时间"""
       if last_char == 'x':  # 结束符需要更长处理时间
           time.sleep(0.3)
       else:
           time.sleep(0.05)
   

2. 实现重试机制

   def robust_send(self, cmd, max_retry=3):
       for _ in range(max_retry):
           try:
               return self.send_command(cmd)
           except serial.SerialTimeoutException:
               self.ser.reset_input_buffer()
       raise Exception("超过最大重试次数")
   

4.2 多设备协同测试

当需要测试STM32与多个外设的交互时：

class MultiDeviceTest:
    def __init__(self):
        self.mcu = UARTController('COM3')
        self.lcd = UARTController('COM4')  # 假设LCD也通过串口监控
        
    def test_display_sequence(self):
        self.mcu.send_command("SHOW 123")
        lcd_content = self.lcd.send_command("GET_DISPLAY")
        assert "123" in lcd_content

4.3 持续集成方案

将自动化测试接入CI流程：

# .github/workflows/uart_test.yml
name: STM32 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
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Run Proteus tests
      run: |
        python -m pytest tests/test_uart.py

5. 性能优化与扩展

5.1 二进制协议支持

扩展框架以支持二进制数据传输：

def send_binary(self, data: bytes):
    self.ser.write(data)
    # STM32需要相应修改为二进制处理模式
    return self.ser.read(size=len(data))

# 使用示例
controller.send_binary(b'\x01\x02\x03\x04')

5.2 实时数据可视化

结合Matplotlib实现通信数据可视化：

import matplotlib.pyplot as plt

def plot_communication(commands):
    timings = []
    for cmd in commands:
        start = time.time()
        controller.send_command(cmd)
        timings.append(time.time() - start)
    
    plt.plot(timings)
    plt.title('串口响应时间分布')
    plt.ylabel('秒')
    plt.show()

5.3 与硬件调试器联动

通过OpenOCD实现更底层的联动调试：

import subprocess

def debug_with_breakpoints(hex_file):
    # 启动OpenOCD调试会话
    proc = subprocess.Popen(['openocd', '-f', 'stm32.cfg'])
    # 在此处添加断点设置和寄存器读取逻辑
    # ...
    proc.terminate()

在项目实践中，这套自动化方案将测试效率提升了近10倍。一个原本需要手动操作2小时的完整测试流程，现在只需12分钟即可完成，且能生成详细的测试报告。对于需要频繁修改串口协议的敏捷开发场景，这种自动化方法尤其有价值——每次代码变更后，只需一条命令即可验证所有边界情况。