FieldTalk Modbus

Master C++ Library

Software manual

Library version 2.9.0

 Contents

Contents
1 Introduction 1
1.1 Library Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 What You should know about Modbus 3

2.1 Some Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2 Technical Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2.1 The Protocol Functions . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2.2 How Slave Devices are identified . . . . . . . . . . . . . . . . . . . . 4
2.2.3 The Register Model and Data Tables . . . . . . . . . . . . . . . . . . 4
2.2.4 Data Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2.5 Register and Discrete Numbering Scheme . . . . . . . . . . . . . . . 6
2.2.6 The ASCII Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.7 The RTU Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.8 The MODBUS/TCP Protocol . . . . . . . . . . . . . . . . . . . . . . . 7

3 Installation and Source Code Compilation 8

3.1 Windows Platforms: Unpacking and Preparation . . . . . . . . . . . . . . . 8
3.2 Linux, UNIX and QNX Platforms: Unpacking and Compiling the Source . . . 8
3.3 Specific Platform Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.3.1 QNX 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.3.2 VxWorks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Linking your Applications against the Library 11

4.1 Windows Platforms: Compiling and Linking Applications . . . . . . . . . . 11
4.2 Linux, UNIX and QNX Platforms: Compiling and Linking Applications . . . . 12

5 How to integrate the Protocol in your Application 14

5.1 Using Serial Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.2 Using MODBUS/TCP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . 16

6 Design Background 19

7 Module Documentation 20
7.1 Data and Control Functions for all Modbus Protocol Flavours . . . . . . . . 20
7.2 Serial Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7.2.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

i
FieldTalk Modbus Master C++ Library: Software manual

7.3 IP based Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.3.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.4 Error Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.4.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.4.2 Macro Definition Documentation . . . . . . . . . . . . . . . . . . . . 24
7.4.3 Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . 29
7.5 Device and Vendor Specific Modbus Functions . . . . . . . . . . . . . . . . 29
7.5.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.5.2 Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . 30

8 C++ Class Documentation 32

8.1 MbusRtuMasterProtocol Class Reference . . . . . . . . . . . . . . . . . . . . 32
8.1.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
8.1.2 Member Enumeration Documentation . . . . . . . . . . . . . . . . . 36
8.1.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . 37
8.2 MbusAsciiMasterProtocol Class Reference . . . . . . . . . . . . . . . . . . . 62
8.2.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.2.2 Member Enumeration Documentation . . . . . . . . . . . . . . . . . 66
8.2.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . 67
8.3 MbusElamMasterProtocol Class Reference . . . . . . . . . . . . . . . . . . . 92
8.3.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
8.3.2 Member Enumeration Documentation . . . . . . . . . . . . . . . . . 96
8.3.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . 97
8.4 MbusTcpMasterProtocol Class Reference . . . . . . . . . . . . . . . . . . . . 122
8.4.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
8.4.2 Member Function Documentation . . . . . . . . . . . . . . . . . . . 126
8.5 MbusRtuOverTcpMasterProtocol Class Reference . . . . . . . . . . . . . . . 150
8.5.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
8.5.2 Member Function Documentation . . . . . . . . . . . . . . . . . . . 154
8.6 MbusAsciiOverTcpMasterProtocol Class Reference . . . . . . . . . . . . . . . 179
8.6.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
8.6.2 Member Function Documentation . . . . . . . . . . . . . . . . . . . 183
8.7 MbusUdpMasterProtocol Class Reference . . . . . . . . . . . . . . . . . . . 208
8.7.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
8.7.2 Member Function Documentation . . . . . . . . . . . . . . . . . . . 212

ii
 Contents

9 License 237

10 Support 240

11 Notices 241

iii
 Introduction

1 Introduction
The FieldTalk™ Modbus® Master C++ Library provides connectivity to Modbus slave com-
patible devices and applications.

Industrial PC

C/C++
Control Software
Soft
PLC RTU
FieldTalk Library PLC

Typical applications are Modbus based Supervisory Control and Data Acquisition Systems
(SCADA), Modbus data concentrators, Modbus gateways, User Interfaces and Factory
Information Systems (FIS).
Features:

• Robust design suitable for real-time and industrial applications

• Full implementation of Bit Access and 16 Bits Access Function Codes as well as a subset
of the most commonly used Diagnostics Function Codes

• Standard Modbus bit and 16-bit integer data types (coils, discretes & registers)

• Support for 32-bit integer, modulo-10000 and float data types, including Daniel/Enron
protocol extensions

• Configurable word alignment for 32-bit types (big-endian, little-endian)

• Support of Broadcasting

• Failure and transmission counters

• Transmission and connection time-out supervision

• Detailed transmission and protocol failure reporting using error codes

1.1 Library Structure

The library's API is organised into one class for each Modbus protocol flavour and a com-
mon base class, which applies to all Modbus protocol flavours. Because the two serial-line
protocols Modbus ASCII and Modbus RTU share some common code, an intermediate
base class implements the functions specific to the serial protocols.

1
FieldTalk Modbus Master C++ Library: Software manual

MbusMasterFunctions

MbusSerialClientBase MbusIpClientBase

MbusAsciiMasterProtocol MbusRtuMasterProtocol MbusTcpMasterProtocol MbusUdpMasterProtocol

MbusElamMasterProtocol MbusRtuOverTcpMasterProtocol MbusAsciiOverTcpMasterProtocol

The base class MbusMasterFunctions contains all protocol unspecific functions, in partic-
ular the data and control functions defined by Modbus. All Modbus protocol flavours
inherit from this base class.
The class MbusAsciiMasterProtocol implements the Modbus ASCII protocol, the
class MbusRtuMasterProtocol implements the Modbus RTU protocol. The class
MbusTcpMasterProtocol implements the MODBUS/TCP protocol and the class MbusRtuOverTcpMaster
the Encapsulated Modbus RTU master protocol (also known as RTU over TCP or RTU/IP).
In order to use one of the four Modbus protocols, the desired Modbus protocol flavour
class has to be instantiated:

MbusRtuMasterProtocol mbusProtocol;

After a protocol object has been declared and opened, data and control functions can be
used:

mbusProtocol.writeSingleRegister(slaveId, startRef, 1234);

2
 What You should know about Modbus

2 What You should know about Modbus

2.1 Some Background
The Modbus protocol family was originally developed by Schneider Automation Inc. as
an industrial network for their Modicon programmable controllers.
Since then the Modbus protocol family has been established as vendor-neutral and open
communication protocols, suitable for supervision and control of automation equipment.

2.2 Technical Information

Modbus is a master/slave protocol with half-duplex transmission.
One master and up to 247 slave devices can exist per network.
The protocol defines framing and message transfer as well as data and control functions.
The protocol does not define a physical network layer. Modbus works on different phys-
ical network layers. The ASCII and RTU protocol operate on RS-232, RS-422 and RS-485
physical networks. The Modbus/TCP protocol operates on all physical network layers sup-
porting TCP/IP. This compromises 10BASE-T and 100BASE-T LANs as well as serial PPP and
SLIP network layers.

Note
To utilise the multi-drop feature of Modbus, you need a multi-point network like
RS-485. In order to access a RS-485 network, you will need a protocol converter
which automatically switches between sending and transmitting operation. How-
ever some industrial hardware platforms have an embedded RS-485 line driver and
support enabling and disabling of the RS-485 transmitter via the RTS signal. Field←-
Talk supports this RTS driven RS-485 mode.

2.2.1 The Protocol Functions

Modbus defines a set of data and control functions to perform data transfer, slave diag-
nostic and PLC program download.
FieldTalk implements the most commonly used functions for data transfer as well as some
diagnostic functions. The functions to perform PLC program download and other device
specific functions are outside the scope of FieldTalk.
All Bit Access and 16 Bits Access Modbus Function Codes have been implemented. In
addition the most frequently used Diagnostics Function Codes have been implemented.
This rich function set enables a user to solve nearly every Modbus data transfer problem.
The following table lists the available Modbus Function Codes in this library:

Function Code Current Terminology Classic Terminology

Bit Access
1 Read Coils Read Coil Status

3
FieldTalk Modbus Master C++ Library: Software manual

Function Code Current Terminology Classic Terminology

2 Read Discrete Inputs Read Input Status
5 Write Single Coil Force Single Coil
15 (0F hex) Write Multiple Coils Force Multiple Coils
16 Bits Access
3 Read Multiple Registers Read Holding Registers
4 Read Input Registers Read Input Registers
6 Write Single Register Preset Single Register
16 (10 Hex) Write Multiple Registers Preset Multiple Registers
22 (16 hex) Mask Write Register Mask Write 4X Register
23 (17 hex) Read/Write Multiple Registers Read/Write 4X Registers
Diagnostics
7 Read Exception Status Read Exception Status
8 subcode 00 Diagnostics - Return Query Data Diagnostics - Return Query Data
8 subcode 01 Diagnostics - Restart Communi- Diagnostics - Restart Communi-
cations Option cations Option
Vendor Specific
Advantech Send/Receive ADAM 5000/6000
ASCII commands

2.2.2 How Slave Devices are identified

A slave device is identified with its unique address identifier. Valid address identifiers
supported are 1 to 247. Some library functions also extend the slave ID to 255, please
check the individual function's documentation.
Some Modbus functions support broadcasting. With functions supporting broadcasting,
a master can send broadcasts to all slave devices of a network by using address identifier
0. Broadcasts are unconfirmed, there is no guarantee of message delivery. Therefore
broadcasts should only be used for uncritical data like time synchronisation.

2.2.3 The Register Model and Data Tables

The Modbus data functions are based on a register model. A register is the smallest
addressable entity with Modbus.
The register model is based on a series of tables which have distinguishing characteristics.
The four tables are:

Table Classic Terminol- Modicon Register Characteristics

ogy Table
Discrete outputs Coils 0:00000 Single bit, alterable
by an application
program, read-write

4
 What You should know about Modbus

Table Classic Terminol- Modicon Register Characteristics

ogy Table
Discrete inputs Inputs 1:00000 Single bit, provided
by an I/O system,
read-only
Input registers Input registers 3:00000 16-bit quantity, pro-
vided by an I/O sys-
tem, read-only
Output registers Holding registers 4:00000 16-bit quantity,
alterable by an ap-
plication program,
read-write

The Modbus protocol defines these areas very loose. The distinction between inputs
and outputs and bit-addressable and register-addressable data items does not imply any
slave specific behaviour. It is very common that slave devices implement all tables as
overlapping memory area.
For each of those tables, the protocol allows a maximum of 65536 data items to be
accessed. It is slave dependant, which data items are accessible by a master. Typically a
slave implements only a small memory area, for example of 1024 bytes, to be accessed.

2.2.4 Data Encoding

Classic Modbus defines only two elementary data types. The discrete type and the regis-
ter type. A discrete type represents a bit value and is typically used to address output coils
and digital inputs of a PLC. A register type represents a 16-bit integer value. Some manu-
facturers offer a special protocol flavour with the option of a single register representing
one 32-bit value.
All Modbus data function are based on the two elementary data types. These elementary
data types are transferred in big-endian byte order.
Based on the elementary 16-bit register, any bulk information of any type can be ex-
changed as long as that information can be represented as a contiguous block of 16-bit
registers. The protocol itself does not specify how 32-bit data and bulk data like strings is
structured. Data representation depends on the slave's implementation and varies from
device to device.
It is very common to transfer 32-bit float values and 32-bit integer values as pairs of two
consecutive 16-bit registers in little-endian word order. However some manufacturers
like Daniel and Enron implement an enhanced flavour of Modbus which supports 32-bit
wide register transfers. FielTalk supports Daniel/Enron 32-bit wide register transfers.
The FieldTalk Modbus Master Library defines functions for the most common tasks like:

• Reading and Writing bit values

• Reading and Writing 16-bit integers
• Reading and Writing 32-bit integers as two consective registers
• Reading and Writing 32-bit floats as two consective registers

5
FieldTalk Modbus Master C++ Library: Software manual

• Reading and Writing 32-bit integers using Daniel/Enron single register transfers

• Reading and Writing 32-bit floats using Daniel/Enron single register transfers

• Configuring the word order and representation for 32-bit values

2.2.5 Register and Discrete Numbering Scheme

Modicon PLC registers and discretes are addressed by a memory type and a register num-
ber or a discrete number, e.g. 4:00001 would be the first reference of the output regis-
ters.
The type offset which selects the Modicon register table must not be passed to the Field←-
Talk functions. The register table is selected by choosing the corresponding function call
as the following table illustrates.

Master Function Call Modicon Register Table

readCoils(), writeCoil(), forceMultipleCoils() 0:00000
readInputDiscretes 1:00000
readInputRegisters() 3:00000
writeMultipleRegisters(), readMultipleRegisters(), 4:00000
writeSingleRegister(), maskWriteRegister(),
readWriteRegisters()

Modbus registers are numbered starting from 1. This is different to the conventional
programming logic where the first reference is addressed by 0.
Modbus discretes are numbered starting from 1 which addresses the most significant bit
in a 16-bit word. This is very different to the conventional programming logic where the
first reference is addressed by 0 and the least significant bit is bit 0.
The following table shows the correlation between Discrete Numbers and Bit Numbers:

Modbus Discrete Bit Number Modbus Discrete Bit Number

