如何修改libmodbus中modbus_read_registers报文的Unit ID

问题根因 #

modbus_set_slave设置不生效、报文Unit ID固定为0xFF，是libmodbus TCP后端的默认行为：TCP模式下库默认开启从站ID强制逻辑，发包前会覆盖用户手动设置的slave值，将Unit ID固定写为0xFF（Modbus-TCP协议定义的网关透传默认值）。
modbus_read_registers等读写函数未设计单独的Unit ID入参是框架的统一设计：所有协议、连接参数都存在modbus_t *ctx上下文实例中，业务函数直接从上下文读取参数，无需每次调用单独传入。

正确配置步骤 #

• 1. 创建Modbus-TCP上下文，完成目标IP、端口配置，按需设置超时、错误恢复模式等基础参数
• 2. 引入TCP专用头文件，调用接口关闭默认的从站ID强制逻辑：

#include <modbus/modbus-tcp.h>
// 关闭TCP模式下Unit ID强制为0xFF的默认逻辑
modbus_tcp_disable_slave_forcing(ctx);

• 3. 调用从站设置接口写入目标Unit ID：

// 设置目标Unit ID为0xFE
modbus_set_slave(ctx, 0xFE);

• 4. 执行后续连接、寄存器读写操作即可，此时发出的Modbus-TCP报文Unit ID会固定为设置的0xFE。

注意事项 #

如果代码包含断连重连逻辑，重连完成后需要重新执行「关闭强制逻辑-设置从站ID」的操作，部分重连流程会重置上下文的TCP参数，重新触发0xFF强制设置。

配置完成后可以调用modbus_get_slave(ctx)打印当前上下文存储的从站ID，返回值为0xFE即代表配置生效，也可以直接抓包确认报文内的Unit ID字段。

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