User Guide for ADVANTECH models including: Protocol MODBUS-RTUMAP Router App, Protocol MODBUS-RTUMAP, Router App, App
Router Apps - Cellular Routers Engineering Portal
File Info : application/pdf, 9 Pages, 572.51KB
DocumentDocumentProtocol MODBUS-RTUMAP Advantech Czech s.r.o., Sokolska 71, 562 04 Usti nad Orlici, Czech Republic Document No. APP-0057-EN, revision from 26th October, 2023. © 2023 Advantech Czech s.r.o. No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photography, recording, or any information storage and retrieval system without written consent. Information in this manual is subject to change without notice, and it does not represent a commitment on the part of Advantech. Advantech Czech s.r.o. shall not be liable for incidental or consequential damages resulting from the furnishing, performance, or use of this manual. All brand names used in this manual are the registered trademarks of their respective owners. The use of trademarks or other designations in this publication is for reference purposes only and does not constitute an endorsement by the trademark holder. Used symbols Danger Information regarding user safety or potential damage to the router. Attention Problems that can arise in specific situations. Information Useful tips or information of special interest. Example Example of function, command or script. Contents 1. Changelog 1 1.1 Protocol MODBUS-RTUMAP Changelog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2. Description of router app 2 3. Configuration of router app 3 3.1 Adding and removing a measuring device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.2 Read and write functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Related Documents 5 List of Figures 1 Model diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Configuration form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 Adding a measuring device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4 Read and write functions supported by the RTUMAP router app . . . . . . . . . . . . . . . . . 4 List of Tables 1 Description of items in configuration form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Changelog 1.1 Protocol MODBUS-RTUMAP Changelog v1.0.0 (2012-01-13) · First release v1.0.1 (2012-01-20) · Allowed reading of register zero v1.0.2 (2013-12-11) · Added support of FW 4.0.0+ v1.0.3 (2015-08-21) · Fixed bug in sorting of data in internal buffer v1.0.4 (2018-09-27) · Added expected ranges of values to JavaSript error messages v1.0.5 (2019-02-13) · Fixed reading of coils Protocol MODBUS-RTUMAP Manual 1 2. Description of router app Router App Protocol MODBUS-RTUMAP is not contained in the standard router firmware. Uploading of this router app is described in the Configuration manual (see [1, 2]). The router app is not v4 platform compatible. Using this module, it is possible to periodically read data from the buffer which stores values obtained from connected measuring devices (meters). To each measuring device can be assigned a certain number of registers (or coils). These ranges follow each other, so RTUMAP module reads data from a total number of assigned registers (or coils) starting from the specified start address. Well-arranged model diagram can be found in the following figure: Figure 1: Model diagram For configuration RTUMAP router app is available web interface, which is invoked by pressing the module name on the Router apps page of the router web interface. The left part of the web interface (ie. menu) contains only the Return item, which switches this web interface to the interface of the router. Protocol MODBUS-RTUMAP Manual 2 3. Configuration of router app The actual configuration of this router app is performed via the form on the right side. The first item in this form Enable RTUMAP on expansion port is used to activate these router app. Meaning of other items is described in the table below: Polozka Expansion port Baudrate Data Bits Parity Stop Bits Split Timeout Read Period TCP Port Start Address Význam Corresponding expansion port (PORT1 or PORT2) Modulation rate (number of distinct symbol changes signaling events made to the transmission medium per second) Number of data bits (7 or 8) Parity (none, even or odd) Number of stop bits (1 or 2) The delay between readings (in miliseconds) Period of reading data from the buffer (in seconds) TCP port number Start address of register Table 1: Description of items in configuration form At the bottom of the configuration form is also available a list of connected meters with information about their settings. All changes will take effect after pressing the Apply button. Figure 2: Configuration form Protocol MODBUS-RTUMAP Manual 3 3.1 Adding and removing a measuring device 3.1 Adding and removing a measuring device Individual meters (measuring devices) can be removed from the list by clicking [Delete] item which is situated in front of the meter description. To add meter click on the [Add Meter] item. Before adding a meter, it is neccessary to enter Meter Address, Start Address, number of registers or coils (Number Of Values (Register or Coils)) and select Read Function (see the figure below). This way it is possible to add up to 10 devices. Figure 3: Adding a measuring device 3.2 Read and write functions The following figure describes functions that are used for reading and writing between PC, RTUMAP router app and meter. Functions 0x01 (read) and 0x0F (write) are intended only for coils. To be able to write some values to coils on MODBUS RTU device (by function 0x0F), set the read function in a meter declaration to function number 1. Figure 4: Read and write functions supported by the RTUMAP router app Protocol MODBUS-RTUMAP Manual 4 4. Related Documents You can obtain product-related documents on Engineering Portal at icr.advantech.cz address. To get your router's Quick Start Guide, User Manual, Configuration Manual, or Firmware go to the Router Models page, find the required model, and switch to the Manuals or Firmware tab, respectively. The Router Apps installation packages and manuals are available on the Router Apps page. For the Development Documents, go to the DevZone page. Protocol MODBUS-RTUMAP Manual 5