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
相关产品推荐
相关产品推荐

