.NET 8.0 NModbus TCP Slave保持寄存器40001精度异常问题

问题现象 #

在.NET 8控制台应用搭建的NModbus TCP Slave中：

• 保持寄存器40001（或改为40003）对应的首个float参数，仅能以0.125为步长变化，其余参数精度正常
• 控制台打印该参数精度可达0.01级，但Modbus Poll读取值始终为0.125的整数倍（如25.625）
• 已在Modbus Poll中配置LittleEndian ByteSwap，排除软件自身故障

核心原因 #

问题出在float与Modbus保持寄存器的字节/字序转换逻辑不匹配：
虽然你在Modbus Poll中设置了LittleEndian ByteSwap，但NModbus默认的float转寄存器数组逻辑，可能与该配置的字节/字排列规则不一致。0.125步长是2^-3的特征，说明转换时只有低3位有效，本质是高字节/高字的位被错误截断或错位。

解决方案 #

1. 明确控制float到寄存器的转换顺序 #

替换原有转换逻辑，严格对齐Modbus Poll的LittleEndian ByteSwap规则（该配置通常指：字节按小端排列，且两个16位寄存器的字序交换）。

示例修正代码：

// 要写入的float值
float targetValue = 25.67f;

// 转换为小端字节数组
byte[] floatBytes = BitConverter.GetBytes(targetValue);
if (!BitConverter.IsLittleEndian)
    Array.Reverse(floatBytes); // 若系统为大端，先转为小端字节

// 按Modbus Poll LittleEndian ByteSwap要求，交换字的顺序
ushort[] registers = new ushort[2];
// 第0个寄存器取字节数组的后2字节（高字），第1个寄存器取前2字节（低字）
registers[0] = BitConverter.ToUInt16(floatBytes, 2);
registers[1] = BitConverter.ToUInt16(floatBytes, 0);

// 将寄存器写入Slave的保持寄存器存储
slaveStore.HoldingRegisters.WriteValues(startAddress, registers);

2. 使用NModbus内置工具类（推荐） #

如果使用NModbus的ModbusUtility类，可直接指定端序避免手动转换错误：

float targetValue = 25.67f;
// 指定LittleEndian，确保与Modbus Poll配置对齐
ushort[] registers = ModbusUtility.GetRegistersFromSingle(targetValue, Endianness.LittleEndian);
slaveStore.HoldingRegisters.WriteValues(startAddress, registers);

验证步骤 #

1. 转换后打印寄存器的十六进制值，与Modbus Poll的「Convert」工具计算结果对比：
   • 例如25.67f的小端字节为0x9A 0x99 0x9A 0x41，对应的寄存器应为0x419A和0x999A
2. 在Modbus Poll中读取该寄存器，确认数值精度与控制台打印一致

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