点击或拖拽改变大小

ModbusRtu 类

Modbus-Rtu通讯协议的类库,多项式码0xA001,支持标准的功能码,也支持扩展的功能码实现,地址采用富文本的形式,详细见备注说明
Modbus-Rtu communication protocol class library, polynomial code 0xA001, supports standard function codes, and also supports extended function code implementation. The address is in rich text. For details, see the remark
继承层次
SystemObject
  HslCommunication.SerialSerialBase
    HslCommunication.SerialSerialDeviceBase
      HslCommunication.ModBusModbusRtu
        更多...

命名空间:  HslCommunication.ModBus
程序集:  HslCommunication (在 HslCommunication.dll 中) 版本:11.8.2.0 (11.8.2.0)
语法
public class ModbusRtu : SerialDeviceBase, IModbus, 
	IReadWriteDevice, IReadWriteNet

ModbusRtu 类型公开以下成员。

构造函数
  名称说明
公共方法ModbusRtu
实例化一个Modbus-Rtu协议的客户端对象
Instantiate a client object of the Modbus-Rtu protocol
公共方法ModbusRtu(Byte)
指定Modbus从站的站号来初始化
Specify the station number of the Modbus slave to initialize
Top
属性
  名称说明
公共属性AddressStartWithZero
获取或设置起始的地址是否从0开始,默认为True
Gets or sets whether the starting address starts from 0. The default is True
公共属性BaudRate
当前连接串口信息的波特率
Baud rate of current connection serial port information
(继承自 SerialBase。)
公共属性代码示例ByteTransform
当前的数据变换机制,当你需要从字节数据转换类型数据的时候需要。
The current data transformation mechanism is required when you need to convert type data from byte data.
(继承自 SerialDeviceBase。)
公共属性ConnectionId
当前连接的唯一ID号,默认为长度20的guid码加随机数组成,方便列表管理,也可以自己指定
The unique ID number of the current connection. The default is a 20-digit guid code plus a random number.
(继承自 SerialDeviceBase。)
公共属性Crc16CheckEnable
获取或设置是否启用CRC16校验码的检查功能,默认启用,如果需要忽略检查CRC16,则设置为 false 即可。
Gets or sets whether to enable the check function of CRC16 check code. It is enabled by default. If you need to ignore the check of CRC16, you can set it to false.
公共属性DataFormat
获取或设置数据解析的格式,可选ABCD, BADC,CDAB,DCBA格式,对int,uint,float,double,long,ulong类型有作用
Get or set the format of the data analysis, optional ABCD, BADC, CDAB, DCBA format, effective for int, uint, float, double, long, ulong type
公共属性IsClearCacheBeforeRead
是否在发送数据前清空缓冲数据,默认是false
Whether to empty the buffer before sending data, the default is false
(继承自 SerialBase。)
公共属性IsStringReverse
字符串数据是否按照字来反转,默认为False
Whether the string data is reversed according to words. The default is False.
公共属性代码示例LogNet
组件的日志工具,支持日志记录,只要实例化后,当前网络的基本信息,就以DEBUG等级进行输出
The component's logging tool supports logging. As long as the instantiation of the basic network information, the output will be output at DEBUG
(继承自 SerialBase。)
公共属性PortName
当前连接串口信息的端口号名称
The port name of the current connection serial port information
(继承自 SerialBase。)
公共属性ReceiveEmptyDataCount
获取或设置连续接收空的数据次数,在数据接收完成时有效,每个单位消耗的时间为SleepTime,配合CheckReceiveDataComplete(MemoryStream)来更好的控制完整数据接收。
Get or set the number of consecutive empty data receptions, which is valid when data reception is completed. The time consumed by each unit is SleepTime, which is better with CheckReceiveDataComplete(MemoryStream) Control complete data reception.
(继承自 SerialBase。)
公共属性ReceiveTimeout
接收数据的超时时间,默认5000ms
Timeout for receiving data, default is 5000ms
(继承自 SerialBase。)
公共属性RtsEnable
获取或设置一个值,该值指示在串行通信中是否启用请求发送 (RTS) 信号。
Gets or sets a value indicating whether the request sending (RTS) signal is enabled in serial communication.
(继承自 SerialBase。)
公共属性SleepTime
连续串口缓冲数据检测的间隔时间,默认20ms,该值越小,通信速度越快,但是越不稳定。
Continuous serial port buffer data detection interval, the default 20ms, the smaller the value, the faster the communication, but the more unstable.
(继承自 SerialBase。)
公共属性Station
获取或者重新修改服务器的默认站号信息,当然,你可以再读写的时候动态指定,参见备注
Get or modify the default station number information of the server. Of course, you can specify it dynamically when reading and writing, see note
受保护的属性WordLength
一个字单位的数据表示的地址长度,西门子为2,三菱,欧姆龙,modbusTcp就为1,AB PLC无效
The address length represented by one word of data, Siemens is 2, Mitsubishi, Omron, modbusTcp is 1, AB PLC is invalid
(继承自 SerialDeviceBase。)
Top
方法
  名称说明
