Adcon A850 User Manual

Adcon A850 User Manual

Telemetry gateway base station
Hide thumbs Also See for A850:
Table of Contents

Advertisement

Quick Links

Base Station
Telemetry Gateway A850

User Guide

valid for A850 firmware release 1.0
SMART WIRELESS SOLUTIONS

Advertisement

Table of Contents
loading

Summary of Contents for Adcon A850

  • Page 1: User Guide

    Base Station Telemetry Gateway A850 User Guide valid for A850 firmware release 1.0 SMART WIRELESS SOLUTIONS...
  • Page 2 Adcon Telemetry. This publication is intended only to assist the reader in the use of the product. Adcon Telemetry shall not be liable for any loss or damage arising from the use of any information in this publica- tion, or any error or omission in such information, or any incorrect use of the product.
  • Page 3: Table Of Contents

    CHAPTER Chapter 1. Introduction ________________________________________________ 13 Scope ________________________________________________________________ 13 Conventions ___________________________________________________________ 14 What is the A850 Telemetry Gateway? ____________________________________ 15 Adcon's Telemetry Network _____________________________________________ 18 What's new on the A850 ? _______________________________________________ 20 Chapter 2. System Setup _______________________________________________ 23 Package Contents ______________________________________________________ 23...
  • Page 4 CHAPTER Principles of GUI operation ______________________________________________ 40 The main window ____________________________________________________ 40 Commands on the Menu Bar __________________________________________ 41 File Commands ___________________________________________________ 41 File Login ______________________________________________________ 41 File Look and feel _______________________________________________ 42 File Exit ________________________________________________________ 43 Edit Undo ______________________________________________________ 43 Edit Redo ______________________________________________________ 44 Configuration Commands __________________________________________ 44 Configuration Refresh ____________________________________________ 44...
  • Page 5 CHAPTER Table view _______________________________________________________ 74 Popup Context Menu ________________________________________________ 75 Detail window_______________________________________________________ 77 Web Interface__________________________________________________________ 78 Home ______________________________________________________________ 78 Credits and Licenses _________________________________________________ 80 GPL________________________________________________________________ 80 LGPL_______________________________________________________________ 81 ASL ________________________________________________________________ 82 Tools_______________________________________________________________ 83 Debugging tools _________________________________________________ 85 Configuration tools _______________________________________________ 85 Firmware tools ___________________________________________________ 86...
  • Page 6 CHAPTER Chapter 3. Configuring the Gateway ____________________________________ 87 PPP Dialup __________________________________________________________ 89 Job scheduling ___________________________________________________ 93 Job status________________________________________________________ 95 Job dependent settings ___________________________________________ 95 Primary Account __________________________________________________ 96 Secondary Account _______________________________________________ 97 Dynamic DNS _______________________________________________________ 98 Job scheduling __________________________________________________ 101 Job status_______________________________________________________ 103 Job dependent settings __________________________________________ 103 Primary Server ___________________________________________________ 104...
  • Page 7 CHAPTER Device parameter________________________________________________ 137 Modem status___________________________________________________ 138 Radio parameter_________________________________________________ 139 Modem-Type dependent settings__________________________________ 140 GPRS Modems _____________________________________________________ 141 Configuration ___________________________________________________ 144 State ___________________________________________________________ 144 Users _____________________________________________________________ 145 Configuration ___________________________________________________ 148 State ___________________________________________________________ 149 Operating System __________________________________________________ 150 Flush interval____________________________________________________ 152 Notifications ____________________________________________________ 152 Last times events ________________________________________________ 153 Networking ________________________________________________________ 153...
  • Page 8 CHAPTER Sensor Type Configuration ______________________________________________ 170 Adding Custom Sensors _____________________________________________ 170 Sensor Tables ______________________________________________________ 171 Sensor Types _______________________________________________________ 174 Analog sensor types ________________________________________________ 176 Common settings ________________________________________________ 178 Analog sensor settings ___________________________________________ 179 Analog sensor sampling methods __________________________________ 180 Conversion settings ______________________________________________ 181 Counter sensor types________________________________________________ 182 Common settings ________________________________________________ 184 Conversion settings ______________________________________________ 185...
  • Page 9 CHAPTER Logs _________________________________________________________________ 211 Call Journal ________________________________________________________ 212 Poll Journal ________________________________________________________ 213 System Log ________________________________________________________ 214 Log types_______________________________________________________ 215 Log types Buttons _______________________________________________ 216 System Log Windows ____________________________________________ 217 System log Buttons ______________________________________________ 217...
  • Page 10 CHAPTER RTU Network Configuration _____________________________________________ 218 Definition of RTU Groups ____________________________________________ 218 Definition of RTUs __________________________________________________ 222 RTU Context Menu _______________________________________________ 222 RTU Configuration __________________________________________________ 225 RTU - Data ______________________________________________________ 226 RTU - State Information ___________________________________________ 232 RTU - Routing ___________________________________________________ 237 RTU Administration _________________________________________________ 241 Copy RTU _______________________________________________________ 242 Replace RTU ____________________________________________________ 244...
  • Page 11 CHAPTER Newest slot _____________________________________________________ 278 Requests _______________________________________________________ 279 Replace sensor _____________________________________________________ 280 Chapter 5. Console Commands ________________________________________ 283 Establishing Console Connection________________________________________ 284 Console Commands details_____________________________________________ 292 Console Login _____________________________________________________ 293 Upgrade the gateway _______________________________________________ 296 Configuration ______________________________________________________ 298 Configuration Quick setup ________________________________________ 298 Configuration Expert setup _______________________________________ 300 Backup the Gateway Configuration ________________________________ 302 Restore the gateway configuration _________________________________ 305...
  • Page 12 CHAPTER Third-party Software ___________________________________________________ 321 hermit 1.2 - ARM bootloader ______________________________________ 321 linux 2.4 - Operating system kernel_________________________________ 321 glibc 2.1.6 - GNU C Library________________________________________ 322 zlib - General purpose compression library __________________________ 322 expat - XML parser library _________________________________________ 322 libmodem - Modem handling library _______________________________ 322 md5 - Message digest algorithm ___________________________________ 323 ghttpd - GazTek HTTP daemon ____________________________________ 323...
  • Page 13: Chapter 1. Introduction

    Scope Chapter 1. Introduction Scope This manual describes the A850 Telemetry Gateway and its use as a Base Station of an Adcon Telemetry Network. Aside of the pro- prietary Base Station configuration consisting in an A850 Teleme- try Gateway combined with an A440 Wireless Modem (“Adcon Wireless Telemetry Network”), also Base Station configurations...
  • Page 14: Conventions

    CHAPTER 1 Introduction Conventions The following conventions apply to this documentation: Italics Indicates that the text formatted that way represents a variable which must be substituted for something spe- cific, in accordance with an appropriate explanation. Otherwise, Italics can also be used just to emphasize certain words or letters.
  • Page 15: What Is The A850 Telemetry Gateway

    What is the A850 Telemetry Gateway? The A850 Telemetry Gateway is a low-power, battery-backed device that acts as an interface between an Adcon Telemetry Net- work and one or more hosts running addVANTAGE or similar data acquisition software. The capabilities of the A850 allow to manage up to 1000 Adcon RTUs (Remote Telemetry Units), depending on the version used.
  • Page 16 CHAPTER 1 Introduction The forwarding of the data from the A850 to the data assessment PC is achieved either through • Ethernet or • Telephone Modem. For data communication from and to an A850, private (LAN, VPN) or public means for data communications (e.g. the Internet) can be used.
  • Page 17 This manual is valid only for release 1.0 of the Gateway's firmware. You can verify that you have the appropriate firmware by logging onto the web page of the A850 via your internet browser. The following should be displayed on the bottom of the web page of the A850: Release 1.0, ©...
  • Page 18: Adcon's Telemetry Network

    CHAPTER 1 Introduction Adcon's Telemetry Network The A850 represents the link between the various RTUs and the PC(s) used for evaluating the sensor data and for transmitting con- trol commands, respectively. Figure 1. Schematics of a Remote Telemetry Network To build a Remote Telemetry Network you need the following: •...
  • Page 19 CHAPTER 1 Adcon's Telemetry Network • an A850 Base Station, • data acquisition and control software, such as Adcon's addVANTAGE Pro 5 software, • appropriate means of communications to access your Remote Telemetry Units, e.g. an Adcon Wireless Modem A440 or other means of communications, depending on the types of RTUs you are using.
  • Page 20: What's New On The A850

    CHAPTER 1 Introduction What's new on the A850 ? The A850 is the successor of the well proven A840 Gateway and offers the following new features: • USB device support : USB based devices are supported as long as they conform to the USB standards for the storage or communication device classes.
  • Page 21 DNS services, such as DynDNS (this requires that the A850 gets an official IP address accessible over the internet after connecting to an ISP. If the A850 is installed in a private network behind a NAT router, dynamic DNS is not guaranteed to work), •...
  • Page 22 User interface: All interactions between the user and the A850 (configuration, monitoring, diagnostics, ...) are done by a JAVA based Graphical User Interface (GUI). Note: An A440 device connected to an A850 must have firmware revision 3.0.0 or newer. CAUTION The A850 do not support addVANTAGE 3.x software...
  • Page 23: Chapter 2. System Setup

    Chapter 2. System Setup Package Contents Before proceeding to the installation of your Base Station, first ver- ify that you have received all of the following components: • the A850 Telemetry Gateway, • a power cord, • a serial null modem cable, •...
  • Page 24: Elements On A850

    Elements on A850 LED Indicator LEDs and LED patterns The device has three LEDs which are forced on during a CPU reset and during the boot process. Figure 2. Front of the A850 Table 1. LED pattern Blinking Blinking Blinking...
  • Page 25: Connectors

    (Linux) operating system kernel. The PWR and RUN LEDs are on and the USR LED is off while the A850 is initialized (the CF card is checked, the configuration is loaded and various services are started). The activity LED flashes for 0.1 seconds if there is an RTU com- mand sent or if the answer is received.
  • Page 26: Modem

    First, in a Wireless (Radio) Network, it is essential to realize the importance of selecting a good location for the trans- ceiver and, as the admissible distance between the transceiver and the Gateway is limited, for the complete Base Station. If the A850...
  • Page 27 Adcon Wireless Modem(s) A440, the Base Station configuration will consist in an indoor unit (the A850) and one (or several) outdoor unit(s), the A440(s). You must consider several factors, some of them quite contradictory, when choosing the location: •...
  • Page 28 CHAPTER 2 System Setup the earth, on flat terrain, the maximum distance which can be reached depends on the height above ground of the antennas of the transceivers of the Base Station and of the measuring stations. You can't do much on the remote station side, but you have more options with the Base Station.
  • Page 29: Installing The Outdoor Unit

    CHAPTER 2 Installation Note: The cable for the outdoor unit delivered with the system is by default 30 m (about 100 ft) long. If necessary, however, you can increase the distance between your indoor and your outdoor unit up to 90 m by using special low-attenuation cables which can be provided upon request by Adcon.
  • Page 30 Secure the mast in its place on the roof. Run the cable to the indoor unit. Note: The cable supplied to connect the outdoor unit to the A850 Telemetry Gateway is 30 m long and cannot be extended, but special low-attenuation cables with a total length of up to 90 m can be provided upon request by Adcon.
  • Page 31: Installing The Indoor Unit

    Also, damage to the Modem could result from inappropriate cable impedance. Installing the indoor unit The indoor unit is the Telemetry Gateway A850. Connect the cables to the Gateway as shown in Figure 5. Figure 5. Indoor Unit Installation...
  • Page 32: Initialize The Base Station

    Initialize the Base Station In order to be able to use your A850 Telemetry Gateway for the first time, you have to initialize it through its Console Interface by means of the Terminal emulation program Hyperterm (as, e.g., pro- vided by WINDOWS operating systems as accessory, and also available for download from the internet).
  • Page 33: Connecting To The Gui

    Graphical User Interface (GUI) of the configurator of the A850 which offers advanced support and extremely user-friendly handling. The connection of a PC to the GUI of the A850 is estab- lished through HTTP/HTTPS via the Web Browser. In order to...
  • Page 34 Figure 6. Web Browser Icon The next step to enable the communication between your PC and the A850 is the input of the IP address in the web browser which you have settled as the IP address of your A850 in the Console Command Setup (see Chapter 5).
  • Page 35 If you have not generated a HTTPS certificate, you have to put in http://IP address/in order to initiate the communication. In any case, the internal Web Page of the A850 will appear. Note: For security reasons, it is strongly recommended that you always use an HTTPS connection if you communicate via internet.
  • Page 36 CHAPTER 2 System Setup Figure 9. A850 Web Site via HTTPS with Valid Certificate As you can see in Fig. 9, a closed keylock appears in the address line of the browser if you connect your Gateway through a secure HTTPS link.
  • Page 37 Configurator can be loaded and opened by clicking the button Figure 10. Start A850 Configurator The click on this button starts the download of the A850 Configu- rator to your workstation (if it does not yet exist there) and starts it.
  • Page 38: Login Procedure

    At this point, you have to fill in the User Name and the Password for logging in. The host is already predefined with the address and the type of communication, in analogy to the A850 web site. Note: For security reasons, if you are working via internet, you should always choose a HTTPS connection for logging into the Configurator.
  • Page 39 A850 connected. After putting in the proper Login data and clicking the Login but- ton, it will just take a little time until the GUI of the Configurator of the A850 will appear: Figure 14. Main Window of the A850 Configurator...
  • Page 40: Principles Of Gui Operation

    IP address which has been set. The IP address rep- resented in the header may differ from the address used as input in the internet browser: this is the case if the A850 is placed in a LAN behind an internet gateway (not an Adcon component). Please contact your Network administator for setting up the internet gate- way.
  • Page 41: Commands On The Menu Bar

    A850 with an “update” command. This means that you can prepare details of the configuration of your A850 in a convenient way on your PC away from your A850 which may even work at the same time in another configuration.
  • Page 42: File Look And Feel

    CHAPTER 2 System Setup File Look and feel “Look and feel” allows you to change the looks of your GUI win- dows. You can select the aspect variant “Windows” which assumes, automatically, the colors, symbols and other design fea- tures of your PC’s MS WINDOWS display design (as selected by you individually) Figure 17.
  • Page 43: File Exit

    Figure 19. Exit Menu Item If you have made changes on the settings which have not been saved in the A850 yet, you will be asked for safety reasons if you would really like to exit without saving your changes.
  • Page 44: Edit Redo

    Configuration Refresh The “Refresh” command fetches the current configuration from the A850 Gateway to the PC running the GUI, overwriting configu- ration data used on the PC up to that moment. The user must answer the question if he wants to discard any changes or cancel the action.
  • Page 45: Configuration Lock Lock Gateway

    CHAPTER 2 Principles of GUI operation Figure 22. Refresh Menu Item Configuration Lock Lock Gateway This command locks the Gateway for other users to perform con- figuration changes. The user is granted a requested lock if no other user has been locking the Gateway configuration before.
  • Page 46: Configuration Lock Show Lock

    CHAPTER 2 System Setup To let other users know who locked the A850 and to enable them to contact this user if necessary, the lockholder is obliged to enter his phone number and email address. The information about the lockholder is displayed if you select “Show Lock State”.
  • Page 47: Configuration Update

    Configuration Update The “Update” command writes the changes done by the configu- ration user to the A850 Gateway. To be able to update the config- uration, the user must be the holder of the current lock of the Gateway. The function is only available using the configuration GUI in the Online mode.
  • Page 48 After choosing “Update”, you will be asked first if you are sure that you want to commit all changes (Fig. 27). In order to confirm, cklick “Yes” and the data will be transferred from the GUI to the A850. WARNING If you confirm by clicking “Yes”, the data having been...
  • Page 49: Configuration Restore

    Configuration Restore The command “Restore” allows you to reload data from the A850 saved by the command “Backup” on your PC again into the A850 if you want to reestablish a certain state of the A850. Figure 31. Restore Selection...
  • Page 50 CHAPTER 2 System Setup In order to be able to replay data again into your A850 by using the command “Restore”, you have to choose the appropriate file on your PC by “Select” and then to click “OK”. Figure 32. Restore File Name Selection Then, you have to confirm that you want to replay the data into your A850.
  • Page 51: Configuration Load

    Configuration Load The “Load” command reads a file previously saved by the “Save” function and loads it into the RAM of the PC running the A850 configuration GUI. This function is also available using the configu- ration GUI in the Offline mode.
  • Page 52 CHAPTER 2 System Setup For resuming the parameters in the A850 which have been loaded that way, the user “root” has to give first the com- mand “Login” and consecutively the command “Update”. Figure 36. Load Selection For replaying data into your GUI by using the command “Load”, you have to choose the desired file on your PC by the command “Select”...
  • Page 53: Tools Commands

    This command retrieves the current license information from the A850 Gateway. Figure 38. Show License Selection If an additional license has been installed on your A850, it will be displayed in this window: Figure 39. Show License Window Note: If there is no special license on the Gateway, the License...
  • Page 54: Tools License Set License

    CHAPTER 2 System Setup Tools License Set License This command supports the update of the license of the A850 Gateway. Figure 40. Set License Selection “Set license” allows you to enter additional licenses for special purposes by input of the license key provided by Adcon as well as by input of the license signature.
  • Page 55 CHAPTER 2 Principles of GUI operation job to be started can be one of the names “ntp update” or “dyndns update”, “send ntf” “ppp dialup”, and “ssh tunnel” . Figure 42. Start Job Selection The following window allows you to select the job that you want to start, Figure 43.
  • Page 56: Tools Job Stop Job

    CHAPTER 2 System Setup Tools Job Stop Job This command allows stopping jobs manually which have been started automatically by the “job scheduling” in their repective detail windows or which have been started manually. The job to be stopped can bear one of the names “ntp update” or “dyndns update”, “send ntf”...
  • Page 57: Tools Time Configuration

    Figure 48. Time Configuration Selection The Time Configuration window can be used to read the actual system time of the A850 and to correct it if necessary. Figure 49. Time Configuration Window After having corrected the time as appropriate, you will have to click first “Set time”...
  • Page 58: Tools Communication Direct Commands

    CHAPTER 2 System Setup Tools Communication Direct Commands For RTUs and Wireless Modems, this command allows the user to initiate radio commands to the respective receiver and effectuates the responses to be displayed. The user must have the “direct” access right to the RTU for being able to use this function. Each command is initiated by sending a “direct”...
  • Page 59 CHAPTER 2 Principles of GUI operation Figure 51. Direct Commands Selection for Wireless Modem Direct commands can be sent also to a separate RTU. To do this, you have to choose the corresponding RTU in the “Table view” and to mark it with the mouse before selecting “Direct com- mands”.
  • Page 60 CHAPTER 2 System Setup Figure 52. Direct Commands Selection for single RTU For sending a command to a Wireless Modem or to a RTU, enter the corresponding “Direct command” in the nether window part and click the “Send” button. This will cause the the command to be sent to the respective device whose feedback will be received.
  • Page 61 CHAPTER 2 Principles of GUI operation Figure 53. Direct Command Window For tracking the commands already sent, click the button “Hist” (history). This will result in list of the sent commands to be dis- played in a new window.
  • Page 62: Tools Communication Broadcast

    Wireless Network. If the command “Radio Broadcast” is sent, all RTUs receiving this broadcast will send a feedback. Thus, sending a broadcast allows to find out which RTUs communicate actively with the A850 via the connected Wireless Modems.
  • Page 63 CHAPTER 2 Principles of GUI operation Figure 55. Broadcast Selection The RTUs which did respond to the broadcast will be displayed thereafter in a list in the Remote broadcast window.
  • Page 64 CHAPTER 2 System Setup Figure 56. Broadcast Window By clicking the button “Update”, another broadcast is initiated so that changes (admissions or outages of RTUs, respectively) will be displayed.
  • Page 65: Tools Save System State

    Principles of GUI operation Figure 57. Broadcast Window Update Tools Save System State The “Save System State” function is very useful to debug the A850 if any error or problem occurs. This command opens the interfaces to specify the data to be stored.
  • Page 66 CHAPTER 2 System Setup Figure 58. Save System State Selection The following data can be selected in the check boxes for saving: “local logfiles”, “modems configuration”, “last backup file” and “user settings”. By default, all data are checked for saving. The local log files of the activities will be stored on the selected place.
  • Page 67: Tools Search

    CHAPTER 2 Principles of GUI operation Figure 59. Save System State Window Tools Search Opens the “Extended Search interface” which allows to specify and to submit queries for retrieving a subset of RTU and sensor objects. Figure 60. Search Selection...
  • Page 68 CHAPTER 2 System Setup In the Search window, RTUs can be searched for according to cer- tain selectable criteria and logical interconnections. In doing so, also complex search queries can be created. Figure 61. Search Window In order to allow more complex queries to be used again in the future, query dialogues can be saved by clicking the button “Save query”...
  • Page 69: Tools Settings

    CHAPTER 2 Principles of GUI operation Figure 62. Search Window Tools Settings By the use of Settings, certain parameters determining the amount of commands and loggings to be held in the GUI can be set up; as soon as the limit of the specified amount is exceeded, an appropri- ate amount of the oldest saved information will be deleted.
  • Page 70 CHAPTER 2 System Setup Figure 63. Settings Selection "Settings” - “Direct commands" allows you to set up the number of commands to be held by history (which is necessary to be able to make use of the “Undo” command) and the number of lines dis- played by the output field (for printing).
  • Page 71: Commands On Tool Bar

    CHAPTER 2 Principles of GUI operation Figure 65. Settings Logging Window Commands on Tool Bar The main window of the Configuration User Interface has a config- urable toolbar to shortcut menu selections. Figure 66. Tool Bar Each user can select his own subset of buttons to be shown out of a predefined list of available toolbar buttons.
  • Page 72: Backup

    CHAPTER 2 System Setup Figure 67. Customize Tool Bar There are some predefined tool bar elements: Backup see Configuration Backup Restore see Configuration Restore Load see Configuration Load Save see Configuration Save Undo see Edit Backup Search see Tools Backup...
  • Page 73: Main Window Views

    CHAPTER 2 Principles of GUI operation Main Window views The main window of the A850 configuration GUI consists of the following components: • Tree view providing access to all the objects to be configured of the actual configuration, • Table view with a configurable column display to provide...
  • Page 74: Table View

    CHAPTER 2 System Setup Figure 68. Tree view Table view The right part of the main window contains a table representation of data. The data shown depends on the selection of one or more nodes in the tree view. The table view is a preview of the objects displayed to support a quick selection of objects to be worked on.
  • Page 75: Popup Context Menu

    CHAPTER 2 Principles of GUI operation Figure 69. Table view Popup Context Menu For each object represented as row in the table view or as node in the tree view, a popup context menu can be activated by clicking the right mouse button when the object is selected. In the popup context menu, the commands applicable in each case to the object or list entry, respectively, are provided.
  • Page 76 CHAPTER 2 System Setup Note: If you have the right to carry out changes at the A850, the command “Edit” is available; otherwise, the command “View” will be provided instead. • Menu items “Undo” or “Redo” - initiate the “Undo” or “Redo”...
  • Page 77: Detail Window

    CHAPTER 2 Principles of GUI operation Figure 71. Extended Popup Context Menu for RTUs Detail window For each class of configurable objects, a detail window provides the detailed view on a specific object. It is used to enter the data of a newly created object or to change the attributes of an existing object.
  • Page 78: Web Interface

    Note: The Detail windows are described in the following chapters “Configuring the Gateway” and “Using the Gateway”. Web Interface The web interface allows you to communicate with your A850 via a web browser. The A850 provides the following web pages: Home The web page “Home”, the front page of Adcon's Telemetry...
  • Page 79 • The link “Configurator”, the hyperlink “configure your Gateway” and the button “Start Configurator”, allowing you to start the A850 GUI as described in chapter 3 and 4, • “Adcon's web site”, a hyperlink forwarding you to the official homepage of Adcon where you can retrieve other information about Adcon products, •...
  • Page 80: Credits And Licenses

    In Credits and Licenses, the general license information forming the basis of the software will be given to you: Figure 74. A850 Credits and Licenses Web Page The web page GPL shows you the GPL license information forming the basis of the software:...
  • Page 81: Lgpl

    CHAPTER 2 Web Interface Figure 75. A850 GPL Web Page LGPL The web page LGPL shows you the LGPL license information underlying the software:...
  • Page 82: Asl

    CHAPTER 2 System Setup Figure 76. A850 LGPL Web Page The web page ASL shows you the ASL license information forming the basis of the software:...
  • Page 83: Tools

    CHAPTER 2 Web Interface Figure 77. A850 ASL Web Page Tools The web page “Tools” provides you support for debugging or for using, respectively, your A850:...
  • Page 84 CHAPTER 2 System Setup Figure 78. A850 Tools Web Page This website offers to you access to • Debugging tools, • Configuration tools and • Firmware tools.
  • Page 85: Debugging Tools

    “View important debugging information” allows you in case of possible problems to retrieve the most important information about the status of your A850 and to get it displayed via your web browser. Note: In order to be able to use the “Debugging tools”, you have to login as system administrator (user “root”) or as user...
  • Page 86: Firmware Tools

    “reboot”, after that, the list of uploaded images will be erased again. • “Upload an A850 firmware image stored as local file”: load an actual version of the firmware image in your A850, Note: Perform an upgrade only if you have problems with your A850 or if an upgrade is recommended by Adcon, respec- tively.
  • Page 87: Chapter 3. Configuring The Gateway

    • Login as system administrator (user “root”) as already explained in chapter 2, “Connecting to the GUI” (Fig. 13, “Login”). After the login, the main window of the A850 Configurator (Fig. 14) appears. • Lock the Gateway by “Lock Gateway” as already explained in chapter 2, “Commands on the Menu Bar”, Figs.
  • Page 88 CHAPTER 3 Configuring the Gateway Figure 79. System Configuration List Window The left part of the system configuration list shows the tree struc- ture (“Tree view”) of the system configuration while the right part displays the respective corresponding table (“Table view”) of the marked item.
  • Page 89: Ppp Dialup

    CHAPTER 3 The system configuration settings encompass: • PPP (Point-to-Point Protocol) Dialup - management of the PPP internet connection, • Dynamic DNS (Domain Name System) - management of your host name in the DNS to convert host names into affiliated IP (Internet Protocol) addresses in cases where the IP address is not static, •...
  • Page 90 CHAPTER 3 Configuring the Gateway The A850 supports two dial-up peer configurations: a primary which is tried first and a secondary which is only used if the primary connection can't be established. A secondary configuration is not required as a matter of principle, but as it enhances the redun- dancy of your network, it is recommended to make use of this practical feature.
  • Page 91 CHAPTER 3 Note: The greyed-out choices “New” and “Delete” are not avail- able in this context. The choice “Edit” ist only available if the Gateway is locked while “View” is only available if the Gateway is unlocked. Note: Menu items “Undo” or “Redo”: see “Popup Context Menu” in chapter 2.
  • Page 92 CHAPTER 3 Configuring the Gateway Figure 81. PPP Configuration Window...
  • Page 93: Job Scheduling

    The following window areas are provided in the window “PPP Configuration”: • Job scheduling: allows to define a time schedule (“Mode”) to determine when the A850 has to establish a PPP connection to the internet; • Job status: allows to get the information when the last PPP...
  • Page 94 CHAPTER 3 Configuring the Gateway Figure 83. PPP Configuration - Job scheduling - Mode Note: The job scheduling layed down can be oversteered by the commands ”Start Job” or “Stop Job” according to Fig. 43 or 46, respectively. • Mode - in this combo box, the time of establishment of a PPP connection is determined, featuring the following selections: •...
  • Page 95: Job Status

    CHAPTER 3 • times - to force an internet connection to be etablished at specific times: Figure 85. PPP Configuration - Job scheduling - Mode - Times Job status “Job status” allows you to check the time and the result of the last PPP network connection set-up:.
  • Page 96: Primary Account

    CHAPTER 3 Configuring the Gateway Figure 87. PPP Configuration - Job dependent settings • notify on success - if the checkbox “notify on success” is marked, a “PPP network connection success message” will be sent in case of successful connection. Primary Account Allows you to enter the following access data to your ISP or PPP server for the Primary Account:...
  • Page 97: Secondary Account

    CHAPTER 3 • Idle timeout [s] - allows you to determine after which period of inactivity the connection to your ISP or PPP server shall be terminated; • IP addr. local - allows you to enter a local IP address for your PPP connection;...
  • Page 98: Dynamic Dns

    A850, as long as the following preconditions are met: • If the A850 is directly connected to the ISP, it must get an official static or dynamic IP address assigned by the ISP; • If the A850 is acting behind a NAT (Network Address Translation) router, the NAT router must get an official static IP address assigned by the ISP;...
  • Page 99 CHAPTER 3 Figure 90. Dynamic DNS Selection The context menu for Dynamic DNS gives you the following options: • “Edit” - to define the Dynamic DNS Update configuration; • “Print item” - to display the defined Dynamic DNS Update configuration in a form formatted for the printer which can be printed from there on your default printer.
  • Page 100 CHAPTER 3 Configuring the Gateway Double-clicking the Dynamic DNS selected in the "Table view" allows you to check the selected Dynamic DNS configuration. Figure 91. Dynamic DNS Update Window The window “Dynamic DNS Update” provides the following win- dow areas:...
  • Page 101: Job Scheduling

    CHAPTER 3 • Job scheduling - allows to define a time schedule (“Mode”) to which time the A850 has to perform a Dynamic DNS Update; • Job status - for information at which time the last Dynamic DNS Update has been performed and with which success, as well as at which time the next update is planned;...
  • Page 102 CHAPTER 3 Configuring the Gateway Figure 93. Dynamic DNS Update - Job scheduling - Mode • Mode - in this combo box, it will be determined in detail how the Dynamic DNS Update is to be performed, offering the following selections: •...
  • Page 103: Job Status

    CHAPTER 3 Figure 95. Dynamic DNS Update - Mode - Times Job status “Job status” allows you to check the time and the result of the last dynamic DNS server connection: Figure 96. Dynamic DNS Update - Job status • Last run - displays the point in time when the last contact with the DNS server was established;...
  • Page 104: Primary Server

    • Host name - allows you to determine which internet name (host name) should be assigned to your A850 by the DNS server. Note: If your ISP assigns dynamic IP addresses, you have to enter “0.0.0.0” in the fields “IP addr. local”, “remote” and “Net-...
  • Page 105: Secondary Server

    SSH Tunnel The SSH tunneling enables other hosts on the internet to connect to the A850 by using a SSH server as a proxy, even if the A850 has no official IP address or cannot be directly reached from the inter- net, as long as the following preconditions are met: •...
  • Page 106 CHAPTER 3 Configuring the Gateway Figure 100. SSH Tunnel Selection The context menu for SSH tunnel allows you to: • determine the SSH tunnel configuration by “New” or “Edit”, • see a print preview of the determined SSH tunnel configuration in a formsheet processed for the printer and start the printout on your default printer by “Print item”.
  • Page 107 CHAPTER 3 Figure 101. SSH Tunnel Window The following window areas are available through the “SSH tun- nel”window :...
  • Page 108: Job Scheduling

    Configuring the Gateway • Job scheduling - allows to define a time schedule (“Mode”) to which time the A850 has to perform a SSH tunneling; • Job status - for information at which time the last SSH tunneling has been performed and with which success, as well as at which time the next SSH tunnelling is planned;...
  • Page 109 CHAPTER 3 Figure 103. SSH Tunnel - Job scheduling - Mode • Mode - This combo box is used for determining details of the SSH tunnelling; the following selections are offered: • dhcp reconfig - a SSH tunnelling has to be performed after changes of dhcp settings made in the tree window “Networking”;...
  • Page 110: Job Status

    CHAPTER 3 Configuring the Gateway Figure 105. SSH Tunnel - Job scheduling - Mode - Times Job status “Job status” allows you to check the time and the result of the last SSH tunnel connection: Figure 106. SSH Tunnel - Job status •...
  • Page 111: Primary Server

    CHAPTER 3 Figure 107. SSH Tunnel - Job dependent settings If the checkbox “notify on success” is marked, a “SSH tunnel con- nection success message” will be sent in case of successful SSH tunnel connection. Primary Server Allows you to define the access data for the SSH tunnel Primary server: Figure 108.
  • Page 112: Secondary Server

    ISP). These noti- fications are queued and sent to the notification server. The A850 supports sending notifications to servers using HTTP, SMS and SMTP (E-Mail) over a primary and a secondary server for each of these methods. The primary server is tried first, the sec- ondary only when the primary server couldn't be contacted.
  • Page 113 CHAPTER 3 Figure 110. Notification Sending Selection The context menu for notification sending selection allows you to: • determine the notification sending configuration by “Edit”, • see a print preview of the determined notification sending configuration in a formsheet processed for the printer and start the printout on your default printer by “Print item”.
  • Page 114 CHAPTER 3 Configuring the Gateway The selected notification sending configuration can be checked by double-clicking the notification sending configuration in the "Table view". Figure 111. Send NTF Detail Window The notification sending window (“Send NTF Detail”) provides the following window areas:...
  • Page 115: Job Scheduling

    CHAPTER 3 • Job scheduling - allows to define a time schedule (“Mode”) to which time the A850 has to perform a notification sending; • Job status - for information at which time the last notification sending has been performed and with which success, as well as at which time the next update is planned;...
  • Page 116 CHAPTER 3 Configuring the Gateway • Mode - This combo box is used for determining details of notification sending; the following selections are offered: • dhcp reconfig - a notification sending has to be performed after changes of dhcp settings made in the tree window “Networking”;...
  • Page 117: Job Status

    HTTP to a notification server (e.g. Advantage Server), by SMS to a cellular phone or via a SMTP server to an E-mail address; Note: To send notifications as SMS messages, an external GSM modem must be connected to the A850!
  • Page 118 CHAPTER 3 Configuring the Gateway Figure 118. Method selection • Format - allows to select the format in which notifications are sent; notifications can be sent in formats “path”, “short” or “name”. The format specifies how the sender of the notification is identified in the E-mail/SMS/HTTP request: •...
  • Page 119: Secondary Server

    The A850 supports acting as both NTP server (provides the system time to other NTP Clients) and NTP client (fetches the system time from a NTP Server). It supports both permanent and dial-up net- working connections to the NTP servers.
  • Page 120 CHAPTER 3 Configuring the Gateway The primary server is tried first, the secondary only if the primary server couldn't be contacted. Figure 121. NTP Selection The context menu “NTP” allows you to: • modify the Network Time Protocol configuration by “Edit”, •...
  • Page 121 CHAPTER 3 Note: Menu items “Undo” or “Redo”: see “Popup Context Menu” in chapter 2. Double-clicking the Network Time Protocol in the "Table view" allows you to check the selected Network Time Protocol configura- tion. Figure 122. NTP Detail Window The “NTP Detail”...
  • Page 122: Job Scheduling

    Configuring the Gateway • Job scheduling - allows to define a time schedule (“Mode”) to which time the A850 has to perform a time synchronization as client and/or server; • Job status - for information at which time the last time...
  • Page 123 CHAPTER 3 Figure 124. NTP Detail - Job scheduling - Mode • dhcp reconfig - a time synchronization has to be performed after changes of dhcp settings made in the tree window “Networking”; Note: The input of time and date (in local time) is made in Tools Commands - Time Configuration described in chapter 2.
  • Page 124: Job Status

    CHAPTER 3 Configuring the Gateway Figure 126. NTP Detail - Job scheduling - Mode - Times Job status “Job status” allows you to check the time and the result of the last time synchronization: Figure 127. NTP Detail - Job status •...
  • Page 125: Primary Server

    CHAPTER 3 Figure 128. NTP Detail - Job dependent settings • Broadcast enabled - if this checkbox is marked, the A850 will broadcast time messages allowing all listening clients to time- synchronize to these messages; • Clients enabled - if this checkbox is marked, clients are allowed to send time requests for getting time messages (in this case, the A850 acts as NTP server);...
  • Page 126: Dialup Modem

    Dialup Modem “Dialup Modem” allows to establish a connection between your A850 and the Internet as well as with your RTUs and with your server on which you run the Adcon Advantage software (for more details, check your ADCON Advantage manual), as far as these system components are not connected via the LAN.
  • Page 127 • Job dependent settings - allow to determine if you admit or not that SMS may be sent, that dialing in into your A850 may also take place, and that also PPP dialup connections may be used;...
  • Page 128 CHAPTER 3 Configuring the Gateway Figure 132. Dialup Modem Window...
  • Page 129: Dialup Parameter

    Device - as a modem can either be connected to the serial modem connector or to one of the two USB connectors of the A850 or indirectly to an USB connector of the A850 via an USH hub, the respective connector is to be selected here: Figure 134.
  • Page 130: Dialup Parameter

    CHAPTER 3 Configuring the Gateway each phone number); if your modem is connected directly to the trunk line, this field is to be left empty; • Initial command - enter here which is required by your modem. As default, ATZ is set; if your modem needs another initialization sequence, please inform yourself about it by consulting the manual of your modem;...
  • Page 131: Dialup Status

    CHAPTER 3 • Log all polls - allows you to determine if you want your dialup requests to be registered in the Logs. Dialup status Figure 136. Dialup modem - Dialup status Provides information about the status of the dialup connection: •...
  • Page 132: Ppp Parameter

    Configuring the Gateway Figure 138. Dialup modem - PPP parameter • Local IP address - enter the IP address your A850 has to use for the PPP connection; • Remote IP address - enter the IP address the remote station has to use for the PPP connection;...
  • Page 133 CHAPTER 3 • A740. Figure 139. Wireless Modem Selection The choices offered by the “Wireless Modem Selection” context menu are: • “New” - allowing to add a new Wireless Modem and to define the configuration (this feature is currently not yet available);...
  • Page 134 CHAPTER 3 Configuring the Gateway • “Connect sensors” - if internal sensors (e.g. for measuring voltage, temperature etc.) are built in into the A440, you can enter here the respective information (see chapter 4, “Logs”); • “Call journal” - The call journal contains a list of the last outgoing phone calls (see chapter 4, “Logs”);...
  • Page 135 CHAPTER 3 The following selections, entries or displays, respectively, are pro- vided in the “Wireless Modem Window”: Figure 140. Wireless Modem Window • Device Parameter - for entering information concerning the Wireless Modem; • Modem status - to achieve information about the status of the wireless connection;...
  • Page 136: Device Parameter

    CHAPTER 3 Configuring the Gateway nite reasons to determine other parameters (e.g., another radio frequency for the communication with your RTUs). • Modem-Type dependent settings - allow to determine if notifications or logging, respectively, should take place, to define the interval for slots (the slot interval specifies how often internal sensor values are stored) and to define ping intervals (a ping is an action which is intended to reveal the arrival time of a message from one computer to another).
  • Page 137: Modem Status

    • Version - allows to display the version number of your Wireless Modem Note: For being suitable for the operation with the A850, the A440 has to be at least of “Version 2.0”. Modem status Figure 143. Wireless Modem - Modem status The “Wireless Modem Status”...
  • Page 138: Radio Parameter

    CHAPTER 3 Configuring the Gateway Radio parameter Figure 144. Wireless Modem - Radio parameter The following radio parameters of the Wireless Modem are to be set here: • Code - enter the code by which your Wireless Modem can be addressed.
  • Page 139: Modem-Type Dependent Settings

    • Node ID - allows to define or to modify a node ID for the Wireless Modem; Note: The node ID is always assigned automatically by the A850, but can be changed by the field “Node ID”. • First sensor index - displays the index of the first sensor connected to the Wireless Modem.
  • Page 140: Gprs Modems

    GPRS Modems In case of a GPRS modem, there is no real hardware installed on the A850. Instead, the gateway listens on a specified port for TCP connections from GPRS based RTUs, leaving the interfacing between GPRS and the TCP network to the GPRS phone providers.
  • Page 141: Gprs Modems

    CHAPTER 3 Figure 146. GPRS Modem Selection The “GPRS Modems” context menu offers the following choices: • “New” - allowing to add a new GPRS modem and to define the configuration (this feature is currently not yet available); • “Edit” - allowing to define a GPRS modem configuration; •...
  • Page 142 CHAPTER 3 Configuring the Gateway • Print item” - see a print preview of the determined GPRS modem configuration in a formsheet processed for the printer and start the printout on your default printer. Note: Menu items “Undo” or “Redo”: see “Popup Context Menu” in chapter 2.
  • Page 143: Configuration

    • Remote ports - allows you to determine the modem ports on the SSH servers if the A850 can be reached from the internet through an SSH tunnel; • Log all calls - allows you to determine if you want your dialup calls to be registered in the Logs;...
  • Page 144: Users

    CHAPTER 3 Configuring the Gateway Users “Users” allows to define all users intended to work with your A850. Figure 150. Users Selection The A850 will support up to 100 users with different user permis- sions: • one “system administrator” (user “root”) who is granted the rights to configure the A850 hardware;...
  • Page 145 CHAPTER 3 Note: In the course of the console dialogue within expert setup, for the purpose of giving an example in this manual, a user “adv” has been set up as first “user administrator”; • multiple “ordinary users” which may query and configure only RTUs and sensors for which they have access permissions.
  • Page 146 CHAPTER 3 Configuring the Gateway Figure 151. User detail Window The following window areas are provided in the “User Detail” win- dow: • Configuration - for entering the information of the account, e.g. the login name as well as the password; •...
  • Page 147: Configuration

    Note: The user type of the system administrator (“root”) cannot be changed. The user “root” can also not be deleted; it is pos- sible to work with an A850 where only the user “root” is installed as only user, and on the other hand, only one sys- tem administrator (the user “root”) can be defined for one...
  • Page 148: State

    CHAPTER 3 Configuring the Gateway Figure 154. Question for Insecure Password Choice Note: The password for the user “root” must always be a combina- tion of letters, digits and special characters. • Retype password - retype the password for verification to make sure that your first password entry did not contain a typing error.
  • Page 149: Operating System

    CHAPTER 3 Operating System Figure 156. Operating System Selection The choices offered by the “Operating System Selection” context menu are: • “Edit” - to make settings concerning your Operating System, to determine at which events notifications should be sent, • Print item”...
  • Page 150: Operating System

    The “Operating System detail” Window provides the following window areas: • Flush interval - the function “Flush” creates an image of certain data of the A850 and saves it in settable intervals on the flash memory; • Notifications - allows you to choose at what events notifications which will be forwarded to the recipients determined in “Notification sending”...
  • Page 151: Flush Interval

    CHAPTER 3 Flush interval Figure 158. OS detail - Flush interval A flush interval can be selected for the following data: • Configuration - enter the Configuration flush interval in seconds; • Database - enter the Database flush interval in seconds; •...
  • Page 152: Last Times Events

    “01.01.70 01:00” or the field will be left blank. Networking Networking allows you to setup the network mode of your A850 and also network parameters for other devices in your LAN.
  • Page 153 CHAPTER 3 Figure 161. Networking Selection The choices offered by the “Networking Selection” context menu are: • “Edit” - to make settings concerning your network configuration; • Print item” - see a print preview of the network details in a formsheet processed for the printer and start the printout on your default printer.
  • Page 154 A850 in your network; • Console Settings - to determine the IP addresses for an access to your console via the network; • DHCP Settings - to enter definitions required for the use and function of your A850 as a DHCP server;...
  • Page 155: Ethernet Settings

    Host name - enter a designation which will be a unique identifier for your A850; • Mode - The A850 can work as well by itself as DHCP server (DHCP = Dynamic Host Configuration Protocol, dynamic assignment of IP addresses to other IP-based devices within...
  • Page 156: Console Settings

    • dhcp server - the A850 acts as a DHCP server for other devices within the LAN; Note: Use the A850 as a DHCP server only if there is no other active DHCP server within your LAN. • static - the A850 works with fixed (static) IP address which you have to set according to the topology of your network.
  • Page 157: Dhcp Settings

    CHAPTER 3 DHCP Settings Figure 166. Network detail - DHCP Settings If you did select for the A850 as mode “dhcp server”, you have to determine the following DHCP settings: • Range start and Range end - specifies the IP address range which the DHCP server can allocate to other devices within the LAN;...
  • Page 158: Primary Dns Server

    CHAPTER 3 Configuring the Gateway • IP address - enter the IP address at which your DNS server can be reached. Secondary DNS Server Figure 168. Network detail - Secondary DNS Server Allows you in analogy to “Primary DNS Server” to disclose an alter- native DNS server.
  • Page 159: Gateway Detail

    The choices offered by the “Gateway Detail Selection” context menu are: • “Connect sensors” - if internal sensors are built in into the A850, you can disclose them here (see chapter 4, “Logs”); • “Edit” - to open the Gateway detail window and to make configuration settings;...
  • Page 160 Configuration - determine supplemental information for your A850 regarding LAN connectivity, time zone, location and timing; Note: This information is required for use in conjunction with the Advantage software. • State - information about the status of the A850 at the moment of specific events.
  • Page 161: Configuration

    Figure 172. Gateway detail - Configuration - Timezone • Slot interval - interval for saving data from the internal sensors of the A850, in seconds (minimum is 60 seconds, maximum is 10800 seconds and the default is 900seconds, or 15 minutes);...
  • Page 162: State

    CHAPTER 3 Configuring the Gateway • Ping interval - the interval within the status data of the A850 is stored (minimum is 60 seconds, maximum is 10800 seconds and the default is 900seconds, or 15 minutes); • Latitude [°] - declaration of the latitude of the location of the A850 (in degrees);...
  • Page 163 Memory free [kiB] - displays the amount of free RAM in KiloByte; • Disk free [kiB] - displays the amount of free storage capacity on the flash disk of the A850; • Charger state - displays whether the internal battery is charged;...
  • Page 164 CHAPTER 3 Configuring the Gateway...
  • Page 165: Chapter 4. Using The Gateway

    Chapter 4. Using the Gateway This chapter summarizes all administrative settings which are required for the use of the A850 in a RTU network. Please keep in mind that only the system administrator (i.e. the user named “root”, by default) has the right to make all the set- tings for the use of the Gateway.
  • Page 166 CHAPTER 4 Using the Gateway Sensor Class/ Analog Pulse Digital Internal Logical Output SDI-12 RTU Type Input Counter Input Channel Channel A725 A726 A731 A732 A733 A733GSM A740 Table 2. Number of Sensor Connection on the RTUs Note: In the A740, the sensor connectors are combined as LC and OC sensors.
  • Page 167 CHAPTER 4 Sensor Connections A723 Power Power Analog1 Analog4 Analog2 Analog5 DIG0 DIG1 PulseCounter0 Analog3 PulseCounter1 Analog6 Ground Ground I/O B I/O A Figure 175. A723 Connector Inputs A733 Power Power Analog1 Analog4 Analog2 DIG0 Analog5 DIG1 PulseCounter0 Analog3 PulseCounter1 Analog6 Ground Ground...
  • Page 168: Analog Input

    CHAPTER 4 Using the Gateway Analog Input The analog input is provided for connecting analog sensors deliv- ering a voltage of 0 - 2.5V or a current of 4 - 20 mA converted to a voltage to the analog pins of the connectors. Note: The "4 - 20mA"...
  • Page 169: Logical Channels And Output Channels

    CHAPTER 4 Sensor Connections Note: To find out which internal sensors your devices are equipped with, please refer to the user manuals of the respective devices. Logical Channels and Output Channels Logical channels and output channel are used at the A740 RTU. The A740 provides programmable sensor connections which are combined as LC and OC connections.
  • Page 170: Actuator Connections

    RTU net- work. For Adcon sensors, type data and conversion tables are already preprogrammed in your A850 at your disposal to allow a quick connection of your RTUs. Detailed information about all sen- sors available from Adcon can be achieved from Adcon’s webside...
  • Page 171: Sensor Tables

    CHAPTER 4 Sensor Type Configuration Figure 177. Sensor Type Configuration Sensor Tables For sensors that either do not provide ouput voltages depending linearly on the measured variable, or that provide output voltages which must be converted into discrete output values, you have to define appropriate tables for conversion/linearization.
  • Page 172 CHAPTER 4 Using the Gateway Note: Interpolation is used for values between the specified data points. Figure 178. Sensor Tables Selection The selections offered by the “Sensor Tables” context menu are: • “New” - allows you to add a new sensor table; •...
  • Page 173 CHAPTER 4 Sensor Type Configuration Figure 179. Sensor tables The “Sensor tables” window provides the following window areas: • Name - allows you to enter a unique name for each conversion table to be determined; later, in the Sensor Type window, the conversion of the data of a sensor (also referred to as “the linearization of a sensor”) can be performed under this name;...
  • Page 174: Sensor Types

    • Output values: - enter the values of the physical units as which you want your A850 to interpret the respective input values. Sensor Types The “Sensor Type Selection” window allows you to define the sen- sor types which you intend to use with your RTUs;...
  • Page 175 CHAPTER 4 Sensor Type Configuration Figure 182. Sensor Types Selection The selections offered by the “Sensor Types” context menu are: • “New” - allows you to add a new sensor type; • “Edit” - allows you to modify an existing sensor type; •...
  • Page 176: Analog Sensor Types

    CHAPTER 4 Using the Gateway Analog sensor types The “Sensor type” window provides the following window areas for analog sensor types: • Common settings - for entering the common definitions of the sensor type, especially determining its technology; • Analog sensor settings - for determining the cabling and the sensor supply time;...
  • Page 177 CHAPTER 4 Sensor Type Configuration Figure 183. Sensor type Window - Analog...
  • Page 178: Common Settings

    CHAPTER 4 Using the Gateway Common settings Figure 184. Sensor type - Common settings - Analog • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 179: Analog Sensor Settings

    Figure 186. Sensor type - Common settings - Icon - Analog Note: If you cannot find a suitable engineering unit or icon for your sensor, ask your Adcon Telemetry distributor for support. • Technology - make the appropriate selection in the combo box “Technology”...
  • Page 180: Analog Sensor Sampling Methods

    CHAPTER 4 Using the Gateway Figure 189. Sensor type - Analog sensor settings - Cabling • Sensor supply time - the delay allowed for the sensors to settle after power has been applied to them (the default value is 2 seconds) so that the sampling of accurate measurements can begin.
  • Page 181: Conversion Settings

    CHAPTER 4 Sensor Type Configuration • first sample - set sampling method to first, i.e. only the first sampled value is stored in each slot; • last sample - set sampling method to last, i.e. only the last sampled value is stored in each slot. Select default sampling method: •...
  • Page 182: Counter Sensor Types

    CHAPTER 4 Using the Gateway “Sensor Tables” for conversion/linearization; if you intend to use a linear sensor, select “none”; Figure 193. Sensor type - Conversion settings - Sensor table - Analog Note: If a sensor table is entered for a non-linear sensor, the fol- lowing entries for Linear input value refer to the output val- ues of the linearization table and not to the voltage measured on the analog pin!
  • Page 183 CHAPTER 4 Sensor Type Configuration • Conversion settings - for determining the method of conversion of input values to output values or to define a sensor table for conversion, respectively. Figure 194. Sensor type Window - Counter...
  • Page 184: Common Settings

    CHAPTER 4 Using the Gateway Common settings Figure 195. Sensor type - Common settings - Counter • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 185: Conversion Settings

    CHAPTER 4 Sensor Type Configuration Figure 197. Sensor type - Common settings - Icon - Counter • Technology - make the appropriate selection in the pulldown menu “Technology” (in this case, “counter”): Figure 198. Sensor type - Common settings - Technology - Counter Conversion settings Figure 199.
  • Page 186: Digital Sensor Types

    CHAPTER 4 Using the Gateway “Sensor Tables” for conversion/linearization; if you intend to use a linear sensor, select “none”; Figure 200. Sensor type - Conversion settings - Sensor table - Counter Note: If a sensor table is entered for a non-linear sensor, the fol- lowing entries for Linear input value refer to the output val- ues of the linearization table and not to the voltage measured on the analog pin!
  • Page 187 CHAPTER 4 Sensor Type Configuration • Conversion settings - for determining the method of conversion of input values to output values or to define a sensor table for conversion, respectively. Figure 201. Sensor type Window - Digital...
  • Page 188: Common Settings

    CHAPTER 4 Using the Gateway Common settings Figure 202. Sensor type - Common settings - Digital • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 189: Digital Sensor Settings

    CHAPTER 4 Sensor Type Configuration Figure 204. Sensor type - Common settings - Icon - Digital • Technology - make the appropriate selection in the pulldown menu “Technology” (in this case, “digital”): Figure 205. Sensor type - Common settings - Technology - Digital Digital sensor settings Figure 206.
  • Page 190: Conversion Settings

    CHAPTER 4 Using the Gateway Conversion settings Figure 207. Sensor type - Conversion settings - Digital • Sensor table - if you want to use a non-linear sensor, select one of the sensor tables already defined in the menu item “Sensor Tables”...
  • Page 191: Internal Sensor Types

    CHAPTER 4 Sensor Type Configuration the values are outside the preset thresholds, an invalid sensor value will be notified; • Display scale - enter the minimum and maximum value for scaling which should to be displayed on the trend graph “Sensor data graphic”.
  • Page 192: Common Settings

    CHAPTER 4 Using the Gateway Figure 209. Sensor type Window - Internal Common settings Figure 210. Sensor type - Common settings - Internal...
  • Page 193: Internal Sensor Settings

    CHAPTER 4 Sensor Type Configuration • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor; • Engineering unit - specify in which measuring unit the sensor data are to be delivered;...
  • Page 194: Conversion Settings

    CHAPTER 4 Using the Gateway Figure 213. Sensor type - Internal sensor settings - Internal type Conversion settings Figure 214. Sensor type - Conversion settings - Internal • Sensor table - if you want to use a non-linear sensor, select one of the sensor tables already defined in the menu item “Sensor Tables”...
  • Page 195: Lc Sensor Types

    CHAPTER 4 Sensor Type Configuration Note: Due to its linear characteristic, a linear sensor is by default exactly defined by only two input values, the minimum and the maximum. The range for Internal sensors is 0 - 1 Units, by default. •...
  • Page 196 CHAPTER 4 Using the Gateway Figure 216. Sensor type Window - LC...
  • Page 197: Common Settings

    CHAPTER 4 Sensor Type Configuration Common settings Figure 217. Sensor type - Common settings - LC • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 198: Sensor Settings

    CHAPTER 4 Using the Gateway Sensor settings Figure 219. Sensor type - Sensor settings - LC • Logical channel - enter the logical channel of the LC sensor. Conversion settings Figure 220. Sensor type - Conversion settings - LC • Sensor table - if you want to use a non-linear sensor, select one of the sensor tables already defined in the menu item “Sensor Tables”...
  • Page 199: Oc Sensor Types

    CHAPTER 4 Sensor Type Configuration Note: Due to its linear characteristic, a linear sensor is by default exactly defined by only two input values, the minimum and the maximum. The range for LC sensors is 0 - 1 Units, by default.
  • Page 200 CHAPTER 4 Using the Gateway Figure 222. Sensor type Window - OC...
  • Page 201: Common Settings

    CHAPTER 4 Sensor Type Configuration Common settings Figure 223. Sensor type - Common settings - OC • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 202: Output Settings

    CHAPTER 4 Using the Gateway Output settings Figure 225. Sensor type - Output settings - OC • Output channel - enter the output channel for the OC sensor. Conversion settings Figure 226. Sensor type - Conversion settings - OC • Sensor table - if you want to use a non-linear sensor, select one of the sensor tables already defined in the menu item “Sensor Tables”...
  • Page 203: Sdi Sensor Types

    CHAPTER 4 Sensor Type Configuration Note: Due to its linear characteristic, a linear sensor is by default exactly defined by only two input values, the minimum and the maximum. The range for OC sensors is 0 - 1 Units, by default.
  • Page 204 CHAPTER 4 Using the Gateway Figure 228. Sensor type Window - SDI...
  • Page 205: Common Settings

    CHAPTER 4 Sensor Type Configuration Common settings Figure 229. Sensor type - Common settings - SDI • Name - enter a unique name for each sensor type; • Manufacturer - enter the name of the manufacturer of the sensor; • Type - enter the type designation of the sensor;...
  • Page 206: Sdi Sensor Settings

    CHAPTER 4 Using the Gateway SDI sensor settings Figure 231. Sensor type - SDI sensor settings • Address: - select the address of the SDI sensor; • Method: - select the methode des SDI sensors; • Index: - select the index des SDI sensors; •...
  • Page 207: Combo Sensor Types

    CHAPTER 4 Sensor Type Configuration Figure 233. Sensor type - Conversion settings - Sensor table - SDI Note: If a sensor table is entered for a non-linear sensor, the fol- lowing entries for Linear input value refer to the output val- ues of the linearization table and not to the voltage measured on the analog pin! •...
  • Page 208 CHAPTER 4 Using the Gateway provides the same functionality as a discrete temperature sensor, a discrete relative humidity sensor and a Y-cable. Figure 234. Combo Sensor Types Selection The selections offered by the “Combo Sensor Types” context menu are: • “New”...
  • Page 209 CHAPTER 4 Sensor Type Configuration Double-clicking the combo sensor type in the "Table view" allows you to check the selected combo sensor type. The “Combo sensor type” window provides the following window areas for combo sensor types: Figure 235. Combo sensor type Window •...
  • Page 210: Sensor Types

    CHAPTER 4 Using the Gateway Sensor types Figure 236. Combo sensor type - Sensor types • Add - the button “Add” allows you to open the window “Select sensor type”, to mark individual sensor types and to combine them to a Combo sensor type by clicking the button •...
  • Page 211: Logs

    CHAPTER 4 Logs Figure 237. Combo sensor type - Sensor types - Select sensor type Logs There are two ways to display the log files of the system. While the whole journal can displayed by a selection within the main menu, the popup menu related to modems and RTUs offers to display the subset of entries of the log file related to the actual modem or RTU, respectively.
  • Page 212: Call Journal

    CHAPTER 4 Using the Gateway Figure 238. Logs Selection Call Journal The call journal contains a list of the last outgoing phone calls.
  • Page 213: Poll Journal

    CHAPTER 4 Logs Figure 239. Call Journal Table Poll Journal The poll journal contains a list with the data polls (poll = the gate- way contacts the RTUs and requests new measurement data) of all connected RTUs.
  • Page 214: System Log

    CHAPTER 4 Using the Gateway Figure 240. Poll Journal Table System Log “System Log” allows you to query the parameters of the A850. The query can be delimited specifically by query options.
  • Page 215: Log Types

    CHAPTER 4 Logs Figure 241. System Log Selection Log types Figure 242. System Log - Log types...
  • Page 216: Log Types Buttons

    CHAPTER 4 Using the Gateway The check boxes depicted above allow you to select which infor- mation about your A850 you want to display or to save, respec- tively: • host - fundamental information about the A850, • cpu - CPU configuration of the A850, •...
  • Page 217: System Log Windows

    CHAPTER 4 Logs System Log Windows Figure 244. System Log Window The System Log Window displays the result of your query. System log Buttons Figure 245. System Log - Log types Buttons • Save to file - The result of the System Log can be saved into a file on your local PC by clicking this button;...
  • Page 218: Rtu Network Configuration

    CHAPTER 4 Using the Gateway RTU Network Configuration The RTU Network Configuration represents the network of the physical Remote Telemetry Units (RTUs) distributed within a certain geographical area. The RTU Network Configuration comprises a reference of each physical RTU grouped by arbitrary RTU groups displaying the infor- mation about the sensors or combo sensors connected.
  • Page 219 CHAPTER 4 RTU Network Configuration Figure 246. RTU Group Selection The selections offered by the “RTU Group” context menu are: • “New” - allows you to add a new RTU group; • “Edit” - allows you to modify an existing RTU group; •...
  • Page 220 CHAPTER 4 Using the Gateway Note: Menu items “Undo” or “Redo”: see “Pop-up Context Menu” in chapter 2. Double-clicking the RTU group in the "Table view" allows you to check the selected RTU group. By appropriate selection of a RTU group, you enter a “RTU group” detail window where user’s access rights are defined as follows: The system administrator (user “root”) and all administrator level (aka “admin”) users can grant access rights for every RTU group.
  • Page 221 CHAPTER 4 RTU Network Configuration Figure 247. RTU Group Window While the users “root” and “admin” have access to all tables of the RTU network, the access to the RTUs, their routes and their sensors for all “ordinary” users is limited. All RTU groups, RTUs, routes and sensors for which a user has no read access rights granted will be hidden for this user.
  • Page 222: Definition Of Rtus

    The management of the RTUs within such a network is a task to be performed by a Telemetry Gateway like the A850. In order to define a RTU, to connect a sensor, to make a change or...
  • Page 223 CHAPTER 4 RTU Network Configuration Figure 248. RTU Context Menu The choices offered by the RTU context menu are: RTU Configuration: • “New” - allowing to add a new RTU and to define the RTU details, see description “RTU Data”; •...
  • Page 224 CHAPTER 4 Using the Gateway RTU Administration: • “Copy RTU” - see description “Copy RTU”; • “Replace RTU” - see description “Replace RTU”; • “Convert RTU” - see description “Convert RTU”. Sensor Administration: • “Connect sensors” - see description “Connect sensors”. RTU Data Management: •...
  • Page 225: Rtu Configuration

    CHAPTER 4 RTU Network Configuration RTU Configuration The Context Menu “RTU Configuration” allows to enter detailed determinations required for the integration of a new RTU or for the modification of an already existing RTU, as well as routing determi- nations. Furthermore, the actual status of a RTU can be queried. Figure 249.
  • Page 226: Rtu - Data

    CHAPTER 4 Using the Gateway RTU - Data Figure 250. RTU - Data Window The “RTU - Data” detail window allows to configure singular RTUs and provides the following window areas: • Main settings - containing name, type, serial number, code, timezone, node ID, RTU type affiliation to a RTU group and modem reference;...
  • Page 227 CHAPTER 4 RTU Network Configuration • Maintenance - possibility to enter information related to installation and maintenance of RTU or battery, respectively; • Location - possibility to enter the coordinates of the location of the RTU; • Other Settings - possibility to enter the parameters required for the calculatation of the radio error rate.
  • Page 228 Figure 253. RTU - Data - Main settings - Timezone • Node ID - unique identification of the RTU. Note: The node ID is allocated automatically by the A850, but can be altered. • Group - selection of the RTU group to which the RTU is to be assigned: Figure 254.
  • Page 229 CHAPTER 4 RTU Network Configuration Polling Figure 255. RTU - Data - Polling • Poll mode - choice of the sort of polling for the selected RTUs: Figure 256. RTU - Data - Polling - Mode • Poll interval [s] - a polling is performed periodically according to the fixed interval: Figure 257.
  • Page 230 CHAPTER 4 Using the Gateway Figure 258. RTU - Data - Polling - Mode - Times • Ping intervals [s] - a ping is performed periodically with the fixed interval for the selected RTUs; • Poll priority - selection of the poll priority to control the polling traffic of several RTUs and in case of large amounts of data: Figure 259.
  • Page 231 CHAPTER 4 RTU Network Configuration Maintenance Figure 260. RTU - Data - Maintenance • Install.date - entry of the date of the first installation the RTU; • Maint.date - entry of the date of the last maintenance of the RTU; •...
  • Page 232: Rtu - State Information

    CHAPTER 4 Using the Gateway • Latitude [°] - declaration of the latitude of the location of the RTU (in degrees); • Longitude [°] - declaration of the longitude of the location of the RTU (in degrees); • Altitude [m] - declaration of the altitude of the location of the RTU (in meters).
  • Page 233 CHAPTER 4 RTU Network Configuration Figure 264. RTU - State information Window The “State information” detail window provides the following win- dow areas: • RTU information - displays general information about the status of the RTU; • Connection information - displays information about the connection status of the RTU;...
  • Page 234 • Int.temperature - displays the internal temperature of the RTU; Note: Internal temperature sensors can be connected to all A7X3 type RTUs and to the A850. • Uptime - displays the time of the last power up; • Reset count - displays the number of RTU resets •...
  • Page 235 CHAPTER 4 RTU Network Configuration Connection Information Figure 266. RTU - State information - Connection information • Radio error rates - displays the actual radio error rates; Note: Radio error rate sensors can be connected to all RTUs and to all Wireless Modems. •...
  • Page 236 CHAPTER 4 Using the Gateway Scheduling Information Figure 267. RTU - State information - Scheduling information • First slot - displays the time the first (oldest) slot was sent from the RTU; • Last slot - displays time the last (newest) slot was sent from the RTU;...
  • Page 237: Rtu - Routing

    RTU was requested. RTU - Routing Routing increases the possible distances between the A850 and the RTUs because the transmission of the information uses other RTUs as relay stations instead of having to go straight from sender to addressee.
  • Page 238 CHAPTER 4 Using the Gateway Figure 268. RTU - Routing Window The “Routing” detail window” provides the following window areas: • Routing Table - list of the RTUs required for routing; • Routing Buttons - buttons to manage the RTU in routing table; •...
  • Page 239 CHAPTER 4 RTU Network Configuration Routing Table Figure 269. RTU - Routing Table • Index - current number in the routing table; • Hops - number of the hops required to reach the RTU concerned; • Use from - time to start using the route; •...
  • Page 240 CHAPTER 4 Using the Gateway • “Down” button - allows to change the routing order by shifting singular routers downwards; Routing - Additional Settings Figure 271. RTU - Routing - Additional Settings • “Notification on route change” check box - triggers a notification being sent on route change;...
  • Page 241: Rtu Administration

    CHAPTER 4 RTU Network Configuration Figure 272. Route Detail Window • RTU name - displays the RTU to be reached by routing; • RTU code - displays the code of the RTU to be reached by routing; • The codes of the hops in this route - entry of the codes of all RTUs which should serve as routers for the RTU to be reached by routing;...
  • Page 242: Copy Rtu

    CHAPTER 4 Using the Gateway Figure 273. RTU Context Menu - RTU Administration • “Copy RTU” - see description “Copy RTU”; • “Replace RTU” - see description “Replace RTU”; • “Convert RTU” - see description “Convert RTU”. Copy RTU Figure 274. RTU Context Menu - RTU Administration - Copy RTU If several RTUs of the same type are to be used, it is possible to use the data of an already completely configured RTU for copying.
  • Page 243 CHAPTER 4 RTU Network Configuration Figure 275. Copy RTU Window • RTU name - displays the name of the RTU to be copied; • Code - displays the code of the RTU to be copied; • Serial number - displays the serial number of the RTU to be copied;...
  • Page 244: Replace Rtu

    CHAPTER 4 Using the Gateway RTU table The lower part of the “Copy RTU” window contains the table of the copies of the selected RTU: Figure 276. Copy RTU - RTU table The list of the saved RTU copies contains the following informa- tion: •...
  • Page 245 CHAPTER 4 RTU Network Configuration Select destination RTU • Select the destination RTU within your RTU network to be replaced and then select “Replace RTU” in the RTU context menu. Select source RTU Figure 278. Replace RTU Window • Select the source RTU within yor RTU network from which you want the RTU information to be taken over;...
  • Page 246: Convert Rtu

    CHAPTER 4 Using the Gateway Figure 279. Replace RTU Question After the confirmation made by clicking the “OK” button, there will be still the security query pictured above to be answered before the RTU replacement is performed. Convert RTU Figure 280. RTU Context Menu - RTU Administration - Convert RTU “Convert RTU”...
  • Page 247 CHAPTER 4 RTU Network Configuration Figure 281. Convert RTU Window RTU information • Name - display the name of the RTU to be converted; • Type - display the previous type of the RTU to be converted; • Node ID - display the node ID of the RTU to be converted; •...
  • Page 248 CHAPTER 4 Using the Gateway Convert to type • Convert to type - selection of the future type in which you want your actual RTU to be converted: Figure 282. Convert RTU - Convert to type Figure 283. Convert RTU Question After the confirmation made by clicking the “OK”...
  • Page 249: Sensor Administration

    CHAPTER 4 RTU Network Configuration Sensor Administration Via the context menu area “Sensor Administration”, the details for the assignment of sensors as well as for the modification of exist- ing sensor assignments to RTUs can be determined. Figure 284. RTU Context Menu - Sensor Administration •...
  • Page 250: Connect Sensors

    CHAPTER 4 Using the Gateway Connect sensors Figure 285. RTU Context Menu - Sensor Administration - Connect sensors The “Connect sensors” interface supports the assignment of avail- able I/O ports to sensors. The user can select one or more RTUs or one or more provided I/O connectors of different RTUs displayed by the tree view of the main window and invoke the “Connect sen- sors”...
  • Page 251 CHAPTER 4 RTU Network Configuration The “Connect sensors” window shows all available I/O ports of the selected RTU as tabs. According to the sensor type technology to be connected, the assignment of the different sensor type technologies to the I/O- ports is to be made as follows: •...
  • Page 252 CHAPTER 4 Using the Gateway Available sensors Available sensors table - displays all available sensor types corre- sponding to the respective port in a list whereby the following sen- sor type information is shown: Figure 287. Connect sensors - Available sensors •...
  • Page 253 CHAPTER 4 RTU Network Configuration Note: For each available cabling, only one sensor corresponding to the cabling can be accepted. • Address - bus address of the sensors (only for SDI sensors), Note: For each available address, only one sensor corresponding to the address can be accepted.
  • Page 254 CHAPTER 4 Using the Gateway Figure 288. Connect sensors - Connected sensors • Name - name of the connected sensor type; • Index - index of the sensors if these are internal, LC or • Cabling - cabling of the sensors if these are connected to IOA, IOB, IOC or IOD;...
  • Page 255 CHAPTER 4 RTU Network Configuration cablings and addresses become again available by the removal of the disconnected sensor types. Figure 289. Connected Sensors Table By clicking a sensor port of a RTU in the tree window, the con- nected sensors will be displayed in the tree window as well as in the table window.
  • Page 256: Rtu Data Management

    CHAPTER 4 Using the Gateway RTU Data Management Figure 290. RTU Context Menu - RTU Data Management The RTU Data Management context menu gives access to the fol- lowing selection possibilities: • “Get data” - see description “Get data”, • “Set data”...
  • Page 257 CHAPTER 4 RTU Network Configuration sensor, respectively, is assigned a column in the list. Please notify that in the column “Slot”, the index of the slot will be shown while the further columns show the values of the sensors corresponding to this slot.
  • Page 258 CHAPTER 4 Using the Gateway Sensors data - Graphic The “Sensors data Graphic” window shows the read out values of the respective sensors in form of a diagram. Thereby, for each con- nected or selected sensor, respectively, a value graph in distinctive color is shown.
  • Page 259: Set Data

    CHAPTER 4 RTU Network Configuration Set data Figure 294. RTU Context Menu - RTU Data Management - Set Data “Set data” allows to send data sets prepared in advance to sen- sors working as actuators: Figure 295. Set data window...
  • Page 260: Configure

    CHAPTER 4 Using the Gateway Data fetched from a file in CSV format (spreadsheet conversion for- mat) on the local PC can be imported into several sensors working as actuators. If one or more RTUs are selected to invoke the “Set data”...
  • Page 261 CHAPTER 4 RTU Network Configuration Figure 297. Configuration update window • Last update - displays the time of the last configuration update of the selected RTU. Configuration state The selection “Configuration state” provides a list of the selected RTUs containing: •...
  • Page 262: Refresh Data

    CHAPTER 4 Using the Gateway • Requested - status for the sheduled refresh data command update of the selected RTU or sensor: • “true” a request is scheduled, • “false” a request is not scheduled; • Scheduled - time schedule for the next request for a configuration update of the selected RTU or sensor.
  • Page 263: Erase Data

    CHAPTER 4 RTU Network Configuration Erase data Figure 300. RTU Context Menu - RTU Data Management - Erase Data Delete the data of the sensors of one or more selected RTUs. Figure 301. Erase data window • Erase data beginning from- enter the date and time (timestamp) from where elder data of the selected RTUs or sensors, respectively, should be deleted.
  • Page 264 CHAPTER 4 Using the Gateway Figure 303. Ping RTU window Responses table Within this context, responses are to be understood as reactions on pings sended to selected RTUs. The responses will be listed in the “Responses table”. The following dialogue buttons are avail- able: •...
  • Page 265: Rtu Communication Management

    CHAPTER 4 RTU Network Configuration RTU Communication Management Figure 304. RTU Context Menu - RTU Communication Management The “RTU Communication Management” allows to make the fol- lowing selections: • “Configure Poll/Ping” - see description “Configure Poll/ Ping”; • “Change frequencies” - see description “Change frequencies”.
  • Page 266 CHAPTER 4 Using the Gateway Figure 306. Poll and ping times configuration Window Poll configuration Figure 307. Poll and ping times configuration - Poll configuration • Poll mode - in this combo box, the time of establishment of a polling is determined, featuring the following selections: •...
  • Page 267 CHAPTER 4 RTU Network Configuration Figure 308. Poll and ping times configuration - Poll configuration - Poll mode - interval • Poll interval [s] - a polling is performed periodically with the defined interval; • times - to force a polling to be etablished at specific times: Figure 309.
  • Page 268: Change Frequencies

    CHAPTER 4 Using the Gateway Change Frequencies Note: This function is not yet implemented! Figure 311. RTU Context Menu - RTU Communication Management - Change Frequencies The frequencies of all RTUs connected to a Wireless Modem will be changed. Note: The frequency change starts in each route at the most dis- tant RTU.
  • Page 269: Rtu Logs

    This call journal contains a list of the last outgoing/incomming con- nections to/from the selected RTU. Note: In comparison to this call journal, the call journal in the tree window contains a list of all the polls performed by the A850. Figure 314. Call Journal Window of RTU (GSM-Type)
  • Page 270: Poll Journal

    The poll journal contains a list of the data polls (poll = the gateway contacts the RTUs and polls for new measurement data) of the selected RTU. Note: In comparison to this poll journal, the poll journal in the tree window contains a list of all the polls performed by the A850.
  • Page 271: Rtu Printing

    CHAPTER 4 RTU Network Configuration Figure 316. Poll Journal Window of a RTU RTU Printing • Print item” - see a print preview of the marked RTU in a formsheet processed for the printer and start the printout on your default printer. IO Port Configuration IO Port Context Menu In the IO Port Context Menu, all actions related to individual I/O...
  • Page 272: Sensor Context Menu

    CHAPTER 4 Using the Gateway Figure 317. IO Port Context Menu The choices offered by the IO Port context menu are: • Menu items “Undo” or “Redo”: see “Pop-up Context Menu” in chapter 2; • “Connect sensors” - see description “Connect sensors”; the “Connect sensors”...
  • Page 273: Sensor Configuration

    CHAPTER 4 RTU Network Configuration Sensor Configuration Sensor Context Menu The Sensor Context Menu allows to select all actions related to sensors asind alle aktionen die im zusammenhang mit sensoren diettaced to RTUs. The possible actions are described below. Figure 318. Sensor Context Menu The choices offered by the Sensor context menu are: Sensor Configuration: •...
  • Page 274 CHAPTER 4 Using the Gateway Sensor Administration: • “Replace sensor” - see description “Replace sensor”; Sensor Data Management: The possibilities offered by the Sensor Data Management are almost identical to these offered by the RTU Data Management, the most significant difference being the fact that not the data of all sensors of a RTU, but only the data of the selected sensor are regarded: •...
  • Page 275: Sensor Details

    CHAPTER 4 RTU Network Configuration Sensor details Figure 319. Sensor details Window...
  • Page 276: Common Details

    CHAPTER 4 Using the Gateway Common details Figure 320. Sensor details - Common details • Name - displays the name defined for this sensor which can be modified; • RTU name - displays the name of the RTU where the sensor is attached;...
  • Page 277 CHAPTER 4 RTU Network Configuration Note: No special entries are provided for internal sensors. Different window areas are displayed for internal, LC, OC and SDI sensors: Allows entries for analog, counter and digital sensors: Figure 321. Sensor details - Raw •...
  • Page 278: Calibration

    CHAPTER 4 Using the Gateway Figure 323. Sensor details - OC • Output channel - enter the output channel for the OC sensor Allows entries for SDI sensors: Figure 324. Sensor details - SDI • Bus address - enter the address of the SDI sensor; •...
  • Page 279: Newest Slot

    CHAPTER 4 RTU Network Configuration • Sensor value - enter the minimum and maximum value of the range within which the sensor delivers measurements; Note: The default range of the sensor value ist defined in “Sensor Type configuration” in the field “Linear input value”. •...
  • Page 280: Replace Sensor

    CHAPTER 4 Using the Gateway Requests Figure 327. Sensor details - Requests • Refresh requested - tells whether a measurement value refresh of the sensor was requested; • Refresh needed - tells whether a measurement value refresh of the sensor is needed; •...
  • Page 281 CHAPTER 4 RTU Network Configuration Figure 328. Sensor Context Menu - Replace Sensor Select destination sensor • Enter the table view of an I/O port or go directly in the tree view to a sensor which you want to replace by another and select “Replace sensor”...
  • Page 282 CHAPTER 4 Using the Gateway Figure 330. Replace Sensor Question After the confirmation made by clicking the “OK” button, there will be still the security query pictured above to be answered before the replacement of the sensor is performed.
  • Page 283: Chapter 5. Console Commands

    Chapter 5. Console Commands The console commands serve as means for the basic configuration of the A850 which is a prerequisite for being able in to work in suc- cession with the Gateway via the Graphical User Interface (GUI). The console commands are executed through the command line interface with a menu driven application which allows the user to perform various maintenance and debugging tasks.
  • Page 284: Establishing Console Connection

    The following possibilities for settings are available to all users (e.g., “root“, “adv” or “yourname”) via the local serial connection “CONSOLE” on the rear side of the A850 (Fig. 3) as well as via remote connection (network or modem connection): •...
  • Page 285 Figure 330. HyperTerminal and PuTTY Icon HyperTerminal Configuration This program is to be configured as follows: Input of a connection name: enter A850 in the field “Name” and confirm by clicking the "OK" button. Figure 331. Hyper Terminal Connection Description...
  • Page 286 CHAPTER 5 Console Commands As next step, select the designation of the COM interface of the PC to which your A850 is connected and confirm by clicking the "OK" button: Figure 332. HyperTerminal Connect To Then select the appropriate port settings according to Fig. 221...
  • Page 287 Establishing Console Connection Figure 333. HyperTerminal Port Settings Now, a HyperTerminal connection to your A850 will be build up. By this, you should have established now the HyperTerminal con- nection. In order to login, press the RETURN key and the following...
  • Page 288 As already indicated above, alternatively, the Freeware PuTTY can be used which is specially suited for remote connections to your A850 because it supports TelNet as well as SSH connections. For a local connection to the A850, select the following parameters for PuTTY configuration:...
  • Page 289 CHAPTER 5 Establishing Console Connection Figure 335. PuTTY Configuration for Local Connection For an insecure remote connection (TelNet connection) to the A850, make the following PuTTY configuration parameter selec- tion:...
  • Page 290 CHAPTER 5 Console Commands Figure 336. PuTTY Configuration for Remote Connection - TelNet For a secure remote connection (SSH connection) to the A850, make the following PuTTY configuration parameter selection:...
  • Page 291 Figure 337. PuTTY Configuration Remote Connection - SSH Note: In case of remote connections, you have to put in the IP address selected by you for the A850, or, via internet, you can also put in the corresponding domain name, respec- tively.
  • Page 292: Console Commands Details

    Console Commands details Consecutively, you find the description of all viable console com- mands relevant to the user of the A850. Note: Some of the settings which can be carried out via console commands can also be set or altered, respectively, at a later...
  • Page 293: Console Login

    After the successful login, the main menu becomes available. Note: At the first login or after erasing the configuration of the A850, no password is disposable at the system adminstrator “root” so that a password has to be entered in succession in the menu item “Configuration”.
  • Page 294 The following main menu is at the disposal of an “user administra- tor” (user “adv” as described in “Users” in chapter 3) via the con- sole connection: ----------------------------Console Dialog Start----------------------------- Telemetry Gateway A850 Version 20070424 (C) 2007 Adcon Telemetry GmbH a850-199002 login: adv Password: Main menu C ...
  • Page 295 Select menu option or press <Esc> to return: ----------------------------Console Dialog End------------------------------ The following main menu is at the disposal of the user “adv” via the LAN connection: ----------------------------Console Dialog Start----------------------------- Telemetry Gateway A850 Version 20070424 (C) 2007 Adcon Telemetry GmbH a850-199002 login: adv Password: Main menu C ...
  • Page 296: Upgrade The Gateway

    Upgrade the gateway In this menu item, you will have the prospective opportunity to upgrade the firmware of your A850 to a newer version, depending from product improvements and possible customer demands. To find out if such an upgrade is available, contact your Adcon distrib- utor or read up on it at www.adcon.at.
  • Page 297 Console Commands details x: ready to receive upload-1180486446.img Note: Now, start your transmission program for sending the new firmware image file to the A850 and proceed according to the following figures. Figure 339. Select Transfer - Send File ... Figure 340. Browse or Select File Name for New Firmware Image File...
  • Page 298: Configuration

    ----------------------------Console Dialog End----------------------------- Configuration Configuration Quick setup In Quick setup, the setup of the A850 is performed only with the most important information, i.e. only the information is necessary which is required for the internal LAN operation of the A850 where the A850 independently establishes the IP addresses and activates its DCHCP server function.
  • Page 299 CHAPTER 5 Console Commands details necessary to enter one password for each single user. A password has always to consist in a combination of letters, digits and special characters (e.g., “rf3312sa!") I----------------------------Console Dialog Start----------------------------- Configuration menu Q ... Quick setup... X ...
  • Page 300: Configuration Expert Setup

    Writing configuration file... ----------------------------Console Dialog End----------------------------- Configuration Expert setup In Expert setup, the information required for Quick setup as well as additional routing parameters for the operation of the A850 in a LAN together with other devices. ----------------------------Console Dialog Start----------------------------- Configuration menu Q ...
  • Page 301 Press <Ctrl-B> to go back to the previous ques- tion or <Tab> for hints Press <Esc> to cancel Password for root: ********* Retype password for root: ********* Hostname: a850-199002 IP address: 192.168.0.121 IP netmask: 255.255.255.0 IP broadcast address: 192.168.0.255 IP router address: 192.168.0.254...
  • Page 302: Backup The Gateway Configuration

    ----------------------------Console Dialog End------------------------------ Backup the Gateway Configuration A backup saves the configuration available in the A850 in a file at the PC from where they can be brought back again at a later date by “Restore” into the A850. This is necessary e.g. in case of data loss or after an exchange of the A850.
  • Page 303 Preparing backup...Start your X-Modem download now! Give your local XMODEM receive command now. Note: Here, you start your transmission program for reception of the A850 backup file. Figure 342. Select Transfer - Receive File ... Figure 343. Choose folder for Backup File...
  • Page 304 CHAPTER 5 Console Commands Figure 344. Select file name for Backup File Figure 345. Receiveing Backup File from A850 Note: Once the “file receive” window did disappear again without any data transmission error having been displayed in its con- sole dialogue, the transmission of the backup file should have been executed successfully.
  • Page 305: Restore The Gateway Configuration

    CHAPTER 5 Console Commands details Restore the gateway configuration Restore retrieves the data saved from the A850 in a file at the PC into the A850. Note: A “Restore” of the A850 is also possible by the configurator GUI as described under “Configuration”.
  • Page 306 CHAPTER 5 Console Commands Figure 346. Select Transfer - Send File... Figure 347. Select file name for Backup File to restore Figure 348. Send Backup File to A850...
  • Page 307: Erase The Gateway Configuration

    Select menu option or press <Esc> to return: ----------------------------Console Dialogue End------------------------------ Erase the gateway configuration In order to relegate your A850 in the initial state (as delivered) which implies to delete all configuration data and settings, you may erase all data from your A850 Gateway by “erase”.
  • Page 308: Encryption

    A850 via the internet, this communications link has to be protected by means of HTTPD encryption so that an internet browser for https can communicate with the A850. To this, a HTTP key is gen- erated at this point for encryption of the connection. The validity of this key can be restricted to a specified period of time.
  • Page 309 Setup dialog Press <BS> to erase one character or <Ctrl-U> to erase the whole line Press <Ctrl-B> to go back to the previous ques- tion or <Tab> for hints Press <Esc> to cancel Hostname: a850-199002 Country code: AT Country name: Austria...
  • Page 310: Sshd Encryption

    SSHD encryption so that applications suited for SSH (i.e., PuTTY or similar programs) can communicate with the A850 via SSH. To that purpose, a SSH key for the encryption of the communication is generated here. If you want to change the key, you have to rerun SSHD encryption.
  • Page 311 CHAPTER 5 Console Commands details E ... Erase SSHD keys... Select menu option or press <Esc> to return: s DSS key fingerprint: C9:E7:F3:E5:28:97:25:37:E8:C1:02:B1:FC:11:76:61 RSA key fingerprint: 89:C5:05:94:B2:30:42:99:54:BB:97:B1:5E:A0:B4:68 SSHD encryption menu S ... Show SSHD keys... C ... Create SSHD keys... E ...
  • Page 312: Show The Java Archive Key

    LAN via NTP service. Note: In order to be independent from the location of the A850, enter the time always referenced to UTC ("Universal Time coordinated"). Otherwise or in making comparisions, keep in mind what happens at the changes between “normal”...
  • Page 313: Licensing

    ----------------------------Console Dialogue End----------------------------- Licensing Here, you can read the license regulations referring to the respec- tive software modules used in your A850. Reading the license reg- ulations has no impact on the functions of the A850. ---------------------------Console Dialogue Start----------------------------- Licensing menu S ...
  • Page 314: Debugging

    ----------------------------Console Dialogue End----------------------------- Callback PPP server If PPP dialup networking is configured, this command can be used to initiate a callback to the configured PPP server. The A850 will quit the CLI to close the current call, then initiate the callback.
  • Page 315: Who Am I

    CHAPTER 5 Console Commands details ---------------------------Console Dialogue Start----------------------------- Main menu U ... Upgrade the gateway... C ... Configuration... E ... Encryption... T ... Set date and time... L ... Licensing... D ... Debugging... P ... Callback PPP server W ... Who am I? O ...
  • Page 316: Operating-System Shell

    Here, you could leave the main menu and start to directly execute operating system (OS) commands. However, no such procedures are required for the regular operation of the A850 and the use of this feature makes only sense for experts or following advices from Adcon support, respectively.
  • Page 317: Exit

    CHAPTER 5 Console Commands details BusyBox v1.01 (2007.04.24-13:38+0000) Built-in shell (ash) Enter 'help' for a list of built-in commands. # help Built-in commands: ------------------- . : alias bg break cd chdir continue eval exec exit export false fg hash help jobs let local pwd read readonly return set shift times trap true type ulimit umask unalias unset wait # exit...
  • Page 318 CHAPTER 5 Console Commands X ... Exit Select menu option or press <Esc> to return: x Press <Enter> for a login prompt ----------------------------Console Dialogue End------------------------------...
  • Page 319: Chapter 6. Appendix

    100-240V~, 15W max, integrated 8.4V NiMH battery with 4500mAh serves as uniterruptible power supply Operating Conditions -10°C to +55°C, RH 90% non condensing Protection Class IP50 The A850 Telemetry Gateway fulfills the specifications of following standards: • EN 55022 • EN 55024...
  • Page 320: Free And Open-Source Software

    • EN 60950 Free and Open-Source Software The A850 Telemetry Gateway contains third-party software packages which were made available to the public by their respective copyright owners under license terms which grant additional rights beyond mere usage of the software, such as the right to get, modify and redistribute the sourcecode of these packages.
  • Page 321 • Adcon provides support only for the A850 firmware packages distributed by Adcon running on the gateway hardware. Modified software or running the A850 firmware packages on other hardware is not supported by Adcon.
  • Page 322 CHAPTER 6 Appendix This file contains the copying permission notices for various files in the GNU C Library distribution that have copyright owners other than the Free Software Foundation. These notices all require that a copy of the notice be included in the accompanying documenta- tion and be distributed with binary distributions of the code, so be sure to include this file along with any binary distributions derived from the GNU C Library.
  • Page 323 CHAPTER 6 The FOSS software packages installed on the gateway are: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUD- ING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • Page 324 CHAPTER 6 Appendix ING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE. Sun RPC is provided with no support and without any obligation on the part of Sun Microsystems, Inc. to assist in its use, correction, modification or enhancement. SUN MICROSYSTEMS, INC.
  • Page 325 CHAPTER 6 The FOSS software packages installed on the gateway are: Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Page 326 CHAPTER 6 Appendix * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copy- right notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distri- bution.
  • Page 327 CHAPTER 6 The FOSS software packages installed on the gateway are: 2. Redistributions of source code must retain the authors' copy- right notice(s), this list of conditions, and the following disclaimer. 3. Redistributions in binary form must reproduce the authors' copyright notice(s), this list of conditions, and the following dis- claimer in the documentation and/or other materials provided with the distribution.
  • Page 328 CHAPTER 6 Appendix Dosfstools This package provides utilities to check and format data storage devices which use the FAT/VFAT filesystem. Licensed under the terms of the GPL version 2. Dropbear (http://matt.ucc.asn.au/dropbear/ dropbear.html) Dropbear is a small SSH 2 server and client. This protocol is a replacement for the TELNET protocol and transmits data in encrypted form.
  • Page 329 CHAPTER 6 The FOSS software packages installed on the gateway are: WISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFT- WARE. ===== LibTomCrypt and LibTomMath are written by Tom St Denis, and are Public Domain.
  • Page 330 CHAPTER 6 Appendix Delchev, Andreas Schultz, Jeroen Massar, Wez Furlong, Nicolas Barry, Justin Bradford, and CORE SDI S.A. Permission is hereby granted, free of charge, to any person obtain- ing a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to...
  • Page 331 CHAPTER 6 The FOSS software packages installed on the gateway are: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIM- ITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIA- BLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHER-...
  • Page 332: License Texts

    CHAPTER 6 Appendix 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copy- right notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distri- bution.
  • Page 333 CHAPTER 6 The FOSS software packages installed on the gateway are: Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Page 334 CHAPTER 6 Appendix WARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ========================================== This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com). Original SSLeay License ----------------------- Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) All rights reserved.
  • Page 335 CHAPTER 6 The FOSS software packages installed on the gateway are: the documentation and/or other materials provided with the distri- bution. 3. All advertising materials mentioning features or use of this soft- ware must display the following acknowledgement: "This product includes cryptographic software written by Eric Young (eay@crypt- soft.com)"...
  • Page 336 CHAPTER 6 Appendix This code is derived from software contributed to Berkeley by James A. Woods, derived from original work by Spencer Thomas and Joseph Orost. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
  • Page 337 CHAPTER 6 The FOSS software packages installed on the gateway are: Copyright (c) 1989 Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertis- ing materials, and other materials related to such distribution and use acknowledge that the software was developed by the Univer-...
  • Page 338 CHAPTER 6 Appendix Copyright (c) 1989 Carnegie Mellon University. All rights reserved. Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertis- ing materials, and other materials related to such distribution and use acknowledge that the software was developed by Carnegie Mellon University.
  • Page 339 CHAPTER 6 The FOSS software packages installed on the gateway are: ing materials, and other materials related to such distribution and use acknowledge that the software was developed by the Austra- lian National University. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission.
  • Page 340 CHAPTER 6 Appendix THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. eui64.c - EUI64 routines for IPv6CP. Copyright (C) 1999 Tommi Komulainen <Tommi.Komu- lainen@iki.fi>...
  • Page 341: Gpl-V2

    CHAPTER 6 The FOSS software packages installed on the gateway are: ** is" without express or implied warranty of any kind. ** These notices must be retained in any copies of any part of this ** ** documentation and/or software. *********************************************************************** Procps (http://procps.sourceforge.net/) This package provides a number of small utilities to extract infor-...
  • Page 342: Lgpl-V2

    Concurrent programming classes (http:// g.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/ concurrent/intro.html) These utility classes help with concurrent Java programming. Note that the A850 only incorporates parts of this library. Released to the public domain. Jakarta commons logging (http:// jakarta.apache.org/commons/logging/) A library for logging informations in Java applications. Licensed...
  • Page 343 CHAPTER 6 The FOSS software packages used for the graphical user interface are: DOM for Java (http://www.dom4j.org/) This library helps using XML, XPath and XSLT on the Java platform. Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved. Redistribution and use of this software and associated documenta- tion ("Software"), with or without modification, are permitted pro- vided that the following conditions are met: 1.
  • Page 344: License Texts

    CHAPTER 6 Appendix OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. JasperReports (http://jasperforge.org/sf/projects/ jasperreports) JasperReports powerful open source Java reporting tool and is used to for printing configuration and data of the gateway. Licensed under the terms of the LGPL version 2.1 or later.
  • Page 345 CHAPTER 6 License texts pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights.
  • Page 346 CHAPTER 6 Appendix "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language.
  • Page 347 CHAPTER 6 License texts interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License.
  • Page 348 CHAPTER 6 Appendix readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code.
  • Page 349 CHAPTER 6 License texts and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions.
  • Page 350 CHAPTER 6 Appendix 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded.
  • Page 351 CHAPTER 6 License texts 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM 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 PROGRAM (INCLUDING BUT NOT...
  • Page 352 CHAPTER 6 Appendix Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110- 1301 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY;...
  • Page 353 CHAPTER 6 License texts 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble...
  • Page 354 CHAPTER 6 Appendix We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library.
  • Page 355 CHAPTER 6 License texts free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software.
  • Page 356 CHAPTER 6 Appendix "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library.
  • Page 357 CHAPTER 6 License texts (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole.
  • Page 358 CHAPTER 6 Appendix accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not...
  • Page 359 CHAPTER 6 License texts under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License.
  • Page 360 CHAPTER 6 Appendix For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that...
  • Page 361 CHAPTER 6 License texts all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions.
  • Page 362 CHAPTER 6 Appendix 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded.
  • Page 363 CHAPTER 6 License texts 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY 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 LIBRARY (INCLUDING BUT NOT LIMITED...
  • Page 364 CHAPTER 6 Appendix Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110- 1301 USA Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer"...
  • Page 365 CHAPTER 6 License texts from this software without prior written permission. For written permis- sion, please contact apache@apache.org. 5. Products derived from this software may not be called "Apache" nor may "Apache" appear in their names without prior written permission of the Apache Group.
  • Page 366 CHAPTER 6 Appendix...

Table of Contents