You need to enable JavaScript to run this app. Python OpenCV叠加ESP32 BME280数据时视频阻塞冻结的解决方法咨询
优惠活动
大模型
产品
解决方案
定价
更多

Python OpenCV叠加ESP32 BME280数据时视频阻塞冻结的解决方法咨询

阻塞问题根因
  • 原代码把串口读取逻辑和OpenCV逐帧渲染逻辑放在同一个同步循环里,每次循环必须等串口读完一整行带\n的完整数据,才会继续处理下一帧视频。ESP32端固定每500ms发送一次数据,自然会造成每500ms一次的画面冻结
  • 串口参数timeout=0时,readline()不会等待攒够带换行符的完整行,会立刻返回当前串口缓冲区的零散内容,因此拿到的传感器数据不完整,无法正常显示
  • 没有对串口IO做异步拆分,导致串口等待时间直接占满视频渲染的循环周期,拖慢整体帧率
代码调整方案

核心思路:把串口读取从视频逐帧的同步循环中拆分,放到独立的后台守护线程中持续运行,视频循环仅读取线程缓存的最新传感器值做画面叠加,让串口IO和视频渲染完全解耦,互不阻塞

Python端代码调整

  • 引入threading模块,创建全局缓存变量存储最新的传感器读数,初始值为空字符串
  • 编写独立的串口读取循环函数,设为守护线程后台运行:函数内部循环调用readline(),拿到有效数据就更新全局缓存
  • 串口超时参数设为0.1(范围0.05~0.2s均可):既不会因为长期等数据阻塞后台线程,也能攒够ESP32发来的带换行的完整行数据
  • 废弃原来的硬字符串替换逻辑,直接对串口返回的bytes做解码、去首尾空白处理,避免乱码残留
  • 主视频循环中不再直接调用串口读方法,仅从全局缓存取最新传感器值叠加到画面上

改完的可运行Python代码如下:

import serial
import cv2 as cv
import datetime
import threading

# 全局缓存:存储最新传感器读数
latest_sensor_data = ""
# 初始化摄像头
cap = cv.VideoCapture(0)
if not cap.isOpened():
    print("Camera cannot open")
    exit()
# 初始化串口:超时设为0.1秒,平衡阻塞时长和数据完整性
arduino = serial.Serial('COM7', baudrate=115200, timeout=0.1)

# 后台串口读取线程
def serial_background_reader():
    global latest_sensor_data
    while True:
        # 读取一整行,自动解码,去掉首尾换行/空白字符
        raw_line = arduino.readline().decode('utf-8', errors='ignore').strip()
        if raw_line:
            latest_sensor_data = raw_line

# 启动后台守护线程,主程序退出时自动终止线程
threading.Thread(target=serial_background_reader, daemon=True).start()

# 主视频渲染循环
while True:
    ret, frame = cap.read()
    if not ret:
        print("void frame")
        break
    
    # 直接取缓存的传感器值,无阻塞
    current_time = str(datetime.datetime.now())
    font = cv.FONT_HERSHEY_SIMPLEX
    cv.putText(frame, current_time, (10, 50), font, 0.8, (255, 0, 0), 2, cv.LINE_AA)
    cv.putText(frame, latest_sensor_data, (10, 80), font, 0.8, (255, 0, 0), 2, cv.LINE_AA)

    cv.imshow("Video", frame)
    # 按q退出
    if cv.waitKey(1) == ord('q'):
        break

arduino.close()
cap.release()
cv.destroyAllWindows()

ESP32端代码调整

原ESP32代码无需大改,Serial.println()方法本身会自动在输出末尾追加\r\n换行符,可被Python端的readline()正常识别。如果需要更快的传感器数据更新频率,可以将原代码中delayTime = 500的参数调低(比如改成200,即每200ms发一次温度值),因为两者已经解耦,串口发送频率不会再影响视频流畅度。

调整后效果
  • 视频渲染循环全程没有串口阻塞操作,帧率保持摄像头本身的正常水平,不会出现每0.5秒一次的冻结
  • 传感器数据会被后台线程实时捕获,哪怕串口暂时因为缓冲区问题攒数据,也不会卡住画面,只会在拿到完整行后更新显示内容
  • 哪怕ESP32暂时断开连接,后台线程会持续等待新数据,主视频循环不会因为串口异常崩溃或卡顿

内容的提问来源于stack exchange,提问作者javk123

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 12:24:03