This is an old revision of the document!

ImodbusRTUmasterAdd()

ImodbusRTUmasterAdd() registers a Master request for repeated execution.

bool ImodbusRTUmasterAdd(HardwareSerial& serialPort, uint8_t slaveId, uint8_t functionCode, uint16_t address, uint16_t quantity, uint16_t* data, uint16_t timeoutMs = 100)

Commands

Command	Arguments	Return Value	Operation
`ImodbusRTUmasterAdd(serialPort, slaveId, functionCode, address, quantity, data, timeoutMs)`	`HardwareSerial& serialPort` — Serial port connected to RS-485 `uint8_t slaveId` — Slave address `uint8_t functionCode` `uint16_t address` `uint16_t quantity` `uint16_t* data` `uint16_t timeoutMs = 100`	`bool`	Registers a Master request for repeated execution.

Example

uint16_t data[2];
bool added = ImodbusRTUmasterAdd(
  Serial2, 1, 3, 0, 2, data, 200);

Precautions

Keep calling the Slave or Master execution function in loop().
The data array size must be at least the requested quantity.
Do not treat return codes BUSY and IDLE as communication failures.
When sharing M and D with Cnet/MC Protocol, define a single final size and initialization order. Do not call ImodbusRTUMem() or ICnetMem() again at runtime.
Memory allocation functions do not return success status. For nonzero sizes, verify that M and D are not nullptr before accessing them in user code.

← Built-in Command List

ILOGICS Product Documentation

Table of Contents

ImodbusRTUmasterAdd()

Commands

Example

Precautions