This is an old revision of the document!

ImodbusRTUmaster()

ImodbusRTUmaster() executes a single Master request immediately.

uint8_t ImodbusRTUmaster(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
`ImodbusRTUmaster(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`	`uint8_t`	Executes a single Master request immediately.

Example

uint16_t data[2];
uint8_t result = ImodbusRTUmaster(
  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

ImodbusRTUmaster()

Commands

Example

Precautions