通信

ModbusRTU

经串口按 Modbus-RTU 协议读写从站线圈与寄存器，支持 1/2/3/4/5/6/15/16 功能码，读回值以逗号分隔，失败返回 -1，运行信息写明原因
ModbusRtuTool · v1.0 · by system

输入参数 12

名称	keyId	类型	默认值	可连接	说明
通信配置ID	`commId`	enum	（空）	否	填入 HardwareConfig 中通信配置条目的 ID 后，工具会复用该 ID 对应的常驻 Modbus RTU 链路，串口参数由配置注入；留空时改为按本工具填写的串口号、波特率等参数自行建立上下文
串口号	`comPort`	enum	COM1	否	从 COM1 到 COM10 中选择要打开的串口设备，默认 COM1；该值为空时无法建立 RTU 上下文，工具返回 -1 并在运行信息提示串口号为空，绑定通信配置后由配置提供串口参数
波特率	`baudRate`	enum	9600	否	串口通信速率，可选 9600、19200、38400、57600、115200，默认 9600；取值必须是整串十进制正整数，含非数字字符或超出允许范围时工具返回 -1 并在运行信息提示波特率非法
数据位	`dataBits`	int	8	否	串口帧的数据位个数，默认 8，常用取值 5、6、7、8；该值与串口号、波特率、校验位、停止位共同决定 RTU 上下文的串口格式，输入缺失时按默认 8 处理
校验位	`parity`	enum	none	否	串口校验方式，可选无校验、偶校验、奇校验，默认无校验；取值 none 按无校验处理，even 按偶校验、odd 按奇校验处理，其它未被识别的取值同样按无校验处理，随串口格式一并生效
停止位	`stopBits`	int	1	否	串口帧的停止位个数，默认 1，常用取值 1 或 2；该值作为串口格式的一部分传入 RTU 上下文建立过程，输入缺失时按默认 1 处理，与数据位、校验位共同决定帧格式
从站地址	`unitId`	int	1	否	要访问的 Modbus 从站地址，默认 1，协议常用范围 1 到 247；工具在每次读写操作前用该值设置目标从站号，绑定通信配置时该地址会一并写入常驻配置并在后续调用中复用
功能码	`functionCode`	int	3	否	指定 Modbus 操作类型，默认 3 读取保持寄存器；1 读线圈、2 读离散输入、3 读保持寄存器、4 读输入寄存器、5 写单线圈、6 写单寄存器、15 写多线圈、16 写多寄存器，取其它值会返回 -1 并在运行信息提示不支持该功能码
起始地址	`address`	int	0	否	读写操作的起始寄存器或线圈地址，默认 0；读操作从该地址起连续读取指定数量的单元，写单值时它就是写入目标，写多值时作为连续写入的首地址
数量	`quantity`	int	1	否	读操作要读取的线圈或寄存器个数，默认 1；工具把该值作为读取长度用于读功能码，取值小于 1 时直接返回 -1 并在运行信息提示数量非法，写操作忽略该参数
写入值	`writeValues`	string	（空）	否	写功能码使用的数值序列，可用 JSON 数组或逗号分隔文本填写，如 [1,0]；工具会剥去方括号与空格后按逗号逐项解析为整数，无法解析的项被忽略；写单寄存器、写多线圈、写多寄存器时该值为空会返回 -1，写单线圈时为空按写 0 处理
超时(ms)	`timeoutMs`	int	3000	否	等待从站响应的超时时间，单位毫秒，默认 3000；工具把该值换算成秒与微秒后设置响应超时，未在时限内收到完整响应时对应读写操作失败并返回 -1，运行信息给出 Modbus 层错误描述

输出参数 4

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	本次操作的返回码，0=成功完成 Modbus 读写并写出读回值与状态，-1=串口上下文建立失败、参数非法、连接失败或读写操作失败，此时运行信息写明具体原因
运行信息	`resultInfo`	string	—	否	本次执行的状态描述，成功时写明 Modbus 操作成功及所用功能码，失败时给出具体原因，如串口上下文初始化失败、波特率非法、数量小于 1、连接失败或从站返回的异常描述，便于定位失败环节
读回值	`values`	string	—	否	读功能码取回的数值序列，以逗号分隔的字符串形式给出，元素顺序与起始地址起的读取顺序一致；写操作不产生读回值，该输出为空字符串，初始化失败时同样为空
异常信息	`exceptions`	string	—	否	Modbus 通信或参数层面的异常描述，操作成功时为空字符串；失败时记录具体原因，例如连接失败、响应错误、写入值为空或不支持的功能码，与返回码和运行信息一起用于排查问题

接入方式

在 FlowDesigner 中将「ModbusRTU」节点加入流程画布，把上游图像或数据连接至「通信配置ID」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← ModbusTCP 返回通信 gRPC客户端 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