Number Number
1 15 (hex 0x8000) 9 7 (hex 0x0080)
2 14 (hex 0x4000) 10 6 (hex 0x0040)
3 13 (hex 0x2000) 11 5 (hex 0x0020)
4 12 (hex 0x1000) 12 4 (hex 0x0010)
5 11 (hex 0x0800) 13 3 (hex 0x0008)
6 10 (hex 0x0400) 14 2 (hex 0x0004)
7 9 (hex 0x0200) 15 1 (hex 0x0002)
8 8 (hex 0x0100) 16 0 (hex 0x0001)

When exchanging register number and discrete number parameters with FieldTalk func-
tions and methdos you have to use the Modbus register and discrete numbering scheme.
(Internally the functions will deduct 1 from the start register value before transmitting
the value to the slave device.)

6
 What You should know about Modbus

2.2.6 The ASCII Protocol

The ASCII protocol uses an hexadecimal ASCII encoding of data and a 8 bit checksum.
The message frames are delimited with a ':' character at the beginning and a carriage
return/linefeed sequence at the end.
The ASCII messaging is less efficient and less secure than the RTU messaging and therefore
it should only be used to talk to devices which don't support RTU. Another application
of the ASCII protocol are communication networks where the RTU messaging is not ap-
plicable because characters cannot be transmitted as a continuos stream to the slave
device.
The ASCII messaging is state-less. There is no need to open or close connections to a
particular slave device or special error recovery procedures.
A transmission failure is indicated by not receiving a reply from the slave. In case of
a transmission failure, a master simply repeats the message. A slave which detects a
transmission failure will discard the message without sending a reply to the master.

2.2.7 The RTU Protocol

The RTU protocol uses binary encoding of data and a 16 bit CRC check for detection of
transmission errors. The message frames are delimited by a silent interval of at least 3.5
character transmission times before and after the transmission of the message.
When using RTU protocol it is very important that messages are sent as continuous char-
acter stream without gaps. If there is a gap of more than 3.5 character times while
receiving the message, a slave device will interpret this as end of frame and discard the
bytes received.
The RTU messaging is state-less. There is no need to open or close connections to a
particular slave device or special error recovery procedures.
A transmission failure is indicated by not receiving a reply from the slave. In case of
a transmission failure, a master simply repeats the message. A slave which detects a
transmission failure will discard the message without sending a reply to the master.

2.2.8 The MODBUS/TCP Protocol

MODBUS/TCP is a TCP/IP based variant of the Modbus RTU protocol. It covers the use of
Modbus messaging in an 'Intranet' or 'Internet' environment.
The MODBUS/TCP protocol uses binary encoding of data and TCP/IP's error detection
mechanism for detection of transmission errors.
In contrast to the ASCII and RTU protocols MODBUS/TCP is a connection oriented protocol.
It allows concurrent connections to the same slave as well as concurrent connections to
multiple slave devices.
In case of a TCP/IP time-out or a protocol failure, a master shall close and re-open the
connection and then repeat the message.

7
FieldTalk Modbus Master C++ Library: Software manual

3 Installation and Source Code Compilation

3.1 Windows Platforms: Unpacking and Preparation
1. Download and save the zip archive into a project directory.
2. Uncompress the archive using unzip or another zip tool of your choice:

# unzip FT-MBMP-WIN-ALL.2.8.0.zip

The archive will create the following directory structure in your project directory:

myprj
|
+-+ fieldtalk
|
+-- doc
+-- include
+-- lib
+-- src
+-- samples
+-- Visual Studio

3. The library is ready to be used.

4. Optionally re-compile from source:
The Windows Editions do come with pre-compiled static libraries for Visual C++ and
do not require compilation from source code. However there may be cases where re-
compilation is desired.
To re-compile, open the Visual Studio\mbusmaster_win.vcxproj solution file with Visual
Studio 2017. The project file will also work with older Visual Studio versions. The library
will be compiled into one of the following sub-directories of your project directory:

Platform Library Directory

Windows 64-bit, Visual Studio 2017 lib\win\x64\Release
Windows 32-bit, Visual Studio 2017 lib\win\Win32\Release
Windows CE, Visual Studio 2005 or 2008 lib\wce\\Release

3.2 Linux, UNIX and QNX Platforms: Unpacking and Compiling the
Source
1. Download and save the zipped tarball into your project directory.
2. Uncompress the zipped tarball using gzip:

# gunzip FT-MBMP-??-ALL.2.8.0.tar.gz

3. Untar the tarball

# tar xf FT-MBMP-??-ALL.2.8.0.tar

8
 Installation and Source Code Compilation

The tarball will create the following directory structure in your project directory:

myprj
|
+-+ fieldtalk
|
+-- doc
+-- include
+-- src
+-- samples

4. Compile the library from the source code. Enter the FieldTalk src directory and run
make:

# cd fieldtalk/src
# make

Note: Previous versions used a shell script to build, this version now uses the make utility
to build.
The make file tries to detect your host platform and executes the compiler and linker com-
mands targeting the host platform. The compiler and linker configurations are contained
in the platform make files in the makefiles folder.
To cross-compile, pass the basename of the cross-compilation make file as parameter:

# make arm-linux
# make qnx6-ppcle

The cross compilation make files can be found in the makefiles directory and you can add
more by copying and editing the supplied files to match your toolchain setting.
5. The library will be compiled into one of the following platform specfic sub-directories:

Platform Library Directory

Linux lib/linux
QNX 6 lib/qnx6
QNX 4 lib/qnx4
Irix lib/irix
OSF1/True 64/Digital UNIX lib/osf
Solaris lib/solaris
HP-UX lib/hpux
IBM AIX lib/aix

Your directory structure looks now like:

myprj
|
+-+ fieldtalk
|
+-- doc
+-- src
+-- include
+-- samples
+-+ lib

9
FieldTalk Modbus Master C++ Library: Software manual

|
+-- {platform} (exact name depends on platform)

6. The library is ready to be used.

3.3 Specific Platform Notes

3.3.1 QNX 4
In order to get proper control over Modebus timing, you have to adjust the system's clock
rate. The standard ticksize is not suitable for Modbus RTU and needs to be adjusted.
Configure the ticksize to be <= 1 ms.

3.3.2 VxWorks
There is no make file or script supplied for VxWorks because VxWorks applications and
libraries are best compiled from the Tornado IDE.
To compile and link your applications against the FieldTalk library, add all the ∗.c and
∗.cpp files supplied in the src, src/hmlib/common, src/hmlib/posix4 and src/hmlib/vxworks
to your project.

10
 Linking your Applications against the Library

4 Linking your Applications against the Library

4.1 Windows Platforms: Compiling and Linking Applications
Let's assume the following project directory structure:

myprj
|
+-- myapp.cpp
+-+ fieldtalk
+-- include
+-+ lib
|
+-+ win
|
+-+ Win32
|
+-- Release

Add the library's include directory to the compiler's include path.

Visual Studio Example:

Visual C++ command line Example:

cl -I fieldtalk/include -c myapp.cpp

Add the file name of the library to the dependency list passed to the linker. Make sure
the library chosen matches your CPU architecture (32-bit vs 64-bit). Use the Win32 library

11
FieldTalk Modbus Master C++ Library: Software manual

for 32-bit code and the x64 library for 64-bit code. Within Visual Studio you can use the
macro to automatically select the correct library architecture. You also must pass the
Winsock2 standard library Ws2_32.lib as additional dependency to the linker.
Visual Studio Example:

Visual C++ command line Example:

cl -Fe myapp myapp.obj fieldtalk/lib/win/Win32/Release/libmbusmaster.lib Ws2_32.lib

4.2 Linux, UNIX and QNX Platforms: Compiling and Linking Appli-
cations
Let's assume the following project directory structure:

myprj
|
+-- myapp.cpp
+-+ fieldtalk
|
+-- include
+-+ lib
|
+-- linux (exact name depends on your platform)

Add the library's include directory to the compiler's include path.

Example:

c++ -I fieldtalk/include -c myapp.cpp

12
 Linking your Applications against the Library

Add the file name of the library to the file list passed to the linker.
Example:

c++ -o myapp myapp.o fieldtalk/lib/linux/libmbusmaster.a

13
FieldTalk Modbus Master C++ Library: Software manual

5 How to integrate the Protocol in your Appli-

cation
5.1 Using Serial Protocols
Let's assume we want to talk to a Modbus slave device with slave address 1.
The registers for reading are in the reference range 4:00100 to 4:00119 and the registers
for writing are in the range 4:00200 to 4:00219. The discretes for reading are in the
reference range 0:00010 to 0:00019 and the discretes for writing are in the range 0←-
:00020 to 0:00029.
1. Include the library header files

#include "MbusRtuMasterProtocol.hpp"

2. Device data profile definition

Define the data sets which reflects the slave's data profile by type and size:

short readRegSet[20];
short writeRegSet[20];
int readBitSet[20];
int writeBitSet[20];

If you are using floats instead of 16-bit shorts define:

float readFloatSet[10];
float writeFloatSet[10];

Note that because a float occupies two 16-bit registers the array size is half the size it
would be for 16-bit shorts!
If you are using 32-bit ints instead of 16-bit shorts define:

long readLongSet[10];
long writeLongSet[10];

Note that because a long occupies two 16-bit registers the array size is half the size it
would be for 16-bit shorts!
3. Declare and instantiate a protocol object

MbusRtuMasterProtocol mbusProtocol;

4. Open the protocol

int result;

result = mbusProtocol.openProtocol(portName,
19200L, // Baudrate
8, // Databits
1, // Stopbits

14
 How to integrate the Protocol in your Application

2); // Even parity

if (result != FTALK_SUCCESS)
{
fprintf(stderr, "Error opening protocol: %s!\n",
getBusProtocolErrorText(result));
exit(EXIT_FAILURE);
}

5. Perform the data transfer functions

• To read register values:

mbusProtocol.readMultipleRegisters(1, 100, readRegSet,

sizeof(readRegSet) / sizeof(short));

• To write a single register value:

mbusProtocol.writeSingleRegister(1, 200, 1234);

• To write mutliple register values:

mbusProtocol.writeMultipleRegisters(1, 200, writeRegSet,

sizeof(writeRegSet) / sizeof(short));

• To read discrete values:

mbusProtocol.readCoils(1, 10, readBitSet, sizeof(readBitSet) / sizeof(int));

• To write a single discrete value:

mbusProtocol.writeCoil(1, 20, 1);

• To write multiple discrete values:

mbusProtocol.forceMultipleCoils(1, 20, sizeof(writeBitSet) / sizeof(int));

• To read float values:

mbusProtocol.readMultipleFloats(1, 100, readFloatSet,

sizeof(readFloatSet) / sizeof(float));

• To read long integer values:

mbusProtocol.readMultipleLongInts(1, 100, readLongSet,

sizeof(readLongSet) / sizeof(long));

6. Close the protocol port if not needed any more

mbusProtocol.closeProtocol();

7. Error Handling
Serial protocol errors like slave device failures, transmission failures, checksum errors and
time-outs return an error code. The following code snippet can handle and report these
errors:

15
FieldTalk Modbus Master C++ Library: Software manual

int result;

result = mbusProtocol.readMultipleRegisters(1, 100, dataSetArray, 10);

if (result != FTALK_SUCCESS)
{
fprintf(stderr, "%s!\n", getBusProtocolErrorText(result));
// Stop for fatal errors
if (!(result & FTALK_BUS_PROTOCOL_ERROR_CLASS))
return;
}

An automatic retry mechanism is available and can be enabled with mbusProtocol.set←-

RetryCnt(3) before opening the protocol port.

5.2 Using MODBUS/TCP Protocol

Let's assume we want to talk to a Modbus slave device with unit address 1 and IP address
10.0.0.11.
The registers for reading are in the reference range 4:00100 to 4:00119 and the registers
for writing are in the range 4:00200 to 4:00219. The discretes for reading are in the
reference range 0:00010 to 0:00019 and the discretes for writing are in the range 0←-
:00020 to 0:00029.
1. Include the library header files

#include "MbusTcpMasterProtocol.hpp"

2. Device data profile definition

Define the data sets which reflects the slave's data profile by type and size:

short readRegSet[20];
short writeRegSet[20];
int readBitSet[10];
int writeBitSet[10];

If you are using floats instead of 16-bit shorts define:

float readFloatSet[10];
float writeFloatSet[10];

Note that because a float occupies two 16-bit registers the array size is half the size it
would be for 16-bit shorts!
If you are using 32-bit ints instead of 16-bit shorts define:

long readLongSet[10];
long writeLongSet[10];

Note that because a long occupies two 16-bit registers the array size is half the size it
would be for 16-bit shorts!
3. Declare and instantiate a protocol object

MbusTcpMasterProtocol mbusProtocol;

16
 How to integrate the Protocol in your Application

4. Open the protocol

mbusProtocol.openProtocol("10.0.0.11");

5. Perform the data transfer functions

• To read register values:

mbusProtocol.readMultipleRegisters(1, 100, readRegSet,

sizeof(readRegSet) / sizeof(short));

• To write a single register value:

mbusProtocol.writeSingleRegister(1, 200, 1234);

• To write mutliple register values:

mbusProtocol.writeMultipleRegisters(1, 200, writeRegSet,

sizeof(writeRegSet) / sizeof(short));

• To read discrete values:

mbusProtocol.readCoils(1, 10, readBitSet, sizeof(readBitSet) / sizeof(int));

• To write a single discrete value:

mbusProtocol.writeCoil(1, 20, 1);

• To write multiple discrete values:

mbusProtocol.forceMultipleCoils(1, 20, writeBitSet,

sizeof(writeBitSet) / sizeof(int));

• To read float values:

