Module "MODBUS RTU" online help

1999-2003 AGG Software

Module "MODBUS RTU" online help

1999-2003 AGG Software
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or
mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the
written permission of the publisher.
Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective
owners. The publisher and the author make no claim to these trademarks.
While every precaution has been taken in the preparation of this document, the publisher and the author assume no
responsibility for errors or omissions, or for damages resulting from the use of information contained in this document
or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be
liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or
indirectly by this document.
Printed:

2003

Publisher
AGG Software
Production
2003, AGG Software
http://www.aggsoft.com

Contents

Table of Contents
Foreword

Part 1 Introduction

Part 2 System requirements

Part 3 User Manual

1 Installation
................................................................................................................................... 3
2 Data query
................................................................................................................................... 4
3 Data parser
................................................................................................................................... 5

Index

1999-2003 AGG Software

Module "MODBUS RTU" online help

Introduction
To extend program functionality we realized plugins modules connection possibility. Module
structure lets reduce your program purchase costs (you pay only functionality, which you need), to
low down program distributive download time, your computer processor load and reduce disk
space.
Advanced Serial Data Logger's MODBUS RTU module supports two modes:
1.

Data query - transmits queries or commands out the serial port to control or query your
instruments directly;
2.
Data parsers - advanced data parser that allows you to parse, filter and format more
complex data from more sophisticated devices. Some of the advanced features of the parser are
the ability to work with raw binary or hex data;
This module has the following peculiarities:

You can send valid data request for any device;

You can send request for any device function;
CRC for each data packet will be calculated automatically;
You can request bytes, word, double words and single registers;
You can send request after data receiving and use any time interval;
You can parse all received data packets and extract register's values.

All these will be done the most convenient and easy for You, thanks to thought over and wide
module functionality!

System requirements
To run the program one of the following operation systems is needed:
Windows 95;
Windows 95 OSR2;
Windows 98;
Windows Me;
Windows NT4 or Windows 2000 or Windows XP (administrator rights needed).
Advanced Serial Data Logger installed on your computer.

1999-2003 AGG Software

User Manual

User Manual

3.1

Installation
If You are untrained user or plan to install module using distributive (file has extension exe), so
to start installation:
1.
2.
3.
4.

5.

Close Advanced Serial Data Logger, if it was run;

Copy module distributive file to your hard disk;
Run file on execution, clicking twice in Explorer on its name;
Execute setup wizard's instructions. In common case, if earlier was installed Advanced
Serial Data Logger, enough to press several times button "Next". All necessary for
installation data, wizard will get himself;
Restart Advanced Serial Data Logger. In case of successful installation module name will
show up in options, on tab "Modules".

If You are trained user and want to shorten time on module run from Internet, so You can make
module installation by simple module file copying (file has extension dll). To make installation:
1.
2.
3.

4.

Close Advanced Serial Data Logger, if it was run;

Copy archive file ( with extension zip), containing module file ( with extension dll) to your
hard disk;
Unpack archive, using, for example, WinZip and place all files from archive to folder
Plugins, which is placed in folder, where to You have installed Advanced Serial Data
Logger. On default, this is folder X:\\Program Files\Advanced Serial Data Logger, where X
your system disk letter;
Restart Advanced Serial Data Logger. In case of lucky installation, module name must
show up in options, on tab "Modules".

If , due to some reasons, You couldn't install publication module, so consult technical support
service on address support@aggsoft.com and our professionals will be glad to help you.
If module is compatible with our program, its brief description You will see in module list (pic.1).
Some modules may demand additional setting. To output module setting dialog select it from the
list and press button "Setup".

1999-2003 AGG Software

Module "MODBUS RTU" online help

Pic.1. Installed plugin modules

3.2

Data query
As well as collecting incoming data, Advanced Serial Data Logger can also send commands or
data strings to your serial devices. Hence you can automatically re-set your device or prompt it to
take more readings. Advanced Serial Data Logger has many advanced features to let you easily
create sophisticated 2-way serial I/O interfaces.
You can add one or more data request items, which send data over serial interface in two modes:
Once on application start up;
Every XXX milliseconds.
If you want add new item click "Add item". The dialog window will be shown (pic.1). Set a request
name and specify necessary parameters. In request name you can enter any characters.

1999-2003 AGG Software

User Manual

Pic.1. Add new item dialog

Also you can specify to send the data after receiving the answer from your device.
Waiting the answer the defined time is possible. If the answer has not been received, the data
request will not be sended more.

3.3

Data parser
To display data and to export data to your application setup parameters, on which program will
pick out significant data blocks (data packets) from the common data flow (pic.2). We can't
describe process for every case, but tried to make easier log export process to our target.
You can specify handle only data packets, received after request from MODBUS RTU data query.
In window "Parser" parameters tree. Having selected necessary parameter set its value. In the
described example all values are in fixed positions. That's why selected necessary value "Device"
and set values of function number and registers range. Also for every field must be select data
type (byte, word, double word).

1999-2003 AGG Software

Module "MODBUS RTU" online help

Pic.2. Data parser.

1999-2003 AGG Software