GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MODBUS_READ_REGISTERS (3)

.ds Aq ’

NAME

modbus_read_registers - read many registers

CONTENTS

SYNOPSIS

int modbus_read_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest);

DESCRIPTION

The modbus_read_registers() function shall read the content of the nb holding registers to the address addr of the remote device. The result of reading is stored in dest array as word values (16 bits).

You must take care to allocate enough memory to store the results in dest (at least nb * sizeof(uint16_t)).

The function uses the Modbus function code 0x03 (read holding registers).

RETURN VALUE

The modbus_read_registers() function shall return the number of read registers if successful. Otherwise it shall return -1 and set errno.

ERRORS

EMBMDATA

Too many registers requested

EXAMPLE

modbus_t *ctx;
uint16_t tab_reg[64];
int rc;
int i;

ctx = modbus_new_tcp("127.0.0.1", 1502); if (modbus_connect(ctx) == -1) { fprintf(stderr, "Connection failed: %s\n", modbus_strerror(errno)); modbus_free(ctx); return -1; }

rc = modbus_read_registers(ctx, 0, 10, tab_reg); if (rc == -1) { fprintf(stderr, "%s\n", modbus_strerror(errno)); return -1; }

for (i=0; i < rc; i++) { printf("reg[%d]=%d (0x%X)\n", i, tab_reg[i], tab_reg[i]); }

modbus_close(ctx); modbus_free(ctx);

SEE ALSO

modbus_write_register(3) modbus_write_registers(3)

AUTHORS

The libmodbus documentation was written by St\(&#146;ephane Raimbault <\m[blue]stephane.raimbault@gmail.com\m[][1]>

NOTES

1. stephane.raimbault@gmail.com  mailto:stephane.raimbault@gmail.com
Search for    or go to Top of page |  Section 3 |  Main Index


libmodbus 3&.1&.0 MODBUS_READ_REGISTER (3) 10/06/2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.