Documentation - AGG Software
Contents
1. 5 2 Regue method iei idi ENTA A E AAA ATEA peRRileiilsteiilbe ieiiiieRcaiii 6 3 Data Parser rasore nner rapain E a RE TEN EASRA ARE a ESAS RED 7 Part 6 Troubles 9 1 Possible problems s eseria nanara iere Sa A ESAERAREN 9 1999 2013 AGG Software 1 MODBUS RTU ASCII MODBUS TCP plugin 1 2 Introduction MODBUS is a serial communications protocol for use with its programmable logic controllers PLCs Simple and robust it has since become a de facto standard communication protocol and it is now a commonly available means of connecting industrial electronic devices Our MODBUS RTU ASCII and MODBUS TCP plugin can work in two modes 1 Data query and parser the plugin sends MODBUS requests and process the responses In this mode the program operates in the Master mode 2 Data parser only in this mode the plugin waits for responses only For example it can work in parallel with other MODBUS master or in the Spy mode This module has the following features Can send valid data request to any MODBUS compatible device Can send request with any MODBUS function CRC for each data packet will be calculated and verified automatically Can request bytes word double words and single registers Can poll MODBUS data by a custom interval Can flexibly parse all received data packets and extract register s values System requirements The following requirements must be met for2. then specify 99 here Registers to read please specify number of consistent registers in the device memory Request timeout It is the time interval for which the program is sending request to a MODBUS device After reaching the timeout limit the program will automatically cancel current request and execute next request in the queue The timeout value depends on the network on which master program and slave device is running If the network is slow then timeout value should be larger and if network is fast then timeout value can be small 1999 2013 AGG Software User Manual 6 amp MODBUS RTU 4 0 13 build 1125 o Requests queue Property Value BL sss Send requests otherwise parse response only Device address 1 Function 3 Data address Address e g POON Value First register e g 0000 Registers to read Request timeout ms Request method CO C m mn mranamrana im Minimal interval between data packets ms Fig 2 MODBUS request 5 2 Request method The plugin can send requests in two modes Once on program startup the program will send request once when the program starts Polling the program will be sending request periodically based on an interval specified The interval between requests depends on the network on which master program and slave device is running If the network is slow then time for each request will be larger and vice versa Be
3. 00 1100011 The MODBUS RTU ASCII MODBUS TCP plugin PRINTED MANUAL 1999 2013 AGG Software MODBUS RTU ASCII MODBUS TCP plugin 1999 2013 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 04 12 2013 Publisher AGG Software Production 1999 2013 AGG Software http www aggsoft com Contents Table of Contents Part1 Introduction 1 Part 2 System requirements 1 Part 3 Installing MODBUS RTU ASCIl MODBUS TCP 2 Part 4 Glossary 4 Part 5 User Manual 5 1 Data quey
4. MODBUS RTU ASCII MODBUS TCP to be installed Operating system Windows 2000 SP4 and above including both x86 and x64 workstations and servers A latest service pack for the corresponding OS is required Free disk space Not less than 5 MB of free disk space is recommended Special access requirements You should log on as a user with Administrator rights in order to install this module The main application core must be installed for example Advanced Serial Data Logger Notes for Microsoft Vista and above Since our software saves data to the registry and installs to the Program Files folder the following requirements must be met 1 You need Administrator rights to run and install our software 2 The shortcut icon of our software will be located on the desktop 3 Windows Vista will ask for your confirmation to continue the installation NOTE You can configure the user account only once in order not to see the above dialog box any more Search Google for the solution of this problem 1999 2013 AGG Software Installing MODBUS RTU ASCII MODBUS TCP 2 3 Installing MODBUS RTU ASCII MODBUS TCP Close the main application for example Advanced Serial Data Logger if it is running Copy the program to your hard drive Run the module installation file with a double click on the file name in Windows Explorer Follow the instructions of the installation software Usually it is enough just to click the Next button sever
5. al times Start the main application The name of the module will appear on the Modules tab of the Settings window if it is successfully installed ROD If the module is compatible with the program its name and version will be displayed in the module list You can see examples of installed modules on fig 1 2 Some types of modules require additional configuration To do it just select a module from the list and click the Setup button next to the list The configuration of the module is described below You can see some types of modules on the Log file tab To configure such a module you should select it from the File type list and click the Advanced button amp Configuration options Query Parse Filter Log file Data query module Other ASCII data query and parser default dll v Setup Modules Parser module ASCII data query and parser default dll x Setup Parsing and exporting for data sent capt tiny J Parsing and exporting for data received Select data filter modules Module name Version AS Aggregation aggregator dll 4 0 6 1128 Data export C Data redirecting dataredirect dll 4 0 6 1128 Data timeout datatimeout dll 4 0 7 1128 E Deadband deadband dll 4 0 6 1128 N Digital inputs filter adamdio dll 4 0 6 1128 E Events generator eventgen dll 4 0 6 1128 pex 9 Expressions expressions
6. cause the program are executing all requests in the queue one by one then time between requests depends on the number of requests in the queue Property Value X Request method 00000000004 Once on program startup Polling B Interval ms 10000 m Interval units Millisecond Response items c Fa Fig 3 Request methods 1999 2013 AGG Software 7 MODBUS RTU ASCII MODBUS TCP plugin 5 3 If you added few requests to the queue then you can move it up and down Select a request title and execute a corresponding menu item by clicking the Actions button With help of this button you can change an item description and delete requests You can access all actions through the popup menu in the request tree Data parser All data publication modules uses variables parsed The parser should pick out significant data blocks data packets from the common data flow Our MODBUS RTU ASCII MODBUS TCP module can do it This module analyze data flow and control data packets integrity by CRC cyclical redundancy check All parser items assigned with a corresponding request in the queue You can assign one or more parser items variables to one request Typically each request has one parser item You can add new parser item variable to the request by clicking Actions gt Add response item Before you should select a caption of the corresponding request New parser item variable will appear in the Response items
7. dll 4 0 7 1218 E File requests filereq dll 4 0 6 1128 Script execute scriptexec dll 4 0 7 1128 3d Up Down Help Setup Fig 1 Examples of installed modules 1999 2013 AGG Software MODBUS RTU ASCII MODBUS TCP plugin E Configuration options Data export Select data export modules Module name DDE Server ddesrv dll Direct Excel connection olexcel dll Excel export excelexport dll Excel Export Professional advexcel dll FoxJet foxjet dll Humbug API humbugapi dll Local database localdb dll ODBC database odbcexport dll OPC server buildin dll Printer nut nrinterqut lll Version 4 0 6 1128 4 0 6 1128 4 0 6 1128 4 0 6 1128 4 0 7 1128 4 0 6 1128 4 0 6 1128 4 0 6 1128 4 0 3 1215 4 1129 Download plugin now Help Redirect data to another configuration Setup Events handling Configuration Fig 2 Examples of installed modules 1999 2013 AGG Software Installing MODBUS RTU ASCII MODBUS TCP 4 n amp Configuration options Events handling Select events handling modules Module name Version Modules Events notification events dll 4 0 7 1128 Internet sharing ishare dll 4 0 7 1128 Log packing packlog dll 4 0 6 1128 Scheduler amp Hotkeys scheduler dll 40 2114 Quer
8. eacting to errors is selected The message implies a Yes or No answer The analysis of the additional information will help you locate the error Unable to verify your SQL script s the message appears when an attempt to analyze your SQL query fails Check if the syntax of your SQL query is correct Tested successfully the message appears if your database connection is successfully tested It requires no additional actions Database isn t used the message appears if the module is temporarily disabled the Temporarily disabled check box is selected or the database name field is empty Check the connection parameters Database isn t selected the message appears if the database type is not selected Check the connection parameters Database 96s s contains the database name The message appears if the database connection is successful Usually you see it when you call the module for the first time It requires no additional actions Invalid data block length columns d length d an internal application error It means that the data sent by the parser is in an invalid format Perhaps you are using the module incompatible with the version of the Advanced Serial Data Logger kernel Update the versions of both the kernel and the module 1999 2013 AGG Software Troubles 10 The time of connection is not due yet d d the message appears during an attempt to connect to the database after the connec
9. group fig 4 1999 2013 AGG Software User Manual 3 r Requests queue Property Value Interval units Millisecond S Response items E Item 1 Name VALUE Offset 0 Count 1 Append counter to name Data type Decimal 16 bit Little endian otherwise Big endian numbers only Unsigned otherwise Signed decimal numbers only V Swapped most significant register first 32 and 64 bit numbers only Default value 0 Scale numbers only 1 E Item 2 Name VALUE2 Offset 1 Count 1 counter to name Data type Decimal 16 bit Little endian otherwise Big endian numbers only Unsigned otherwise Signed decimal numbers only Swapped most significant register first 32 and 64 bit numbers only Default value D Scale numbers only 1 Minimal interval between data packets ms Fig 4 Data parser items Each response item has few important options e Name the of the parser variable This name you ll bind with fields in data publication modules Offset the device can response few data bytes but you need only some of them The Offset field contains a byte offset of the data from the beginning of the data block This value is zero based If first byte of your value located at the begin of data block then this value should be 0 You can specify 1 here then the program will automatically calculate the val
10. tion to it has been lost and the Reconnect after option is enabled No additional actions are required Invalid procedure call Bad arguments an attempt to call the module using invalid parameters Perhaps you are using the module incompatible with the version of the Advanced Serial Data Logger kernel Update the versions of both the kernel and the module Writing to the database is complete the message appears if your queue of SQL queries is successfully executed It requires no additional actions Writing to the database is complete with errors the message appears if the executing your queue of SQL queries was interrupted by an error It requires no additional actions Your SQL is empty Please specify some SQL text first the message appears if you do not enter the text for your SQL query Check if the options on the SQL queue tab are configured correctly Invalid temporary path the path to the temporary file specified by you does not exist Enter a new path in the Temporary folder field on the Errors handling tab 96s will be replaced by additional information 1999 2013 AGG Software
11. ue offset 1999 2013 AGG Software 9 MODBUS RTU ASCII MODBUS TCP plugin Count the number of values nor bytes with same parameters data type and default value that located one after another since the offset If you specify more than one here then a value index 1 2 3 etc will be added to the parser item name Data type data type of the value Each value can utilize one for byte data type or more bytes Default value this value will be used if the parser can t parser data block for this parser item For example if the data block has a small size or offset is too large 6 Troubles 6 1 Possible problems No data for publication exporting no data is passed for exporting Solution configure the parser make sure that one or more variables are declared in the parser Error on binding variable with name s s the error usually occurs if data does not correspond to the specified format For example the date and time format does not correspond to the data Unable to disconnect from the database s and Unable to connect to a database s it is impossible to connect disconnect to form the database You should check the parameters of the database connection The analysis of the additional information will help you locate the error Database access error s Stop operations with the database the message appears if an error occurs during an attempt to execute an SQL query if the second variant of r
12. y Parse Download plugin now Help Setup Fig 3 Examples of installed modules 4 Glossary Plug in module Main program the program shell that uses this module For example Advanced Serial Data Logger Parser the module that processes the data flow singling out data packets from it and variables from data packets These variables are used in data export modules after that Core see Main program 1999 2013 AGG Software 5 MODBUS RTU ASCII MODBUS TCP plugin 5 User Manual 5 1 Data query To add new item click Actions gt Add new request The dialog window will be shown fig 1 Enter a request description that can contain any characters and click the OK button r Enter your description New request Fig 1 Name dialog New MODBUS request will appear in the requests tree fig 2 Each MODBUS request has few important options Device address your hardware device address in the RS232 or RS485 network By MODBUS protocol specification this address can be from 0 to 255 If you ll specify 0 as a device address then all devices in the network should answer to this request Function the MODBUS protocol function number Usually this value is 3 for reading holding registers or 4 for reading input registers First register it s register address This value is zero based by MODBUS protocol specification If you want to read a register with number 100
Download Pdf Manuals
Related Search