mbusProtocol.readMultipleFloats(1, 100, readFloatSet,

sizeof(readFloatSet) / sizeof(float));

• To read long integer values:

mbusProtocol.readMultipleLongInts(1, 100, readLongSet,

sizeof(readLongSet) / sizeof(long));

6. Close the connection if not needed any more

mbusProtocol.closeProtocol();

7. Error Handling
TCP/IP protocol errors like slave failures, TCP/IP connection failures and time-outs return
an error code. The following code snippet can handle these errors:

17
FieldTalk Modbus Master C++ Library: Software manual

int result;

result = mbusProtocol.readMultipleRegisters(1, 100, dataSetArray, 10);

if (result != FTALK_SUCCESS)
{
fprintf(stderr, "%s!\n", getBusProtocolErrorText(result));
// Stop for fatal errors
if (!(result & FTALK_BUS_PROTOCOL_ERROR_CLASS))
return;
}

If the method returns FTALK_CONNECTION_WAS_CLOSED, it signals that the the TCP/IP

connection was lost or closed by the remote end. Before using further data and control
functions the connection has to be re-opened succesfully.

18
 Design Background

6 Design Background
FieldTalk is based on a programming language neutral but object oriented design model.
This design approach enables us to offer the protocol stack for the languages C++, C#,
Visual Basic .NET, Java and Object Pascal while maintaining similar functionality.
The C++ editions of the protocol stack have also been designed to support multiple
operating system and compiler platforms, including real-time operating systems. In order
to support this multi-platform approach, the C++ editions are built around a lightweight
OS abstraction layer called HMLIB.
During the course of implementation, the usability in automation, control and other in-
dustrial environments was always kept in mind.

19
FieldTalk Modbus Master C++ Library: Software manual

7 Module Documentation
7.1 Data and Control Functions for all Modbus Protocol Flavours
This Modbus protocol library implements the most commonly used data functions as well
as some control functions. The functions to perform PLC program download and other
device specific functions are outside the scope of this library.
All Bit Access and 16 Bits Access Modbus Function Codes have been implemented. In
addition the most frequently used Diagnostics Function Codes have been implemented.
This rich function set enables a user to solve nearly every Modbus data transfer problem.
The following table lists the supported Modbus function codes:

Function Code Current Terminology Classic Terminology

Bit Access
1 Read Coils Read Coil Status
2 Read Discrete Inputs Read Input Status
5 Write Single Coil Force Single Coil
15 (0F hex) Write Multiple Coils Force Multiple Coils
16 Bits Access
3 Read Multiple Registers Read Holding Registers
4 Read Input Registers Read Input Registers
6 Write Single Register Preset Single Register
16 (10 Hex) Write Multiple Registers Preset Multiple Registers
22 (16 hex) Mask Write Register Mask Write 4X Register
23 (17 hex) Read/Write Multiple Registers Read/Write 4X Registers
Diagnostics
7 Read Exception Status Read Exception Status
8 subcode 00 Diagnostics - Return Query Data Diagnostics - Return Query Data
8 subcode 01 Diagnostics - Restart Communi- Diagnostics - Restart Communi-
cations Option cations Option
Vendor Specific
Advantech Send/Receive ADAM 5000/6000
ASCII commands

Remarks
When passing register numbers and discrete numbers to FieldTalk library functions
you have to use the the Modbus register and discrete numbering scheme. See
Register and Discrete Numbering Scheme. (Internally the functions will deduct 1
from the start register value before transmitting the value to the slave device.)

Using multiple instances of a MbusMaster... class enables concurrent protocol transfer

on different communication channels (e.g. multiple TCP/IP sessions in separate threads
or multiple COM ports in separate threads).

20
 Module Documentation

7.2 Serial Protocols

Classes
• class MbusRtuMasterProtocol
Modbus RTU Master Protocol class.
• class MbusAsciiMasterProtocol
Modbus ASCII Master Protocol class.
• class MbusElamMasterProtocol
Extended Lufkin Automation Modbus Master Protocol.

7.2.1 Detailed Description

The two classic serial Modbus protocol flavours RTU and ASCII are implemented in the
MbusRtuMasterProtocol and MbusAsciiMasterProtocol classes.
The popular vendor specific Extended Lufkin Automation Modbus Master (ELAM) protocol
is also available as class MbusElamMasterProtocol. This proprietary Modbus extension
allows adressing of up to 2295 slave units and the retrieval of up to 2500 registers for
Modbus functions 3 and 4.
These classes provide functions to open and to close serial port as well as data
and control functions which can be used at any time after a protocol has been
opened. The data and control functions are organized into different conformance
classes. For a more detailed description of the data and control functions see section
Data and Control Functions for all Modbus Protocol Flavours.
Using multiple instances of a MbusRtuMasterProtocol or MbusAsciiMasterProtocol class
enables concurrent protocol transfers on multiple COM ports (they should be executed
in separate threads).
See sections The RTU Protocol and The ASCII Protocol for some background information
about the two serial Modbus protocols.
See section Using Serial Protocols for an example how to use the MbusRtuMasterProtocol
class.

7.3 IP based Protocols

Classes
• class MbusTcpMasterProtocol
MODBUS/TCP Master Protocol class.
• class MbusRtuOverTcpMasterProtocol
Encapsulated Modbus RTU Master Protocol class.
• class MbusAsciiOverTcpMasterProtocol
Modbus ASCII TCP Master Protocol class.
• class MbusUdpMasterProtocol
MODBUS/UDP Master Protocol class.

21
FieldTalk Modbus Master C++ Library: Software manual

7.3.1 Detailed Description

The library provides several flavours of IP based Modbus protocols.
The MODBUS/TCP master protocol is implemented in the class MbusTcpMasterProtocol
and is the only IP based protocol officially specified by the Modbus organisation.
In addition to MODBUS/TCP, the library offers implementations of both serial protocols
RTU and ASCII transported over TCP streams. These are implemented in the classes
MbusRtuOverTcpMasterProtocol and MbusAsciiOverTcpMasterProtocol.
Also an implementation for MODBUS/TCP packets transported via UDP is available in form
of the class MbusUdpMasterProtocol.
All classes provide functions to establish and to close a TCP/IP connection to the slave as
well as data and control functions which can be used after a connection to a slave device
has been established successfully. For a more detailed description of the data and control
functions see section Data and Control Functions for all Modbus Protocol Flavours.
Using multiple instances of a MbusTcpMasterProtocol class enables concurrent protocol
transfers using multiple TCP/IP sessions. They should be executed in separate threads.
See section The MODBUS/TCP Protocol for some background information about MOD←-
BUS/TCP.
See section Using MODBUS/TCP Protocol for an example how to use the MbusTcpMasterProtocol
class.

7.4 Error Management

Macros
• #define FTALK_SUCCESS 0
Operation was successful.
• #define FTALK_ILLEGAL_ARGUMENT_ERROR 1
Illegal argument error.
• #define FTALK_ILLEGAL_STATE_ERROR 2
Illegal state error.
• #define FTALK_EVALUATION_EXPIRED 3
Evaluation expired.
• #define FTALK_NO_DATA_TABLE_ERROR 4
No data table configured.
• #define FTALK_ILLEGAL_SLAVE_ADDRESS 5
Slave address 0 illegal for serial protocols.

Functions
• const TCHAR ∗ getBusProtocolErrorText (int errCode)
Translates a numeric error code into a description string.

22
 Module Documentation

Fatal I/O Errors

Errors of this class signal a problem in conjunction with the I/O system.
If errors of this class occur, the operation must be aborted and the protocol closed.

• #define FTALK_IO_ERROR_CLASS 64
I/O error class.
• #define FTALK_IO_ERROR 65
I/O error.
• #define FTALK_OPEN_ERR 66
Port or socket open error.
• #define FTALK_PORT_ALREADY_OPEN 67
Serial port already open.
• #define FTALK_TCPIP_CONNECT_ERR 68
TCP/IP connection error.
• #define FTALK_CONNECTION_WAS_CLOSED 69
Remote peer closed TCP/IP connection.
• #define FTALK_SOCKET_LIB_ERROR 70
Socket library error.
• #define FTALK_PORT_ALREADY_BOUND 71
TCP port already bound.
• #define FTALK_LISTEN_FAILED 72
Listen failed.
• #define FTALK_FILEDES_EXCEEDED 73
File descriptors exceeded.
• #define FTALK_PORT_NO_ACCESS 74
No permission to access serial port or TCP port.
• #define FTALK_PORT_NOT_AVAIL 75
TCP port not available.
• #define FTALK_LINE_BUSY_ERROR 76
Serial line busy.

Communication Errors
Errors of this class indicate either communication faults or Modbus exceptions reported
by the slave device.

• #define FTALK_BUS_PROTOCOL_ERROR_CLASS 128

Fieldbus protocol error class.
• #define FTALK_CHECKSUM_ERROR 129
Checksum error.
• #define FTALK_INVALID_FRAME_ERROR 130
Invalid frame error.
• #define FTALK_INVALID_REPLY_ERROR 131

23
FieldTalk Modbus Master C++ Library: Software manual

Invalid reply error.

• #define FTALK_REPLY_TIMEOUT_ERROR 132
Reply time-out.
• #define FTALK_SEND_TIMEOUT_ERROR 133
Send time-out.
• #define FTALK_INVALID_MBAP_ID 134
Invalid MPAB indentifer.
• #define FTALK_MBUS_EXCEPTION_RESPONSE 160
Modbus exception response.
• #define FTALK_MBUS_ILLEGAL_FUNCTION_RESPONSE 161
Illegal Function exception response.
• #define FTALK_MBUS_ILLEGAL_ADDRESS_RESPONSE 162
Illegal Data Address exception response.
• #define FTALK_MBUS_ILLEGAL_VALUE_RESPONSE 163
Illegal Data Value exception response.
• #define FTALK_MBUS_SLAVE_FAILURE_RESPONSE 164
Slave Device Failure exception response.
• #define FTALK_MBUS_GW_PATH_UNAVAIL_RESPONSE 170
Gateway Path Unavailable exception response.
• #define FTALK_MBUS_GW_TARGET_FAIL_RESPONSE 171
Gateway Target Device Failed exception response.

7.4.1 Detailed Description

This module documents all the exception classes, error and return codes reported by the
various library functions.

7.4.2 Macro Definition Documentation

FTALK_SUCCESS #define FTALK_SUCCESS 0

Operation was successful.
This return codes indicates no error.

FTALK_ILLEGAL_ARGUMENT_ERROR #define FTALK_ILLEGAL_ARGUMENT_ERROR 1

Illegal argument error.
A parameter passed to the function returning this error code is invalid or out of range.

24
 Module Documentation

FTALK_ILLEGAL_STATE_ERROR #define FTALK_ILLEGAL_STATE_ERROR 2

Illegal state error.
The function is called in a wrong state. This return code is returned by all functions if the
protocol has not been opened succesfully yet.

FTALK_EVALUATION_EXPIRED #define FTALK_EVALUATION_EXPIRED 3

Evaluation expired.
This version of the library is a function limited evaluation version and has now expired.

FTALK_NO_DATA_TABLE_ERROR #define FTALK_NO_DATA_TABLE_ERROR 4

No data table configured.
The slave has been started without adding a data table. A data table must be added by
either calling addDataTable or passing it as a constructor argument.

FTALK_ILLEGAL_SLAVE_ADDRESS #define FTALK_ILLEGAL_SLAVE_ADDRESS 5

Slave address 0 illegal for serial protocols.
A slave address or unit ID of 0 is used as broadcast address for ASCII and RTU protocol
and therefor illegal.

FTALK_IO_ERROR_CLASS #define FTALK_IO_ERROR_CLASS 64

I/O error class.
Errors of this class signal a problem in conjunction with the I/O system.

FTALK_IO_ERROR #define FTALK_IO_ERROR 65

I/O error.
The underlaying I/O system reported an error.

FTALK_OPEN_ERR #define FTALK_OPEN_ERR 66

Port or socket open error.
The TCP/IP socket or the serial port could not be opened. In case of a serial port it indicates
that the serial port does not exist on the system.

FTALK_PORT_ALREADY_OPEN #define FTALK_PORT_ALREADY_OPEN 67

Serial port already open.
The serial port defined for the open operation is already opened by another application.

25
FieldTalk Modbus Master C++ Library: Software manual

FTALK_TCPIP_CONNECT_ERR #define FTALK_TCPIP_CONNECT_ERR 68

TCP/IP connection error.
Signals that the TCP/IP connection could not be established. Typically this error occurs
when a host does not exist on the network or the IP address or host name is wrong. The
remote host must also listen on the appropriate port.

FTALK_CONNECTION_WAS_CLOSED #define FTALK_CONNECTION_WAS_CLOSED 69

Remote peer closed TCP/IP connection.
Signals that the TCP/IP connection was closed by the remote peer or is broken.

FTALK_SOCKET_LIB_ERROR #define FTALK_SOCKET_LIB_ERROR 70

Socket library error.
The TCP/IP socket library (e.g. WINSOCK) could not be loaded or the DLL is missing or not
installed.

FTALK_PORT_ALREADY_BOUND #define FTALK_PORT_ALREADY_BOUND 71

TCP port already bound.
Indicates that the specified TCP port cannot be bound. The port might already be taken
by another application or hasn't been released yet by the TCP/IP stack for re-use.

FTALK_LISTEN_FAILED #define FTALK_LISTEN_FAILED 72

Listen failed.
The listen operation on the specified TCP port failed..

