<< modbus_newTcp modbus modbus_readInBits >>

modbus >> modbus > modbus_readBits

modbus_readBits

read many bits

Calling Sequence

res = modbus_readBits(mbc, addr, nb)
[res, ierr] = modbus_readBits(mbc, addr, nb)

Arguments

mbc

The Modbus connection created with modbus_newTcp or modbus_newRtu.

addr

The address on device where bits should be read from.

nb

The number of bits that should be read.

res

A double matrix (size 1 x nb) with coils values. An empty matrix in case of error when called with two output arguments.

ierr

Erreur number.

Description

This function reads the status of the nb bits (coils) to the address addr of the remote device through mbc connection descriptor.

The function uses the Modbus function code 0x01 (read coil status).

When called with one output argument, a Scilab error will occur when the reading fails. When called with two output arguments, no Scilab error will occur but ierr will contain the internal modbus error number.

Examples

mbc = modbus_newTcp("127.0.0.1", 502);
modbus_connect(mbc);
res = modbus_readBits(mbc, 0, 8);
modbus_close(mbc);
modbus_free(mbc);

See Also


Report an issue
<< modbus_newTcp modbus modbus_readInBits >>