RS-232串口读取标准方法及自动化测试实现疑问咨询

云上老周

2026-5-11

问题分析与解决方案

首先梳理下你的需求：开发一款自动化测试通用工具，读取嵌入式PC启动时RS232串口的输出文本，后续从中解析特定标识。当前方案是将串口数据写入文件，针对你的几个疑问，我逐一分析解答：

一、现有方案的遗漏点&优化建议

你的基础思路没问题，但有几个细节会影响工具的稳定性和通用性，需要补充优化：

错误处理不完整：目前仅检查了串口打开的错误，但OpenFile（比如无文件创建权限、路径不存在）、SetComTime、ComToFile都可能执行失败。这些失败如果不处理，程序会静默出错，你根本无法定位问题。建议给这些操作都加上错误检查，出错时要先关闭已打开的资源（串口、文件）再退出。
串口参数硬编码：当前波特率、数据位、停止位等参数都是写死的，作为通用工具，应该把这些做成可配置项——比如用宏定义集中管理，后续还可以扩展支持从配置文件读取，这样换设备不用改代码就能适配。
资源未释放：程序结束前没有调用CloseCom和CloseFile，虽然小工具退出后系统会回收资源，但养成主动释放的习惯很重要，尤其是后续如果添加异常分支，未释放的串口可能被占用，导致下次启动工具无法连接。
启动日志完整性不足：嵌入式设备启动通常需要数秒，你当前ComToFile的超时设置为2000ms，可能还没等启动完成就停止读取了。建议把超时调大（比如5000ms甚至更久），或者改成「连续一段时间无数据输入就自动终止」的逻辑，保证能拿到完整的启动日志。
编码兼容性问题：你用VAL_ASCII打开文件，但有些嵌入式设备的输出是UTF-8或其他编码，遇到非ASCII字符会出现乱码。最好先确认设备输出的编码格式，或者用二进制模式存储文件，后续解析时再转换编码。

二、如何禁用`ComToFile`的终止字节机制

从你使用的rs232.h和函数风格来看，应该是LabWindows/CVI的API吧？如果要禁用终止字节机制，你可以传递一个设备绝对不会输出的字节值，比如0xFF（一般启动日志里不会出现这个非打印字符）。如果API文档里有专门的常量（比如VAL_NO_TERMINATION_CHAR）那更稳妥，没有的话用0xFF这类非常规字符就可以，这样ComToFile只会在超时或达到最大读取限制时停止，不会因碰到某个字节就中断。

三、存文件vs内存缓冲区怎么选？

这个要结合你的测试需求来判断：

选择存文件的场景：

需要保留原始启动日志，方便测试失败后回溯排查问题；
启动日志体积很大，超出程序可用内存范围；
后续解析工具需要读取日志文件，或者要和其他测试环节共享日志内容。

选择内存缓冲区的场景：

追求测试执行速度，不想承受磁盘IO的开销；
启动日志大小可控，不会超过内存限制；
可以边读取边解析（比如读到目标标识就停止，不用等整个启动流程完成），能节省时间和内存。

作为通用解决方案，我建议优先实现存文件的版本，因为保留原始日志对自动化测试的问题排查非常重要，而且文件解析的逻辑也更容易调试。如果后续有性能优化需求，再添加内存缓冲区的可选模式即可。

优化后的代码示例

我把上述优化点整合到代码里了，你可以参考：

#include <formatio.h>
#include<stdio.h>
#include<string.h>
#include<rs232.h>

// 将串口参数做成可配置的宏，方便后续修改
#define PORT_NUMBER 1
#define COM_PORT "COM1"
#define COM_BAUD_RATE 115200
#define COM_DATA_BITS 7
#define COM_STOP_BITS 1
#define COM_PARITY 0  // 0=无校验
#define READ_TIMEOUT_MS 5000  // 延长超时时间，适配嵌入式设备启动时长
#define TERMINATION_CHAR 0xFF  // 用非常规字节禁用终止字节机制
#define LOG_FILE_PATH "BootText.txt"

int main (void) {
    int fileHandle;
    int status;
    int bytesRead;

    // 打开并配置串口
    if (0 > OpenComConfig(PORT_NUMBER, COM_PORT, COM_BAUD_RATE, COM_PARITY, COM_DATA_BITS, COM_STOP_BITS, 5000, 512)) {
        printf("Error: Failed to open and configure COM port\n");
        return -1;
    }

    // 设置串口超时
    status = SetComTime(PORT_NUMBER, 10);
    if (status < 0) {
        printf("Error: Failed to set COM port timeout\n");
        CloseCom(PORT_NUMBER);  // 出错时先关闭已打开的串口
        return -1;
    }

    // 打开日志文件
    fileHandle = OpenFile(LOG_FILE_PATH, VAL_READ_WRITE, VAL_TRUNCATE, VAL_ASCII);
    if (fileHandle < 0) {
        printf("Error: Could not create or open log file\n");
        CloseCom(PORT_NUMBER);
        return -1;
    }

    // 读取串口内容到文件
    bytesRead = ComToFile(PORT_NUMBER, fileHandle, READ_TIMEOUT_MS, TERMINATION_CHAR);
    if (bytesRead < 0) {
        printf("Error: Failed to read data from COM port to file\n");
    } else {
        printf("Successfully read %d bytes of boot log to %s\n", bytesRead, LOG_FILE_PATH);
    }

    // 主动释放所有资源
    CloseFile(fileHandle);
    CloseCom(PORT_NUMBER);

    return 0;
}

内容的提问来源于stack exchange，提问作者TestEngineer11

RS-232串口读取标准方法及自动化测试实现疑问咨询

一、现有方案的遗漏点&优化建议 #

二、如何禁用ComToFile的终止字节机制 #

三、存文件vs内存缓冲区怎么选？ #

选择存文件的场景： #

选择内存缓冲区的场景： #