FTALK_FILEDES_EXCEEDED #define FTALK_FILEDES_EXCEEDED 73

File descriptors exceeded.
Maximum number of usable file descriptors exceeded.

FTALK_PORT_NO_ACCESS #define FTALK_PORT_NO_ACCESS 74

No permission to access serial port or TCP port.
You don't have permission to access the serial port or TCP port. Run the program as root.
If the error is related to a serial port, change the access privilege. If it is related to TCP/IP
use TCP port number which is outside the IPPORT_RESERVED range.

FTALK_PORT_NOT_AVAIL #define FTALK_PORT_NOT_AVAIL 75

TCP port not available.
The specified TCP port is not available on this machine.

26
 Module Documentation

FTALK_LINE_BUSY_ERROR #define FTALK_LINE_BUSY_ERROR 76

Serial line busy.
The serial line is receiving characters or noise despite being in a state where there should
be no traffic.

FTALK_BUS_PROTOCOL_ERROR_CLASS #define FTALK_BUS_PROTOCOL_ERROR_CLASS 128

Fieldbus protocol error class.
Signals that a fieldbus protocol related error has occured. This class is the general class
of errors produced by failed or interrupted data transfer functions. It is also produced
when receiving invalid frames or exception responses.

FTALK_CHECKSUM_ERROR #define FTALK_CHECKSUM_ERROR 129

Checksum error.
Signals that the checksum of a received frame is invalid. A poor data link typically causes
this error.

FTALK_INVALID_FRAME_ERROR #define FTALK_INVALID_FRAME_ERROR 130

Invalid frame error.
Signals that a received frame does not correspond either by structure or content to the
specification or does not match a previously sent query frame. A poor data link typically
causes this error.

FTALK_INVALID_REPLY_ERROR #define FTALK_INVALID_REPLY_ERROR 131

Invalid reply error.
Signals that a received reply does not correspond to the specification.

FTALK_REPLY_TIMEOUT_ERROR #define FTALK_REPLY_TIMEOUT_ERROR 132

Reply time-out.
Signals that a fieldbus data transfer timed out. This can occur if the slave device does not
reply in time or does not reply at all. A wrong unit adress will also cause this error. In
some occasions this exception is also produced if the characters received don't constitute
a complete frame.

FTALK_SEND_TIMEOUT_ERROR #define FTALK_SEND_TIMEOUT_ERROR 133

Send time-out.
Signals that a fieldbus data send timed out. This can only occur if the handshake lines
are not properly set.

27
FieldTalk Modbus Master C++ Library: Software manual

FTALK_INVALID_MBAP_ID #define FTALK_INVALID_MBAP_ID 134

Invalid MPAB indentifer.
Either the protocol or transaction identifier in the reply is incorrect. A slave device must
return the identifiers received from the master.

FTALK_MBUS_EXCEPTION_RESPONSE #define FTALK_MBUS_EXCEPTION_RESPONSE 160

Modbus exception response.
Signals that a Modbus exception response was received. Exception responses are sent
by a slave device instead of a normal response message if it received the query message
correctly but cannot handle the query. This error usually occurs if a master queried an
invalid or non-existing data address or if the master used a Modbus function, which is
not supported by the slave device.

FTALK_MBUS_ILLEGAL_FUNCTION_RESPONSE #define FTALK_MBUS_ILLEGAL_FUNCTION_RESPONSE 161

Illegal Function exception response.
Signals that an Illegal Function exception response (code 01) was received. This exception
response is sent by a slave device instead of a normal response message if a master sent
a Modbus function, which is not supported by the slave device.

FTALK_MBUS_ILLEGAL_ADDRESS_RESPONSE #define FTALK_MBUS_ILLEGAL_ADDRESS_RESPONSE 162

Illegal Data Address exception response.
Signals that an Illegal Data Address exception response (code 02) was received. This
exception response is sent by a slave device instead of a normal response message if a
master queried an invalid or non-existing data address.

FTALK_MBUS_ILLEGAL_VALUE_RESPONSE #define FTALK_MBUS_ILLEGAL_VALUE_RESPONSE 163

Illegal Data Value exception response.
Signals that a Illegal Value exception response was (code 03) received. This exception
response is sent by a slave device instead of a normal response message if a master sent
a data value, which is not an allowable value for the slave device.

FTALK_MBUS_SLAVE_FAILURE_RESPONSE #define FTALK_MBUS_SLAVE_FAILURE_RESPONSE 164

Slave Device Failure exception response.
Signals that a Slave Device Failure exception response (code 04) was received. This ex-
ception response is sent by a slave device instead of a normal response message if an
unrecoverable error occured while processing the requested action. This response is also
sent if the request would generate a response whose size exceeds the allowable data size.

FTALK_MBUS_GW_PATH_UNAVAIL_RESPONSE #define FTALK_MBUS_GW_PATH_UNAVAIL_RESPONSE 170

Gateway Path Unavailable exception response.

28
 Module Documentation

Signals that a Gateway Path Unavailable exception response (code 0A) was received. This
exception is typically sent by gateways if the gateway was unable to establish a connec-
tion with the target device.

FTALK_MBUS_GW_TARGET_FAIL_RESPONSE #define FTALK_MBUS_GW_TARGET_FAIL_RESPONSE 171

Gateway Target Device Failed exception response.
Signals that a Gateway Target Device failed exception response (code 0B) was received.
This exception is typically sent by gateways if the gateway was unable to receive a re-
sponse from the target device. Usually means that the device is not present on the net-
work.

7.4.3 Function Documentation

getBusProtocolErrorText() const TCHAR∗ getBusProtocolErrorText (

int errCode )

Translates a numeric error code into a description string.

Parameters
errCode FieldTalk error code

Returns
Error text string

7.5 Device and Vendor Specific Modbus Functions

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-

t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Advantec ADAM 5000/6000 Series Commands

• int adamSendReceiveAsciiCmd (const char ∗const commandSz, char ∗responseSz)

Send/Receive ADAM 5000/6000 ASCII command.

29
FieldTalk Modbus Master C++ Library: Software manual

7.5.1 Detailed Description

Some device specific or vendor specific functions and enhancements are supported.

7.5.2 Function Documentation

customFunction() int customFunction (

int slaveAddr,
int functionCode,
void ∗ requestData,
size_t requestLen,
void ∗ responseData,
size_t ∗ responseLenPtr )

User Defined Function Code

This method can be used to implement User Defined Function Codes.
The caller has only to pass the user data to this function. The assembly of the Modbus
frame (the so called ADU) including checksums, slave address and function code and
subsequentially the transmission, is taken care of by this method.
The modbus specification reserves function codes 65-72 and 100-110 for user defined
functions.

Note
Modbus functions usually have an implied response length and therefore the num-
ber of bytes expected to be received is known at the time when sending the request.
In case of a custom Modbus function with an open or unknown response length,
this function can not be used.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255
for serial, 0 - 255 for TCP)
functionCode Custom function code to be used for Modbus transaction (1-127)
requestData Pointer to data sent as request (not including slave address or
function code)
requestLen Length of request data structure (0-252)
responseData Pointer to data structure which holds response data
responseLenPtr Length of response data (0-252). The number of bytes expected to
be sent as response must be known when submitting the request.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

30
 Module Documentation

References FTALK_ILLEGAL_ARGUMENT_ERROR.

adamSendReceiveAsciiCmd() int adamSendReceiveAsciiCmd (

const char ∗const commandSz,
char ∗ responseSz )

Send/Receive ADAM 5000/6000 ASCII command.

Sends an ADAM 5000/6000 ASCII command to the device and receives the reply as ASCII
string. (e.g. ”$01M” to retrieve the module name)

Parameters
commandSz Buffer which holds command string. Must not be longer than 255
characters.
responseSz Buffer which holds response string. Must be a buffer of 256 bytes. A
possible trailing CR is removed.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_CONNECTION_WAS_CLOSED, FTALK_ILLEGAL_ARGUMENT_ERROR, F←-

TALK_IO_ERROR, and FTALK_SUCCESS.

31
FieldTalk Modbus Master C++ Library: Software manual

8 C++ Class Documentation

8.1 MbusRtuMasterProtocol Class Reference
Modbus RTU Master Protocol class.

Public Types

• enum { SER_DATABITS_7 = 7, SER_DATABITS_8 = 8 }

• enum { SER_STOPBITS_1 = 1, SER_STOPBITS_2 = 2 }
• enum { SER_PARITY_NONE = 0, SER_PARITY_EVEN = 2, SER_PARITY_ODD = 1 }

Public Member Functions

• MbusRtuMasterProtocol ()
Constructs a MbusRtuMasterProtocol object and initialises its data.
• virtual int openProtocol (const char ∗const portName, long baudRate, int dataBits, int
stopBits, int parity)
Opens a Modbus RTU protocol and the associated serial port with specific port parameters.
• virtual void closeProtocol ()
Closes an open protocol including any associated communication resources (com ports or
sockets).
• virtual int isOpen ()
Returns whether the protocol is open or not.
• virtual int enableRs485Mode (int rtsDelay)
Enables RS485 mode.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

32
 C++ Class Documentation

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

33
FieldTalk Modbus Master C++ Library: Software manual

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

34
 C++ Class Documentation

Slave Configuration

• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions

• static const TCHAR ∗ getPackageVersion ()

Returns the library version number.

35
FieldTalk Modbus Master C++ Library: Software manual

8.1.1 Detailed Description

Modbus RTU Master Protocol class.
This class realizes the Modbus RTU master protocol. It provides functions to open and
to close serial port as well as data and control functions which can be used at any time
after the protocol has been opened. The data and control functions are organized into
different conformance classes. For a more detailed description of the data and control
functions see section Data and Control Functions for all Modbus Protocol Flavours.
It is possible to instantiate multiple instances of this class for establishing multiple con-
nections on different serial ports (They should be executed in separate threads).

See also
Data and Control Functions for all Modbus Protocol Flavours, Serial Protocols
MbusRtuOverTcpMasterProtocol

8.1.2 Member Enumeration Documentation

anonymous enum anonymous enum [inherited]

Enumerator
SER_DATABITS←- 7 data bits
_7
SER_DATABITS←- 8 data bits
_8

anonymous enum anonymous enum [inherited]

Enumerator
SER_STOPBITS←- 1 stop bit
_1
SER_STOPBITS←- 2 stop bits
_2

anonymous enum anonymous enum [inherited]

36
 C++ Class Documentation

Enumerator
No parity.
SER_PARITY_NONE
SER_PARITY_EVEN Even parity.
SER_PARITY_ODD Odd parity.

8.1.3 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const portName,
long baudRate,
int dataBits,
int stopBits,
int parity ) [virtual]

Opens a Modbus RTU protocol and the associated serial port with specific port parame-
ters.
This function opens the serial port. After a port has been opened, data and control
functions can be used.

Note
The default time-out for the data transfer is 1000 ms.
The default poll delay is 0 ms.
Automatic retries are switched off (retry count is 0).
The Modbus standard requires two stop bits if no parity is chosen. This library is
not enforcing this but it is a recommended configuration.

Parameters
portName Serial port identifier (e.g. ”COM1”, ”/dev/ser1” or ”/dev/ttyS0”)
baudRate The port baudRate in bps (typically 1200 - 115200, maximum value
depends on UART hardware)
dataBits Must be SER_DATABITS_8 for RTU
stopBits SER_STOPBITS_1: 1 stop bit, SER_STOPBITS_2: 2 stop bits
parity SER_PARITY_NONE: no parity, SER_PARITY_ODD: odd parity,
SER_PARITY_EVEN: even parity

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

37
FieldTalk Modbus Master C++ Library: Software manual

Reimplemented from MbusSerialClientBase.

References FTALK_ILLEGAL_ARGUMENT_ERROR, MbusSerialClientBase::openProtocol(),
and MbusSerialClientBase::SER_DATABITS_8.

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

enableRs485Mode() int enableRs485Mode (

int rtsDelay ) [virtual], [inherited]

Enables RS485 mode.

In RS485 mode the RTS signal can be used to enable and disable the transmitter of a
RS232/RS485 converter. The RTS signal is asserted before sending data. It is cleared after
the transmit buffer has been emptied and in addition the specified delay time has elapsed.
The delay time is necessary because even the transmit buffer is already empty, the UART's
FIFO will still contain unsent characters.

Warning

The use of RTS controlled RS232/RS485 converters should be avoided if possible. It

is difficult to determine the exact time when to switch off the transmitter with non
real-time operating systems like Windows and Linux. If it is switched off to early
characters might still sit in the FIFO or the transmit register of the UART and these
characters will be lost. Hence the slave will not recognize the message. On the
other hand if it is switched off too late then the slave's message is corrupted and
the master will not recognize the message.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

38
 C++ Class Documentation

Parameters
rtsDelay Delay time in ms (Range: 0 - 100000) which applies after the transmit
buffer is empty. 0 disables this mode.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusSerialClientBase::isOpen().

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,

39
FieldTalk Modbus Master C++ Library: Software manual

int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

40
 C++ Class Documentation

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

41
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,

42
 C++ Class Documentation

int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

43
FieldTalk Modbus Master C++ Library: Software manual

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

44
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

45
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,

46
 C++ Class Documentation

const int int32Arr[ ],

int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

47
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

48
 C++ Class Documentation

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.

49
FieldTalk Modbus Master C++ Library: Software manual

Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
50 refCnt Number of M10K integers to be read (Range: 1-62)
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

51
FieldTalk Modbus Master C++ Library: Software manual

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

