QT QSerialPort 的坑

最新推荐文章于 2025-10-20 10:28:55 发布
原创 最新推荐文章于 2025-10-20 10:28:55 发布 · 1.7k 阅读 · 8 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#qt

本文探讨了在ARM-Linux环境下使用QSerialPort接收GPS数据遇到的问题及解决方法。指出将QSerialPort的readAll()方法置于主线程，并在子线程中进行数据解析的重要性。

最近在做ARM-LINUX GPS信息接收
4G模块是通过串口通讯的
用QSerialPort接收数据
因为数据量比较大，所以把串口接收数据的类放入了线程
结果程序莫名崩溃，一开始还以为哪里指针报错了

尝试了很久
然后我在 QSerialPort 的 readAll() 前后进行了qDebug()
发现 readAll() 后没有打印输出，那就是readAll() 出问题了

readAll()不能放入子线程

当接数据少的时候，在线程readAll()不容易出问题
因为GPS数据量大，所以才发现了这个问题，之前一直把串口放入线程接收数据

正确做法是，把readAll()放入到主线程
然后把解析的类 放入到子线程解析，通过moveToThread()
然后在emit 把 QByteArray 传入到子线程
connect的时候 末尾参数写 Qt::QueuedConnection, 这个参数意思是线程为接收槽的线程。
不写的话emit发送信号，槽接收时的线程为主线程

