Device and Vendor Specific Modbus Functions

Some device specific or vendor specific functions and enhancements are supported. More...

Advantec ADAM 5000/6000 Series Commands
	adamSendReceiveAsciiCmd (string command, string &response)
	Send/Receive ADAM 5000/6000 ASCII command.
Custom Function Codes
	customFunction (integer slaveAddr, integer functionCode, byte[]requestArr, byte[]responseArr, integer &responseLen)
	User Defined Function CodeThis method can be used to implement User Defined Function Codes.

---

Detailed Description

Some device specific or vendor specific functions and enhancements are supported.

---

Function Documentation

adamSendReceiveAsciiCmd	(	string	command,
		string &	response
	)			[inherited]

Send/Receive ADAM 5000/6000 ASCII command.

Sends an ADAM 5000/6000 ASCII command to the device and receives the reply as ASCII string. (e.g. "$01M" to retrieve the module name)

Parameters:

	command	Command string. Must not be longer than 255 characters.
	response	Response string. A possible trailing CR is removed.

Exceptions:

EIllegalArgumentError

A parameter is out of range

Note:

No broadcast supported

customFunction	(	integer	slaveAddr,
		integer	functionCode,
		byte[]	requestArr,
		byte[]	responseArr,
		integer &	responseLen
	)			[inherited]

User Defined Function CodeThis method can be used to implement User Defined Function Codes.

The caller has only to pass the user data to this function. The assembly of the Modbus frame (the so called ADU) including checksums, slave address and function code and subsequentially the transmission, is taken care of by this method.

The modbus specification reserves function codes 65-72 and 100-110 for user defined functions.

Note:

Modbus functions usually have an implied response length and therefore the number of bytes expected to be received is known at the time when sending the request. In case of a custom Modbus function with an open or unknown response length, this function can not be used.

Parameters:

	slaveAddr	Modbus address of slave device or unit identifier (Range: 0 - 255)
	functionCode	Custom function code to be used for Modbus transaction (1-127)
	requestArr	Buffer with data sent as request (not including slave address or function code). The length of the array determines how many bytes sent. (Range: 0-252)
	responseArr	Buffer which will be filled with the data bytes read.
	responseLen	Length of response data (0-252). The number of bytes expected to be sent as response must be known when submitting the request.

Exceptions:

	EIllegalStateError	Port or connection is closed
	EInOutError	An I/O error occurred
	EIllegalArgumentError	A parameter is out of range
	EBusProtocolException	A protocol failure occurred. See descendants of EBusProtocolException for a more detailed failure list.

Note:

No broadcast supported