52
 C++ Class Documentation

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

53
FieldTalk Modbus Master C++ Library: Software manual

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

54
 C++ Class Documentation

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

55
FieldTalk Modbus Master C++ Library: Software manual

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

56
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

57
FieldTalk Modbus Master C++ Library: Software manual

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

58
 C++ Class Documentation

Configures all slaves for Standard 32-bit Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

59
FieldTalk Modbus Master C++ Library: Software manual

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

60
 C++ Class Documentation

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

61
FieldTalk Modbus Master C++ Library: Software manual

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.2 MbusAsciiMasterProtocol Class Reference

Modbus ASCII Master Protocol class.

Public Types
• enum { SER_DATABITS_7 = 7, SER_DATABITS_8 = 8 }
• enum { SER_STOPBITS_1 = 1, SER_STOPBITS_2 = 2 }
• enum { SER_PARITY_NONE = 0, SER_PARITY_EVEN = 2, SER_PARITY_ODD = 1 }

Public Member Functions

• MbusAsciiMasterProtocol ()
Constructs a MbusAsciiMasterProtocol object and initialises its data.
• virtual int openProtocol (const char ∗const portName, long baudRate, int dataBits, int
stopBits, int parity)
Opens a serial Modbus protocol and the associated serial port with specific port parameters.
• virtual void closeProtocol ()
Closes an open protocol including any associated communication resources (com ports or
sockets).
• virtual int isOpen ()
Returns whether the protocol is open or not.
• virtual int enableRs485Mode (int rtsDelay)
Enables RS485 mode.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

62
 C++ Class Documentation

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

63
FieldTalk Modbus Master C++ Library: Software manual

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

64
 C++ Class Documentation

Slave Configuration

• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions

• static const TCHAR ∗ getPackageVersion ()

Returns the library version number.

65
FieldTalk Modbus Master C++ Library: Software manual

8.2.1 Detailed Description

Modbus ASCII Master Protocol class.
This class realizes the Modbus ASCII master protocol. It provides functions to open and
to close serial port as well as data and control functions which can be used at any time
after the protocol has been opened. The data and control functions are organized into
different conformance classes. For a more detailed description of the data and control
functions see section Data and Control Functions for all Modbus Protocol Flavours.
It is possible to instantiate multiple instances of this class for establishing multiple con-
nections on different serial ports (They should be executed in separate threads).

See also
Data and Control Functions for all Modbus Protocol Flavours, Serial Protocols
MbusAsciiOverTcpMasterProtocol

8.2.2 Member Enumeration Documentation

anonymous enum anonymous enum [inherited]

Enumerator
SER_DATABITS←- 7 data bits
_7
SER_DATABITS←- 8 data bits
_8

anonymous enum anonymous enum [inherited]

Enumerator
SER_STOPBITS←- 1 stop bit
_1
SER_STOPBITS←- 2 stop bits
_2

anonymous enum anonymous enum [inherited]

66
 C++ Class Documentation

Enumerator
No parity.
SER_PARITY_NONE
SER_PARITY_EVEN Even parity.
SER_PARITY_ODD Odd parity.

8.2.3 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const portName,
long baudRate,
int dataBits,
int stopBits,
int parity ) [virtual], [inherited]

Opens a serial Modbus protocol and the associated serial port with specific port param-
eters.
This function opens the serial port. After a port has been opened, data and control
functions can be used.

Note
The default time-out for the data transfer is 1000 ms.
The default poll delay is 0 ms.
Automatic retries are switched off (retry count is 0).
The Modbus standard requires two stop bits if no parity is chosen. This library is
not enforcing this but it is a recommended configuration.

Parameters
portName Serial port identifier (e.g. ”COM1”, ”/dev/ser1” or ”/dev/ttyS0”)
baudRate The port baudRate in bps (typically 1200 - 115200, maximum value
depends on UART hardware)
dataBits SER_DATABITS_7: 7 data bits (ASCII protocol only), SER_DATABITS_8:
data bits
stopBits SER_STOPBITS_1: 1 stop bit, SER_STOPBITS_2: 2 stop bits
parity SER_PARITY_NONE: no parity, SER_PARITY_ODD: odd parity,
SER_PARITY_EVEN: even parity

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

67
FieldTalk Modbus Master C++ Library: Software manual

Reimplemented in MbusRtuMasterProtocol.
References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK←-
_OPEN_ERR, FTALK_PORT_ALREADY_OPEN, FTALK_PORT_NO_ACCESS, FTALK_SUCCESS,
and MbusSerialClientBase::isOpen().

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

enableRs485Mode() int enableRs485Mode (

int rtsDelay ) [virtual], [inherited]

Enables RS485 mode.

In RS485 mode the RTS signal can be used to enable and disable the transmitter of a
RS232/RS485 converter. The RTS signal is asserted before sending data. It is cleared after
the transmit buffer has been emptied and in addition the specified delay time has elapsed.
The delay time is necessary because even the transmit buffer is already empty, the UART's
FIFO will still contain unsent characters.

Warning

The use of RTS controlled RS232/RS485 converters should be avoided if possible. It

is difficult to determine the exact time when to switch off the transmitter with non
real-time operating systems like Windows and Linux. If it is switched off to early
characters might still sit in the FIFO or the transmit register of the UART and these
characters will be lost. Hence the slave will not recognize the message. On the
other hand if it is switched off too late then the slave's message is corrupted and
the master will not recognize the message.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

68
 C++ Class Documentation

Parameters
rtsDelay Delay time in ms (Range: 0 - 100000) which applies after the transmit
buffer is empty. 0 disables this mode.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusSerialClientBase::isOpen().

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,

69
FieldTalk Modbus Master C++ Library: Software manual

int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

70
 C++ Class Documentation

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

71
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,

72
 C++ Class Documentation

int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

73
FieldTalk Modbus Master C++ Library: Software manual

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

74
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

75
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,

76
 C++ Class Documentation

const int int32Arr[ ],

int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

77
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

78
 C++ Class Documentation

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.

79
FieldTalk Modbus Master C++ Library: Software manual

Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
80 refCnt Number of M10K integers to be read (Range: 1-62)
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

81
FieldTalk Modbus Master C++ Library: Software manual

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

82
 C++ Class Documentation

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

83
FieldTalk Modbus Master C++ Library: Software manual

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

84
 C++ Class Documentation

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

85
FieldTalk Modbus Master C++ Library: Software manual

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

86
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

87
FieldTalk Modbus Master C++ Library: Software manual

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

88
 C++ Class Documentation

Configures all slaves for Standard 32-bit Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

89
FieldTalk Modbus Master C++ Library: Software manual

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

90
 C++ Class Documentation

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

91
FieldTalk Modbus Master C++ Library: Software manual

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.3 MbusElamMasterProtocol Class Reference

Extended Lufkin Automation Modbus Master Protocol.

Public Types
• enum { SER_DATABITS_7 = 7, SER_DATABITS_8 = 8 }
• enum { SER_STOPBITS_1 = 1, SER_STOPBITS_2 = 2 }
• enum { SER_PARITY_NONE = 0, SER_PARITY_EVEN = 2, SER_PARITY_ODD = 1 }

Public Member Functions

• MbusElamMasterProtocol ()
Constructs a MbusRtuMasterProtocol object and initialises its data.
• virtual int openProtocol (const char ∗const portName, long baudRate, int dataBits, int
stopBits, int parity)
Opens a Modbus RTU protocol and the associated serial port with specific port parameters.
• virtual void closeProtocol ()
Closes an open protocol including any associated communication resources (com ports or
sockets).
• virtual int isOpen ()
Returns whether the protocol is open or not.
• virtual int enableRs485Mode (int rtsDelay)
Enables RS485 mode.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

92
 C++ Class Documentation

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

93
FieldTalk Modbus Master C++ Library: Software manual

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

94
 C++ Class Documentation

Slave Configuration

• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions

• static const TCHAR ∗ getPackageVersion ()

Returns the library version number.

95
FieldTalk Modbus Master C++ Library: Software manual

8.3.1 Detailed Description

Extended Lufkin Automation Modbus Master Protocol.
This class realizes the Extended Lufkin Automation (ELAM) Modbus protocol. This pro-
prietary Modbus extension allows adressing of up to 2295 slave units and the retrieval of
up to 2500 registers for Modbus functions 3 and 4.
It's implementation is based on the specification ”ELAM Extended Lufkin Automation
Modbus Version 1.01” published by LUFKIN Automation. The ELAM multiple instruction
requests extensions are not implemented.
Tests showed the following size limits with a LUFKIN SAM Well Manager device:
Coils: 1992 for read Registers: 2500 to read, 60 for write

See also
Data and Control Functions for all Modbus Protocol Flavours, Serial Protocols
MbusRtuMasterProtocol

8.3.2 Member Enumeration Documentation

anonymous enum anonymous enum [inherited]

Enumerator
SER_DATABITS←- 7 data bits
_7
SER_DATABITS←- 8 data bits
_8

anonymous enum anonymous enum [inherited]

Enumerator
SER_STOPBITS←- 1 stop bit
_1
SER_STOPBITS←- 2 stop bits
_2

anonymous enum anonymous enum [inherited]

96
 C++ Class Documentation

Enumerator
No parity.
SER_PARITY_NONE
SER_PARITY_EVEN Even parity.
SER_PARITY_ODD Odd parity.

8.3.3 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const portName,
long baudRate,
int dataBits,
int stopBits,
int parity ) [virtual], [inherited]

Opens a Modbus RTU protocol and the associated serial port with specific port parame-
ters.
This function opens the serial port. After a port has been opened, data and control
functions can be used.

Note
The default time-out for the data transfer is 1000 ms.
The default poll delay is 0 ms.
Automatic retries are switched off (retry count is 0).
The Modbus standard requires two stop bits if no parity is chosen. This library is
not enforcing this but it is a recommended configuration.

Parameters
portName Serial port identifier (e.g. ”COM1”, ”/dev/ser1” or ”/dev/ttyS0”)
baudRate The port baudRate in bps (typically 1200 - 115200, maximum value
depends on UART hardware)
dataBits Must be SER_DATABITS_8 for RTU
stopBits SER_STOPBITS_1: 1 stop bit, SER_STOPBITS_2: 2 stop bits
parity SER_PARITY_NONE: no parity, SER_PARITY_ODD: odd parity,
SER_PARITY_EVEN: even parity

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

97
FieldTalk Modbus Master C++ Library: Software manual

Reimplemented from MbusSerialClientBase.

References FTALK_ILLEGAL_ARGUMENT_ERROR, MbusSerialClientBase::openProtocol(),
and MbusSerialClientBase::SER_DATABITS_8.

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

enableRs485Mode() int enableRs485Mode (

int rtsDelay ) [virtual], [inherited]

Enables RS485 mode.

In RS485 mode the RTS signal can be used to enable and disable the transmitter of a
RS232/RS485 converter. The RTS signal is asserted before sending data. It is cleared after
the transmit buffer has been emptied and in addition the specified delay time has elapsed.
The delay time is necessary because even the transmit buffer is already empty, the UART's
FIFO will still contain unsent characters.

Warning

The use of RTS controlled RS232/RS485 converters should be avoided if possible. It

is difficult to determine the exact time when to switch off the transmitter with non
real-time operating systems like Windows and Linux. If it is switched off to early
characters might still sit in the FIFO or the transmit register of the UART and these
characters will be lost. Hence the slave will not recognize the message. On the
other hand if it is switched off too late then the slave's message is corrupted and
the master will not recognize the message.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

98
 C++ Class Documentation

Parameters
rtsDelay Delay time in ms (Range: 0 - 100000) which applies after the transmit
buffer is empty. 0 disables this mode.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusSerialClientBase::isOpen().

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,

99
FieldTalk Modbus Master C++ Library: Software manual

int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

100
 C++ Class Documentation

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

101
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,

102
 C++ Class Documentation

int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

103
FieldTalk Modbus Master C++ Library: Software manual

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

104
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

105
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,

106
 C++ Class Documentation

const int int32Arr[ ],

int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

107
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

108
 C++ Class Documentation

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.

109
FieldTalk Modbus Master C++ Library: Software manual

Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
110 refCnt Number of M10K integers to be read (Range: 1-62)
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

111
FieldTalk Modbus Master C++ Library: Software manual

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

112
 C++ Class Documentation

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

113
FieldTalk Modbus Master C++ Library: Software manual

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

114
 C++ Class Documentation

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

115
FieldTalk Modbus Master C++ Library: Software manual

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

116
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

117
FieldTalk Modbus Master C++ Library: Software manual

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

118
 C++ Class Documentation

Configures all slaves for Standard 32-bit Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

119
FieldTalk Modbus Master C++ Library: Software manual

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

120
 C++ Class Documentation

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

121
FieldTalk Modbus Master C++ Library: Software manual

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.4 MbusTcpMasterProtocol Class Reference

MODBUS/TCP Master Protocol class.

Public Member Functions

• MbusTcpMasterProtocol ()
Constructs a MbusTcpMasterProtocol object and initialises its data.
• int openProtocol (const char ∗const hostName)
Connects to a MODBUS/TCP slave.
• int setPort (unsigned short portNo)
Sets the TCP port number to be used by the protocol.
• virtual void closeProtocol ()
Closes a TCP/IP connection to a slave and releases any system resources associated with the
connection.
• virtual int isOpen ()
Returns whether the protocol is open or not.
• unsigned short getPort ()
Returns the TCP port number used by the protocol.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

122
 C++ Class Documentation

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