Lj2_jOker
关注
Qt程序在ARM aarch64环境缺少serialbus serialport
jingjm00的博客
04-17 874
我的这个环境是嵌入式Linuxon。QT交叉编译的程序在此环境运行提示没有serialbus对应的动态链接库。前后试了好几种方法，一开始想直接在此环境安装qt creator编译。发现这样安装后还是缺这个模块。在网上查询后又得到两个方法。
（Qt）封装下串口类QSerialPort的线程操作
苏州-青蛙
07-16 2109
串口基类-使用时请继承该类 -在子类业务逻辑,不要直接扩展该类。 原则上读操作应该放入同一个线程，写操作也要放入同一个线程。这里读操作(read)和写操作(打开,关闭，write)不放在一个线程里这里因为我需要方便获取串口打开判断返回值所以打开放到主线程里，而且一般情况下写数据量不是很大，所以这里所有的写操作放到主线程，读操作处理包常规放到次线程里。 如果串口读量很大,可以将所有操作放入线程里，比如用该类发信号进入线程，但是打开之类的返回值需要在异步中，通过信号通知合适对象是否打开成功。 头文件.h ..
QT5 QSerialPort 串口 读数据中途崩溃
qq_42217401的博客
08-06 306
但是又是在子线程中open 或者读取数据。串口的创建 new， 打开open，读数据要在一个线程中。可以开子线程都在里面运行但是要在一个线程中。有时候在构造函数中 new 了一个串口对象。开始能读数据，过一会儿就崩了。
libserialport 库在x86架构下交叉编译成arm64架构
最新发布
沉在嵌入式的鱼的博客
10-20 432
本文介绍了如何在x86_64架构的Ubuntu22.04系统上为ARM64架构的RK3588平台交叉编译libserialport库。主要步骤包括：1)下载源码并安装构建工具；2)设置交叉编译环境变量；3)配置编译参数；4)执行编译和安装。重点说明了工具链路径、目标架构参数等关键配置项，最终生成静态库并安装到指定目录。该过程适用于需要在x86平台为ARM设备编译libserialport库的场景。
Qt串口QSerialPort的多线程 及 QSerialPort的waitForReadyRead函数的问题
热门推荐
joyopirate的博客
12-08 2万+
在官方的文档中提到，QSerialPort是不支持跨线程调用。 因此不能在主线程（UI线程）创建QSerialPort，然后传递个指针给子线程，然后在子线程中执行耗时的发送任务。 最好的方式是在子线程里面创建QSerialPort，然后通过信号槽来使用。 但是我想偷个懒，我已经在主线程创建了QSerialPort，并且界面相关的东西都做好了，不想改动太大，因此我想了个办法： 在新线程里面建立一个临时对象，复制传递进去的串口参数，执行完就干掉他。 void MainWindow::on_pushButton_
【QT】串口通信，usb通信QSerialPort::TimeoutErro超时问题
weixin_44939430的博客
04-24 2385
在处理时，通常不需要重启整个软件。这种错误通常指出在进行串口操作（如读取或写入）时超时，但它不一定意味着串口设备出现了不可修复的错误。应该根据具体的错误情况采取合适的错误恢复策略。
串口QSerialPort类同步与异步接收和发送数据及常见问题解决
m0_73482095的博客
07-23 3834
QT作为C++的库，也是一样的道理。通讯的一方（B）如果不能及时处理串口数据，会设置自己的RTS为低电平，B的RTS连着对方（A）的CTS，A发现自己的CTS为低电平，将停止发送数据；因此每个bit紧接着下个bit，不存在额外的间隔，不管是起始bit，数据bit，奇偶bit，停止bit。通讯的双方A和B，假如A给B发送数据时，B反应过慢，A不管不顾的不停发送数据，结果会导致数据丢失。电脑串口以及一般使用的开发板串口都是默认8个数据bit，一个停止bit，（起始1bit是必须的）默认无奇偶校验位，无流控。
Qt嵌入式串口编程include <QtSerialPort>提示找不到
qq_33346150的博客
10-05 1759
include报错 我也折腾半天才解决了，首先官方文档提示Qt5.1以上才有模块，再三确认我的是5.1.2但还是提示报错，真的很无奈。组后还是老外说得好一语道破附连接 ...
Qt温度湿度传感器采样上位机C++源代码：实现数据记录功能在Windows平台上
kNIBonaubXy的博客
03-23 840
Qt温度湿度传感器采样上位机源代码C++数据记录功能Windows上位机。
基于Qt C++的双串口实时曲线显示系统：数据接收与平滑绘制
03-28
首先，文中讲解了如何正确配置并初始化两个独立的QSerialPort实例用于双串口通信，确保每个串口能够稳定收发数据。接着，针对接收到的不同类型的数据（二进制和文本）进行了适当的解析，并将解析后的数据存储于队列...
怎么学好qt 的一些建议
02-12
串口通信和网络编程也是Qt中的重要组成部分，涉及到QSerialPort、QTcpSocket、QUdpSocket、QNetworkAccessManager等类。数据库方面，QSqlDatabase用于连接数据库，如MySQL和SQLite，而QSqlQuery则用于执行SQL查询。 ...
基于linux平台使用QSerialPort注意事项
zerolity的博客
10-25 1555
问题现象： m_serialPort->write(）//这句正常 connect(m_serialPort,SIGNAL(readyRead()),this,SLOT(slot_receiveInfo()));//整死都没有进入槽里面 描述： Qt5.1开始，开发串口应用使用的是QSerialPort和QSerialPortInfo；网上很多例程，但是都是基本都是windows平台。基于...
vs+qt找不到＜QserialPort＞
xu010810的博客
09-30 1138
在QT Modules中添加serialport就行了（图中有颜色的地方）扩展->Qt VS Tools->Qt Project Setings。
【Qt开发】串口通信收不到QSerialPort::readyRead信号的问题
csdnofhaner的博客
12-28 4634
Qt利用QSerialPort模块与串口设备通信时，收不到readyRead SIGNAL，进而导致无法正常读取数据怎么办？ 本文给出了答案，并附有代码示例。
QtSerialPort在ARM下面的编译问题
cph_att的博客
11-09 2633
这几天做一个项目，需要用到串口通讯。由于是QT4.2，所以没有QtSerialPort这个包，于是在网上下载了一个，桌面编译通过，但是在ARM模式下始终QT编译不过。解决方式如下： 1.先编译一个ARM版本的QT。用于编译ARM下运行的QT程序。/opt/external-toolchain/qt4.7.4 这是我的ARM-QT的目录 2.下载一个QtSerialPort，利用arm-qmak
Unknown module(s) in QT: serialport，error: ‘QtSerialPort‘ file not found，两种解决方法
qq_52926110的博客
02-04 1万+
在使用QT编写串口软件时，会用到serialport的类 我们在加入了serialport模块后发现还是不行 我就上网搜了各种方法，一种方法是下面这样 sudo apt-get install build-essential sudo apt-get install cmake qt5-default qtcreator 这样仅仅解决了Unknown module(s) in QT: serialport这个问题 我在操作完后，发现还是error: 'QtSerialPort' file no.
Qt----Serial Port
lengyuefeng212的博客
08-21 6043
文章目录Serial Port一、资源简介二、应用实例三、程序运行效果 Serial Port Qt 提供了串口类，可以直接对串口访问。我们可以直接使用 Qt 的串口类编程即可，十分方便。Qt 串口类不仅在 Windows 能用，还能在 Linux 下用，虽然串口编程不是什么新鲜事儿，既然 Qt 提供了这方面的接口，我们就充分利用起来，这将会使我们的开发十分方便！其实 Qt也提供了相关的 Qt 串口的例子，我们也可以直接参考来编程，编者根据实际情况，化繁为易，直接写了个简单的例子给大家参考。 一、资源简介
解决Qt 构建项目时报错找不到serialport模块
mct123的专栏
09-13 2490
解决Qt 构建项目时报错找不到serialport模块
QSerialPort不适合需要严格按顺序执行的情况
u012565113的博客
04-28 296
浪费了2天时间在项目里面引入QSerialPort,解决了run()跨线程调用问题，emit 延时问题，readAll()数据完整问题，最后还是在同步的问题上撞墙 我的项目要求：发送命令>>处理返回的消息>>处理下一个指令，需要严格按顺序执行。 QSerialPort问题在于它是非同步的，即便是使用waitForReadyRead()强制等待接收结果，几轮过后还是会出现readAll()无法读取完整的数据情况，而且返回的数据也没有按顺序，搞不清楚内部的缓冲是怎么处理的。 最后很
QT5.14.2串口通信
09-01
<think> 嗯，用户这次的需求很明确，就是要获取QT 5.14.2版本的串口通信开发资料。从引用内容看，用户显然是个开发者，正在做串口相关的项目，而且已经查阅过一些资料了——引用[2][4]都是具体的代码片段，说明用户需要的是可直接落地的技术方案。 用户特意强调版本号5.14.2，这个细节很重要。QT的串口模块在不同版本间确实有差异，比如5.12之后废弃了QSerialPortInfo::standardBaudRates()。从引用[4]的代码片段看，用户应该是在Windows平台开发，因为代码里出现了convertStringToHex这样的方法，这在处理ASCII指令设备时很常见。 注意到用户提供的引用[3]里有学习资料包的线索，不过那个更像是广告。其实官方文档才是最权威的，所以我在回复里优先放上了Qt 5.14文档的链接。代码示例部分特别处理了波特率设置的版本差异问题——5.14.2需要用QSerialPort::Baud9600这样的枚举值而非数字，这个坑很多新手会踩。 用户没提具体应用场景，但从"串口助手"这个关键词推测，可能是要开发调试工具。所以示例代码里包含了完整的搜索端口、收发数据流程，readData()槽函数故意留白让用户自己实现业务逻辑。考虑到嵌入式开发常见需求，最后还补充了编码转换和十六进制发送的典型方案。 要不要主动问用户是否需要更多硬件交互的示例呢？比如Modbus协议解析之类的。不过先保持回复聚焦吧，后续可以根据反馈再深入。 </think> 以下是针对 **QT 5.14.2 串口通信** 的详细使用指南和示例代码，结合官方文档和最佳实践整理： --- ### **一、核心步骤与代码示例** #### 1. **工程配置** 在 `.pro` 文件中添加串口模块依赖： ```qmake QT += serialport ``` #### 2. **头文件引入** ```cpp #include <QSerialPort> #include <QSerialPortInfo> ``` --- #### 3. **获取可用串口列表** ```cpp QStringList getAvailablePorts() { QStringList ports; foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) { ports << info.portName(); qDebug() << "Port:" << info.portName() << "| Description:" << info.description(); } return ports; } ``` --- #### 4. **初始化串口并连接** ```cpp QSerialPort *serial = new QSerialPort(this); // 配置串口参数 serial->setPortName("COM3"); // Windows 端口名 // serial->setPortName("/dev/ttyUSB0"); // Linux 端口名 serial->setBaudRate(QSerialPort::Baud9600); // 波特率 serial->setDataBits(QSerialPort::Data8); // 数据位 serial->setParity(QSerialPort::NoParity); // 校验位 serial->setStopBits(QSerialPort::OneStop); // 停止位 serial->setFlowControl(QSerialPort::NoFlowControl); // 流控制 // 打开串口 if (serial->open(QIODevice::ReadWrite)) { qDebug() << "串口打开成功"; connect(serial, &QSerialPort::readyRead, this, &MyClass::readData); // 连接数据接收槽 } else { qDebug() << "串口打开失败：" << serial->errorString(); } ``` --- #### 5. **数据接收槽函数** ```cpp void MyClass::readData() { QByteArray data = serial->readAll(); // 读取所有可用数据 qDebug() << "接收数据：" << data.toHex(' '); // 以十六进制打印 // 或转换为字符串： QString text = QString::fromUtf8(data); } ``` --- #### 6. **发送数据** ```cpp // 发送字符串 QString message = "Hello Serial!"; serial->write(message.toUtf8()); // 发送十六进制数据 (例如: 0xA0 0x01) QByteArray hexData = QByteArray::fromHex("A001"); serial->write(hexData); ``` --- #### 7. **关闭串口** ```cpp serial->close(); ``` --- ### **二、关键注意事项** 1. **跨平台路径差异**： - Windows：`"COM3"`, Linux：`"/dev/ttyUSB0"`, macOS：`"/dev/cu.usbserial"`。 2. **波特率设置**： - 使用 `QSerialPort::Baud9600` 等枚举值而非数字（避免兼容性问题）[^2]。 3. **数据编码**： - 设备通信常用十六进制格式，可通过 `QByteArray::toHex()` 和 `fromHex()` 转换。 4. **错误处理**： - 检查 `serial->error()` 并调用 `errorString()` 获取错误信息。 --- ### **三、完整示例代码片段** 基于引用 [4] 的代码结构简化： ```cpp // widget.h private slots: void on_btnOpen_clicked(); void on_btnSend_clicked(); void receiveData(); private: QSerialPort *m_serial; void initSerialPort(); // widget.cpp void Widget::initSerialPort() { m_serial = new QSerialPort(this); connect(m_serial, &QSerialPort::readyRead, this, &Widget::receiveData); } void Widget::on_btnOpen_clicked() { if (m_serial->isOpen()) { m_serial->close(); } else { m_serial->setPortName(ui->comboBoxPort->currentText()); m_serial->setBaudRate(QSerialPort::Baud115200); // ...其他参数配置 if (!m_serial->open(QIODevice::ReadWrite)) { qDebug() << "Error:" << m_serial->errorString(); } } } void Widget::on_btnSend_clicked() { QString text = ui->lineEditSend->text(); m_serial->write(text.toUtf8()); } void Widget::receiveData() { QByteArray data = m_serial->readAll(); ui->textEditRecv->append(QString::fromUtf8(data)); } ``` --- ### **四、资源推荐** 1. **[Qt 5.14 官方文档 - QSerialPort](https://doc.qt.io/qt-5.14/qserialport.html)** 2. **GitHub 开源项目参考**： - [QT 串口助手实现](https://github.com/search?q=qt+serial+port+example)（搜索关键词） 3. **调试工具**： - 使用虚拟串口软件（如 `com0com`）模拟设备通信。 --- ### **常见问题解决方案** - **无法检测串口**：检查系统权限（Linux需`sudo`或添加用户到`dialout`组）。 - **数据乱码**：确认设备编码格式（如UTF-8/GBK），使用 `QTextCodec` 转换。 - **接收不全**：使用 `while (serial->waitForReadyRead(50))` 循环读取剩余数据。
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值