Click or drag to resize

MbusDataTableInterfacereadHoldingRegistersTable Method

Override this method to implement a Data Provider function to read Holding Registers.

Namespace:  FieldTalk.Modbus.Slave
Assembly:  FieldTalk.Modbus.Slave (in FieldTalk.Modbus.Slave.dll) Version: 2.11.0-eval+eb1ecbe71c969eff5d7c05d58da16dade0474678
Syntax
Copy
protected virtual bool readHoldingRegistersTable(
	int startRef,
	short[] regArr
)

Parameters

startRef
Type: SystemInt32
Start register (Range: 1 - 65536)
regArr
Type: SystemInt16
Buffer which has to be filled with the reply data (Length: 0 - 125)

Return Value

Type: Boolean
true indicates a successful access and that valid reply data is contained in regArr. The Server Engine will reply the data passed in regArr to the master.

false indicates that access has been denied or is out of range. The Server Engine will reply to the master with an exception reply message

Remarks
When a slave receives a poll request for the 4:00000 data table it calls this method to retrieve the data.

Required: Yes

Default Implementation: Returns false which indicates to Server Engine that this address range is unsupported.

Examples
A simple implementation which holds the application data in an array of Int16 called localRegisters could be:
Copy
protected override int readHoldingRegistersTable(Int32 startRef, Int16[] regArr)
{
    // Adjust Modbus reference counting from 1-based to 0-based
    startRef--;
    // Validate range
    if (startRef + regArr.Length > localRegisters.Length)
        return false;
    // Copy registers from local data array to Modbus
    for (int i = 0; i < regArr.Length; i++)
        regArr[i] = localRegisters[startRef + i];
    return true;
}
See Also