使用pyserial无法从serial console读取命令返回输出的问题排查

• 串口初始化默认触发硬件流控/设备复位：pyserial打开串口时默认会拉低DTR、RTS引脚，绝大多数嵌入式设备的串口控制台（开发板、网络设备等）检测到DTR引脚电平变化会触发设备复位，或是因硬件流控未关闭直接阻塞数据收发，导致发送的命令根本没有被设备端接收，自然不会返回执行结果。
• 读取逻辑冲突：send_to_console函数内已经通过ser.read(ser.inWaiting())读取了当前串口接收缓冲区的全部数据，后续再调用ser.read(64)时缓冲区已被清空，在1秒超时时间内等不到新数据就会返回空字节b''。
• 命令结束符不匹配：部分串口控制台要求使用\r\n作为命令输入的结束触发符，仅发送\r不会触发命令执行，设备会持续等待输入完成，不会返回任何执行结果。
• 串口参数配置不全：初始化串口时未显式关闭软硬件流控，若设备端开启了流控校验，会直接拦截数据收发链路。

直接替换为以下可运行代码：

import serial
from time import sleep

def send_to_console(ser: serial.Serial, command: str, wait_time: float = 0.5):
    # 发送前清空接收缓冲区，避免历史残留数据干扰
    ser.reset_input_buffer()
    # 适配通用串口控制台的命令结束符要求
    command_to_send = command + "\r\n"
    ser.write(command_to_send.encode('utf-8'))
    sleep(wait_time)
    # 读取当前缓冲区全部数据，忽略非法编码字节避免程序崩溃
    recv_data = ser.read(ser.inWaiting()).decode('utf-8', errors='ignore')
    print(recv_data, end="")
    return recv_data

if __name__ == "__main__":
    # 初始化串口时显式关闭DTR/RTS触发、禁用所有流控
    with serial.Serial(
        port="/dev/ttyUSB2",
        baudrate=460800,
        bytesize=8,
        parity="N",
        stopbits=1,
        timeout=1,
        dsrdtr=False,
        rtscts=False,
        xonxoff=False
    ) as ser:
        print(f"Connecting to {ser.name}...")
        # 等待串口链路、设备控制台初始化就绪
        sleep(2)
        # 清空串口打开阶段的设备启动输出残留
        ser.reset_input_buffer()
        send_to_console(ser, "")
        # 根据设备ifconfig命令的实际执行时长调整等待时间
        send_to_console(ser, "ifconfig", wait_time=3)
        print(f"\nConnection to {ser.name} closed.")

• 若设备控制台需要登录认证，需先发送用户名、密码完成认证流程后，再执行业务命令，否则命令会被登录拦截无法执行。
• wait_time参数需根据设备实际响应速度调整，若设备性能较弱、命令执行耗时长，可适当增大等待时长，避免数据未完全返回就提前读取缓冲区。
• 若修改后仍无输出，可先使用minicom、picocom等成熟串口工具连接对应串口验证链路、波特率、流控参数是否正确，排除硬件接线问题。

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