ESP8266 MicroPython捕获ANSI转义序列终端响应的实现方法

• 硬件资源占用冲突：ESP8266的UART0默认和系统REPL通道硬件复用，WebREPL运行期间哪怕断开网页连接，底层UART资源也不会完全释放。之前的代码手动新建UART实例时，没有先彻底解除REPL对UART的绑定，也没有重新激活UART的硬件接收中断，导致Putty主动发回的响应序列根本不会被硬件捕获到接收缓冲区。
• 时序逻辑错误：发送完光标定位、位置查询指令后，没有预留终端的处理延迟（PC端终端处理VT100转义序列、生成响应的延迟通常在10~50ms之间），直接判断uart.any()并读取，此时Putty还未把响应发回，自然读不到任何内容。
• 响应匹配逻辑错误：第二个方案中直接把UART读到的整块字节流和单个b"R"做相等判断，实际终端返回的完整响应是带ESC控制符、行号、列号的长字节串（如b"\x1b[45;157R"），根本不可能等于单个R的字节，程序只会在用户手动输入R时才会退出循环，完全无法匹配自动返回的响应。
• UART读取方式不合理：直接调用无参数的uart.read()方法时，MicroPython的UART驱动会等待接收缓冲区填满才返回，对于长度仅几字节的短响应序列，会一直阻塞到超时，稳定性极差。

前置准备 #

• 关闭WebREPL功能，将代码保存为ESP设备的main.py，通过独立USB转串口供电运行，排除WebREPL对UART0的资源占用。
• 检查ESP-01与USB转串口的接线：ESP的TX连接转串口RX，ESP的RX连接转串口TX，两端共地，波特率匹配为115200。

修正后的可运行代码 #

import time
from machine import UART
import uos

# 彻底解除REPL对UART0的资源绑定
uos.dupterm(None, 1)

# 重新初始化UART0，开启硬件接收中断，设置合理的接收超时
uart = UART(0, 115200, bits=8, parity=None, stop=1, timeout=20)

# 发送指令：先将光标定位到超出终端边界的位置，再触发光标位置查询
# 终端收到越界的光标定位指令后，会自动把光标移动到实际显示区域的最后一行、最后一列
uart.write("\x1b[999;999H\x1b[6n")

# 预留终端响应的处理时间
time.sleep_ms(50)

# 逐字节收集完整响应序列
response = b""
timeout_counter = 0
while True:
    if uart.any() > 0:
        current_byte = uart.read(1)
        response += current_byte
        # 响应序列以R作为结束标记，读到R即停止收集
        if current_byte == b"R":
            break
        timeout_counter = 0
    else:
        timeout_counter += 1
        # 累计空等10ms未读到数据，触发超时退出，避免程序卡死
        if timeout_counter > 10:
            break
    time.sleep_ms(1)

# 调试输出原始捕获内容
print("Raw ANSI response:", response)

# 解析终端尺寸参数
if b"[" in response and b"R" in response:
    seq_content = response.split(b"[")[1].split(b"R")[0]
    row_count, col_count = seq_content.split(b";")
    print(f"Detected terminal size: {row_count.decode()} rows, {col_count.decode()} columns")

代码修正点说明 #

• 重新调用UART构造函数时，会重新激活ESP8266的UART硬件接收中断，确保外部发回的字节能被存入接收缓冲区。
• 发送指令后预留固定等待时间，给终端足够的处理、回发响应的窗口。
• 采用逐字节读取的方式收集响应，严格匹配R作为结束标记，避免整块读取的阻塞问题。
• 增加超时计数保护，无响应时自动退出，避免程序死等。

常见踩坑提示 #

• 如果捕获到的内容混有自身发送的查询指令，是因为ESP8266的UART存在硬件发送环回，可以在读取时跳过所有ESC控制符开头的自发送序列，仅保留终端返回的响应内容。
• 不要在WebREPL网页界面下测试串口响应捕获，WebREPL会通过TCP通道和设备交互，占用UART的资源，导致串口收不到正常数据。

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