QT Modbus RTU：向保持寄存器发送浮点值失败如何解决？

问题背景 #

刚入手一台485设备，需发送数据运行功能。设备手册指明目标保持寄存器起始地址为16/17，数据类型为浮点型。使用Modbus Poll读取寄存器后发现数据为二进制16位整数格式，尝试将浮点值转换为quint16类型（区分高低位）并通过QModbusDataUnit发送，但操作未成功。以下是原代码：

void Widget::on_lineEdit_RttSpeed_returnPressed() //Rotate Speed setting
{
    //Speed Range，0.1-100rpm，precision 0.1rpm
    QDoubleValidator *doubleValidator = new QDoubleValidator(this);
    doubleValidator->setRange(0.1,100,1);
    ui->lineEdit_RttSpeed->setValidator(doubleValidator);

    //Read data from LineEdit
    QString rotate_speed = ui->lineEdit_RttSpeed->text();
    //QString -> Float
    float port = rotate_speed.toFloat();
    //Float -> Qunit16
    union {
        struct {
            quint16 lo;
            quint16 hi;
        };
        float flt;
    } converter;
    converter.flt = port;
    //Qdebug Part
    qDebug() << "lo short"  << converter.lo;
    qDebug() << "hi short"  << converter.hi;

    // Send Write Request
    if (modbusDevice.state()==QModbusDevice::ConnectedState)
    {
        //QModbusDataUnit writeUnit(QModbusDataUnit::HoldingRegisters, 16, 2);
        //writeUnit.setValue(0, converter.flt);

        QModbusDataUnit writeUnit1(QModbusDataUnit::HoldingRegisters, 16, 1);
        writeUnit1.setValue(0, converter.hi); 
        QModbusDataUnit writeUnit2(QModbusDataUnit::HoldingRegisters, 17, 1); 
        writeUnit2.setValue(0, converter.lo); 
        
        //modbusDevice.sendWriteRequest(writeUnit, 1); //Device Slave ID: 1
        modbusDevice.sendWriteRequest(writeUnit1, 1);
        modbusDevice.sendWriteRequest(writeUnit2, 1);
        
        ui->plainTextEdit->appendPlainText("");
        ui->plainTextEdit->insertPlainText("Rotate Speed Set:" + QString(rotate_speed) + "rpm");
    }
    else
    {
        ui->plainTextEdit->appendPlainText("");
        ui->plainTextEdit->insertPlainText("Connection Fail");
    }
    return;
}

核心问题与解决步骤 #

• 字节序不匹配
  Modbus设备普遍使用**大端（Big-Endian）**存储多字节数据，而x86架构主机是小端（Little-Endian）。原union结构直接取lo和hi的顺序可能与设备要求相反，需将浮点值转换为大端格式的两个16位寄存器值，或根据设备手册确认字节序后调整高低位顺序。

• 分两次写入不可靠
  浮点型数据占用两个连续寄存器，应一次性发送写请求，避免分两次写入导致设备读取到不完整的浮点数据。使用QModbusDataUnit直接创建包含两个寄存器的请求，而非拆分两次发送。

• 寄存器地址偏移问题
  部分设备手册使用基于1的地址编号，但Qt的QModbusDataUnit默认使用基于0的地址。若设备手册的16号寄存器实际对应Qt中的地址15，需调整地址参数。

• 缺乏错误处理
  原代码未处理写请求的返回结果，无法排查通信错误。需监听QModbusReply的完成信号，获取错误信息定位问题。

修正后的代码示例 #

void Widget::on_lineEdit_RttSpeed_returnPressed() //Rotate Speed setting
{
    // 验证器只需初始化一次，避免重复创建
    static QDoubleValidator *doubleValidator = new QDoubleValidator(0.1, 100, 1, this);
    ui->lineEdit_RttSpeed->setValidator(doubleValidator);

    // 读取并验证输入值
    bool conversionOk;
    float rotateSpeed = ui->lineEdit_RttSpeed->text().toFloat(&conversionOk);
    if (!conversionOk) {
        ui->plainTextEdit->appendPlainText("输入无效，请输入0.1-100之间的数值");
        return;
    }

    // 将浮点值转换为大端格式的两个16位寄存器
    quint32 floatRaw = *reinterpret_cast<quint32*>(&rotateSpeed);
    quint16 regHigh = static_cast<quint16>((floatRaw >> 16) & 0xFFFF);
    quint16 regLow = static_cast<quint16>(floatRaw & 0xFFFF);
    // 若设备要求小端，取消下面一行注释交换高低位
    // std::swap(regHigh, regLow);

    qDebug() << "寄存器16值:" << regHigh;
    qDebug() << "寄存器17值:" << regLow;

    // 检查连接状态
    if (modbusDevice.state() != QModbusDevice::ConnectedState) {
        ui->plainTextEdit->appendPlainText("连接失败");
        return;
    }

    // 一次性写入两个连续寄存器（注意地址是否需要减1，如15）
    QModbusDataUnit writeUnit(QModbusDataUnit::HoldingRegisters, 16, 2);
    writeUnit.setValue(0, regHigh);
    writeUnit.setValue(1, regLow);

    // 发送写请求并处理结果
    QModbusReply *reply = modbusDevice.sendWriteRequest(writeUnit, 1);
    if (!reply) {
        ui->plainTextEdit->appendPlainText("发送请求失败: " + modbusDevice.errorString());
        return;
    }

    connect(reply, &QModbusReply::finished, this, [this, reply, rotateSpeed]() {
        if (reply->error() == QModbusDevice::NoError) {
            ui->plainTextEdit->appendPlainText("转速设置成功: " + QString::number(rotateSpeed) + "rpm");
        } else {
            ui->plainTextEdit->appendPlainText("设置失败: " + reply->errorString());
        }
        reply->deleteLater();
    });
}

额外测试建议 #

• 用Modbus Poll手动写入已知浮点值的寄存器（如1.0对应大端0x3F80和0x0000），验证设备是否正常响应，确认字节序和地址是否正确。
• 监听QModbusDevice::errorOccurred信号，获取更详细的通信错误信息。

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