Qt C++使用QSerialPort读取IMU串口十六进制数据全为0求助

核心问题点 #

你的代码存在4个直接导致读值全0的问题：

• 串口配置校验不全：仅校验了波特率设置结果，数据位、停止位、流控等配置失败时无感知，Windows下COM口被其他进程占用、权限不足时配置会静默失败，返回全0数据
• 轮询缓冲区逻辑错误：data定义为静态局部变量无限追加数据，从不清理无效字节、不做帧头对齐，缓存堆积乱码后解析完全错位，读值全0
• 串口未就绪就开始读：打开串口后立刻启动10ms轮询，Windows下串口底层初始化需要50~100ms，前N次读取只会拿到空值/残留0值
• 未配置读缓存与超时：QSerialPort在Windows下默认不设置读缓存大小，readAll()会直接返回空，不会等待串口缓存的数据

修正代码 #

构造函数与析构函数修正 #

static const int FRAME_SIZE = 68;

Imu::Imu() :
    moving(false)
{
    serialPort = new QSerialPort("COM3",this);
    if (!serialPort->open(QIODevice::ReadOnly))
    {
        log_warning("imu","failed to open device file \"%s\", IMU measures will be unavailable",qPrintable(serialPort->portName()));
        return;
    }

    // 全量校验串口配置
    bool configSuccess = true;
    configSuccess &= serialPort->setBaudRate(115200);
    configSuccess &= serialPort->setDataBits(QSerialPort::Data8);
    configSuccess &= serialPort->setParity(QSerialPort::NoParity);
    configSuccess &= serialPort->setStopBits(QSerialPort::OneStop);
    configSuccess &= serialPort->setFlowControl(QSerialPort::NoFlowControl);
    configSuccess &= serialPort->setReadBufferSize(2048);
    if (!configSuccess)
    {
        log_error("imu","serial config failed, error code: %d", serialPort->error());
        serialPort->close();
        return;
    }

    // 清空打开时串口残留的无效数据
    serialPort->clear(QSerialPort::Input);

    pollingTimer = new QTimer(this);
    // 用新式信号槽写法，避免宏定义拼写错误导致连接失败
    connect(pollingTimer, &QTimer::timeout, this, &Imu::pollSerialPort);
    // 延后100ms启动轮询，等待串口初始化完成
    pollingTimer->start(100);
}

Imu::~Imu()
{
    if (serialPort->isOpen())
        serialPort->close();
}

轮询函数修正 #

void Imu::pollSerialPort()
{
    static const unsigned char START_BYTES[2] = {0x55,0xAA};
    static const QByteArray START_WORD((char*)START_BYTES,2);
    static QByteArray recvBuffer;

    QByteArray newData = serialPort->readAll();
    if (newData.isEmpty()) return;
    recvBuffer.append(newData);

    // 循环处理缓冲区里的完整帧
    while (recvBuffer.size() >= FRAME_SIZE)
    {
        // 查找帧头位置
        int frameStart = recvBuffer.indexOf(START_WORD);
        if (frameStart == -1)
        {
            // 无有效帧头，清空所有乱码
            recvBuffer.clear();
            return;
        }
        // 丢弃帧头前的无效字节
        if (frameStart > 0)
            recvBuffer.remove(0, frameStart);
        // 数据不足一帧，等下次轮询凑数
        if (recvBuffer.size() < FRAME_SIZE)
            break;

        // 取出完整单帧
        QByteArray frame = recvBuffer.left(FRAME_SIZE);
        recvBuffer.remove(0, FRAME_SIZE);

        // 调试打印单帧十六进制
        qDebug() << "IMU frame hex:" << frame.toHex(' ');

        // 后续解析逻辑
    }
}

注意：解析数值时禁止直接将QByteArray缓存强转为自定义结构体指针，Windows平台默认结构体会做字节对齐，加上IMU多为小端序传输，直接强转90%概率会出现数值全0、乱跳的问题，需要按字节移位拼接数值，参考示例：

// 小端序16位加速度数据解析示例
int16_t accX = static_cast<uint8_t>(frame[2]) | (static_cast<uint8_t>(frame[3]) << 8);
int16_t accY = static_cast<uint8_t>(frame[4]) | (static_cast<uint8_t>(frame[5]) << 8);
int16_t accZ = static_cast<uint8_t>(frame[6]) | (static_cast<uint8_t>(frame[7]) << 8);

额外排查项 #

• 先拿串口调试助手验证硬件：同端口、115200/8N1/无流控配置，确认能稳定收到0x55 0xAA开头的数据流，排除接线错、供电不足、端口被其他软件占用的问题
• 确认IMU输出的帧长确实是68字节，部分IMU会根据配置输出不同长度的帧，帧长不匹配会导致解析错位
• Qt版本为6时，注意QSerialPort的枚举值命名空间是否正确，旧版SIGNAL/SLOT宏写法不会报编译错误，连接失败时轮询函数根本不会触发

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