123
FieldTalk Modbus Master C++ Library: Software manual

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

124
 C++ Class Documentation

Slave Configuration
• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions
• static const TCHAR ∗ getPackageVersion ()
Returns the library version number.

Advantec ADAM 5000/6000 Series Commands

• int adamSendReceiveAsciiCmd (const char ∗const commandSz, char ∗responseSz)
Send/Receive ADAM 5000/6000 ASCII command.

125
FieldTalk Modbus Master C++ Library: Software manual

8.4.1 Detailed Description

MODBUS/TCP Master Protocol class.
This class realises the MODBUS/TCP master protocol. It provides functions to estab-
lish and to close a TCP/IP connection to the slave as well as data and control func-
tions which can be used after a connection to a slave device has been established
successfully. The data and control functions are organized into different conformance
classes. For a more detailed description of the data and control functions see section
Data and Control Functions for all Modbus Protocol Flavours.
It is also possible to instantiate multiple instances of this class for establishing multiple
connections to either the same or different hosts.

See also
Data and Control Functions for all Modbus Protocol Flavours, IP based Protocols

8.4.2 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const hostName )

Connects to a MODBUS/TCP slave.

This function establishes a logical network connection between master and slave. After
a connection has been established data and control functions can be used. A TCP/IP
connection should be closed if it is no longer needed.

Note
The default time-out for the connection is 1000 ms.

Parameters
hostName String with IP address or host name

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
The default TCP port number is 502.

126
 C++ Class Documentation

setPort() int setPort (

unsigned short portNo )

Sets the TCP port number to be used by the protocol.

Usually the port number remains unchanged from its default. In this case no call to this
function is necessary. However if the port number has to be different, this function must
be called before opening the connection with openProtocol().

Parameters
port←- Port number to be used when opening the connection
No

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_STATE_ERR←- Protocol already open
OR

Note
Defaults to 502.

Remarks
Usually the port number remains unchanged and defaults to 502. In this case no
call to this function is necessary. However if the port number has to be differ-
ent from 502 this function must be called before opening the connection with
openProtocol().

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

getPort() unsigned short getPort ( ) [inline], [inherited]

Returns the TCP port number used by the protocol.

127
FieldTalk Modbus Master C++ Library: Software manual

Returns
Port number used by the protocol

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

128
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

129
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

130
 C++ Class Documentation

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,
int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

131
FieldTalk Modbus Master C++ Library: Software manual

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

132
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

133
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

134
 C++ Class Documentation

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

135
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,

136
 C++ Class Documentation

int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)

137
FieldTalk Modbus Master C++ Library: Software manual

Parameters
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

138
 C++ Class Documentation

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

139
FieldTalk Modbus Master C++ Library: Software manual

Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

140
 C++ Class Documentation

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

141
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

142
 C++ Class Documentation

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

143
FieldTalk Modbus Master C++ Library: Software manual

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

144
 C++ Class Documentation

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.

145
FieldTalk Modbus Master C++ Library: Software manual

Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

146
 C++ Class Documentation

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

Configures all slaves for Standard 32-bit Mode.
In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

147
FieldTalk Modbus Master C++ Library: Software manual

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

148
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

149
FieldTalk Modbus Master C++ Library: Software manual

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.5 MbusRtuOverTcpMasterProtocol Class Reference

Encapsulated Modbus RTU Master Protocol class.

Public Member Functions

• MbusRtuOverTcpMasterProtocol ()
Constructs a MbusRtuOverTcpMasterProtocol object and initialises its data.
• int openProtocol (const char ∗const hostName)

150
 C++ Class Documentation

Connects to a Modbus RTU slave via TCP/IP.

• int setPort (unsigned short portNo)
Sets the TCP port number used to connect to the Modbus RTU slave device.
• virtual void closeProtocol ()
Closes a TCP/IP connection to a slave and releases any system resources associated with the
connection.
• virtual int isOpen ()
Returns whether the protocol is open or not.
• unsigned short getPort ()
Returns the TCP port number used by the protocol.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

151
FieldTalk Modbus Master C++ Library: Software manual

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

152
 C++ Class Documentation

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

Slave Configuration
• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)

153
FieldTalk Modbus Master C++ Library: Software manual

Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions
• static const TCHAR ∗ getPackageVersion ()
Returns the library version number.

8.5.1 Detailed Description

Encapsulated Modbus RTU Master Protocol class.
This class realises the Encapsulated Modbus RTU master protocol. This protocol is also
known as RTU over TCP or RTU/IP and used for example by ISaGraf Soft-PLCs. This class
provides functions to establish and to close a TCP/IP connection to the slave as well as
data and control functions which can be used after a connection to a slave device has
been established successfully. The data and control functions are organized different
conformance classes. For a more detailed description of the data and control functions
see section Data and Control Functions for all Modbus Protocol Flavours.
It is also possible to instantiate multiple instances of this class for establishing multiple
connections to either the same or different hosts.

See also
Data and Control Functions for all Modbus Protocol Flavours, IP based Protocols
MbusRtuMasterProtocol

8.5.2 Member Function Documentation

154
 C++ Class Documentation

openProtocol() int openProtocol (

const char ∗const hostName )

Connects to a Modbus RTU slave via TCP/IP.

This function establishes a logical network connection between master and slave. After
a connection has been established data and control functions can be used. A TCP/IP
connection should be closed if it is no longer needed.

Note
The default time-out for the connection is 1000 ms.

Parameters
hostName String with IP address or host name

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
The default TCP port number is 1100.

setPort() int setPort (

unsigned short portNo )

Sets the TCP port number used to connect to the Modbus RTU slave device.
Usually the port number remains unchanged from its default. In this case no call to this
function is necessary. However if the port number has to be different, this function must
be called before opening the connection with openProtocol().

Parameters
port←- Port number to be used when opening the connection
No

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_STATE_ERR←- Protocol already open
OR

155
FieldTalk Modbus Master C++ Library: Software manual

Note
Defaults to 1100.

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

getPort() unsigned short getPort ( ) [inline], [inherited]

Returns the TCP port number used by the protocol.

Returns
Port number used by the protocol

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

156
 C++ Class Documentation

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

157
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

158
 C++ Class Documentation

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

159
FieldTalk Modbus Master C++ Library: Software manual

writeSingleRegister() int writeSingleRegister (

int slaveAddr,
int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

160
 C++ Class Documentation

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

161
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

162
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,

163
FieldTalk Modbus Master C++ Library: Software manual

const int int32Arr[ ],

int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

164
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

165
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.

166
 C++ Class Documentation

Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62) 167
FieldTalk Modbus Master C++ Library: Software manual

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

168
 C++ Class Documentation

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

169
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

170
 C++ Class Documentation

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

171
FieldTalk Modbus Master C++ Library: Software manual

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

172
 C++ Class Documentation

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

173
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

174
 C++ Class Documentation

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

175
FieldTalk Modbus Master C++ Library: Software manual

Configures all slaves for Standard 32-bit Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

176
 C++ Class Documentation

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

177
FieldTalk Modbus Master C++ Library: Software manual

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

178
 C++ Class Documentation

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.6 MbusAsciiOverTcpMasterProtocol Class Reference

Modbus ASCII TCP Master Protocol class.

Public Member Functions

• MbusAsciiOverTcpMasterProtocol ()
Constructs a MbusAsciiOverTcpMasterProtocol object and initialises its data.
• int openProtocol (const char ∗const hostName)
Connects to a Modbus ASCII slave via TCP/IP.
• int setPort (unsigned short portNo)
Sets the TCP port number used to connect to the Modbus ASCII slave device.
• virtual void closeProtocol ()
Closes a TCP/IP connection to a slave and releases any system resources associated with the
connection.
• virtual int isOpen ()
Returns whether the protocol is open or not.
• unsigned short getPort ()
Returns the TCP port number used by the protocol.

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

179
FieldTalk Modbus Master C++ Library: Software manual

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

180
 C++ Class Documentation

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.
• int setRetryCnt (int retryCnt)
Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

181
FieldTalk Modbus Master C++ Library: Software manual

Slave Configuration

• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()
Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions

• static const TCHAR ∗ getPackageVersion ()

Returns the library version number.

182
 C++ Class Documentation

8.6.1 Detailed Description

Modbus ASCII TCP Master Protocol class.
This class realises the Modbus ASCII master protocol using TCP as transport layer. This
class provides functions to establish and to close a TCP/IP connection to the slave as well
as data and control functions which can be used after a connection to a slave device
has been established successfully. The data and control functions are organized different
conformance classes. For a more detailed description of the data and control functions
see section Data and Control Functions for all Modbus Protocol Flavours.
It is also possible to instantiate multiple instances of this class for establishing multiple
connections to either the same or different hosts.

See also
Data and Control Functions for all Modbus Protocol Flavours, IP based Protocols
MbusAsciiMasterProtocol

8.6.2 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const hostName )

Connects to a Modbus ASCII slave via TCP/IP.

This function establishes a logical network connection between master and slave. After
a connection has been established data and control functions can be used. A TCP/IP
connection should be closed if it is no longer needed.

Note
The default time-out for the connection is 1000 ms.

Parameters
hostName String with IP address or host name

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
The default TCP port number is Telnet port 23.

183
FieldTalk Modbus Master C++ Library: Software manual

setPort() int setPort (

unsigned short portNo )

Sets the TCP port number used to connect to the Modbus ASCII slave device.
Usually the port number remains unchanged from its default. In this case no call to this
function is necessary. However if the port number has to be different, this function must
be called before opening the connection with openProtocol().

Parameters
port←- Port number to be used when opening the connection
No

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_STATE_ERR←- Protocol already open
OR

Note
Defaults to 23 (Telnet port).

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

getPort() unsigned short getPort ( ) [inline], [inherited]

Returns the TCP port number used by the protocol.

Returns
Port number used by the protocol

184
 C++ Class Documentation

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

185
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

186
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

187
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,
int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

188
 C++ Class Documentation

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

189
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,

190
 C++ Class Documentation

int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

191
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

192
 C++ Class Documentation

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

193
FieldTalk Modbus Master C++ Library: Software manual

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

194
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

195
FieldTalk Modbus Master C++ Library: Software manual

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

196
 C++ Class Documentation

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

197
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,

198
 C++ Class Documentation

const unsigned char queryArr[ ],

unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

199
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

200
 C++ Class Documentation

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

201
FieldTalk Modbus Master C++ Library: Software manual

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

202
 C++ Class Documentation

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

203
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

204
 C++ Class Documentation

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

Configures all slaves for Standard 32-bit Mode.
In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

205
FieldTalk Modbus Master C++ Library: Software manual

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success

206
 C++ Class Documentation

Return values
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

207
FieldTalk Modbus Master C++ Library: Software manual

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

8.7 MbusUdpMasterProtocol Class Reference

MODBUS/UDP Master Protocol class.

Public Member Functions

• int openProtocol (const char ∗const hostName)
Opens a connection to a slave device.
• virtual void closeProtocol ()
Closes a TCP/IP connection to a slave and releases any system resources associated with the
connection.
• virtual int isOpen ()
Returns whether the protocol is open or not.
• int setPort (unsigned short portNo)
Sets the port number to be used by the protocol.
• unsigned short getPort ()
Returns the TCP port number used by the protocol.

208
 C++ Class Documentation

Bit Access
Table 0:00000 (Coils) and Table 1:0000 (Input Status)