受保护的方法CheckReceiveDataComplete
检查当前从串口接收的数据是否是完整的,如果是完整的,则需要返回 True,串口数据接收立即完成,默认返回 False
Check whether the data currently received from the serial port is complete. If it is complete, you need to return True. The serial port data reception is completed immediately, and the default returns False
(重写 SerialBaseCheckReceiveDataComplete(MemoryStream).)
公共方法ClearSerialCache
清除串口缓冲区的数据,并返回该数据,如果缓冲区没有数据,返回的字节数组长度为0
The number sent clears the data in the serial port buffer and returns that data, or if there is no data in the buffer, the length of the byte array returned is 0
(继承自 SerialBase。)
公共方法Close
关闭当前的串口连接
Close the current serial connection
(继承自 SerialBase。)
公共方法Dispose
释放当前的对象
(继承自 SerialBase。)
受保护的方法Dispose(Boolean)
释放当前的对象
(继承自 SerialBase。)
公共方法Equals (继承自 Object。)
受保护的方法代码示例ExtraOnClose
根据实际的协议选择是否重写本方法,有些协议在断开连接之前,需要发送一些报文来关闭当前的网络通道
Select whether to rewrite this method according to the actual protocol. Some protocols need to send some packets to close the current network channel before disconnecting.
(继承自 SerialBase。)
受保护的方法Finalize (继承自 Object。)
公共方法GetHashCode (继承自 Object。)
公共方法GetPipeSerial
获取当前用于通信的管道信息
Get the current pipe information used for communication
(继承自 SerialBase。)
公共方法GetType (继承自 Object。)
受保护的方法GetWordLength
一个字单位的数据表示的地址长度,西门子为2,三菱,欧姆龙,modbusTcp就为1,AB PLC无效
The address length represented by one word of data, Siemens is 2, Mitsubishi, Omron, modbusTcp is 1, AB PLC is invalid
(继承自 SerialDeviceBase。)
受保护的方法代码示例InitializationOnOpen
根据实际的协议选择是否重写本方法,有些协议在创建连接之后,需要进行一些初始化的信号握手,才能最终建立网络通道。
Whether to rewrite this method is based on the actual protocol. Some protocols require some initial signal handshake to establish a network channel after the connection is created.
(继承自 SerialBase。)
公共方法IsOpen
获取一个值,指示串口是否处于打开状态
Gets a value indicating whether the serial port is open
(继承自 SerialBase。)
受保护的方法MemberwiseClone (继承自 Object。)
公共方法Open
打开一个新的串行端口连接
Open a new serial port connection
(继承自 SerialBase。)
公共方法PackCommandWithHeader
对当前的命令进行打包处理,通常是携带命令头内容,标记当前的命令的长度信息,需要进行重写,否则默认不打包
The current command is packaged, usually carrying the content of the command header, marking the length of the current command, and it needs to be rewritten, otherwise it is not packaged by default
(重写 SerialBasePackCommandWithHeader(Byte).)
公共方法代码示例Read(String, UInt16)
从Modbus服务器批量读取寄存器的信息,需要指定起始地址,读取长度,如果富文本地址不指定,默认使用的功能码是 0x03,如果需要使用04功能码,那么地址就写成 x=4;100
To read the register information from the Modbus server in batches, you need to specify the start address and read length. If the rich text address is not specified, the default function code is 0x03. If you need to use the 04 function code, the address is written as x = 4; 100
(重写 SerialDeviceBaseRead(String, UInt16).)
公共方法代码示例ReadT
读取支持Hsl特性的数据内容,该特性为HslDeviceAddressAttribute,详细参考api文档说明
Read the data content of the Hsl attribute. The attribute is HslDeviceAddressAttribute, please refer to the api documentation for details.
(继承自 SerialDeviceBase。)
公共方法ReadAsync(String, UInt16)
异步批量读取字节数组信息,需要指定地址和长度,返回原始的字节数组
Asynchronous batch read byte array information, need to specify the address and length, return the original byte array
(继承自 SerialDeviceBase。)
公共方法代码示例ReadAsyncT
异步读取支持Hsl特性的数据内容,该特性为HslDeviceAddressAttribute,详细参考api文档说明
Asynchronously read the data content of the Hsl attribute. The attribute is HslDeviceAddressAttribute, please refer to the api documentation for details.
(继承自 SerialDeviceBase。)
公共方法ReadBool(String)
读取单个的Boolean数据信息
Read a single Boolean data message
(继承自 SerialDeviceBase。)
公共方法ReadBool(String, UInt16)
批量读取线圈或是离散的数据信息,需要指定地址和长度,具体的结果取决于实现,如果富文本地址不指定,默认使用的功能码是 0x01
To read coils or discrete data in batches, you need to specify the address and length. The specific result depends on the implementation. If the rich text address is not specified, the default function code is 0x01.
(重写 SerialDeviceBaseReadBool(String, UInt16).)
公共方法ReadBoolAsync(String)
异步读取单个的Boolean数据信息
Asynchronously read a single Boolean data message
(继承自 SerialDeviceBase。)
公共方法ReadBoolAsync(String, UInt16)
异步批量读取Boolean数组信息,需要指定地址和长度,返回Boolean 数组
Asynchronously batch read Boolean array information, need to specify the address and length, return Boolean array
(继承自 SerialDeviceBase。)
公共方法ReadCoil(String)
读取线圈,需要指定起始地址,如果富文本地址不指定,默认使用的功能码是 0x01
To read the coil, you need to specify the start address. If the rich text address is not specified, the default function code is 0x01.
公共方法ReadCoil(String, UInt16)
批量的读取线圈,需要指定起始地址,读取长度,如果富文本地址不指定,默认使用的功能码是 0x01
For batch reading coils, you need to specify the start address and read length. If the rich text address is not specified, the default function code is 0x01.
公共方法ReadCoilAsync(String)
读取线圈,需要指定起始地址,如果富文本地址不指定,默认使用的功能码是 0x01
To read the coil, you need to specify the start address. If the rich text address is not specified, the default function code is 0x01.
公共方法ReadCoilAsync(String, UInt16)
批量的读取线圈,需要指定起始地址,读取长度,如果富文本地址不指定,默认使用的功能码是 0x01
For batch reading coils, you need to specify the start address and read length. If the rich text address is not specified, the default function code is 0x01.
公共方法代码示例ReadCustomerT(String)
读取自定义的数据类型,需要继承自IDataTransfer接口,返回一个新的类型的实例对象。
To read a custom data type, you need to inherit from the IDataTransfer interface and return an instance object of a new type.
(继承自 SerialDeviceBase。)
公共方法代码示例ReadCustomerT(String, T)
读取自定义的数据类型,需要继承自IDataTransfer接口,传入一个实例,对这个实例进行赋值,并返回该实例的对象。
To read a custom data type, you need to inherit from the IDataTransfer interface, pass in an instance, assign a value to this instance, and return the object of the instance.
(继承自 SerialDeviceBase。)
公共方法代码示例ReadCustomerAsyncT(String)
读取自定义的数据类型,需要继承自IDataTransfer接口,返回一个新的类型的实例对象。
To read a custom data type, you need to inherit from the IDataTransfer interface and return an instance object of a new type.
(继承自 SerialDeviceBase。)
公共方法代码示例ReadCustomerAsyncT(String, T)
读取自定义的数据类型,需要继承自IDataTransfer接口,传入一个实例,对这个实例进行赋值,并返回该实例的对象。
To read a custom data type, you need to inherit from the IDataTransfer interface, pass in an instance, assign a value to this instance, and return the object of the instance.
(继承自 SerialDeviceBase。)
公共方法ReadDiscrete(String)
读取输入线圈,需要指定起始地址,如果富文本地址不指定,默认使用的功能码是 0x02
To read the input coil, you need to specify the start address. If the rich text address is not specified, the default function code is 0x02.
公共方法ReadDiscrete(String, UInt16)
批量的读取输入点,需要指定起始地址,读取长度,如果富文本地址不指定,默认使用的功能码是 0x02
To read input points in batches, you need to specify the start address and read length. If the rich text address is not specified, the default function code is 0x02
公共方法ReadDiscreteAsync(String)
读取输入线圈,需要指定起始地址,如果富文本地址不指定,默认使用的功能码是 0x02
To read the input coil, you need to specify the start address. If the rich text address is not specified, the default function code is 0x02.
公共方法ReadDiscreteAsync(String, UInt16)
批量的读取输入点,需要指定起始地址,读取长度,如果富文本地址不指定,默认使用的功能码是 0x02
To read input points in batches, you need to specify the start address and read length. If the rich text address is not specified, the default function code is 0x02
公共方法代码示例ReadDouble(String)
读取双浮点的数据
Read double floating point data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadDouble(String, UInt16)
读取双浮点数据的数组
Read double floating point data array
(重写 SerialDeviceBaseReadDouble(String, UInt16).)
公共方法代码示例ReadDoubleAsync(String)
异步读取双浮点的数据
Asynchronously read double floating point data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadDoubleAsync(String, UInt16)
异步读取双浮点数据的数组
Asynchronously read double floating point data array
(重写 SerialDeviceBaseReadDoubleAsync(String, UInt16).)
公共方法代码示例ReadFloat(String)
读取单浮点数据
Read single floating point data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadFloat(String, UInt16)
读取单浮点精度的数组
Read single floating point array
(重写 SerialDeviceBaseReadFloat(String, UInt16).)
公共方法代码示例ReadFloatAsync(String)
异步读取单浮点数据
Asynchronously read single floating point data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadFloatAsync(String, UInt16)
异步读取单浮点精度的数组
Asynchronously read single floating point array
(重写 SerialDeviceBaseReadFloatAsync(String, UInt16).)
公共方法ReadFromCoreServer(Byte)
将Modbus报文数据发送到当前的通道中,并从通道中接收Modbus的报文,通道将根据当前连接自动获取,本方法是线程安全的。
Send Modbus message data to the current channel, and receive Modbus messages from the channel. The channel will automatically obtain it according to the current connection. This method is thread-safe.
(重写 SerialBaseReadFromCoreServer(Byte).)
公共方法ReadFromCoreServer(IEnumerableByte) (继承自 SerialBase。)
公共方法ReadFromCoreServer(Byte, Boolean, Boolean)
将原始的字节数据发送到串口,然后从串口接收一条数据。
The raw byte data is sent to the serial port, and then a piece of data is received from the serial port.
(继承自 SerialBase。)
公共方法ReadFromCoreServer(SerialPort, Byte, Boolean, Boolean)
将数据发送到当前的串口通道上去,并且从串口通道接收一串原始的字节报文,默认对方必须返回数据,也可以手动修改不返回数据信息。
Send data to the current serial channel, and receive a string of original byte messages from the serial channel. By default, the other party must return data, or you can manually modify it to not return data information.
(继承自 SerialBase。)
公共方法ReadFromCoreServerAsync(Byte)
将原始的字节数据发送到串口,然后从串口接收一条数据。
The raw byte data is sent to the serial port, and then a piece of data is received from the serial port.
(继承自 SerialBase。)
公共方法ReadFromCoreServerAsync(IEnumerableByte) (继承自 SerialBase。)
公共方法代码示例ReadInt16(String)
读取16位的有符号的整型数据
Read 16-bit signed integer data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt16(String, UInt16)
读取16位的有符号整型数组
Read 16-bit signed integer array
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt16Async(String)
异步读取16位的有符号的整型数据
Asynchronously read 16-bit signed integer data
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt16Async(String, UInt16)
异步读取16位的有符号整型数组
Asynchronously read 16-bit signed integer array
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt32(String)
读取32位的有符号整型
Read 32-bit signed integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt32(String, UInt16)
读取32位有符号整型数组
Read 32-bit signed integer array
(重写 SerialDeviceBaseReadInt32(String, UInt16).)
公共方法代码示例ReadInt32Async(String)
异步读取32位的有符号整型
Asynchronously read 32-bit signed integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt32Async(String, UInt16)
异步读取32位有符号整型数组
Asynchronously read 32-bit signed integer array
(重写 SerialDeviceBaseReadInt32Async(String, UInt16).)
公共方法代码示例ReadInt64(String)
读取64位的有符号整型
Read 64-bit signed integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt64(String, UInt16)
读取64位的有符号整型数组
Read 64-bit signed integer array
(重写 SerialDeviceBaseReadInt64(String, UInt16).)
公共方法代码示例ReadInt64Async(String)
异步读取64位的有符号整型
Asynchronously read 64-bit signed integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadInt64Async(String, UInt16)
异步读取64位的有符号整型数组
Asynchronously read 64-bit signed integer array
(重写 SerialDeviceBaseReadInt64Async(String, UInt16).)
公共方法代码示例ReadString(String, UInt16)
读取字符串数据,默认为最常见的ASCII编码
Read string data, default is the most common ASCII encoding
(继承自 SerialDeviceBase。)
公共方法代码示例ReadString(String, UInt16, Encoding)
使用指定的编码,读取字符串数据
Reads string data using the specified encoding
(继承自 SerialDeviceBase。)
公共方法代码示例ReadStringAsync(String, UInt16)
异步读取字符串数据,默认为最常见的ASCII编码
Asynchronously read string data, default is the most common ASCII encoding
(继承自 SerialDeviceBase。)
公共方法代码示例ReadStringAsync(String, UInt16, Encoding)
异步使用指定的编码,读取字符串数据
Asynchronously reads string data using the specified encoding
(继承自 SerialDeviceBase。)
公共方法代码示例ReadStructT
读取结构体类型的数据,根据结构体自身的定义,读取原始字节数组,然后解析出实际的结构体数据,结构体需要实现HslStructAttribute特性
(继承自 SerialDeviceBase。)
公共方法代码示例ReadStructAsyncT
读取结构体类型的数据,根据结构体自身的定义,读取原始字节数组,然后解析出实际的结构体数据,结构体需要实现HslStructAttribute特性
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt16(String)
读取16位的无符号整型
Read 16-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt16(String, UInt16)
读取16位的无符号整型数组
Read 16-bit unsigned integer array
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt16Async(String)
异步读取16位的无符号整型
Asynchronously read 16-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt16Async(String, UInt16)
异步读取16位的无符号整型数组
Asynchronously read 16-bit unsigned integer array
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt32(String)
读取32位的无符号整型
Read 32-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt32(String, UInt16)
读取32位的无符号整型数组
Read 32-bit unsigned integer array
(重写 SerialDeviceBaseReadUInt32(String, UInt16).)
公共方法代码示例ReadUInt32Async(String)
异步读取32位的无符号整型
Asynchronously read 32-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt32Async(String, UInt16)
异步读取32位的无符号整型数组
Asynchronously read 32-bit unsigned integer array
(重写 SerialDeviceBaseReadUInt32Async(String, UInt16).)
公共方法代码示例ReadUInt64(String)
读取64位的无符号整型
Read 64-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt64(String, UInt16)
读取64位的无符号整型的数组
Read 64-bit unsigned integer array
(重写 SerialDeviceBaseReadUInt64(String, UInt16).)
公共方法代码示例ReadUInt64Async(String)
异步读取64位的无符号整型
Asynchronously read 64-bit unsigned integer
(继承自 SerialDeviceBase。)
公共方法代码示例ReadUInt64Async(String, UInt16)
异步读取64位的无符号整型的数组
Asynchronously read 64-bit unsigned integer array
(重写 SerialDeviceBaseReadUInt64Async(String, UInt16).)
公共方法ReadWrite
使用0x17功能码来实现同时写入并读取数据的操作,使用一条报文来实现,需要指定读取的地址,长度,写入的地址,写入的数据信息,返回读取的结果数据。
Use 0x17 function code to write and read data at the same time, and use a message to implement it, you need to specify the read address, length, written address, written data information, and return the read result data.
公共方法SerialPortInni(ActionSerialPort)
根据自定义初始化方法进行初始化串口信息
Initialize the serial port information according to the custom initialization method
(继承自 SerialBase。)
公共方法SerialPortInni(String)
初始化串口信息,9600波特率,8位数据位,1位停止位,无奇偶校验
Initial serial port information, 9600 baud rate, 8 data bits, 1 stop bit, no parity
(继承自 SerialBase。)
公共方法SerialPortInni(String, Int32)
初始化串口信息,波特率,8位数据位,1位停止位,无奇偶校验
Initializes serial port information, baud rate, 8-bit data bit, 1-bit stop bit, no parity
(继承自 SerialBase。)
公共方法SerialPortInni(String, Int32, Int32, StopBits, Parity)
初始化串口信息,波特率,数据位,停止位,奇偶校验需要全部自己来指定
Start serial port information, baud rate, data bit, stop bit, parity all need to be specified
(继承自 SerialBase。)
公共方法SetPipeSerial
设置一个新的串口管道,一般来说不需要调用本方法,当多个串口设备共用一个COM口时才需要使用本方法进行设置共享的管道。
To set a new serial port pipe, generally speaking, you do not need to call this method. This method is only needed to set the shared pipe when multiple serial devices share the same COM port.
(继承自 SerialBase。)
受保护的方法SPReceived
从串口接收一串字节数据信息,直到没有数据为止,如果参数awaitData为false, 第一轮接收没有数据则返回
Receives a string of bytes of data information from the serial port until there is no data, and returns if the parameter awaitData is false
(继承自 SerialBase。)
受保护的方法SPSend
发送数据到串口去。
Send data to serial port.
(继承自 SerialBase。)
公共方法ToString (重写 SerialDeviceBaseToString.)
公共方法TranslateToModbusAddress
将当前的地址信息转换成Modbus格式的地址,如果转换失败,返回失败的消息。默认不进行任何的转换。
Convert the current address information into a Modbus format address. If the conversion fails, a failure message will be returned. No conversion is performed by default.
公共方法UnpackResponseContent
根据对方返回的报文命令,对命令进行基本的拆包,例如各种Modbus协议拆包为统一的核心报文,还支持对报文的验证
According to the message command returned by the other party, the command is basically unpacked, for example, various Modbus protocols are unpacked into a unified core message, and the verification of the message is also supported
(重写 SerialBaseUnpackResponseContent(Byte, Byte).)
公共方法Wait(String, Boolean, Int32, Int32)
等待指定地址的Boolean值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Boolean value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, Int16, Int32, Int32)
等待指定地址的Int16值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int16 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, Int32, Int32, Int32)
等待指定地址的Int32值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int32 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, Int64, Int32, Int32)
等待指定地址的Int64值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int64 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, UInt16, Int32, Int32)
等待指定地址的UInt16值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt16 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, UInt32, Int32, Int32)
等待指定地址的UInt32值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt32 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Wait(String, UInt64, Int32, Int32)
等待指定地址的UInt64值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt64 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, Boolean, Int32, Int32)
等待指定地址的Boolean值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Boolean value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, Int16, Int32, Int32)
等待指定地址的Int16值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int16 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, Int32, Int32, Int32)
等待指定地址的Int32值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int32 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, Int64, Int32, Int32)
等待指定地址的Int64值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the Int64 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, UInt16, Int32, Int32)
等待指定地址的UInt16值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt16 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, UInt32, Int32, Int32)
等待指定地址的UInt32值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt32 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法WaitAsync(String, UInt64, Int32, Int32)
等待指定地址的UInt64值为指定的值,可以指定刷新数据的频率,等待的超时时间,如果超时时间为-1的话,则是无期限等待。
Waiting for the UInt64 value of the specified address to be the specified value, you can specify the frequency of refreshing the data, and the timeout time to wait. If the timeout time is -1, it is an indefinite wait.
(继承自 SerialDeviceBase。)
公共方法Write(String, Boolean)
向线圈中写入bool数值,返回是否写入成功,如果富文本地址不指定,默认使用的功能码是 0x05, 如果你的地址为字地址,例如100.2,那么将使用0x16的功能码,通过掩码的方式来修改寄存器的某一位,需要Modbus服务器支持,否则写入无效。
Write bool value to the coil and return whether the writing is successful. If the rich text address is not specified, the default function code is 0x05. If your address is a word address, such as 100.2, then you will use the function code of 0x16 to modify a bit of the register through a mask. It needs Modbus server support, otherwise the writing is invalid.
(重写 SerialDeviceBaseWrite(String, Boolean).)
公共方法Write(String, Boolean)
向线圈中写入bool数组,返回是否写入成功,如果富文本地址不指定,默认使用的功能码是 0x0F
Write the bool array to the coil, and return whether the writing is successful. If the rich text address is not specified, the default function code is 0x0F.
(重写 SerialDeviceBaseWrite(String, Boolean).)
公共方法代码示例Write(String, Byte)
将数据写入到Modbus的寄存器上去,需要指定起始地址和数据内容,如果富文本地址不指定,默认使用的功能码是 0x10
To write data to Modbus registers, you need to specify the start address and data content. If the rich text address is not specified, the default function code is 0x10
(重写 SerialDeviceBaseWrite(String, Byte).)
公共方法代码示例Write(String, Double)
写入double数组,返回是否成功
Write double array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, Double).)
公共方法Write(String, Int16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
(重写 SerialDeviceBaseWrite(String, Int16).)
公共方法代码示例Write(String, Int32)
写入int[]数组,返回是否成功
Write int array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, Int32).)
公共方法代码示例Write(String, Int64)
写入long数组,返回是否成功
Write long array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, Int64).)
公共方法代码示例Write(String, Single)
写入float数组,返回是否成功
Write float array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, Single).)
公共方法Write(String, UInt16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
(重写 SerialDeviceBaseWrite(String, UInt16).)
公共方法代码示例Write(String, UInt32)
写入uint[]数组,返回是否成功
Write uint array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, UInt32).)
公共方法代码示例Write(String, UInt64)
写入ulong数组,返回是否成功
Write ulong array, return whether the write was successful
(重写 SerialDeviceBaseWrite(String, UInt64).)
公共方法代码示例Write(String, Double)
写入double数据,返回是否成功
Write double data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, Int16)
写入short数组,返回是否成功
Write short array, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, Int32)
写入int数据,返回是否成功
Write int data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, Int64)
写入long数据,返回是否成功
Write long data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, Single)
写入float数据,返回是否成功
Write float data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, String)
写入字符串信息,编码为ASCII
Write string information, encoded as ASCII
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, UInt16)
写入ushort数组,返回是否成功
Write ushort array, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, UInt32)
写入uint数据,返回是否成功
Write uint data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, UInt64)
写入ulong数据,返回是否成功
Write ulong data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, String, Int32)
写入指定长度的字符串信息,如果超出,就截断字符串,如果长度不足,那就补0操作,编码为ASCII
Write string information of the specified length. If it exceeds the value, the string is truncated. If the length is not enough, it is filled with 0 and the encoding is ASCII.
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, String, Encoding)
写入字符串信息,需要指定的编码信息
Write string information, need to specify the encoding information
(继承自 SerialDeviceBase。)
公共方法代码示例Write(String, String, Int32, Encoding)
写入指定长度的字符串信息,如果超出,就截断字符串,如果长度不足,那就补0操作,编码为指定的编码信息
Write string information of the specified length. If it exceeds the value, the string is truncated. If the length is not enough, then the operation is complemented with 0 , you should specified the encoding information
(继承自 SerialDeviceBase。)
公共方法代码示例WriteT(T)
写入支持Hsl特性的数据,返回是否写入成功,该特性为HslDeviceAddressAttribute,详细参考api文档说明
Write data that supports the Hsl attribute, and return whether the write was successful. The attribute is HslDeviceAddressAttribute, please refer to the api documentation for details.
(继承自 SerialDeviceBase。)
公共方法WriteAsync(String, Boolean)
向线圈中写入bool数值,返回是否写入成功,如果富文本地址不指定,默认使用的功能码是 0x05, 如果你的地址为字地址,例如100.2,那么将使用0x16的功能码,通过掩码的方式来修改寄存器的某一位,需要Modbus服务器支持,否则写入无效。
Write bool value to the coil and return whether the writing is successful. If the rich text address is not specified, the default function code is 0x05. If your address is a word address, such as 100.2, then you will use the function code of 0x16 to modify a bit of the register through a mask. It needs Modbus server support, otherwise the writing is invalid.
(重写 SerialDeviceBaseWriteAsync(String, Boolean).)
公共方法代码示例WriteAsync(String, Double)
异步写入double数组,返回是否成功
Asynchronously write double array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, Double).)
公共方法WriteAsync(String, Int16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
(重写 SerialDeviceBaseWriteAsync(String, Int16).)
公共方法代码示例WriteAsync(String, Int32)
异步写入int[]数组,返回是否成功
Asynchronously write int array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, Int32).)
公共方法代码示例WriteAsync(String, Int64)
异步写入long数组,返回是否成功
Asynchronously write long array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, Int64).)
公共方法代码示例WriteAsync(String, Single)
异步写入float数组,返回是否成功
Asynchronously write float array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, Single).)
公共方法WriteAsync(String, UInt16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
(重写 SerialDeviceBaseWriteAsync(String, UInt16).)
公共方法代码示例WriteAsync(String, UInt32)
异步写入uint[]数组,返回是否成功
Asynchronously write uint array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, UInt32).)
公共方法代码示例WriteAsync(String, UInt64)
异步写入ulong数组,返回是否成功
Asynchronously write ulong array, return whether the write was successful
(重写 SerialDeviceBaseWriteAsync(String, UInt64).)
公共方法WriteAsync(String, Boolean)
异步批量写入Boolean数组数据,返回是否成功
Asynchronously batch write Boolean array data, return success
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Byte)
异步写入原始的byte数组数据到指定的地址,返回是否写入成功
Asynchronously writes the original byte array data to the specified address, and returns whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Double)
异步写入double数据,返回是否成功
Asynchronously write double data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Int16)
异步写入short数组,返回是否成功
Asynchronously write short array, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Int32)
异步写入int数据,返回是否成功
Asynchronously write int data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Int64)
异步写入long数据,返回是否成功
Asynchronously write long data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, Single)
异步写入float数据,返回是否成功
Asynchronously write float data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, String)
异步写入字符串信息,编码为ASCII
Asynchronously write string information, encoded as ASCII
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, UInt16)
异步写入ushort数组,返回是否成功
Asynchronously write ushort array, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, UInt32)
异步写入uint数据,返回是否成功
Asynchronously write uint data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, UInt64)
异步写入ulong数据,返回是否成功
Asynchronously write ulong data, return whether the write was successful
(继承自 SerialDeviceBase。)
公共方法WriteAsync(String, String, Int32)
异步写入指定长度的字符串信息,如果超出,就截断字符串,如果长度不足,那就补0操作,编码为ASCII
Asynchronously write string information of the specified length. If it exceeds the value, the string is truncated. If the length is not enough, it is filled with 0 and the encoding is ASCII.
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsync(String, String, Encoding)
异步写入字符串信息,需要指定的编码信息
Asynchronously write string information, need to specify the encoding information
(继承自 SerialDeviceBase。)
公共方法WriteAsync(String, String, Int32, Encoding)
异步写入指定长度的字符串信息,如果超出,就截断字符串,如果长度不足,那就补0操作,编码为指定的编码信息
Asynchronously write string information of the specified length. If it exceeds the value, the string is truncated. If the length is not enough, then the operation is complemented with 0 , you should specified the encoding information
(继承自 SerialDeviceBase。)
公共方法代码示例WriteAsyncT(T)
异步写入支持Hsl特性的数据,返回是否写入成功,该特性为HslDeviceAddressAttribute,详细参考api文档说明
Asynchronously write data that supports the Hsl attribute, and return whether the write was successful. The attribute is HslDeviceAddressAttribute, please refer to the api documentation for details.
(继承自 SerialDeviceBase。)
公共方法代码示例WriteCustomerT
写入自定义类型的数据,该类型必须继承自IDataTransfer接口
Write data of a custom type, which must inherit from the IDataTransfer interface
(继承自 SerialDeviceBase。)
公共方法代码示例WriteCustomerAsyncT
写入自定义类型的数据,该类型必须继承自IDataTransfer接口
Write data of a custom type, which must inherit from the IDataTransfer interface
(继承自 SerialDeviceBase。)
公共方法WriteMask
向设备写入掩码数据,使用0x16功能码,需要确认对方是否支持相关的操作,掩码数据的操作主要针对寄存器。
To write mask data to the server, using the 0x16 function code, you need to confirm whether the other party supports related operations. The operation of mask data is mainly directed to the register.
公共方法WriteMaskAsync
向设备写入掩码数据,使用0x16功能码,需要确认对方是否支持相关的操作,掩码数据的操作主要针对寄存器。
To write mask data to the server, using the 0x16 function code, you need to confirm whether the other party supports related operations. The operation of mask data is mainly directed to the register.
公共方法WriteOneRegister(String, Int16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
公共方法WriteOneRegister(String, UInt16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
公共方法WriteOneRegisterAsync(String, Int16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
公共方法WriteOneRegisterAsync(String, UInt16)
将数据写入到Modbus的单个寄存器上去,需要指定起始地址和数据值,如果富文本地址不指定,默认使用的功能码是 0x06
To write data to a single register of Modbus, you need to specify the start address and data value. If the rich text address is not specified, the default function code is 0x06.
Top
字段
  名称说明
受保护的字段AtLeastReceiveLength
从串口中至少接收的字节长度信息
(继承自 SerialBase。)
受保护的字段LogMsgFormatBinary
设置日志记录报文是否二进制,如果为False,那就使用ASCII码
Set whether the log message is binary, if it is False, then use ASCII code
(继承自 SerialBase。)
受保护的字段pipeSerial
串口交互的核心
(继承自 SerialBase。)
Top
扩展方法
  名称说明
公共扩展器方法ToJsonString
获取当前对象的JSON格式表示的字符串。
Gets the string represented by the JSON format of the current object.
(由 HslExtension 定义。)
Top
备注
本客户端支持的标准的modbus协议,Modbus-Tcp及Modbus-Udp内置的消息号会进行自增,地址支持富文本格式,具体参考示例代码。
读取线圈,输入线圈,寄存器,输入寄存器的方法中的读取长度对商业授权用户不限制,内部自动切割读取,结果合并。
示例
本客户端支持的标准的modbus协议,Modbus-Tcp及Modbus-Udp内置的消息号会进行自增,比如我们想要控制消息号在0-1000之间自增,不能超过一千,可以写如下的代码:
序号示例
// modbus-tcp和udp的例子是一样的,只是实例化方面不一样,对于rtu及ascii则没有消息号这一个功能
ModbusTcpNet modbusTcp = new ModbusTcpNet( "127.0.0.1", 502 );
// 如果是modbus-udp
ModbusUdpNet modbusUdp = new ModbusUdpNet( "127.0.0.1", 502 );

// 重置最大值,这样的话,消息号就在0-1000
modbusTcp.MessageId.ResetMaxValue( 1000 );

// 如果我们需要一直保持消息号在0,不需要增长的计数
modbusTcp.MessageId.IncreaseTick = 0;

// 同理,我们需要消息号保持在1000
modbusTcp.MessageId.ResetCurrentValue( 1000 );
modbusTcp.MessageId.IncreaseTick = 0;

// 如果消息号需要为1,3,5,7,9,......999
modbusTcp.MessageId.ResetStartValue( 1 );
modbusTcp.MessageId.ResetMaxValue( 999 );
modbusTcp.MessageId.IncreaseTick = 2;

// 更加详细的用法需要参考SoftIncrementCount类
在标准的Modbus协议里面,客户端发送消息ID给服务器,服务器是需要复制返回客户端的,在HSL里会默认进行检查操作,如果想要忽略消息ID一致性的检查,可以编写如下的方法。
重要事项 重要事项
地址共可以携带4个信息,常见的使用表示方式"s=2;x=3;100",对应的modbus报文是 02 03 00 64 00 01 的前四个字节,站号,功能码,起始地址,下面举例
当读写int, uint, float, double, long, ulong类型的时候,支持动态指定数据格式,也就是 DataFormat 信息,本部分内容为商业授权用户专有,感谢支持。
ReadInt32("format=BADC;100") 指示使用BADC的格式来解析byte数组,从而获得int数据,同时支持和站号信息叠加,例如:ReadInt32("format=BADC;s=2;100")
读取线圈
ReadCoil("100")表示读取线圈100的值,ReadCoil("s=2;100")表示读取站号为2,线圈地址为100的值
读取离散输入
ReadDiscrete("100")表示读取离散输入100的值,ReadDiscrete("s=2;100")表示读取站号为2,离散地址为100的值
读取寄存器
ReadInt16("100")表示读取寄存器100的值,ReadInt16("s=2;100")表示读取站号为2,寄存器100的值
读取输入寄存器
ReadInt16("x=4;100")表示读取输入寄存器100的值,ReadInt16("s=2;x=4;100")表示读取站号为2,输入寄存器100的值
读取寄存器的位
ReadBool("100.0")表示读取寄存器100第0位的值,ReadBool("s=2;100.0")表示读取站号为2,寄存器100第0位的值,支持读连续的多个位
读取输入寄存器的位
ReadBool("x=4;100.0")表示读取输入寄存器100第0位的值,ReadBool("s=2;x=4;100.0")表示读取站号为2,输入寄存器100第0位的值,支持读连续的多个位
对于写入来说也是一致的
写入线圈
WriteCoil("100",true)表示读取线圈100的值,WriteCoil("s=2;100",true)表示读取站号为2,线圈地址为100的值
写入寄存器
Write("100",(short)123)表示写寄存器100的值123,Write("s=2;100",(short)123)表示写入站号为2,寄存器100的值123
特殊说明部分:
当碰到自定义的功能码时,比如读取功能码 07,写入功能码 08 的自定义寄存器时,地址可以这么写
ReadInt16("s=2;x=7;w=8;100")表示读取这个自定义寄存器地址 100 的数据,读取使用的是 07 功能码,写入使用的是 08 功能码,也就是说 w=8 可以强制指定写入的功能码信息
01功能码
ReadBool("100")
02功能码
ReadBool("x=2;100")
03功能码
Read("100")
04功能码
Read("x=4;100")
05功能码
Write("100", True)
06功能码
Write("100", (short)100);Write("100", (ushort)100)
0F功能码
Write("100", new bool[]{True}) 注意:这里和05功能码传递的参数类型不一样
10功能码
如果写一个short想用10功能码:Write("100", new short[]{100})
16功能码
Write("100.2", True) 当写入bool值的方法里,地址格式变为字地址时,就使用16功能码,通过掩码的方式来修改寄存器的某一位, 需要Modbus服务器支持,对于不支持该功能码的写入无效。
特别说明:调用写入 short 及 ushort 类型写入方法时,自动使用06功能码写入。需要需要使用 16 功能码写入 short 数值,可以参考下面的两种方式:
1. modbus.Write("100", new short[]{ 1 });
2. modbus.Write("w=16;100", (short)1); (这个地址读short也能读取到正确的值)
基本的用法请参照下面的代码示例
Modbus示例
// 本类支持的读写操作提供了非常多的重载方法,总有你想要的方法
private ModbusTcpNet modbus = new ModbusTcpNet( "192.168.0.1" );   // 实例化
// 如果你的是rtu
private ModbusRtu modbusRtu = new ModbusRtu( 1 );// 实例化

// 方法的调用都是一模一样的。

private void CoilExample()
{
    // 读取线圈示例,使用01功能码
    bool coil100 = modbus.ReadCoil( "100" ).Content;

    // 判断是否读取成功
    OperateResult<bool> result_coil100 = modbus.ReadCoil( "100" );
    if(result_coil100.IsSuccess)
    {
        // success
        bool value = result_coil100.Content;
    }
    else
    {
        // failed
    }

    // 假设读取站号10的线圈100的值
    bool coil_station_ten_100 = modbus.ReadCoil( "s=10;100" ).Content;

    // =============================================================================================
    // 写入也是同理,线圈100写通,使用的是05功能码
    modbus.Write( "100", true );

    // 站号10的线圈写通
    modbus.Write( "s=10;100", true );

    // 想要判断是否写入成功
    if(modbus.Write( "s=10;100", true ).IsSuccess)
    {
        // success
    }
    else
    {
        // failed
    }



    // ===========================================================================================
    // 批量读写也是类似,批量的读取,使用01功能码
    bool[] coil10_19 = modbus.ReadCoil( "100", 10 ).Content;

    // 写入也是同理,使用的0F功能码
    modbus.Write( "100", new bool[] { true, false, true, false, false, false, true, false, false, false } );


    // 离散输入的数据读取同理
    ModbusTcpNet plc = modbus;
    OperateResult write = plc.Write( "100", "ABCDEF" );
    if (write.IsSuccess)
        Console.WriteLine( "Write Address[100] Success!" );
    else
        Console.WriteLine( "Write Address[100] failed: " + write.Message );

    OperateResult<string> read = plc.ReadString( "100", 3 );
    if (read.IsSuccess)
        Console.WriteLine( "Read Address[100] Success: " + read.Content );
    else
        Console.WriteLine( "Read Address[100] Failed: " + read.Message );

}


private void RegisterExample( )
{
    // 读取寄存器100的值,使用的03功能码
    short register100 = modbus.ReadInt16( "100" ).Content;

    // 批量读取寄存器100-109的值
    short[] register100_109 = modbus.ReadInt16( "100", 10 ).Content;

    // 写入寄存器100的值,注意,一定要强制转换short类型,使用的是06功能码
    modbus.Write( "100", (short)123 );

    // 批量写,使用的是10功能码
    modbus.Write( "100", new short[] { 123, -123, 4244 } );


    // ==============================================================================================
    // 以下是一些常规的操作,不再对是否成功的结果进行判断
    // 读取操作,除了第一个,其他都是03功能码
    bool coil100 = modbus.ReadCoil( "100" ).Content;          // 读取线圈100的通断,01功能码
    short short100 = modbus.ReadInt16( "100" ).Content;       // 读取寄存器100的short值
    ushort ushort100 = modbus.ReadUInt16( "100" ).Content;    // 读取寄存器100的ushort值
    int int100 = modbus.ReadInt32( "100" ).Content;           // 读取寄存器100-101的int值
    uint uint100 = modbus.ReadUInt32( "100" ).Content;        // 读取寄存器100-101的uint值
    float float100 = modbus.ReadFloat( "100" ).Content;       // 读取寄存器100-101的float值
    long long100 = modbus.ReadInt64( "100" ).Content;         // 读取寄存器100-103的long值
    ulong ulong100 = modbus.ReadUInt64( "100" ).Content;      // 读取寄存器100-103的ulong值
    double double100 = modbus.ReadDouble( "100" ).Content;    // 读取寄存器100-103的double值
    string str100 = modbus.ReadString( "100", 5 ).Content;    // 读取100到104共10个字符的字符串

    // 写入操作,第一个05功能码,第二第三是06功能码,后面是10功能码
    modbus.Write( "100", true );                              // 写入线圈100为通
    modbus.Write( "100", (short)12345 );                      // 写入寄存器100为12345
    modbus.Write( "100", (ushort)45678 );                     // 写入寄存器100为45678
    modbus.Write( "100", 123456789 );                         // 写入寄存器100-101为123456789
    modbus.Write( "100", (uint)123456778 );                   // 写入寄存器100-101为123456778
    modbus.Write( "100", 123.456 );                           // 写入寄存器100-101为123.456
    modbus.Write( "100", 12312312312414L );                   //写入寄存器100-103为一个大数据
    modbus.Write( "100", 12634534534543656UL );               // 写入寄存器100-103为一个大数据
    modbus.Write( "100", 123.456d );                          // 写入寄存器100-103为一个双精度的数据
    modbus.Write( "100", "K123456789" );
    modbus.Write( "100", "测试数据", Encoding.Unicode );      // 写入unicode编码的中文

    // ===============================================================================================
    // 读取输入寄存器,使用的04功能码
    short input_short100 = modbus.ReadInt16( "x=4;100" ).Content;    // 读取寄存器100的short值
    ushort input_ushort100 = modbus.ReadUInt16( "x=4;100" ).Content; // 读取寄存器100的ushort值
    int input_int100 = modbus.ReadInt32( "x=4;100" ).Content;        // 读取寄存器100-101的int值
    uint input_uint100 = modbus.ReadUInt32( "x=4;100" ).Content;     // 读取寄存器100-101的uint值
    float input_float100 = modbus.ReadFloat( "x=4;100" ).Content;    // 读取寄存器100-101的float值
    long input_long100 = modbus.ReadInt64( "x=4;100" ).Content;      // 读取寄存器100-103的long值
    ulong input_ulong100 = modbus.ReadUInt64( "x=4;100" ).Content;   // 读取寄存器100-103的ulong值
    double input_double100 = modbus.ReadDouble( "x=4;100" ).Content; // 读取寄存器100-103的double值
    string input_str100 = modbus.ReadString( "x=4;100", 5 ).Content; // 读取100到104共10个字符的字符串
}
参见
继承层次