addVANTAGE Pro 6.
Proprietary Notice The Adcon logo, Adcon Telemetry, Smart Wireless Solutions, the A720, A723 and A730 series, addIT, addWAVE, the A840 and A850 series and Telemetry Gateway, AgroExpert, addVANTAGE®, addVANTAGE Lite and addVANTAGE Pro are trademarks or registered trademarks of Adcon Telemetry GmbH. Excel® is a registered trademark of the Microsoft Corporation. Acrobat Reader® is a registered trademark of the Adobe Corporation. OOo.calc is part of the OpenOffice.
Contents Chapter 1. Introduction ________________________________________________ 6 What’s New in addVANTAGE Pro 6.
Contents Chapter 4.
Contents Properties for Extensions and Crops _________________________________________________ 50 Common Properties ___________________________________________________________ 50 Properties for Crops ___________________________________________________________ 50 The Crop Tab _____________________________________________________________ 51 The Treatments Tab ________________________________________________________ 51 The Irrigation Tab__________________________________________________________ 53 Properties
Chapter 1. Introduction This manual details the installation and use of the addVANTAGE Pro software product, which is used in conjunction with most of Adcon’s telemetry devices. For information about the installation and use of the telemetry devices, refer to the respective device’s manual. What’s New in addVANTAGE Pro 6.
addVANTAGE Pro 6.2 User Guide CHAPTER 1 What is the Adcon System? employing different wireless technologies, from private radio to GSM/GPRS based devices. An RTU has its own intelligence in the form of a built-in microcontroller, which periodically performs several tasks, for example, interrogate the sensors, store the measured data, check the radio channel, check the local battery status, and so forth. It is part of a remote station, which consists of the RTU, its assembly parts, and its sensors.
addVANTAGE Pro 6.2 User Guide CHAPTER 1 WAP Access WAP Access WAP access is automatically enabled in addVANTAGE Pro 6.2 and it is password protected. The information accessible via WAP is limited and the users can access only the last value recorded for each tag. However, you can disable password protection for WAP access on your server. To access the addVANTAGE Pro server via WAP, your users need to enter (and store) a link similar to: http://yourserver.domain.
addVANTAGE Pro 6.2 User Guide CHAPTER 1 Summary Listbox This area shows a list of choices you can select by clicking. Dropdown A box with a small down arrow ( ) you must click before you can see the list of choices to select from. Button These are rectangular shapes with a name. Select a button by clicking it. Tab Click to see another view of the dialog. Documentation Certain conventions apply in this documentation.
addVANTAGE Pro 6.
Chapter 2. Getting Started Since the initial introduction of addVANTAGE Pro 5 in 2006, you have been able to access the client software through a standard Internet browser such as Microsoft Internet Explorer or Mozilla Firefox. While you still have the option to install addVANTAGE Pro on your own machine, you can also work through an internet connection linking up to your data provider’s addVANTAGE Pro 6.2 server, accessing all the features through your web browser on that machine.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Connecting to addVANTAGE Pro Connecting to addVANTAGE Pro You connect to addVANTAGE Pro by starting your browser and entering the URL of your server, for example, http://addvantage.adcon.at:8080. A web page similar to the one in Figure 3 is displayed in your browser. Figure 3. addVANTAGE Pro Login Window If you need browser information for logging in, you can click the question mark ( ) on the login window. A page with login help is displayed.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Navigating the Data Objects in the Explorer Use the Explorer to navigate through all the objects in your system: areas, RTUs (devices), tags (sensors), extensions, and panels. All such objects are generically called nodes. You can open more than one Explorer at once, each showing different levels of the system tree. You can also move certain node types from one area to another.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Navigating the Data Functions in Explorer As the “main window” in addVANTAGE Pro, the Explorer offers many features. In addition to the usual expand/collapse of branches by clicking the plus (+) or minus (-) sign, you can rename a node just by clicking the name twice. You can also right-click a node and see a variety of options on the context menu, depending on the node type and the permissions your user ID has.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Navigating the Data Manual Event When you right-click a node in the Explorer, you’ll see a Manual event choice. Select it to display a dialog similar to the one shown in Figure 7. Figure 7. Creating a Manual Event 1. 2. 3. 4. 5. In the Begin Date field, enter or select the date you want to be associated with the event. Leave the Duration fields blank if this is an active event.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Navigating the Data 2. Select Change values manually to display the dialog shown in Figure 8. Figure 8. Change Values Manually Dialog 3. 4. Target shows which value you selected to change. Click the down arrow next to Source to choose what you want to do: • Copy values from another tag Select this when you know another tag has the correct values and you want to copy them to the current tag. Continue with step 4.
addVANTAGE Pro 6.2 User Guide CHAPTER 2 Navigating the Data Menubar and Toolbar The menubar and toolbar in the Explorer (Figure 10) provide different ways to access the features of addVANTAGE Pro 6.2. Figure 10. The Menu Bar and the Toolbar Menubar • • • • Tools: accesses addVANTAGE Pro 6.2 user options and other administrative tools. Window: refreshes the current window and allows you to select an addVANTAGE Pro 6.
Chapter 3. Node Properties and Tools The robust Properties and Tools features in addVANTAGE Pro are the building blocks of the system. Properties let you tinker with node settings such as whether a node is connected to the server and what to do when a threshold is reached. The tools options affect system-wide settings such as data acquisition and e-mail. The tabs you see on the Properties dialog depend on the node type and, in some cases, your user role.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 Node Properties Node Action Properties With the Action tab, you can specify the action that a certain event will cause. The example below illustrates the sequence that occurs when an extension’s threshold event is “Treatment recommended” and action is “E-mail.” The extension registers itself as listener on the input tag (e.g. the Temp sensor) as soon as you set the Temp sensor as an input tag of the extension.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 Node Properties • Note: When you select this action, you must enter the appropriate Phone numbers and, optionally, select the Soundfile you want to be played. E-mail sends an email to the Recipients you specify in the field below. In specifying recipients, you can enter full e-mail addresses in the format name@address.extension. For recipients who are also system users, you can enter a shortcut in the format user{name}, such as user{root}.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 Node Properties can also select None for any of the fields to prevent anyone from viewing or editing the node. Figure 14. Security Tab of Node Properties Dialog For Children Nodes, you select whether to have child notes get the same privileges as the user or the privileges of the node. Figure 14 also shows the Availability section. If you select the checkbox in this section, users who are not logged in will still be able to see the node.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 Node Properties The other difference between RTU and tag properties is the addition of the Climate setting immediately above the Attributes button (Figure 16). You use this setting to select the type of climate applicable to the RTU’s location. You can also click Detect by GPS to automatically select a climate setting based on GPS coordinates. Figure 16.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 Node Properties Tag Threshold Properties Use the Thresholds tab (Figure 19) to set conditions that will trigger an alarm, event or service log entry when a threshold has been reached. Figure 19. Thresholds Tab of Tag Properties Dialog One of the actions you can set on the Action tab is for the Threshold reached event. Use the Thresholds tab to create the threshold that causes the action to occur, as detailed in the following steps: 1. 2.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 The Tools Menu d. If you used any of the “between” conditions, enter the other value in the Value2 field that appears. The following table describes how values are used with these conditions. Sample Value 1 Sample Value 2 is between (incl) 2.0 5.0 2.0, 3.0, 4.0, 5.0 is between (excl) 2.0 5.0 3.0, 4.0 is between (incl - excl) 2.0 5.0 2.0, 3.0, 4.0 is between (excl - incl) 2.0 5.0 3.0, 4.0, 5.0 Condition 3. 4. Condition Applies to e.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 The Tools Menu Selecting User Options To change options in your addVANTAGE Pro user profile, select Tools User options in the Explorer window. The dialog shown in Figure 22 appears. Figure 22. User Options Dialog, My Settings Tab My Settings Tab Use the My Settings tab to view or change various settings: • • Select the Language dropdown to choose the language used by addVANTAGE Pro during your sessions.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 The Tools Menu Options for Trends These options serve two purposes: 1. 2. At the top of the section, select the default view to use for a trend you create when you select View Data from the context menu: graphic, table, or instrument. From the boxes that follow, define color defaults for the Graphic view of new trends. You cannot use this dialog to change the colors in open or existing trend panels.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 The Tools Menu If a specific crop extension has been made invisible on the Extensions tab (as described next), the extension will not appear in any list of disease models or calculation extensions that can be added to the crop. Your ability to edit this dialog depends on your role. Extensions Tab Use the Extensions tab (Figure 26) to select whether to Show advanced settings in extensions.
addVANTAGE Pro 6.2 User Guide CHAPTER 3 The Tools Menu Area (square centimeter) in the Metric system will be displayed as Area (square centimeter). If you select the Imperial system, the displayed unit changes to Area (square inch). You can also make specific selections for one or more of the original engineering units. To use a different displayed unit, select the Custom, system and click the radio button indicating the unit you want to be displayed, such as Area (square foot).
Chapter 4. Creating Panels Lists, Trend Viewers, and Event Viewers are panels that offer different ways to view data in addVANTAGE Pro 6.2. The List Use the List to display a group of addVANTAGE Pro objects in a different way. The List is similar to an Explorer view, with the difference that the objects in a list are not expandable. Use a List when you need to work on a group of objects with similar properties, for example, configure extensions or synchronize tag settings.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The List 1. 2. 3. 4. 5. In an Explorer, click the Search icon (the magnifying glass icon on the right side of the text box in the Explorer toolbar) to open the advanced search dialog (Figure 31). Node name is displayed by default, with the default property of contains. Enter Adcon in the text field. Click the Add criteria dropdown, then select Class. Another line of search parameters is displayed in the Search dialog.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer The Trend Viewer Use the Trend viewer to see a plot of tag values stored in the database. To open a Trend viewer, click New Window and select Trend. The trend toolbar is shown in Figure 33. Figure 33. Trend Viewer’s Toolbar Prior to explaining the ways to display data in a Trend viewer, please make yourself familiar with the tool bar and its elements, which you will frequently use in your daily work with addVANTAGE Pro 6.2.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer Show Values at Cursor Displays the values of each tag in a little flag next to the cursor. This allows a faster understanding than looking at the legend. Button 14 Always jump to last available data Sets the Trend view to always open showing the last available date. (Replaces having to open a Trend view and click Go to End.) Button 15 Graphical view Displays the Trend’s values on a graph.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer placing the cursor in the legend for the respective tag. After a short delay a tool tip pops up, displaying the tag’s full path. Note: Currently the drag and drop method works only if you are using Microsoft Internet Explorer. In Firefox you can still drag and drop tags, but only onto a Trend viewer icon within the same Explorer. Viewing Trends from Explorer addVANTAGE Pro 6.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer display, click the OK button. The Trend viewer displays the tags and their data in a graphic form. Figure 36. Selecting, Adding, and Removing Tags Note: If no plots are displayed, check the date and use the arrows and the calendar in the Trend viewer to move to a date and time where you have data.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer • • refreshed and the scale of the selected sensor is shown. However, if you select the Always show y-axis checkbox, you will see the current sensor’s yaxis and the y-axis for the sensor you select in the Legend. Use the Major Grid to show horizontal lines. The number gives the number of lines spread over the value range of the sensor and the values between the lines.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer The trend’s thresholds are only informational and thus are not the same as the tag’s thresholds. Figure 38. Trend Properties, Thresholds Tab Following is an explanation of the options on the Thresholds tab shown in Figure 38. • • • • In the Thresholds list, use the Add, Remove, Move Up, and Move Down buttons the same way you use them for Tags. In this case, however, when you Add a threshold, you will give it a name that has meaning for you.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer Display Tab Following is an explanation of the options on the Display tab shown in Figure 39. These options apply to the Trend itself, not the individual tag selected in the Tags list. Figure 39. Trend Properties, Display Tab • • • • • • • • Time Axis • If you select the Major Grid checkbox, vertical lines will display on the grid. The number of lines is not selectable, but it depends on the selected time range (e.g.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer group of RTUs and be able to inspect or compare them at a glance, such as the example shown in Figure 40. Figure 40. A Trend Viewer Showing Tags from Several RTUs You can export all of the data from this graphical view the same way as from the table view, which is described on page 40. Saving Trends Now that you’ve configured those tags, you might want to save this panel for later use.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer Create a Trend from a Template If you have to create a large number of identical panels on different areas, you can use the Trend from template function and save yourself some work: 1. 2. 3. 4. Create a panel in a single area by using one of the methods previously described, then add the tags you need and configure the panel’s properties. Save the panel in its area. This will be used later as a template panel.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Trend Viewer If you want to add values to the table, right-click in the table and select Add new values to display the dialog shown in Figure 43. Figure 43. Adding a Value in the Table View Say you manually recorded values in addition to the u’s values. You can add them to the table by following these steps: 1. 2. 3. 4. 5. 6. Note: Select the tag (that is, the Tag) from the dropdown.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer Should you want to export all the data of a selected trend, you need to: • • Set the start date to the beginning of the database (Button 5 - Go to Begin) Select Custom in the Span Chooser (List 12), then select a reasonable duration that shows all of the data on the Display tab. Method 2: Export selected data sets only (copy to clipboard) If you want to export only a few lines of data from the current screen, you can copy them to the clipboard.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer Selecting Nodes Use the Nodes tab (Figure 47) to select the nodes whose events you want to display. It is the second tab in the Properties dialog, but you must select a node before you can select the event types to display alarms for. With addVANTAGE Pro 6.2, all nodes can issue events. Figure 47.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer list. Use the Check All and Uncheck All buttons to select or unselect all events at once. Figure 49. Events Options Dialog, Event Types Tab The Event Types tab has several options for viewing events. First, you can select which types of events to view in the Severity section: • • • Show alarms displays alarms. Show events displays events.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer Selecting Event Options The Events Options tab (Figure 50) has customization options for the data to be displayed in the viewer. Figure 50. Events Options Dialog, Events Options Tab • • In the Columns section, each checkbox represents a column. Select the columns you want to see in the viewer The Duration Options mirror the settings on the toolbar. You can choose to Always jump to last available data or not.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer while it’s the Statistic extension that has an alarm, the Hop crop and the Dimi area folder also show the alarm icon. Figure 52. Alarm Icons in the Explorer Locating the Source of an Alarm If you notice in an Explorer that an area shows an alarm, you can right-click the node and select Show Events. An Events viewer properly configured for you is displayed, showing only the alarms pertinent to the selected object.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer The dialog shown in Figure 54 appears. Figure 54. View/Save dialog for Event List PDF Notice that the file is named report.pdf by default. You can view the document immediately by selecting Open with, or you can use Save to Disk to save the file to the default location for your downloaded files. If you open the PDF, then save it, it is by default saved in your Temp folder.
addVANTAGE Pro 6.2 User Guide CHAPTER 4 The Events Viewer Note: The original panels are not affected. Figure 55. Linked Panels To change the properties of an individual panel, right-click the appropriate panel and select Properties.
Chapter 5. Working with Extensions and Crops As with previous versions, the addVANTAGE Pro 6.2 software has extended functionality through additional software modules called extensions. Extensions are entities that perform calculations. The types of extensions you work with are calculation extensions and disease models. Crops are nodes that store information about phenophases, irrigations, and treatments. They are not extensions.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Adding Extensions and Crops to an Area extensions by selecting the respective extension in the Explorer, right-clicking, and selecting Recalculate. Adding Extensions and Crops to an Area Extensions can be added to areas and crops, while crops can be added only to areas. To add either, follow these steps: 1. 2. 3. Open an Explorer. Select where you want the extension or crop added (use the shift and control keys if you’re selecting multiple locations).
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops Properties for Extensions and Crops Some extensions and crops must be configured. To display the properties (Figure 57), highlight the extension or crop in the Explorer and click the Properties icon. Figure 57. Statistics Extension Properties Dialog, General Tab Common Properties Figure 57 shows the properties specific to the Statistics calculation extension.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops The Crop Tab Use the Crop tab (Figure 58) to specify and monitor the phenological stages of crops. Figure 58. Apple Crop Properties, Crop Tab Note: Clicking a phase causes a graphic depiction of the phase to be displayed on the right side of the dialog, if such a graphic is available.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops If the chemical you want to apply is not in the system’s database, you must first add it. For more details about adding to or modifying the chemicals database, refer to the addVANTAGE Pro 6.1 Extensions and Crops manual. Figure 60. Apple Crop Properties, Treatments Tab Adding Treatments A spraying application usually follows a treatment recommendation (displayed in the Events list).
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops The Irrigation Tab Use the Irrigation tab (Figure 62) to create irrigation schedules for the crop. Figure 62. Apple Crop Properties, Irrigation Tab Adding an Irrigation Schedule When you add an irrigation schedule, you are telling the model what type of irrigation, how long the irrigation occurs, and how much irrigation the crop gets (Figure 63). Follow these steps to add this schedule: 1. 2.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops The Extension Tab Most calculation extensions have an Extension tab, as shown in Figure 64. Figure 64. Statistic Extension Properties, Extension Tab The Extension tab contains options and configuration panels that are specific to the extension. The Advanced Settings Tab The Advanced settings tab (Figure 65) provides additional information about the extension options. Figure 65.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops The Inputs Tab The Inputs tab (Figure 66) allows you to set the input tags for the extension. The extensions have an intelligent algorithm that searches for the appropriate tags, but only within the extension’s own area. Figure 66. Extension Properties Dialog, Inputs Tab Adding Inputs If some tags are missing and the auto discovery feature fails, you should manually intervene to identify the required tags.
addVANTAGE Pro 6.2 User Guide CHAPTER 5 Properties for Extensions and Crops can unselect the Use climate settings checkbox and enter or select the data you want. The Schedule settings are the same as for calculation extensions.
Appendix. Appendix This appendix contains information concerning third-party tools Adcon employs. Third-Party Tools The following tools are used in the addVANTAGE Project. You can find the actual license agreement for each tool in our separate addVANTAGE Pro Third-Party License Agreements document. ant.jar Version 1.6.2 http://ant.apache.org Apache License Version 2.0, January 2004 Used to compile the project with dependencies on other project parts antlr-2.7.6.jar Version 2.7.6, Current Version 3.
addVANTAGE Pro 6.2 User Guide APPENDIX Third-Party Tools commons-discovery-0.4.jar Version 0.4, Current Version 0.4 http://commons.apache.org/discovery/ Apache License Version 2.0, January 2004 Webapp programming framework commons-logging.jar Version 1.0.4, Current Version 1.1 http://jakarta.apache.org/commons/logging/ Apache License Version 2.0, January 2004 Helper for Scheduler (Quartz) commons-logging-api.jar Version 1.0.4, Current Version 1.1 http://jakarta.apache.
addVANTAGE Pro 6.2 User Guide APPENDIX Third-Party Tools hibernate3.jar Version 3.4.0.GA, Current Version 4.0.1.GA https://www.hibernate.org/344.html LGPL Database framework hibernate-entitymanager.jar Version 3.4.0.GA, Current Version 3.4.0 GA https://www.hibernate.org/397.html LGPL Database framework hsqldb.jar Adcon-Version http://hsqldb.org/ LGPL (Version 3, June 2007) Database iText-2.0.7.jar Version 2.0.7, Current Version 5.0.0 http://itextpdf.com/ LGPL (Version 2.
addVANTAGE Pro 6.2 User Guide APPENDIX Third-Party Tools jfreechart-1.1.1_adcon.jar Version 1.1_adcon, Current Version 1.0.6 http://www.jfree.org/jfreechart/ LGPL (Version 3, June 2007) Chart drawing tool jmf.jar http://java.sun.com/products/java-media/jmf/ JMF License Java Media Framework, used to play Wave files in SIP calls jsf-api-1.2_04-p02.jar Version 1.2_04-b16-p02, Current Version 2.0 http://java.sun.
addVANTAGE Pro 6.2 User Guide APPENDIX Third-Party Tools myfaces-impl-1.2.3.jar Version 1.2.3, Current Version 2.0.0-alpha http://myfaces.apache.org/ Apache License Version 2.0, January 2004 Webapp programming framework nist-sdp-1.0.jar http://jain-sip.dev.java.net/ Public Domain Used in SIP Calls ojdbc14.jar Version 10.2.0.1.0, Current Version 10.2.0.1.0 http://www.oracle.com Bought Used in the Oracle database connection quartz.jar Version 1.6.0, Current Version 1.6.0 http://www.opensymphony.
addVANTAGE Pro 6.2 User Guide APPENDIX Third-Party Tools velocity-1.4.jar Version 1.4, Current Version 1.5 http://velocity.apache.org/ Apache License Version 2.0, January 2004 Framework that supports web development velocity-tools-1.1.jar Version 1.1, Current Version 1.3 http://velocity.apache.org/ Apache License Version 2.0, January 2004 Framework that supports web development xalan.jar Version 2.7.0, Current Version 2.7.1 http://xml.apache.org/xalan-j/ Apache License Version 2.
Index A acknowledged events, 43 action types, 19 active alarm/event, 43 Adcon system, 6–7 adding actions, 19 areas in Explorer, 14 extensions and crops to areas, 49 irrigation from events viewer, 45 manual events from events viewer, 45 multiple extensions and crops, 49 objects to a List, 29 RTU diagnostics to a tag, 49 RTU diagnostics when adding RTU, 26 tags to trends, 33 treatments from events viewer, 45 advanced settings properties, 54 search, 17 showing for extensions, 27 alarms acknowledging, 44 d
addVANTAGE Pro 6.
addVANTAGE Pro 6.
addVANTAGE Pro 6.