• int readCoils (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 1, Read Coil Status/Read Coils.
• int readInputDiscretes (int slaveAddr, int startRef, int bitArr[ ], int refCnt)
Modbus function 2, Read Inputs Status/Read Input Discretes.
• int writeCoil (int slaveAddr, int bitAddr, int bitVal)
Modbus function 5, Force Single Coil/Write Coil.
• int forceMultipleCoils (int slaveAddr, int startRef, const int bitArr[ ], int refCnt)
Modbus function 15 (0F Hex), Force Multiple Coils.

16-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 3, Read Holding Registers/Read Multiple Registers.
• int readInputRegisters (int slaveAddr, int startRef, short regArr[ ], int refCnt)
Modbus function 4, Read Input Registers.
• int writeSingleRegister (int slaveAddr, int regAddr, short regVal)
Modbus function 6, Preset Single Register/Write Single Register.
• int writeMultipleRegisters (int slaveAddr, int startRef, const short regArr[ ], int refCnt)
Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.
• int maskWriteRegister (int slaveAddr, int regAddr, short andMask, short orMask)
Modbus function 22 (16 Hex), Mask Write Register.
• int readWriteRegisters (int slaveAddr, int readRef, short readArr[ ], int readCnt, int
writeRef, const short writeArr[ ], int writeCnt)
Modbus function 23 (17 Hex), Read/Write Registers.

32-bit Access
Table 4:00000 (Holding Registers) and Table 3:00000 (Input Registers)

• int readMultipleLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
• int readInputLongInts (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
• int writeMultipleLongInts (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/Write
Multiple Registers with long int data.
• int readMultipleFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)

209
FieldTalk Modbus Master C++ Library: Software manual

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Regis-
ters as float data.
• int readInputFloats (int slaveAddr, int startRef, float float32Arr[ ], int refCnt)
Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
• int writeMultipleFloats (int slaveAddr, int startRef, const float float32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
• int readMultipleMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding Registers/←-
Read Multiple Registers as modulo-10000 long int data.
• int readInputMod10000 (int slaveAddr, int startRef, int int32Arr[ ], int refCnt)
Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
• int writeMultipleMod10000 (int slaveAddr, int startRef, const int int32Arr[ ], int refCnt)
Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.

Diagnostics
• int readExceptionStatus (int slaveAddr, unsigned char ∗statusBytePtr)
Modbus function 7, Read Exception Status.
• int returnQueryData (int slaveAddr, const unsigned char queryArr[ ], unsigned char
echoArr[ ], int len)
Modbus function code 8, sub-function 00, Return Query Data.
• int restartCommunicationsOption (int slaveAddr, int clearEventLog)
Modbus function code 8, sub-function 01, Restart Communications Option.

Custom Function Codes

• int customFunction (int slaveAddr, int functionCode, void ∗requestData, size_←-
t requestLen, void ∗responseData, size_t ∗responseLenPtr)
User Defined Function Code
This method can be used to implement User Defined Function Codes.

Protocol Configuration
• int setTimeout (int timeOut)
Configures time-out.
• int getTimeout ()
Returns the time-out value.
• int setPollDelay (int pollDelay)
Configures poll delay.
• int getPollDelay ()
Returns the poll delay time.

210
 C++ Class Documentation

• int setRetryCnt (int retryCnt)

Configures the automatic retry setting.
• int getRetryCnt ()
Returns the automatic retry count.

Transmission Statistic Functions

• long getTotalCounter ()
Returns how often a message transfer has been executed.
• void resetTotalCounter ()
Resets total message transfer counter.
• long getSuccessCounter ()
Returns how often a message transfer was successful.
• void resetSuccessCounter ()
Resets successful message transfer counter.

Slave Configuration
• void configureBigEndianInts ()
Configures 32-bit int data type functions to do a word swap.
• int configureBigEndianInts (int slaveAddr)
Enables int data type functions to do a word swap on a per slave basis.
• void configureLittleEndianInts ()
Configures 32-bit int data type functions not to do a word swap.
• int configureLittleEndianInts (int slaveAddr)
Disables word swapping for int data type functions on a per slave basis.
• void configureIeeeFloats ()
Configures float data type functions not to do a word swap.
• int configureIeeeFloats (int slaveAddr)
Disables float data type functions to do a word swap on a per slave basis.
• void configureSwappedFloats ()
Configures float data type functions to do a word swap.
• int configureSwappedFloats (int slaveAddr)
Enables float data type functions to do a word swap on a per slave basis.
• void configureStandard32BitMode ()
Configures all slaves for Standard 32-bit Mode.
• int configureStandard32BitMode (int slaveAddr)
Configures a slave for Standard 32-bit Register Mode.
• void configureEnron32BitMode ()
Configures all slaves for Daniel/ENRON 32-bit Mode.
• int configureEnron32BitMode (int slaveAddr)
Configures all slaves for Daniel/ENRON 32-bit Mode.
• void configureCountFromOne ()

211
FieldTalk Modbus Master C++ Library: Software manual

Configures the reference counting scheme to start with one for all slaves.
• int configureCountFromOne (int slaveAddr)
Configures a slave's reference counting scheme to start with one.
• void configureCountFromZero ()
Configures the reference counting scheme to start with zero for all slaves.
• int configureCountFromZero (int slaveAddr)
Configures a slave's reference counting scheme to start with zero.

Utility Functions
• static const TCHAR ∗ getPackageVersion ()
Returns the library version number.

8.7.1 Detailed Description

MODBUS/UDP Master Protocol class.
This class realises a Modbus client using MODBUS over UDP protocol variant. It pro-
vides functions to establish a UDP connection to the slave as well as data and control
functions which can be used after a connection to a slave device has been established
successfully. The data and control functions are organized into different conformance
classes. For a more detailed description of the data and control functions see section
Data and Control Functions for all Modbus Protocol Flavours.
It is also possible to instantiate multiple instances of this class for establishing multiple
connections to either the same or different hosts.

See also
Data and Control Functions for all Modbus Protocol Flavours, IP based Protocols

8.7.2 Member Function Documentation

openProtocol() int openProtocol (

const char ∗const hostName ) [inherited]

Opens a connection to a slave device.

This function establishes a logical network connection between master and slave. After
a connection has been established data and control functions can be used. A TCP/IP
connection should be closed if it is no longer needed.

Note
The default time-out for the connection is 1000 ms.

212
 C++ Class Documentation

Parameters
hostName String with IP address or host name

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

References FTALK_ILLEGAL_STATE_ERROR, FTALK_TCPIP_CONNECT_ERR, and MbusIp←-

ClientBase::isOpen().

isOpen() int isOpen ( ) [virtual], [inherited]

Returns whether the protocol is open or not.

Return values
true = open
false = closed

Implements MbusMasterFunctions.

setPort() int setPort (

unsigned short portNo ) [inherited]

Sets the port number to be used by the protocol.

Usually the port number remains unchanged from its default. In this case no call to this
function is necessary. However if the port number has to be different, this function must
be called before opening the connection with openProtocol().

Parameters
port←- Port number to be used when opening the connection
No

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_STATE_ERR←- Protocol already open
OR

References FTALK_ILLEGAL_STATE_ERROR, FTALK_SUCCESS, and MbusIpClientBase::is←-

Open().

213
FieldTalk Modbus Master C++ Library: Software manual

getPort() unsigned short getPort ( ) [inline], [inherited]

Returns the TCP port number used by the protocol.

Returns
Port number used by the protocol

readCoils() int readCoils (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 1, Read Coil Status/Read Coils.

Reads the contents of the discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputDiscretes() int readInputDiscretes (

int slaveAddr,
int startRef,
int bitArr[ ],
int refCnt ) [inherited]

Modbus function 2, Read Inputs Status/Read Input Discretes.

Reads the contents of the discrete inputs (input status, 1:00000 table).

214
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which will contain the data read
refCnt Number of coils to be read (Range: 1-2000)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeCoil() int writeCoil (

int slaveAddr,
int bitAddr,
int bitVal ) [inherited]

Modbus function 5, Force Single Coil/Write Coil.

Sets a single discrete output variable (coil, 0:00000 table) to either ON or OFF.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
bitAddr Coil address (Range: 1 - 65536)
bitVal true sets, false clears discrete output variable

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

215
FieldTalk Modbus Master C++ Library: Software manual

forceMultipleCoils() int forceMultipleCoils (

int slaveAddr,
int startRef,
const int bitArr[ ],
int refCnt ) [inherited]

Modbus function 15 (0F Hex), Force Multiple Coils.

Writes binary values into a sequence of discrete outputs (coils, 0:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
bitArr Buffer which contains the data to be sent
refCnt Number of coils to be written (Range: 1-1968)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleRegisters() int readMultipleRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 3, Read Holding Registers/Read Multiple Registers.

Reads the contents of the output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read
refCnt Number of registers to be read (Range: 1-125)

216
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputRegisters() int readInputRegisters (

int slaveAddr,
int startRef,
short regArr[ ],
int refCnt ) [inherited]

Modbus function 4, Read Input Registers.

Read the contents of the input registers (3:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer which will be filled with the data read.
refCnt Number of registers to be read (Range: 1-125)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeSingleRegister() int writeSingleRegister (

int slaveAddr,
int regAddr,
short regVal ) [inherited]

Modbus function 6, Preset Single Register/Write Single Register.

Writes a value into a single output register (holding register, 4:00000 reference).

217
FieldTalk Modbus Master C++ Library: Software manual

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
regAddr Register address (Range: 1 - 65536)
regVal Data to be sent

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

writeMultipleRegisters() int writeMultipleRegisters (

int slaveAddr,
int startRef,
const short regArr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex), Preset Multiple Registers/Write Multiple Registers.

Writes values into a sequence of output registers (holding registers, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start register (Range: 1 - 65536)
regArr Buffer with the data to be sent.
refCnt Number of registers to be written (Range: 1-123)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

218
 C++ Class Documentation

maskWriteRegister() int maskWriteRegister (

int slaveAddr,
int regAddr,
short andMask,
short orMask ) [inherited]

Modbus function 22 (16 Hex), Mask Write Register.

Masks bits according to an AND & an OR mask into a single output register (holding
register, 4:00000 reference). Masking is done as follows: result = (currentVal AND and←-
Mask) OR (orMask AND (NOT andMask))

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
regAddr Register address (Range: 1 - 65536)
andMask Mask to be applied as a logic AND to the register
orMask Mask to be applied as a logic OR to the register

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readWriteRegisters() int readWriteRegisters (

int slaveAddr,
int readRef,
short readArr[ ],
int readCnt,
int writeRef,
const short writeArr[ ],
int writeCnt ) [inherited]

Modbus function 23 (17 Hex), Read/Write Registers.

Combines reading and writing of the output registers in one transaction (holding regis-
ters, 4:00000 table).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
readRef Start register for reading (Range: 1 - 65536)
readArr Buffer which will contain the data read
readCnt Number of registers to be read (Range: 1-125)
writeRef Start register for writing (Range: 1 - 65536)

219
FieldTalk Modbus Master C++ Library: Software manual

Parameters
writeArr Buffer with data to be sent
writeCnt Number of registers to be written (Range: 1-121)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

readMultipleLongInts() int readMultipleLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit long int data types, Read Holding Registers/Read Multiple
Registers as long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into 32-bit long int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

220
 C++ Class Documentation

Note
No broadcast supported

readInputLongInts() int readInputLongInts (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit long int data types, Read Input Registers as long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into 32-bit long
int values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of long integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleLongInts() int writeMultipleLongInts (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit long int data types, Preset Multiple Registers/←-
Write Multiple Registers with long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table).

221
FieldTalk Modbus Master C++ Library: Software manual

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integers to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleFloats() int readMultipleFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit float data types, Read Holding Registers/Read Multiple Reg-
isters as float data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of float values to be read (Range: 1-62)

222
 C++ Class Documentation

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputFloats() int readInputFloats (

int slaveAddr,
int startRef,
float float32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit float data types, Read Input Registers as float data.
Reads the contents of pairs of consecutive input registers (3:00000 table) into float values.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer which will be filled with the data read
refCnt Number of floats to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

writeMultipleFloats() int writeMultipleFloats (

int slaveAddr,
int startRef,
const float float32Arr[ ],
int refCnt ) [inherited]

223
FieldTalk Modbus Master C++ Library: Software manual

Modbus function 16 (10 Hex) for 32-bit float data types, Preset Multiple Registers/Write
Multiple Registers with float data.
Writes float values into pairs of output registers (holding registers, 4:00000 table).

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
float32Arr Buffer with the data to be sent
refCnt Number of float values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readMultipleMod10000() int readMultipleMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 3 for 32-bit modulo-10000 long int data types, Read Holding
Registers/Read Multiple Registers as modulo-10000 long int data.
Reads the contents of pairs of consecutive output registers (holding registers, 4:00000
table) representing a modulo-10000 long int value into 32-bit int values and performs
number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

224
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

readInputMod10000() int readInputMod10000 (

int slaveAddr,
int startRef,
int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 4 for 32-bit modulo-10000 long int data types, Read Input Registers as
modulo-10000 long int data.
Reads the contents of pairs of consecutive input registers (3:00000 table) representing
a modulo-10000 long int value into 32-bit long int values and performs number format
conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer which will be filled with the data read
refCnt Number of M10K integers to be read (Range: 1-62)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

225
FieldTalk Modbus Master C++ Library: Software manual

Note
No broadcast supported

writeMultipleMod10000() int writeMultipleMod10000 (

int slaveAddr,
int startRef,
const int int32Arr[ ],
int refCnt ) [inherited]

Modbus function 16 (10 Hex) for 32-bit modulo-10000 long int data types, Preset Multiple
Registers/Write Multiple Registers with modulo-10000 long int data.
Writes long int values into pairs of output registers (holding registers, 4:00000 table)
representing a modulo-10000 long int value and performs number format conversion.

Remarks
Depending on the 32-bit Mode setting, an int will be transferred as two consecutive
16-bit registers (Standard) or as one 32-bit register (Daniel/Enron).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 0 - 255)
startRef Start reference (Range: 1 - 65536)
int32Arr Buffer with the data to be sent
refCnt Number of long integer values to be sent (Range: 1-61)

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
Broadcast supported for serial protocols

References FTALK_ILLEGAL_ARGUMENT_ERROR.

readExceptionStatus() int readExceptionStatus (

int slaveAddr,
unsigned char ∗ statusBytePtr ) [inherited]

Modbus function 7, Read Exception Status.

Reads the eight exception status coils within the slave device.

226
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
statusBytePtr Slave status byte. The meaning of this status byte is slave specific and
varies from device to device.

Returns
FTALK_SUCCESS on success or error code. See Error Management for a list of error
codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

returnQueryData() int returnQueryData (

int slaveAddr,
const unsigned char queryArr[ ],
unsigned char echoArr[ ],
int len ) [inherited]

Modbus function code 8, sub-function 00, Return Query Data.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
queryArr Buffer with data to be sent
echoArr Buffer which will contain the data read
len Number of bytes send sent and read back

Returns
FTALK_SUCCESS on success, FTALK_INVALID_REPLY_ERROR if reply does not match
query data or error code. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_INVALID_REPLY_ERROR, and FT←-

ALK_SUCCESS.

227
FieldTalk Modbus Master C++ Library: Software manual

restartCommunicationsOption() int restartCommunicationsOption (

int slaveAddr,
int clearEventLog ) [inherited]

Modbus function code 8, sub-function 01, Restart Communications Option.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255 for
serial, 0 - 255 for TCP)
clearEventLog Flag when set to one clears in addition the slave's communication
even log.

Returns
FTALK_SUCCESS on success. See Error Management for a list of error codes.

Note
No broadcast supported

References FTALK_ILLEGAL_ARGUMENT_ERROR.

setTimeout() int setTimeout (

int msTime ) [inherited]

Configures time-out.
This function sets the operation or socket time-out to the specified value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Timeout value in ms (Range: 1 - 100000)

Return values
FTALK_SUCCESS Success

228
 C++ Class Documentation

Return values
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getTimeout() int getTimeout ( ) [inline], [inherited]

Returns the time-out value.

Remarks
The time-out value is indicative only and not guaranteed to be maintained. How
precise it is followed depends on the operating system used, it's scheduling priority
and it's system timer resolution.

Returns
Timeout value in ms

setPollDelay() int setPollDelay (

int msTime ) [inherited]

Configures poll delay.

This function sets the delay time which applies between two consecutive Modbus
read/write. A value of 0 disables the poll delay.

Remarks
The delay value is indicative only and not guaranteed to be maintained. How precise
it is followed depends on the operating system used, it's scheduling priority and it's
system timer resolution.

Note
A protocol must be closed in order to configure it.

Parameters
msTime Delay time in ms (Range: 0 - 100000), 0 disables poll delay

229
FieldTalk Modbus Master C++ Library: Software manual

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

getPollDelay() int getPollDelay ( ) [inline], [inherited]

Returns the poll delay time.

Returns
Delay time in ms, 0 if poll delay is switched off

setRetryCnt() int setRetryCnt (

int retries ) [inherited]

Configures the automatic retry setting.

A value of 0 disables any automatic retries.

Note
A protocol must be closed in order to configure it.

Parameters
retries Retry count (Range: 0 - 10), 0 disables retries

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR
FTALK_ILLEGAL_STATE_ERROR Protocol is already open

References FTALK_ILLEGAL_ARGUMENT_ERROR, FTALK_ILLEGAL_STATE_ERROR, FTALK_←-

SUCCESS, and MbusMasterFunctions::isOpen().

230
 C++ Class Documentation

getRetryCnt() int getRetryCnt ( ) [inline], [inherited]

Returns the automatic retry count.

Returns
Retry count

getTotalCounter() long getTotalCounter ( ) [inline], [inherited]

Returns how often a message transfer has been executed.

Returns
Counter value

getSuccessCounter() long getSuccessCounter ( ) [inline], [inherited]

Returns how often a message transfer was successful.

Returns
Counter value

configureBigEndianInts() [1/2] void configureBigEndianInts ( ) [inherited]

Configures 32-bit int data type functions to do a word swap.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian slave.

configureBigEndianInts() [2/2] int configureBigEndianInts (

int slaveAddr ) [inherited]

Enables int data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. The data transfer functions
operating upon 32-bit int data types can be configured to do a word swap which enables
them to read 32-bit data correctly from a big-endian machine.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

231
FieldTalk Modbus Master C++ Library: Software manual

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureLittleEndianInts() [1/2] void configureLittleEndianInts ( ) [inherited]

Configures 32-bit int data type functions not to do a word swap.
This is the default.

configureLittleEndianInts() [2/2] int configureLittleEndianInts (

int slaveAddr ) [inherited]

Disables word swapping for int data type functions on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit data in little little-endian word order.

Remarks
This is the default mode

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureIeeeFloats() [1/2] void configureIeeeFloats ( ) [inherited]

Configures float data type functions not to do a word swap.
This is the default.

configureIeeeFloats() [2/2] int configureIeeeFloats (

int slaveAddr ) [inherited]

Disables float data type functions to do a word swap on a per slave basis.
Modbus is using little-endian word order for 32-bit values. This setting assumes that the
slave also serves 32-bit floats in little little-endian word order which is the most common
case.

Remarks
This is the default mode

232
 C++ Class Documentation

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureSwappedFloats() [1/2] void configureSwappedFloats ( ) [inherited]

Configures float data type functions to do a word swap.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

configureSwappedFloats() [2/2] int configureSwappedFloats (

int slaveAddr ) [inherited]

Enables float data type functions to do a word swap on a per slave basis.
The data functions operating upon 32-bit float data types can be configured to do a word
swap.

Note
Most platforms store floats in IEEE 754 little-endian order which does not need a
word swap.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureStandard32BitMode() [1/2] void configureStandard32BitMode ( ) [inherited]

Configures all slaves for Standard 32-bit Mode.
In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

233
FieldTalk Modbus Master C++ Library: Software manual

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

Remarks
This is the default mode

configureStandard32BitMode() [2/2] int configureStandard32BitMode (

int slaveAddr ) [inherited]

Configures a slave for Standard 32-bit Register Mode.

In Standard 32-bit Register Mode a 32-bit value is transmitted as two consecutive 16-bit
Modbus registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Remarks
This is the default mode

Note
This function call also re-configures the endianess to default little-endian for 32-bit
values!

References MbusMasterFunctions::configureIeeeFloats(), MbusMasterFunctions←-

::configureLittleEndianInts(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureEnron32BitMode() [1/2] void configureEnron32BitMode ( ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.
Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

234
 C++ Class Documentation

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

configureEnron32BitMode() [2/2] int configureEnron32BitMode (

int slaveAddr ) [inherited]

Configures all slaves for Daniel/ENRON 32-bit Mode.

Some Modbus flavours like the Daniel/Enron protocol represent a 32-bit value using one
32-bit Modbus register instead of two 16-bit registers.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Return values
FTALK_SUCCESS Success
FTALK_ILLEGAL_ARGUMENT_ERR←- Argument out of range
OR

Note
This function call also re-configures the endianess to big-endian for 32-bit values
as defined by the Daniel/ENRON protocol!

References MbusMasterFunctions::configureBigEndianInts(), MbusMasterFunctions←-

::configureSwappedFloats(), FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromOne() [1/2] void configureCountFromOne ( ) [inherited]

Configures the reference counting scheme to start with one for all slaves.
This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Remarks
This is the default mode

configureCountFromOne() [2/2] int configureCountFromOne (

int slaveAddr ) [inherited]

235
FieldTalk Modbus Master C++ Library: Software manual

Configures a slave's reference counting scheme to start with one.

This renders the reference range to be 1 to 65536 (0x10000) and register #0 is an illegal
register.

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

Remarks
This is the default mode

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

configureCountFromZero() [1/2] void configureCountFromZero ( ) [inherited]

Configures the reference counting scheme to start with zero for all slaves.
This renders the valid reference range to be 0 to 65535 (0xFFFF).
This renders the first register to be #0 for all slaves.

configureCountFromZero() [2/2] int configureCountFromZero (

int slaveAddr ) [inherited]

Configures a slave's reference counting scheme to start with zero.

This is also known as PDU addressing.
This renders the valid reference range to be 0 to 65535 (0xFFFF).

Parameters
slaveAddr Modbus address of slave device or unit identifier (Range: 1 - 255). A
value of zero configures the behaviour for broadcasting.

References FTALK_ILLEGAL_ARGUMENT_ERROR, and FTALK_SUCCESS.

getPackageVersion() const TCHAR ∗ getPackageVersion ( ) [static], [inherited]

Returns the library version number.

Returns
Library version string

236
 License

9 License
Library License
proconX Pty Ltd, Brisbane/Australia, ACN 104 080 935

Revision 4, October 2008

Definitions
"Software" refers to the collection of files and any part hereof,
including, but not limited to, source code, programs, binary
executables, object files, libraries, images, and scripts, which are
distributed by proconX.

"Copyright Holder" is whoever is named in the copyright or copyrights

for the Software.

"You" is you, if you are thinking about using, copying or distributing

this Software or parts of it.

"Distributable Components" are dynamic libraries, shared libraries,

class files and similar components supplied by proconX for
redistribution. They must be listed in a "README" or "DEPLOY" file
included with the Software.

"Application" pertains to Your product be it an application, applet or

embedded software product.
_________________________________________________________________

License Terms

1. In consideration of payment of the licence fee and your agreement

to abide by the terms and conditions of this licence, proconX
grants You the following non-exclusive rights:
a. You may use the Software on one or more computers by a single
person who uses the software personally;
b. You may use the Software nonsimultaneously by multiple people
if it is installed on a single computer;
c. You may use the Software on a network, provided that the
network is operated by the organisation who purchased the
license and there is no concurrent use of the Software;
d. You may copy the Software for archival purposes.
2. You may reproduce and distribute, in executable form only,
Applications linked with static libraries supplied as part of the
Software and Applications incorporating dynamic libraries, shared
libraries and similar components supplied as Distributable
Components without royalties provided that:
a. You paid the license fee;
b. the purpose of distribution is to execute the Application;
c. the Distributable Components are not distributed or resold
apart from the Application;
d. it includes all of the original Copyright Notices and
associated Disclaimers;
e. it does not include any Software source code or part thereof.
3. If You have received this Software for the purpose of evaluation,
proconX grants You a non-exclusive license to use the Software
free of charge for the purpose of evaluating whether to purchase
an ongoing license to use the Software. The evaluation period is
limited to 30 days and does not include the right to reproduce and
distribute Applications using the Software. At the end of the
evaluation period, if You do not purchase a license, You must
uninstall the Software from the computers or devices You installed

237
FieldTalk Modbus Master C++ Library: Software manual

it on.
4. You are not required to accept this License, since You have not
signed it. However, nothing else grants You permission to use or
distribute the Software or its derivative works. These actions are
prohibited by law if You do not accept this License. Therefore, by
using or distributing the Software (or any work based on the
Software), You indicate your acceptance of this License to do so,
and all its terms and conditions for copying, distributing or
using the Software or works based on it.
5. You may not use the Software to develop products which can be used
as a replacement or a directly competing product of this Software.
6. Where source code is provided as part of the Software, You may
modify the source code for the purpose of improvements and defect
fixes. If any modifications are made to any the source code, You
will put an additional banner into the code which indicates that
modifications were made by You.
7. You may not disclose the Software's software design, source code
and documentation or any part thereof to any third party without
the expressed written consent from proconX.
8. This License does not grant You any title, ownership rights,
rights to patents, copyrights, trade secrets, trademarks, or any
other rights in respect to the Software.
9. You may not use, copy, modify, sublicense, or distribute the
Software except as expressly provided under this License. Any
attempt otherwise to use, copy, modify, sublicense or distribute
the Software is void, and will automatically terminate your rights
under this License.
10. The License is not transferable without written permission from
proconX.
11. proconX may create, from time to time, updated versions of the
Software. Updated versions of the Software will be subject to the
terms and conditions of this agreement and reference to the
Software in this agreement means and includes any version update.
12. THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING PROCONX,
THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
13. ANY LIABILITY OF PROCONX WILL BE LIMITED EXCLUSIVELY TO REFUND OF
PURCHASE PRICE. IN ADDITION, IN NO EVENT UNLESS REQUIRED BY
APPLICABLE LAW OR AGREED TO IN WRITING WILL PROCONX OR ITS
PRINCIPALS, SHAREHOLDERS, OFFICERS, EMPLOYEES, AFFILIATES,
CONTRACTORS, SUBSIDIARIES, PARENT ORGANIZATIONS AND ANY COPYRIGHT
HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
SOFTWARE AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE
(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN
IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
14. IN ADDITION, IN NO EVENT DOES PROCONX AUTHORIZE YOU TO USE THIS
SOFTWARE IN APPLICATIONS OR SYSTEMS WHERE IT'S FAILURE TO PERFORM
CAN REASONABLY BE EXPECTED TO RESULT IN A SIGNIFICANT PHYSICAL
INJURY, OR IN LOSS OF LIFE. ANY SUCH USE BY YOU IS ENTIRELY AT
YOUR OWN RISK, AND YOU AGREE TO HOLD PROCONX HARMLESS FROM ANY
CLAIMS OR LOSSES RELATING TO SUCH UNAUTHORIZED USE.
15. This agreement constitutes the entire agreement between proconX

238
 License

and You in relation to your use of the Software. Any change will
be effective only if in writing signed by proconX and you.
16. This License is governed by the laws of Queensland, Australia,
excluding choice of law rules. If any part of this License is
found to be in conflict with the law, that part shall be
interpreted in its broadest meaning consistent with the law, and
no other parts of the License shall be affected.
_________________________________________________________________

239
FieldTalk Modbus Master C++ Library: Software manual

10 Support
We provide electronic support and feedback for our FieldTalk products.
Please use the Support web page at: http://www.modbusdriver.com/support
Your feedback is always welcome. It helps improving this product.

240
 Notices

11 Notices
Disclaimer:
proconX Pty Ltd makes no warranty for the use of its products, other than those expressly
contained in the Company's standard warranty which is detailed in the Terms and Condi-
tions located on the Company's Website. The Company assumes no responsibility for any
errors which may appear in this document, reserves the right to change devices or speci-
fications detailed herein at any time without notice, and does not make any commitment
to update the information contained herein. No licenses to patents or other intellectual
property of proconX are granted by the Company in connection with the sale of proconX
products, expressly or by implication. proconX products are not authorized for use as
critical components in life support devices or systems.
This FieldTalk™ library was developed by:
proconX Pty Ltd, Australia.
Copyright © 2002-2018. All rights reserved.
proconX and FieldTalk are trademarks of proconX Pty Ltd. Modbus is a registered trade-
mark of Schneider Automation Inc. All other product and brand names mentioned in this
document may be trademarks or registered trademarks of their respective owners.

241