讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

如何解决 PySerial 读取不完整行的问题:线程化串口读取与队列通信

浅丽姑娘_9048

浅丽姑娘_9048

发布时间:2026-11-17 12:04:07

|

866人浏览过

|

来源于php中文网

原创

如何解决 PySerial 读取不完整行的问题:线程化串口读取与队列通信

本文详解 PySerial 在高频数据传输(如 Arduino 每 10ms 发送)下出现“半行截断”问题的根本原因,并提供基于多线程 + queue.Queue 的鲁棒解决方案,确保 Tkinter GUI 实时、稳定、完整地解析串口数据。

本文详解 pyserial 在高频数据传输(如 arduino 每 10ms 发送)下出现“半行截断”问题的根本原因,并提供基于多线程 + `queue.queue` 的鲁棒解决方案,确保 tkinter gui 实时、稳定、完整地解析串口数据。

PySerial 本身不保证 readline() 总能返回一条逻辑完整的、以 \n 结尾的记录——尤其当上位机读取速率跟不上 Arduino 发送节奏,或 GUI 主循环因窗口重绘、事件处理等造成 I/O 阻塞时,缓冲区中的数据极易被“撕裂”。您观察到的 ['0','0',..., 'Malik'] 等残缺列表,正是 ReadLine.readline() 在未收全换行符前被迫返回部分缓冲内容所致(尽管您的 ReadLine 类已做基础缓冲,但未解决线程竞争与 GUI 阻塞双重瓶颈)。

根本解法不是调大超时或改用 read(),而是解耦串口读取与 GUI 更新:

✅ 正确架构:生产者-消费者模式

  • 生产者(独立线程):专注、不间断地从串口读取、解析、校验并投递有效数据;
  • 消费者(Tkinter 主线程):仅通过安全队列获取已验证数据,专注 UI 渲染,零阻塞。

? 实现步骤

1. 初始化线程安全队列与串口读取线程

import threading
import queue
import serial

# 全局队列(线程安全)
data_queue = queue.Queue()

# 假设 ser 已正确初始化(例如:ser = serial.Serial('COM3', 115200, timeout=1))
def serial_read_thread():
    read_Line = ReadLine(ser)  # 复用您原有的缓冲类
    while True:
        try:
            # 同步读取一行(阻塞直到收到 \n 或超时)
            line_bytes = read_Line.readline()
            if not line_bytes:  # 超时或空行,跳过
                continue
            line = line_bytes.decode('utf-8').strip()
            parts = [x for x in line.split(",") if x.strip()]

            # 关键校验:仅投递长度 ≥21 的有效数据
            if len(parts) >= 21:
                data_queue.put(parts)  # 安全入队
            else:
                print(f"⚠️ Invalid line (len={len(parts)}), skipped: {parts}")

        except UnicodeDecodeError:
            print("⚠️ Decode error: non-UTF8 bytes received")
        except Exception as e:
            print(f"⚠️ Serial read error: {e}")
            break  # 或根据需求重连

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

2. Tkinter 主循环中安全消费数据

def update_gui_from_serial():
    # 批量消费队列,避免频繁调用
    try:
        while True:
            data = data_queue.get_nowait()
            # ✅ 此处 data 必为 len>=21 的完整列表,可直接用于更新 UI
            self.Inp_manager.save_Repeating_Input(data)
            # 例如:self.label.config(text=f"Sensor[0]: {data[0]}")
    except queue.Empty:
        pass  # 队列为空,正常退出循环

    # 每 50ms 检查一次(平衡实时性与 CPU 占用)
    root.after(50, update_gui_from_serial)

# 在 Tkinter 初始化后启动
root.after(50, update_gui_from_serial)

⚠️ 关键注意事项

  • *禁止在主线程调用 `ser.read()**:Tkinter 的mainloop()是单线程事件循环,任何阻塞 I/O(包括readline()`)都会冻结界面,导致“移动窗口时丢数据”。
  • ReadLine 类需保持 timeout 合理:建议 ser 初始化时设 timeout=0.1(100ms),既防死锁,又避免过长等待;您的自定义 ReadLine 已处理分片,无需修改。
  • Arduino 端配合优化:确保每帧数据以 \n 结尾(如 Serial.println("0,0,...,Malik");),且发送间隔 ≥5ms(10ms 更稳妥),避免硬件缓冲区溢出。
  • 异常防护:示例中加入了 UnicodeDecodeError 和通用异常捕获,防止非法字节或断开连接导致线程崩溃。

此方案将数据吞吐能力与 GUI 响应性彻底分离,实测可稳定支持 Arduino 5–10ms 周期发送,同时杜绝“半行解析”和界面卡顿。核心在于:让串口读取只做一件事——可靠收全一行;让 GUI 只做一件事——高效刷新画面。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1931

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

5504

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1889

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

33537

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3927

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3947

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1283

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

636

2023.08.10

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn