ENVIS Application User Guide Version 1.8 for Supported Measuring Instruments. K M B systems s.r.o

Transcription

1 ENVIS Application User Guide Version 1.8 for Supported Measuring Instruments K M B systems s.r.o September 5, 2017

2 1 ENVIS software is distributed alongside the advanced PQ monitors and energy analyzers produced by the KMB systems. It is a basic tool for configuration, management and data acquisition for the supported measuring controllers and analyzers. Data are archived in a SQL databases and binary CEA files. It also supports export to standard formats such as XML and CSV, PQDIF, NEQUAL. ENVIS provides basic visualization and analysis of the trend data of energy utilisation and power quality. It can be used in energy management systems as per EN ISO 50001:2011. Its architecture is modular so as that its features can also be expanded with additional plugins (see ch. 6). An installation package contains the following components: ENVIS for analysis of the archived measurement records trend visualization, archives, reporting, exports, energy efficiency and management, power quality compliance etc. ENVIS.Daq (Data Acquisition) to manage the device configuration, download data and store it to various formats. Also contains locator tool to simplify the discovery of network instruments. ENVIS.Online optionally licensed system service for continuous online data acquisition, analysis and reporting. First two instruments can be used without license for feature evaluation purposes. UpgradeTool is used to update firmware in instruments over the USB, serial line or Ethernet. e-get, e-set, export, report (.exe) - set of command line tools for simple scripting of data acquisition, processing and reporting tasks.

3 Contents 1 Software Installation USB Driver Installation Remote Communication Option Setup MS SQL Server and Database Setup Getting started Connecting new instrument to the computer Installing USB driver Discovering instruments over the Ethernet Locating RS232/RS485 instruments Locating the ES and MM slaves Configuration of the instrument Basic communication parameters Basic installation setup Time and date setup Visualization of the actual data Using ENVIS.Daq Connecting to the embedded web server of the instrument Download the archive data Process the downloaded data Manual data analysis Report generation and basic configuration Export and aggregate the archived data Visualization and Processing Data sources Object list features Analysis of downloaded data Main archive Set- and Max-Day profile archive LOG archive PQ main archive Only for instruments connected via USB 2 Only for instruments with internal memory for archives 2

4 CONTENTS PQ event archive PQ oscillogram archive PQ event trend archive Electricity meter reading archive Navigation through the records Trends and charts Application setup Import and Export Features Database backup ENVIS.Online Service Installation License generation Client usage and configuration Plugins for ENVIS Management of Plugins Plugin Licence Activation Report Plugins EN50160 Report Plugin PQ events report eplug Import/Export Plugins PQDIF Export Plugin Data Processing Plugins Histogram Plugin Scatter Plot Plugin ENVIS.Online Plugins ENVIS.Online Reporting Plugin Troubleshooting ENVIS Issues with ENVIS Issues with instruments ENVIS Error Logging System A Quantity Abbreviations and Terminology 71 A.1 Abbreviations of basic quantities A.1.1 General information A.1.2 Basic quantities A.1.3 Flags and states A.1.4 Communication statistics A.1.5 Inputs and Outputs A.2 Electricity meter readings A.3 Voltage events

5 CONTENTS 4 A.4 Flags ( ) A.4.1 GO Triggers B Instrument status, archived logs and error codes 86 B.1 Error Codes B.2 Status Information B.3 Event Logging C Frequently Asked Questions 89 C.1 ENVIS: How To C.2 Instruments: How To C.2.1 reset an instrument to its factory defaults C.2.2 enable the optional firmware modules D Release informations and changelog 96

6 Chapter 1 Software Installation The software is supported in MS Windows environments (32-bit, 64-bit) and is currently tested in desktop Windows 10, 7 and 8.1 and Windows Server 2008 R2, 2012, 2012 R2 and It might with limitations also work on other versions of the Windows operating systems - in any case make sure that the system and the.net framework is updated to the most recent version. During or after the installation the system might require to restart your computer. So before you begin do save all your current work and close all unnecessary applications. Carefully backup all the data. If a previous installation of ENVIS is already present in your system it must be uninstalled before proceeding with the actual installation. When ready, un-zip the installation package into a local temporary directory 1. Run the setup.exe - installation should normally proceed and will install all required components into the system. Custom installation folder location can be specified in the wizzard. Finally the required system service and database access libraries from Microsoft are installed in a separate window. The support of SQL database storage is optional in ENVIS. If required the actual instance of MS SQL server and database can be installed and configured separately. Supported versions of SQL server database is version 2012 and newer. For PC with limited resources users can use portable ENVIS.Daq Standalone (available online) to set up instruments, download all data and store them in CEA file. Firmware upgrade tool standalone is also available. This is useful for computers and laptops with limited resources or where installation of software with proper admin rights in not allowed. To remove previously installed ENVIS start Control Panel Programs and Features, select the appropriate ENVIS program and choose the uninstall option. Proceed accordingly. ENVIS.Online service is automatically installed to the system but is not started automatically. It is configured the first time the ENVIS.Online Client application starts. See ch. 5 on page 44 for more details. Start-up of the service can also be configured in the Windows control panels related to services. To do so navigate to Computer management section Services in your system. Locate service called ENVIS.Online and proceed as required. 1 Installation requires MS.NET framework 2.0 or higher and under normal circumstances installs it automatically. If the automatic installation fails please install the required.net framework manually. 5

7 CHAPTER 1. SOFTWARE INSTALLATION USB Driver Installation Some analyzers and instruments are equipped with an USB interface. The Windows operating system in PC needs to be correctly configured before such supported instrument can be served by the ENVIS software using its USB port. When the device is connected to the PC over the USB for the first time, user will be asked to provide a driver file to the operating system. Browse to the ENVIS Installation Folder/Driver directory and select the KMB USB.inf driver file. New driver will be installed to the PC. For USB communication there is no need to configure any other parameter in the instrument. Connected instruments appear in the Device Manager under the USB devices and also become immediately available in the drop down box in Daq. 1.2 Remote Communication Option Setup The remote configuration parameters (if any) needs to be configured manually in the appropriate configuration menu on the instrument screen or by using the available local communication and ENVIS.Daq software. For serial communication the protocol, speed and device address must be configured appropriately in the instrument. For devices with an optional Ethernet communication the IP address, network mask, gateway and ports for each protocol must be configured. For some Ethernet instruments the Locator feature of ENVIS.Daq can be used to discover new or unknown instruments in the local network. 1.3 MS SQL Server and Database Setup Actual version of ENVIS supports MS SQL server database as a data storage option. It is recommended to use SQL Server version 2012 or newer. Version 2008 with the most recent service packs is suported on some old systems. ENVIS supports booth Windows authentication mode and Mixed authentication mode. The server and database requires correctly configured FILESTREAM functions. See the respective property panels in the Sql server configuration manager (full access enabled) and in Microsoft SQL Server Management studio (all options enabled). For full functionality the user must have database rights assigned at least the following level of the corresponding roles: db owner or db datawriter, db datareader and db ddladmin.

8 Chapter 2 Getting started 2.1 Connecting new instrument to the computer ENVIS.Daq is a tool to communicate, configure and download a measuring instrument or a power factor controller. Upon its start two tabs are immediately available to quickly connect to a desired instrument. For connection over the Ethernet the tab TCP requires a valid IP address or domain name of the instrument and its respective port (default 2101). The valid Device Address is only required when actually the given IP address is a converter between Ethernet and a serial line. For common instruments the Device type is KMB. KMB Short option is valid for older type of instruments v1 and v0.9. Mod-bus electricity meter or M-BUS option integrates data from a third party mod-bus/m-bus meters. The REST option enables reading of quantities from the supported REST API interfaces. To connect to the instrument hit Enter key or select Connect menu item. After successful connection a main Daq window will be opened - see fig. 2.3 and 2.4. The collapsed Identification panel shows detail information about instruments hardware, firmware, modules, serial number etc. On the left side buttons offer access to the actual data panel, instrument configurations and device status information. Shortcut button can be used to generate quick access to the connection from a selected folder on the computer - Click, CTRL-Click (opens actual data), Drag&Drop and CTRL-Drag&Drop are all available functions. Setup/Connection Setting opens a dialog with global communication options, which influence a performance of the all the data acquisition. Timeouts control how long an attempt lasts to connect to or to receive reply from the instrument. Packet size - value 6800 enables use of so called jumbo packets for Ethernet networks where available, value 1300 is a default value for almost all standard installations. For specific sites such as 2G/3G routers with uncommon MTU setup the user can specify his own custom value. The smaller the packet size is, the slower the communication will be. 7

9 CHAPTER 2. GETTING STARTED 8 Figure 2.1: ENVIS.Daq - entering the instrument connection properties. Figure 2.2: Global connection setting influences system reliability and latency of the communication in a location specific projects.

10 CHAPTER 2. GETTING STARTED 9 Figure 2.3: DAQ - main window of an instrument without historical data memory (SML133). Figure 2.4: DAQ - main window of an instrument with historical data memory (SMC235 with MM, GO, PQ-S,...). The Destination panel governs whether downloaded data will be stored in file or database. Downloader button opens panel with progress of the actual operations and results for the previous ones. Advanced button enables more specific definition of the downloaded interval. Recording button can manually stop the creation of all the archives in the instrument.

11 CHAPTER 2. GETTING STARTED Installing USB driver 1 1. Plug USB cable to the computer and to the instrument. 2. Windows will start to search for driver for connected device. Automatic driver installation might fail if there is no driver already installed. Otherwise it normally installs new USB device into your system. Figure 2.5: System message for installation of the USB driver (left) and a message for situation where the actual driver can not be found in system (right). 3. Navigate to Device Manager located in Control panel of Windows. Locate item Other devices and in it s sub-tree you should see your instrument with little exclamation mark (fig. 2.6). Raise context menu on this item (right mouse click) and select Update Driver Software.... Figure 2.6: Incompletely installed instrument with an exclamation mark. 4. On Update Driver Software screen select second option Browse my computer for driver software. Figure 2.7: Choosing and installing the correct USB device driver. 5. Define location of driver by clicking Browse and navigating to Driver folder located in 1 Only for instruments connected via USB

12 CHAPTER 2. GETTING STARTED 11 your ENVIS installation folder and click Next. (default path is C:\Program Files\KMB systems\envis 1.8\Driver ) 6. After-while driver should be installed. 7. After installing the driver, you can connect to the instrument by ENVIS.Daq. Run EN- VIS.Daq, switch to COM tab and select your device with appropriate port from roll down menu. Then press connect and you will be connected to the instrument Discovering instruments over the Ethernet In cases you have instrument connected to your local network and you don t know it s IP or domain address you can use the Locator Tool in ENVIS.Daq. This tool discovers all visible KMB instruments connected via Ethernet to your LAN. See fig Figure 2.8: Opening the Locator window to automatically discover instruments in local network. All discovered units are listed and can be accessed directly through the Connect button. The View tab displays a different perspective for the discovered units. The Archive button transfers a discovered instrument into the archived tab/list. The Archived tab organizes all known instruments added by users into a hierarchical list. The bar on bottom of the window offers additional tools and information for the locator function Locating RS232/RS485 instruments Locator tool in ENVIS.Daq also allows to locate instruments connected to the serial port. This feature is especially useful when you don t know exact Device addresses of your connected instrument. See fig. 2.8.

13 CHAPTER 2. GETTING STARTED 12 Figure 2.9: Locator for serial line communication: setting up communication parameters (left) and the discovered instrument (right). 1. Press button Locate on 232/ Fill in the required parameters into the form. 3. Tool will start enumerating list of address on selected port. 4. When instrument is located, double click on in in the list. Setting will be transferred to the ENVIS.Daq and you can connect to the instrument by standard way Locating the ES and MM slaves Figure 2.10: ES locator in the ENVIS.Daq/Configuration/Communication tab discovers slave units on the selected and configured local communication. For slaves which do support a dual communication speed it can use booth speeds to discover the unit. Port speed: Auto will use the speed which is actually predefined in the port configuration. Instruments with active Ethernet-to-serial (ES) or Mod-bus master (MM) firmware module do serve as a concentrator for data to Ethernet clients from slaves connected on their local serial interfaces. In many situation it might be useful to discover those slaves remotely. A special locator function has been implemented in the communication configuration tab of ENVIS.Daq and in the firmware to discover such units comfortably.

14 CHAPTER 2. GETTING STARTED 13 Figure 2.11: Configuration window with an overview displayed (Summary tab.) and highlighted modifications. 2.2 Configuration of the instrument Warning: writing a new configuration to the device may result in a clearance of the stored data. Always read and backup the data from instrument before proceeding with the instrument management tasks. Some changes in the configuration may require the instrument to be restarted or disconnected during the operation. To prepare the instrument into the operation at least the following basic steps should be performed in its configuration. Some of the units can be alternatively configured through their local display interface (see the respective manual) but some need to be initialized over the communication interface with the use of ENVIS.Daq software tool. 1. Follow steps in ch. 1 to install the required software and section 2.1 to connect to the instrument locally or remotely via ENVIS.Daq. 2. Click on button Configs in the main window of Daq (fig. 2.4). 3. A complete configuration window (fig. 2.11) is opened with all the parameters organized in

15 CHAPTER 2. GETTING STARTED 14 Figure 2.12: Instrument configuration - Communication tab - serial line (COM 1) and Ethernet (ETH) panels are displayed among others. several tabs on the left side. 4. The Summary tab shows the most important configuration keys and values and highlight those which have been changed. 5. Specific parameters are organized inside the tabs. As soon as some parameter is changed, its tab displays an orange exclamation mark and the new value of that parameter is highlighted in red color in the Summary tab. 6. Bottom left of the window is occupied with Save and Load functions to backup and restore the actual configuration to/from a file. 7. Bottom right of the window is occupied with Send and Receive functions to write or read the actual configuration to/from an instrument. 8. User can freely switch back to main window or other opened windows while the configuration is open. 9. Most to the bottom right is a Close button to leave the configuration window Basic communication parameters Warning: writing an incorrect communication configuration to the (remotely) connected device may result in a loss of the connectivity. Always properly check the input values and make sure you can achieve physical access to the instrument in case of any unexpected trouble. 1. Select Communication tab. Each instrument offers a different set of parameters according to its available features.

16 CHAPTER 2. GETTING STARTED 15 Figure 2.13: Instrument Configuration - Install tab contains the most important configuration options related to the measured site and methods - nominal values, current transformer ratios, connection methods etc. In the Advanced panel there are some interesting options (hidden by default and for simplicity). 2. Change the appropriate parameters for serial line or Ethernet interface - it will be located in the appropriate COM or ETH panel. 3. Click Send to write the modified configuration to the instrument. 4. The ENVIS.Daq will display a warning and disconnect from the device. 5. Instrument will restart and apply the configuration change Basic installation setup Warning: modification of an installation configuration in the device always results in clearing of all the recorded information in the instrument. Always read and backup the data from instrument before proceeding with the instrument management tasks. 1. Select Install tab. Each instrument offers a different set of installation parameters according to its features. 2. Select nominal frequency, voltage, current and power according to the monitored network. 3. Select Via VT connection mode for higher voltage systems with (voltage) instrument transformer, select direct other-wise. 4. Select Connection type, VT ratio, CT ratio etc according to your actual setup. 5. In most cases leave the multipliers set to 1 and the advanced panel unchecked.

17 CHAPTER 2. GETTING STARTED 16 Figure 2.14: Instrument configuration - Time and date tab. 6. Click Send to write the modified configuration to the instrument. 7. The ENVIS.Daq will display a warning This operation can clear the archive(s). 8. If confirmed, the new install configuration is written to the instrument Time and date setup Warning: modification of time and date parameters in the device always results in clearing of all the recorded information in the instrument. Always read and backup the data from instrument before proceeding with the instrument management tasks. If the instrument has a real time clock it is always recommended to check its valid configuration before starting of the measurement. Before proceeding, make sure that your PC time is properly synchronized and the time zone info/summer time is set-up properly. 1. Select Time and date tab. If it is not present, your instrument does not have a backed up RTC. 2. Instrument time panel displays the actual PC time, instrument time and its difference. If it is too big, the difference is highlighted in red color. 3. Set instrument time panel offers various functions to adjust the time in the instrument. Adjust time will attempt synchronize the time and date non-destructively. the other two functions will set it in any situation, but instrument will erase all the old data. 4. Time settings panel offers time zone and summer time parameters. It also offers synchronization options - we recommend to us NTP to synchronize time where applicable. 5. Click Send to write the modified settings to the instrument.

18 CHAPTER 2. GETTING STARTED Visualization of the actual data Using ENVIS.Daq 1. Follow steps in section 2.1 to connect to the instrument locally or remotely via ENVIS.Daq. 2. Click on button Actual Data in the main window of Daq (fig. 2.4). 3. A panel with all the actual data is displayed (a) in its top left corner several layouts of its panels are defined to be chosen, next to the layout selector there is also a simple channel filter to hide phases which are not actually relevant for display, (b) in the top right corner the refresh interval and list of (groups of) displayed quantities can be defined (to limit the communication bandwidth), (c) values are organized in tabs according to the selection of the layout Connecting to the embedded web server of the instrument Figure 2.15: Main page of the instrument web site with live view of the measured data.

19 CHAPTER 2. GETTING STARTED 18 Each instrument with Ethernet interface offers a view of the actual data and basic configuration values over its embedded web server. Address of the web server is the instruments IP or domain name, port is by default 80 and can be changed in the communication configuration (see fig. 2.12). 1. Open a web browser and enter an address of the instrument 2. A simple web page all the actual data is displayed. The displayed data are automatically refreshed. 3. Navigation to data displayed on another pages is provided by the top page menu. 4. Configuration data is displayed only for reading and can not be modified over the web site. 2.4 Download the archive data 2 Figure 2.4 shows an instrument with several archive files available for download. All the archives are listed in the central area of the window. First column shows the name of the archive, second column displays actual count of the records (can be refreshed), third column allows certain archives to be picked manually for refresh, download and delete operations. Fourth column offers download functions per line, per selection and for all available archives. Fifth column offer the clear function for same choices. The choice of Destination influences where and how the data is stored. You can select either database or file and the file type - default CEA, various specific CSV formats, NEQUAL, PQDIF, etc. Figure 2.16: Selecting target destination for the data download - to a database or to a file. Figure 2.17: Downloader window with two tasks and its progress in detail. 2 Only for instruments with internal memory for archives

20 CHAPTER 2. GETTING STARTED Database: Press button Database and select your SQL server and database. To create new database press Create. Database selection is confirmed by pressing Connect. (a) File: You can choose between.cea file, which is native ENVIS file type for data and supports most features, or.xls or.csv. 2. When Destination of data is defined, you can initiate the download. Either by clicking Download link in row with respective archive or by clicking Download sel. which downloads all selected archives. 3. Downloader window is displayed (fig. 2.17) and a new task appears in the list: (a) each task displays its progress, number of communication problems such as timeouts or wrong data and a brief summary, (b) each task can be stopped or interrupted and (c) if a task is finished the data it received can be directly opened in a new ENVIS window. 4. The downloader window can be closed, but the tasks remain active on the background as long as the actual instance of ENVIS.Daq is running. 5. Additional operations can be started even while disconnecting the Daq from actual device and connecting to another one. 2.5 Process the downloaded data Manual data analysis To display the downloaded data: Figure 2.18: Selection of the data source in an object and measurement tree.

21 CHAPTER 2. GETTING STARTED 20 Figure 2.19: Selecting quantities for detailed analysis and creating new graph (trend) from the actual selection. Figure 2.20: Context menu over the selected values in an archive tree panel - to open data in a trend (graph) or in a table, to export the data, and to execute other special functions over the selected quantities.

22 CHAPTER 2. GETTING STARTED 21 Figure 2.21: Archive values displayed in a filtered table. Figure 2.22: Drag and drop selected nodes into the opened chart to add the quantities. 1. Run ENVIS. Click Open file to load data stored in file or Connect Database to load data from database. 2. Double-click on desired measurement in the Object List. Available archives stored under this measurement will be listed in lower part of the Object List panel. if there is only one measurement in the data source, it is automatically selected. (fig. 2.18)

23 CHAPTER 2. GETTING STARTED Browse through tree list and check quantities you would like to display in graph. (fig. 2.19) You can also use predefined sets in the Quantities sets node. 4. To create the graph, double-click with left mouse button on one of the selected quantities or click with right mouse button and select New Graph from context menu. (fig. 2.20) 5. To add quantities to existing graph select quantities you would like to add and drag them over the graph pane where you drop them.(fig. 2.22) 6. To open a table of values instead, right-click on the selected quantity(ies) and from the context menu select Table of all values or Table of selected values option. 7. Top part of the displayed table contains controls required to move in time, filter data in and out, or export the data. 8. For simpler and faster data processing the most common sets of selected quantities can be saved into Quantities sets node: (a) Default sub-node contains predefined sets. (b) User defined contains sets defined by the actual user (stored in the operating system) (c) Data source node contains set, stored in the actual file or database Report generation and basic configuration To create a customized report over the recorded data: Figure 2.23: Selection of input data for the report in a form of wizard.

24 CHAPTER 2. GETTING STARTED 23 Figure 2.24: Time interval and its separation to sub-intervals (master-detail) in a report customization dialog. Figure 2.25: Final report displayed in an ENVIS window, list of user defined reports in the lower left corner and its context menu features.

25 CHAPTER 2. GETTING STARTED Run ENVIS. Click Open file to load data stored in file or Connect Database to load data from database. 2. Select one or more objects or measurements from the Object List. With CTRL-Mouse Click, by holding the SHIFT key and moving the cursor with arrows or select all with CTRL-A hot-key. 3. Now there are several ways to start creating reports: (a) Function key F5 opens the last report configuration, (b) function key F6, F7, F8 and F9 opens various standard predefined report configuration for user modification. (c) CTRL+function key opens report wizard instead of standard configuration form (fig. 2.23) (d) SHIFT+function key creates the respective report immediately. 4. To manually configure a report in the report configuration window (fig. 2.24): (a) Select an interval for the report and optionally also the sub-interval in the upper part of the window. Sub-interval choice will generate subsections in most of the available reports. (b) In the report tabs, check all panels which you want to include in the final report output. (c) In each checked tab adjust the details of report setup according to your requirements. (d) You can Save and Load the report configuration to/from a file. (e) You can Save as... the configuration to a list of user defined report configurations. 5. To generate the report proceed through the forms of wizard or hit Create report button in the lower right corner of the configuration window. 6. To export the generated report to an external file click on arrow next to this icon and select option PDF, XLS, User modified configurations can be archived in a list of configured reports, organized in a user defined structure and reused in ENVIS, ENVIS.Online or directly from the Windows Explorer (fig. 2.25).

26 CHAPTER 2. GETTING STARTED Export and aggregate the archived data Figure 2.26: Export selected data from data source to a CEA, CSV, PQDIF or other supported output format. Figure 2.27: Configuration of the sub-division of the exported data and its aggregation. Data from every source can be simply exported to a supported output format, split and aggregated. Standard formats are CEA, CSV and XLS. other formats such as NEQUAL, PQDIF or customized CSVs can be added via plugins. Before export, user can define which quantities will be included in the output. To export data proceed as is shown on the fig and fig Data export functions are also available on charts, tables, in the object list and in a Data menu.

27 Chapter 3 Visualization and Processing 3.1 Data sources ENVIS can use an SQL Server database or a CEA file as a data storage. In Dashboard or in the menu the File Connect Database (CTRL-D) or Open File (CTRL-O) option allows user to connect to a specific data source. If a data source is correctly opened and initialized the Object List panel will display all data available. Path to the data source is displayed in the application label. The records are ordered according to the user preference by time, objects and record name. With database the backup and restore operation can be initiated from the application. Menu options File Backup resp. Restore serves to perform back up task on the database level. If the data source is a file, changes made during work are not immediately stored to file. Instead it preserves content in a temporary directory. Changes are saved by clicking menu option File Save (CTRL-S) or Save as...(ctrl-shift-s). User will be also asked whether changes should be saved when the application is closing. New records from a connected instrument can be added into the data source with ENVIS.Daq (ch.??). It can be started separately, with the Data Acquire Data menu option or from the Object List in its context menu Connect Device... options. 26

28 CHAPTER 3. VISUALIZATION AND PROCESSING Object list features The list of objects, devices and records in the ENVIS application is a tool to navigate all data stored in the data store (file or database). By default it shows all available devices grouped by Objects. Each device is recognised by its type and serial number. By double-clicking on a certain object, device or record in the Object List the Data Navigator panel (see 3.4) is updated with new details. For better clarity of object list, application provides also Alias column. User can specify his own marking of Object and Record Name there. This solution is suitable not only for instruments which doesn t support configuration of object and record name but also for improved transparency of recorded data. Configured values are then stored in data source (file or database). If a node with record is selected, it displays all available archived data in the lower view of the Object List panel. Categorization and ordering of the Object List tree can be adjusted in the sub menu. Right click on the Object List View... and choose the appropriate view method. By selecting the Show Identify Detail the software displays a floating panel with device information wherever the mouse cursor moves above the instruments. Items in the tree can be also managed from this submenu. To delete the selected item(s) press the Delete key or choose Manage List Delete Selected Items option from the context menu. Yes/No query form is displayed before the actual deletion proceeds. New nodes can be added with Add Object/Identify/Record Name. New items also appear automatically if data from new instruments are downloaded or imported into the data store. Content of an existing node can be adjusted with Edit Selected Item. Data Import and Export functions are available in pop-up content menu. The instrument tree can be also saved or loaded separately to back-up the list of all available instruments in a certain data set. This specific type of export preserves all the connection strings related to the contained instruments and can be used to port complex site definitions elsewhere. If a specific instrument node is selected, the context menu (fig.: 3.1c) also contains Connect Device item. It groups various choices to start the ENVIS.Daq directly from ENVIS and to immediately establish connection to the particular instrument. The lower view (panel) contains list of all available archives for the actualy selected record. Quantities and their abbreviations are listed and explained in the Appendix A. Further value analysis can be initiated by selecting single quantity or a set of multiple quantities. Selectors (check boxes) are used to refine the content of the data set to be displayed or analysed. The default action (either to display a chart or to display a table evaluation) is initiated by a Mouse Double Click on the item in the tree. Drag-and-drop feature is used to add series of quantities into the existing chart. Other optional actions can be started from the context menu. Specific action is to open chart with a preset time interval as a limit. This operation can be started from the tree by a CTRL- Mouse Double Click. Archive view of object list also allows users to store selection of quantities. Selection can then be recalled next time. To store selection proceed as follows: 1. Check all items in archive view list you want to add to selection.

29 CHAPTER 3. VISUALIZATION AND PROCESSING Type name of your selection to the box in lower part of the panel (fig. 3.1a). 3. Press button + and selection is stored under provided name. To restore selection proceed as follows: 1. Select name of your selection from the drop down edit (fig. 3.1a). 2. Check archives where you want to restore your selection until no checkbox is selected. 3. Check archive one more time. 4. Selection should now be restored. To draw graph directly from stored selection. Click with right mouse button on item in a Object list (Object, instrument, record). In context menu click on item Graph from raised list click on name of desired selection. (a) Selection of quantities profile (b) Filter control editor (c) Object List context menu with various options. Object list filter (CTRL-F ) is control that filters items in object list by user defined parameters. Filter control editor is accessbile via right mouse button click on object list and selecting Filter control from context menu or by pressing CTRL-F. Filter control editor contains text field where user sets key word under which object list will be filtered. Furthermore user can set which items (objects, records, identify, alias) are included in filtering.

30 CHAPTER 3. VISUALIZATION AND PROCESSING Analysis of downloaded data Figure 3.1: Mixed display of main archive, log and PQ event archives. The data source contains various records of the real data. Different operations and processes are available for different data. Most common feature of the archive record is an ability to be displayed as a time-value series in a chart. Main archive records, PQ main, S/M Profiles, logs, electricity meter readings, voltage events, oscillograms and other can be all added into the same chart and displayed. Main and PQ main archive readings are displayed as a regular value series (trends). Two points are connected with a line if the time span is corresponding to the recording interval and if no interruption of measurement occurred between the two records. Logs and voltage event records added to the chart will display spots or intervals in the time of the recorded event. Electricity meter in a chart is displayed as a bar with value of the difference between two consecutive readings. Its default behavior can be modified in Setup Global Counters View. Bars and Curves options can be used, the later showing counters ans trends. Duration of the actual meter evaluation interval can be adjusted in the Curve Properties form. Power quality related archives are analyzed in more specific ways and are described in greater detail in section?? Main archive Main archive contains quantity measurements with a fixed interval. Its total capacity is influenced by choice of archived quantities in the archive configuration, the type of instrument etc. For detailed information see the respective device maual. Quantities recorded in main archive can be analysed within reports, opened as a tabular view, exported to spreadsheet formats for further processing or displayed in a chart (default option).

31 CHAPTER 3. VISUALIZATION AND PROCESSING Set- and Max-Day profile archive Profiles are historical feature to record indetail the required specific situation. It has been discontinued with the new instruments as these have enough memory capacity to record more details continually. S-Profile is profile of a day which was taken at a specified date, M-Profile is a profile of a day when maximal sum of all currents occurred. Each profile is a measurement with fixed one minute aggregation and includes voltages, currents, powers, frequency etc. Profile archives are overwritten immediately after new profile starts recording. Profile records can be processed in same way as main archive records LOG archive (a) (b) Figure 3.2: Example of the archived log data in tabular form (a) and in trends (b) This archive contains information about operation of the device - such as changes in the configuration, power supply failures, resets, state changes etc. The LOG can be analyzed by a user in a table, exported to a file for further archiving or included in other charts to co-relate its events with recorded quantity data.

32 CHAPTER 3. VISUALIZATION AND PROCESSING PQ main archive Figure 3.3: Weekly power quality evaluation table and diagram Figure 3.4: PQ Main data displayed in a table. PQ main archive is available in devices with PQ-A or PQ-S option enabled. It contains data necessary to evaluate power quality in specified short periods (usually 10 minutes 1 ) and complete week evaluations as required by EN standard. It can be used as a stand alone source for statistical survey evaluation. If the campaign also requires other synchronized detailed data, than the main archive (sec ) can be pre-set to same interval and provide a complete measurement set. In the fig. 3.3 the power quality evaluation of the selected week is displayed. Dark green color is used for the quantities to display a region where the more strict criteria was met - for compliance it is required to be within this interval all of the time. Light green colored region represents the weaker criteria for quantity (usually 95% of time). Red color marks the failed category which did not met the preset criteria in the selected interval. The detailed 10-minute records can be displayed 1 Other intervals can be specified for nonstandard applications in the PQ settings form.

33 CHAPTER 3. VISUALIZATION AND PROCESSING 32 in the PQ Main table for more detailed overview of the failed week (fig. 3.4) PQ event archive (a) (b) Figure 3.5: Voltage events: archive records displayed as a CBEMA/ITIC curve diagram (a) and in a plain table (b). This archive is included in SMPQ device and is optional for SMP and SMV devices. Voltage events (power failures, sags, swells) are sources of many severe costs (damages) caused by poor power quality. According to standard the lowest achieved value, start and end time and phase information is stored in this archive. Parameters for the event evaluation are configured in PQ Settings Form.

34 CHAPTER 3. VISUALIZATION AND PROCESSING PQ oscillogram archive Figure 3.6: List of recorded PQ event oscillograms and chart with visualization of recorded values. This archive contains waveforms of recorded events. Further calculations can be performed in the PC software to evaluate parameters of each recorded event. In visualization user can influence which lines are displayed. An area can be selected using cursors which is than automatically processed and estimated quantities are calculated for the selected interval.

35 CHAPTER 3. VISUALIZATION AND PROCESSING PQ event trend archive Figure 3.7: List of recorded PQ events and the PQ event trend chart. This archive records voltage events as a sequence of half period effective values for each line voltage. The archive can record longer time intervals for events using less memory.

36 CHAPTER 3. VISUALIZATION AND PROCESSING Electricity meter reading archive Figure 3.8: Two day energy consumption profile visualized (in 1-hour interval). The device includes four-quadrant, three-tariff electricity meter which can be periodically recorded in preset intervals (Electricity Meter Configuration Form) as short as 15 minutes and up to once a week. Using ENVIS one can download and display these recordings as a bar graph in the chart together with other quantities, analyze them in a table or export these data to various formats. The archived values are separated by quadrants, phases or tariffs. 3.4 Navigation through the records Figure 3.9: Data navigator displays amount of readings in all available archives for selected object, instrument or record.

37 CHAPTER 3. VISUALIZATION AND PROCESSING 36 Data Navigator: When certain object, record or instrument is selected from an Object List than the Data Navigator Window is opened with summary information about all contained records for each archive. Time of the first and last record and the total count of records is shown. The full path of the archives is displayed in the panel title for easier orientation. Each group of records can be deleted using the red x button in the Delete column. To view more detailed information open from the main application menu the Data Source Statistics form. Database usage, free space available, database upgrade history and other information is available. Limits to Display Values: Panels with tabular data such as Main, LOG, PQ Main, PQ Events, PQ Event Trends, PQ Oscillograms or Electricity Meter Readings display by default all records in the selected interval starting at the 1st record. Exact date of the interest can be filled into the edit form or the slider can be used to interactively navigate through the archive. The total number of displayed lines is limited by the Max Table Rows (see. Max table rows). If the actual interval contains more records than it is allowed to it is automatically switched to a shorter interval to suffice the global configuration. All changes are reflected with the Apply button. Panel Selection Synchronisation: By default each table/panel has an independent set of controls. If required the check box in upper left corner can be checked in some other panels to synchronize the selection of lines. If a line is selected in one of the tables all the other checked tables/panels will update their selection to show the closest available record. 3.5 Trends and charts Initially charts are created from the Object List in the following order: 1. Select one Object/Instrument/Measurement. 2. Use the displayed list of available data bellow. Check quantities which should be displayed in chart. 3. Double-click on quantity that you want to display. 4. A new chart will open in the chart area. Optionally you can drag a node with quantities and drop them to the empty chart area or onto any opened chart. Data from multiple supported instruments can be combined into single chart to display records isochronously or sequentially. Displayed chart can be exported as an image or sent to the printer within the content menu. Each chart can contain up to 50 data series. Data Series can be shown/hidden or permanently removed from the active chart. First select the series in a legend than right click will show/hide it from display. Pressing the Delete key removes it completely. The properties for each series in the chart can be adjusted in Curve Properties option (fig. 3.11).

38 CHAPTER 3. VISUALIZATION AND PROCESSING 37 Figure 3.10: Zoom/Unzoom function of the data series displayed in chart. Zooming and sliding inside the displayed area is available with specific mouse and keyboard interactions. Optionally user can use the provided scrolling controls to move in a chart. Simplest zoom is done with a mouse region selection as displayed in fig.: st, 2nd and 3rd quadrant will zoom (black color) the selected data onto the full chart space. The 4th quadrant will unzoom (blue color) the chart - it fits the whole chart space into the selected area. To zoom only in certain direction the appropriate axis must be selected. Mouse wheel controls the zooming of data related to the selected (thick) axis. Plus and minus keys and the respective buttons in the toolbar control zooming of the displayed charts in the time. Center of zooming is either a center of the graph area or the primary red cursor (if placed). To reset view to its initial scale click on Un-zoom resp. Undo All Zoom/Pan tool in the toolbar or in the context menu of a chart. Axis can be selected by mouse clicking on the respective horizontal or vertical axis area. Pressing middle button while moving the mouse will move the axis. Rotating the middle mouse button will scale the axis and its data series respectively. Double click on Axis will activate it (move it to the rightmost position). The selected axis will be displayed in bold. Each axis has a content menu with various functions. Axis can be automatically auto scaled, separated or synchronized to various points. Selected axis and all related series can be removed by pressing the Delete key or hidden by choosing Hide All in the context menu. Legend is displayed above the chart and holds description and color for displayed quantities. The legend can contain limited number of entries (50). Each entry can be selected by mouse click - the description as well as the selected serie data will be displayed in bold. Pressing keyboard Delete key on a selected quantity will remove the data from the chart. Entry is removed from the legend and if there is no more series related to the same axis than also the axis is removed. User can temporarily hide entries in legend by mouse right-click. Selecting Hide Legend from the context menu the whole legend area is hidden.

39 CHAPTER 3. VISUALIZATION AND PROCESSING 38 Figure 3.11: User configurable properties of a selected series in chart Curve properties are used to define parameters of the displayed series such as color or quantity name. To modify the settings open graph, right click on it to open context menu and choose Curve Properties. Edit accordingly the displayed quantities and click Ok to confirm the edit. For electricity meter quantities the Elmeter interval defines aggregation of the automated electricity meter readings - displayed energy consumption is a difference of the first and last reading per interval. Figure 3.12: Example showing both cursors, a cursor readings panel and auto-scaling option in the context menu of the chart.

40 CHAPTER 3. VISUALIZATION AND PROCESSING 39 Cursors (primary-red and secondary-blue, fig.: 3.12) can be placed onto a chart using a mouse. First double click places first cursor at the location of mouse cursor. Second double-click places a another cursor and makes it active. The third double click hides both currently displayed cursors. To select one cursor and activate it you simply click on it with mouse. The cursor renders its units/values from the actual vertical axis (the one which is directly attached to the chart area). Each cursors can be dragged around the chart with mouse to provide precise readings of the selected quantity and time. The primary cursor is also controlled by keyboard. Left Arrow and Right Arrow key adjusts the location to the nearest valid value of the selected quantity. Up Arrow and Down Arrow changes the selected quantity in a cyclic manner in the order similar to the Legend. While cycling through all available quantities also the actual axis is adjusted and so are the units of the cursor. Reading is visible in the Cursor Readings panel for both placed cursors. The panel provides in-depth overview of all the quantities measured at this exact time such as harmonics, phasor diagram, voltages, currents, powers, status etc. A special type of cursor is used for PQ Event Trend and PQ Oscillograms. It can be placed in both voltage and current window and the vertical line of both is synchronized. Generally the behaviour is similar to the main chart cursors described above. In PQ Oscillogram the cursor identifies one or more periods from which the values of all basic quantities can be calculated. Figure 3.13: Opening configuration forms related to the selected quantity at a certain time. Instrument configuration panels An actual configuration of the device during the measurement can be also displayed in read-only mode see the Show Configs sub-menu items of the context menu to display all available configurations.

41 CHAPTER 3. VISUALIZATION AND PROCESSING Application setup (a) (b) (c) (d) Figure 3.14: Application setup screens Application setup dialog ( Setup Application Setup ) provides acces to customization of application. Configuration parameters are separated into tabs according to their relevance. First tab is Global which contains mainly visual configuration options. Max curve points defines maximal number of displayed points per curve. Use lower numbers for computers with limited resources. Max table rows specifies maximal number of rows displayed in table. Also affects performance of ENVIS, lower values are better for slower PC. Resolution determines resolution of values displayed mainly in tables. Counters view sets default display of counters in graphs. First option is Bars which displays differences between each recorded state. Other option is Lines which displays exact value for each record. Export/Import defines mainly configuration of data import/export to/from.csv file except item called Aggregation.

42 CHAPTER 3. VISUALIZATION AND PROCESSING 41 Aggregation specifies way how data are stored in database. Data in database are compressed for better performance of application. When one wants to read data directly from database without ENVIS then turn this option off for better clarity of data in database. For best performance of ENVIS use option Long. Quantity renaming Some users may prefer to name the quantities differently for greater clarity of measured results. In this case navigate to Export/Import tab of Application setup. Insert original names of quantities which you would like to rename into rows of Original Name column, then insert required name into Required Name column for each quantity. i.e. to rename Voltage of first phase from U1 to V1. Insert U1 into first column and V1 into second column of same row. It s also possible to save/load the configuration into/from the file by pressing Load and Save buttons. At the end press OK to confirm your setting. Logs Tab called Logs sets logging level of individual applications of ENVIS suite. When one of application behaves strangely select it in list displayed in this tab and switch radio button to DEBUG. Application then starts to make detailed log during it s operation. This detailed log can then be send to our support (support@kmb.cz) for further analysis. When problem is fixed switch value back to ERROR because in DEBUG level application produces and stores large amount of data which affects performance and can cause overfill of hard disk. Server Roles tab is usefull when problem with database acces rights or privilegies occurs. Start ENVIS with administrator privilegies, connect to database, which is located on desired SQL server and visit this tab. Since then it s possible to manage user roles of server you are connected to. This tool allows to create or edit logins to server and assign rules to specific users. Remaining tabs are Plugins details are described in ch. 6 and Message Boxes which allows to disable or re-enable warning popup windows in application.

43 Chapter 4 Import and Export Features Import To import the file(s) into the ENVIS.App right-click the Object List and select Import, follow instructions to choose appropriate files and start the import. Optionally the menu selection Data Import will start the same operation. An import form is opened ( Import File to DB ) which allows one or multiple files to be selected. The File Info panel contains general information about the data to be imported - times and dates of records, instrument information, number of records etc. Below it the Object and Record Name is displayed. If these fields need to be changed, user can select the Set other Object and Record Name. option and than edit the information. Click Import to start the actual process on background with its own progress display. The selection of archived records can continue with another file(s) or the selection can be finished with Close button. Export data from ENVIS.App to a CEA file can be started in Object List by selecting a specific measurement. The Data Export... option will display archives available for export. Proceed with selection - you can export single archive by clicking at its name or you can select multiple archives and export them using the Export Selected button. Than specify the target file name and location. Optionally export can be started from the Device list context menu on each specific record name. This way the user can export selected device data into.xls or.csv file formats. Various tables throughout the ENVIS application can export its context menus a direct native export function of the displayed data. In that case formats such as.csv,.xls,.pdf or.html are available. 4.1 Database backup ENVIS can directly start to backup or restore the connected database. This steps are initiated by Data Source BackUp resp. Data Source Restore menu options. The output or input file is selected by user and the operation than proceeds showing its progress. In case of restore operation the user must also choose into which database the backup should be restored. Optionally the same backup or restore process can be initiated using common Backup/Restore SQL commands on the database (see SQL Server Management Studio for possible reference). The.BAK file produced using both of these methods is in the same format. 42

44 CHAPTER 4. IMPORT AND EXPORT FEATURES 43 A successful restore operation erases all the actual data in chosen database, use with caution!!!

45 Chapter 5 ENVIS.Online Service ENVIS.Online is a system service for automatic and unsupervised data acquisition. With this service the continuous patching of archives in a database is performed as a background task without necessity for the user to interact. The service is usually started immediately after the operating system boots up. It automatically starts to perform all the configured operations on all registered instruments. This system service supports various devices such as: ARTIQ panel power quality analyzers NOVAR power factor controllers SMY, SMZ, PA and SMC panel meters and data loggers SMM, SML panel meters 3rd party Modbus or M-bus enabled electricity meters For analyzers with internal memory it can repeatedly download the selected archives on the background and store it continuously in the database. For all other supported devices this tool can be used to download and store the actual data with a time stamp. For some devices it also supports an alarm operations where actual state of instruments inputs/outputs is monitored and user is alerted when value changes by defined way. It also monitors the status and condition of each device and can generate an reports with this status information. The ENVIS.Online service is fully integrated in version 1.0 of the ENVIS software suite and is by default licensed for two instruments (for evaluation purposes). For obtaining of further license see the section Installation This software is distributed as a part of the ENVIS installation package (MSI, Setup.EXE) but its not installed automatically. To install it follow next steps. 1. Run ENVIS.Online Client application which was installed together with ENVIS. You will be informed that application is not installed (fig. 5.1) 2. Click Install button. You will be prompted for administrator credentials to allow instalation of all necessary components 44

46 CHAPTER 5. ENVIS.ONLINE SERVICE After sucesfull instalation of all components (fig.5.2) Client application will restart and ENVIS.Online will start automaticaly. Figure 5.1: ENVIS.Online installation (1) Figure 5.2: ENVIS.Online installation (2) The service (once installed) starts by default with the start of the computer and performs predefined tasks (so called loops) in a round-robin manner. In the Services section of the Computer Management console the system administrators can specify the exact behavior of this system service after start up.

47 CHAPTER 5. ENVIS.ONLINE SERVICE 46 Figure 5.3: ENVIS.Online License Request Form 5.2 License generation Each device operated in ENVIS.Online needs license key. License key is bound to exact type and serial number of device and is portable between computers. Each ENVIS.Online have free 10 days trial period which can be activated from License form. During this period all functions will be unlocked. Same approach is valid for plugins, except most of the plugins operates in limited way even without license. License key of plugin is bound serialn number of ENVIS and exact plugin type. ENVIS serial number is unique for each computer therefore license for plugins are not portable. How to request additional licenses and activate them: 1. Add all the required instruments into the Object List. 2. Click on License button, license form will show up. 3. All instruments and installed plugins will be listed here together with information about status of the license. 4. You can report serial number and type of devices, or ENVIS serial number and plugins directly to your local KMB systems products supplier. Or click Inquiry New License button to generate with license requests automatically for you. When license keys are received: 1. Paste your license keys to respective field and click Activate (tip: multiple keys at once can be entered)

48 CHAPTER 5. ENVIS.ONLINE SERVICE All valid keys will be uplodade to ENVIS.Online and license status of each device with new valid license will be updated. 5.3 Client usage and configuration On the user level the service can be parametrized by its client application (ENVIS.Online Client). Upon start and during the operation this client controls state of the system service and displays list of managed instruments and its tasks. Devices can be added and removed by user. By selecting a respective line in the instrument table it will also display its assigned tasks and their actual status. To see detailed information about each loop, move mouse cursor over the status column. A tool tip will be displayed with detailed actual information. Figure 5.4: Registration of new instruments over TCP/IP and serial line. Adding/Removing an Instrument is performed by New Instrument button. After that tabbed pane is displayed below with various options. Basically to register any instrument user must specify the type of the communication and its parameters. For Ethernet devices the IP address or DNS name of the device must be specified, port number and device address 1. For USB and serial line connections the device address, communication port and its communication speed should be entered. Optionally the behavior and reliability of the communication can be tuned by two timeout parameters which are located under Connection Setting link. To remove the instruments from operation select them in the Object List and click Remove Instrument. All related loops will be also removed. 1 For devices where it applies. Most Ethernet instruments do not require specific device address. Most concentrators connecting multiple instruments will require it.

49 CHAPTER 5. ENVIS.ONLINE SERVICE 48 Figure 5.5: Example of a new loop configuration Adding/Removing of Loops is performed on selected instrument using bellow Add Operation and Remove Operation buttons. Type of newly added loop is dictated by the selected tab and its parameters. For many loops it is required to chose proper database on local SQL server instance. Click Select DB and SQL button and in newly shown window select proper SQL server and database. It is also possible to create new database there by clicking Create. The database will be created and uninitialized in the selected SQL server instance. Figure 5.6: Other operations list Overview of Operations all defined operations (i.e. alarms, time synchronization, archive patching, device accessibility monitoring) except archive downloading (which got own managing

50 CHAPTER 5. ENVIS.ONLINE SERVICE 49 panel) can be managed via Other Operations tab in lower part of main window. Right mouse button click on one of listed items raise context menu, from which it s possible to remove, disable or raise configuration form. (a) (b) Figure 5.7: Example of alarm operations configuration: Read-only mode (a), Edit mode (b) Figure 5.8: Sample alarm notification methods setting Configuring Alarm Operations is also performed on selected instrument using bellow Alarms Configuration button. New pane will show up with table of observable variables for selected instrument. Newly shown pane works in two modes. ReadOnly mode, which is default. This mode is for observing through list of variables, actual values of enabled variables are automatically updated. In EditMode which can be raised by EditMode button, it s possible to configure alarms for listed variables. Alarm operation is configured by checking field in Enabled column and setting Trigger value, Treshold and Alert method. For example: When Trigger Value is set to 230 V and Threshold to 110 % alarm is raised when actual value crosses over 253 V. Alert type determines whether user will be notified only first time alarm value is observed (When First Noticed) or every time in rate of checking period (Every Time). Common for all monitored values for each instrument is Checking period and notification methods. Detailed configuration of notification methods is done via Setting button. ENVIS.Online supports three different methods of notification, via SNMP trap, via messages and via SMS over When supported by your mobile network provider

51 CHAPTER 5. ENVIS.ONLINE SERVICE 50 Figure 5.9: Instrument status monitoring window Instrument Status provides information about selected instrument. Identification box provides all information about connected instrument, in two text-boxes user can set name of Object and Record of instrument. In middle section called State monitoring of Instrument status form user can set operation for testing instruments accessibility by sending simple messages. Operation is enabled by checking Enabled check box. Interval presents interval in which instrument is tested and Range presents for how many days statistics are stored. It s also possible to specify type of test message (KMB or ModBus). Some instruments like SMP, SMC, SMY or SMZ also supports time synchronization. When enabled, instrument time is synchronized with computers time in preset interval. Figure 5.10: SMTP configuration example SMTP configuration is available in SMTP tab of Application Setup form and is accessible via Management Application Setup or through various SMTP configuration links placed in application. User must fill in Server adress and appropriate Port. Optionally also the SMTP

52 CHAPTER 5. ENVIS.ONLINE SERVICE 51 user name and password might be required and also secure communication method (SSL). On some smtp servers like gmail senders address have to be same as user name used for login. Figure 5.11: Language setting Language setting via Management Application Setup. is possible to set in Global tab of Application Setup form which is accessible Figure 5.12: Configuration of minimal free space limit on HDD HDD Information for preventing system crash ENVIS.Online monitors free space on hard drives which are in use for databases or configuration files. This configuration window is accessible via Management Application Setup HDD info tab. When HDD free space reaches predefined limit all operations which works with this HDD are stopped until free space raises over the limit. Limit value is set to 1000 MB by default, but its possible to adjust it.

53 CHAPTER 5. ENVIS.ONLINE SERVICE 52 Figure 5.13: Sample of available context menus Context Menus is possible to raise by using right mouse button on some controls of EN- VIS.Online Client. Basically on Object List and on Table of Operations. Object list context menu mainly provides basic features for controlling assigned operations and also some features for instrument configuration. In case of Operations Table it provides some extended methods for operations control. Figure 5.14: Example of automatic database backup configuration Automatic Database Backup is possible to set via Management Backups Database. Automatic backup of the database can be configured by providing database via Select DB, setting file to which data will be backed up by using button Select File. Backups can be done in two ways more common is to set Rolling Files where each backup creates new file with time-stamp. In this case it s possible to set number of backup files to store. Second method is adding every database backup to same file. In Backup Period section is possible to set how often backups will

54 CHAPTER 5. ENVIS.ONLINE SERVICE 53 be performed, there are few predefined intervals i.e. Dialy, Weekly, Monthly etc. but user can also specify his own interval. Field Perform Backup At: presents exact time when backup will be performed. When user wants to be notified on his about backup result its possible to fill address to appropriate field and clicking Add button. Whole setting is stored by Save button. Figure 5.15: Example of automatic database export configuration Automatic Database Export is possible to set via Management Data Export. This kind of operation automatically exports predefined data in predefined interval to file of selected type (i.e..cea,.csv,.xls, compressed.csv, compressed.xls and also to.pqdif when appropriate plug-in is used). Basic setting like database, file, export period is almost similar to automatic database backup configuration. By selecting database Object list section automatically loads available objects from database. User can then select objects for export by mouse. In Data To Export frame is possible to select data which will be exported from selected objects. User can switch between whole Archives and predefined User Sets. When selecting file name you can use several predefined expressions (fig. 5.16) to create dynamic file names. notification setting is similar to database backup configuration. Whole setting is stored by Save button.

55 CHAPTER 5. ENVIS.ONLINE SERVICE 54 Figure 5.16: Predefined expression Figure 5.17: Example of loading instruments from database Import Instruments list from database allows importing of existing instruments from database to ENVIS.Online. This feature is accessible via menu Instruments Load Instruments From DB. Click on Select DB button pick required database. After selecting database user will be asked what to do with existing list of devices and in some case also what to do with already existing devices in list. Instruments form will be filled with instruments from database. By checking checkboxes user can specify which instruments to import. It s also possible to select Device Location when more then one was loaded from database. Import is confirmed by clicking button Import.

56 CHAPTER 5. ENVIS.ONLINE SERVICE 55 Figure 5.18: Example of instruments list export/import to.cea Instruments list export/import to/from.cea file is made via Management Backups Instruments Opened form automatically loads current instruments list. To perform export simply select devices to export and click Export To File and set path and name of the export.cea file. For importing from existing.cea file click Select File To Import pick requested file. After that user will be asked what to do with existing list of devices and in some case also what to do with already existing devices in list. Import/Export form will now contain list of instruments loaded from selected file. User can now check which instruments should be imported and pick right location from combobox for them if more than one is present. Import is finished by button Import In cases when instruments listed in form not represents actual state it s possible to reload instruments list by button Refresh list to export.

57 CHAPTER 5. ENVIS.ONLINE SERVICE 56 Figure 5.19: Example of configuration backup/restore Backup/Restore configuration backups or restores whole configuration of ENVIS.Online to/from XML file. To perform backup navigate through Management Backups All Setting Backup then select location and name of the backup file. For restoring configuration navigate to same submenu and click on item Restore then select file with backup configuration. Automatic reports sent via 3 module. see section on page 64 for more details about this 3 ENVIS Reports plug-in have to be installed.

58 Chapter 6 Plugins for ENVIS 6.1 Management of Plugins To install the plugin navigate to Setup Application Setup Plugins tab. Click button Install and in opened file dialog select all ENVIS plugin files (.eplug) you want to install. Installation of selected plugins will start when OK button is clicked. You may be asked to enter administrator password to continue with plugin installation. In case you are installing new version of existing plugin you will be also asked to stop running processes which are using these plugins (see. fig.6.2). Click Stop Processes to continue with plugin installation. All processes which are checked in Restart column will be started again after the installation. Process to uninstall plugins is mostly simillar to instalation. Only click Uninstall and follow the instructions. You don t have to uninstall plugin to disable it, just click puzzle icon in Use collumn and plugin will be disabled. To enable plugin click puzzle icon again. Plugins that have already been loaded are marked with yellow puzzle icon in Loaded column, other are marked with gray. 57

59 CHAPTER 6. PLUGINS FOR ENVIS 58 Figure 6.1: Plugin setup window - displays the ENVIS licence number, used to generate activation licences, list of available plugins with name, description and its version, and controls to enable/disable, add and remove each plugin. Languages (translations) are also distributed and managed as plugins. Figure 6.2: Uninstalling or Re-Installing existing plugins Plugin Licence Activation All plugins for ENVIS software can be downloaded from our website or requested at support@kmb.cz. Its general use is subject to limitations. To use plugins fully featured one might need to obtain a valid licence activation code at sales@kmb.cz. Requesting the license process is similar to request a license for an instruments firmware module.

60 CHAPTER 6. PLUGINS FOR ENVIS 59 Figure 6.3: Requesting a new licences for selected plugins. Figure 6.4: Filling the licence activation codes, received by from our sales support team. 1. Open the Setup/Plugins tab. 2. Plugins which are already active on this computer are listed in the state column. Those that are not activated are displayed with red DEMO mark. 3. Select one or more plugins which you want to activate. Use CTRL+A to select all plugins. 4. Click on Request License button. 5. A request licence form is open, where all the selected plugins and the unique ENVIS licence number is included in the text (fig. 6.3). 6. You can manually fill the other required modules into the text or any other comment you wish us to receive.

61 CHAPTER 6. PLUGINS FOR ENVIS Either copy/paste the text to an client or use the client button to open your system default application directly. 8. Send this file by (as an attachment) to You should receive an answer with a block of activation licence codes, each line for one plugin. 1. Open the Setup/Plugins tab. 2. Click the Add License button. A simple text editor is opened. 3. Paste the text with licences into the empty field (fig. 6.4) and click OK. 4. The license file should be installed and plugins will update their status automaticaly. 6.2 Report Plugins EN50160 Report Plugin This module generates report, which evaluates power quality of the grid according to standard EN Output is simple and uderstandable displayed in tabular and/or graphical form. One can easily see which of evaluated parameter is compliant with defined limits and which not. Configuration can be accessed through standard Summary report key F5 or through Reporting wizard F9. Figures 6.5 shows how configuration looks in these two tools. Basically configuration is similar to standard Compliance Report. One can set whether report will be calculated from PQ Archive or Main Archive, with limits from instrument or custom defined. It s possible to show evaluation graphs and/or tables and also it can evaluate harmonics and voltage events and display results in the tables. See fig. 6.6 which shows output from this optional module. Figure 6.5: EN50160 report configuration

62 CHAPTER 6. PLUGINS FOR ENVIS 61 Figure 6.6: EN50160 Report module output PQ events report eplug Output of PQ Events Report module is simple table with overview of all recorded voltage events. It displays no. of occurences of each set event with total duration of each event in respective lines of the grid. One gets quick and clear overview of occured events without need of browsing big tables or sheets. Configuration can be accessed through standard Summary report key F5 or through Reporting wizard F9. Figures 6.7 shows how configuration looks in these two tools. User can define whether he wants to evaluate single-phase and/or three-phase quantities. Furthermore it s possible to set which kind of events will be included in the report. Figure 6.7: PQ events report configuration

63 CHAPTER 6. PLUGINS FOR ENVIS 62 Figure 6.8: PQ Events Report module output 6.3 Import/Export Plugins PQDIF Export Plugin This plugin module adds support for IEEE PQDIF files (.pqd) to ENVIS. It s possible to use it also in ENVIS.Online function of Automatic Database Export, in Object list features in ENVIS application or to directly download data to.pqd file using ENVIS.Daq??. After instalation and activation of this plugin, the export dialog and the Save to... file type lists are enhanced with a new PQDIF option. Demo mode: Each export to a pqd file is limited to a maximum of records while the plugin is operated without a valid license. 6.4 Data Processing Plugins Histogram Plugin Histogram module provides graphical interpretation of distribution of selected measured data. To display histogram raise context menu (right-mouse button click) on desired quantity in object list and click item Create Histrogram. In Histogram Setting screen you can set time interval, interval of values, bars count and type of histogram. Histrogram will be created by button OK. (a) (b) Figure 6.9: Histogram context menu (a) and example of histogram configuration (b)

64 CHAPTER 6. PLUGINS FOR ENVIS Scatter Plot Plugin Scatter plot module is mainly used for identifying relationships between 2 or 3 different measured quantities. Scatter plot module draws 2d graphs with color option as 3rd dimension. To creat Scatter chart, check two or three quantities in object list from which you would like to create chart. Raise context menu on one of selected quantity (right-mouse button click) and select Create Scatter Plot. In Scatter Plot Setting window set quantity for X axis, Y axis and Z axis represented as color. Z axis is optional, when set to Constant all drawn points will remain the same color. To prepare configuration pres button =>. Chart is generated by pressing OK. Figure 6.10: Scatter plot context menu Figure 6.11: Scatter plot configuration screen

65 CHAPTER 6. PLUGINS FOR ENVIS ENVIS.Online Plugins ENVIS.Online Reporting Plugin Figure 6.12: Example of reports configuration Automatic reports sent periodically via 1 (Fig. 6.12) are accessible via menu Plugins Reports. 1. Start with selecting database with data from which reports will be created. 2. Select one or more objects and records of devices. 3. Define name of the report. This will be used as subject of and for filename. You can use expressions for dynamic names, such as %yyyy% for year, %OB% for object etc (check respective tooltip for further options). 4. Choose report type which will be generated. Not only predefined are available, you can choose also from custom ones from User and Data set group (see ENVIS reports part of manual for more information). 5. Select groups with list of s who will receive the reports periodically. groups have to be defined first in ENVIS.Online setup. 6. Define how ofthen and at what time s will be sent. Custom option is available next to few predefined periods. 7. Reports can be stored periodically to defined location by selecting Store reports option. 8. Configuration is saved and activated by clicking Save As New. 1 ENVIS Reports plug-in have to be installed.

66 Chapter 7 Troubleshooting ENVIS 7.1 Issues with ENVIS If any of the ENVIS application doesn t behave as expected you probably encountered some incompatibility or you found yet unrevealed bug. To help us quickly find a problem and resolve the situation please proceed as follows. 1. Open ENVIS application and click on Help Show LOGs. 2. Depending on application where problem occurred, you click on appropriate item in the list. ENVIS for ENVIS application, ENVIS.Daq for ENVIS.Daq application. And for EN- VIS.Online there are two items ENVIS.Online Client and Service. After that you click Open Folder to open folder where log file is located. 65

67 CHAPTER 7. TROUBLESHOOTING ENVIS Put this file into.zip and send it by to For application where multiple files are present choose few (5-8) of the latest (each file have timestamp in the name). (a) It also helps to attach to the screen-shot of the problem by capturing the screen when problem occurs. (b) And - where possible - it helps a lot to have the same data set for the reincarnation of your problem. 4. Our technical support will contact you if more information will be needed. For advanced users only: The default level of our logging system is set to ERROR which records only the critical problems. The log level can be changed in Setup Application Setup Logs panel. To help us analyze the problem in detail you can temporarily switch the DEBUG level for a particular application. Then you can follow steps above to send the required log file(s) to our technical support. Warning: The debug settings might consume a lot of disk space and might decrease the performance of your computer, so it is recommended to switch back to ERROR level after you report the problem.

68 CHAPTER 7. TROUBLESHOOTING ENVIS Issues with instruments If you encounter problem with our instrument and it doesn t seem to be hardware related. You can follow this guide to provide us important information from the instrument so we can identify the problems. 1. Connect to instrument using ENVIS.Daq. 2. If the instrument has memory and it is working, download a all the data (or at least a small part of the time the problem was observed) to a CEA file. If there is too much data you can limit the download to 2 days of measurement in the advanced panel as presented on a figure bellow. Follow to the step If the instrument has no memory or if the memory can not be read

69 CHAPTER 7. TROUBLESHOOTING ENVIS 68 (a) Write down information form identify panel or take a screenshot of it. Important are mainly Model, Serial number, Hardware Version, Boot-loader version, Firmware version and a list of activated firmware modules. (b) Save the actual configuration of the instrument to a file. Go to configuration and save all configurations from instrument to file as shown on figure bellow. 4. Send us all information (files, device information) by to support@kmb.cz. Our technical support will contact you if more information will be needed. 7.3 ENVIS Error Logging System Each ENVIS application is logging its exceptional states in special LOG files for a convenient collection of detailed information for the support and bug fixing. Please send these logs as an attachment to you support request to simplify identification of the root case of your problem.

70 CHAPTER 7. TROUBLESHOOTING ENVIS 69 Figure 7.1: ENVIS Logs opened in an internal log reader. The log is organized in an expandable line structure - important records are highlighted by colors. A selected line(s) can be copied to clipboard (CTRL+C/CTRL+V) or the whole log file can be opened externally. ENVIS Log Reader Actual content of the file can be browsed in ENVIS, click Help Show Current LOG or Show LOGs. This menu choice will open a browser which displays all recorded messages in a certain file. User can Refresh or Clear the log file. Open in Editor will open the currently selected LOG in a default text editor. Open in Folder opens the folder containing the LOG file in file explorer window. Open File allows another LOG file to be opened in the ENVIS LOG browser. Regular Configuration ENVISDaqLog.config ENVISLog.config ENVISOnlineLog.config ENVISOnlineClientLog.config Detailed (Debug) Configuration ENVISDaqLog.config.Debug ENVISLog.config.Debug ENVISOnlineLog.config.Debug ENVISOnlineClientLog.config.Debug ENVIS Logging Features Setup and Configuration In its default configuration it only records crucial errors and start-up messages. In cases where incorrect behavior is observed in the program or service it can be used to track more details of an occurring error by changing the log configuration. In such case the DEBUG log level can be enabled in the respective configuration file (see above) which is located in the installation folder s sub folder called Config. Use this feature with caution as it can produce a lot of data or significantly degrade the system performance if configured inappropriately. Don t forget to turn off logging when enough information is recorded. To enable detailed logging in, navigate to the Config sub folder of the ENVIS installation directory. Backup the original files to turn the logging off later. Then simply rename required file with *.debug.config extension to their shorter *.config sibling. Exact target location, size and other parameters of the created log files can be precisely specified inside the configuration file.

71 CHAPTER 7. TROUBLESHOOTING ENVIS 70 ENVIS.Online Specifics The ENVIS.Online is a system service which has no user interface. So its log files are the only place where abnormal behavior can be spotted. These log files can be attached in the periodically sent s, if reporting is configured. Default location of the log files is as follows. For ENVIS.Online Client application it is by default located in the AppData folder 1. For the system service the LOG files are stored in LOG sub directory of the ENVIS.Online installation directory. This location can usually be only accessed by user with the the system administrator role. To open the created log files in ENVIS.Online client application click on the LOG button. A list of all known log files not older than 7 days is displayed in tabs and each of the files can be opened in a default text editor. 1 Such as %APPDATA%\ENVIS\*.TXT or literally c:\users\actualusername\appdata\roaming\envis\ for example.

72 Appendix A Quantity Abbreviations and Terminology A.1 Common abbreviations of basic quantities A.1.1 General information avg, min, max Average/minimum/maximum value in the aggregation interval. F1, F2,...F8 Feeder 1 1 to 8. For instruments where more than one feeder can be measured simultaneously such as NEMO and SMC 118. This abbreviation is used together with currents, powers and othe feeder related quantities such as F1.3P (three phase active power, of feeder 1), F2.I3 (current in feeder 2, phase 3), max.f8.q3 (maximum of reactive power in feeder 8, channel 3 - which might be single phase reactive power or other signal). A.1.2 Basic quantities f measured system frequency f10s system frequency averaged per 10 seconds as required by IEC Voltages [U] U1, U2, U3, U4: true RMS value of line (phase) voltages, line-to-neutral voltage [V]. UN: Neutral-to-PE voltage (only applies to some instrumentsand connection types). U12, U23, U31: true RMS value of line-to-line voltage [V] Ripple Control Signals frcs - preset frequency of the ripple control signal 1 Feeder is a set of L1, L2,L3,N wires, where 3 or 4 voltages and 3 or 4 related currents can be measured. Within an analyzer all measured feeders must share the same bus voltage U 1,U 2, U 3 and optionally U N. 71

73 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 72 RCS values in the main and pq-main atrchive U1rcs50ms, U2rcs50ms, U3rcs50ms - minimal, maximal and average value of the 50 ms tone voltage value over the aggregation interval U1rcs3s, U2rcs3s, U3rcs3s - minimal, maximal and average value of the 3 s tone voltage value over the aggregation interval (required by PQ evaluation). Total, Out of limit - counters used in the PQ module to evaluate amount of 3s RCS readings and how many of these were compliant. RCS message bits U1rcs {b1}, U2rcs {b1}, U3rcs {b1} - RMS value of the first bit U1rcs {b2}, U2rcs {b2}, U3rcs {b2} - RMS value of the second bit Over- and under- deviation U1over, U2over, U3over - voltage overdeviation in [%] as defined in IEC U1under, U2under, U3under - voltage underdeviation in [%] as defined in IEC Currents [I] I1, I2, I3, I4, IN: measured current in each channel [A]. 3I, 4I: three-phase or four-phase current measured as a sum of rms values of all measured currents. Residual current monitoring (RCM) In instruments with this special current input option the following quantities are also present in relation to the residual current monitoring: In live data nad over Modbus an actual value, average value, minimums and maximums and the respective times are available. In main archive an avertage, minimum and maximum value over the archive aggregation interval is recorded. In IO all RCM valueas can be used to trigger an event and hour meter has capabilities to monitor how long and when the condition was met. IΔ1, IΔ2, IΔ3, IΔ4, IΔ5,...: r.m.s. value of the vector sum of the currents flowing through the main circuit of the residual current device [IEV ] IΔno: value of residual current at which (and below which) the residual current device does not operate under specified conditions [IEV ] residual operating current: value of residual current which causes the residual current device to operate under specified conditions [IEV ] limiting non-actuating time: maximum delay during which a value of residual current higher than the residual non-operating current can be applied to the residual current device without bringing it actually to operate [IEV ]

74 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 73 I Nc calculated neutral conductor current. This virtual current is calculated from a signal which is generated as a sum per sample of I1, I2 and I3. I P Ec residual current calculated. This virtual current is calculated from a signal which is generated as a sum per sample of I1, I2, I3 and IN current inputs. Powers [W, var, VA] Active power P [W]: P1, P2, P3, P4, 3P: active power (defined as abs(qi+qiv)+(abs(qii+qiii)) in L1, L2, L3, L4 and net sum (of P1, P2, P3). P1+, P2+, P3+, P4+, 3P+: active power+ (QI+QIV) in L1, L2, L3, L4 and net sum (of P1, P2, P3). P1-, P2-, P3-, P4-, 3P-: active power- (QII+QIII) in L1, L2, L3, L4 and net sum (of P1, P2, P3). Reactive power Q [var]: Q1, Q2, Q3, Q4, 3Q: reactive power in L1, L2, L3, L4 and net sum (of L1, L2, L3). Q1+, Q2+, Q3+, Q4+,3Q+: reactive power+ (QI+QII) in L1, L2, L3, L4 and net sum (of Q1, Q2, Q3). Q1-, Q2-, Q3-, Q4-, 3Q-: reactive power- (QIII+QIV) in L1, L2, L3, L4 and net sum (of Q1, Q2, Q3). Apparent power S [VA]: S1, S2, S3, S4, 3S: aparent power in L1, L2, L3, L4 and net sum (of L1, L2, L3) apparent powers. Distortion power D [VA]: D1, D2, D3, D4, 3D: distortion power in L1, L2, L3, L4 and net sum (of L1, L2, L3) Active power of the fundamental harmonic Pfh [W]: P1fh, P2fh, P3fh, P4fh, 3Pfh: fundamenta active power (defined as abs(qi+qiv)+(abs(qii+qiii)) in L1, L2, L3, L4 and net sum (of P1, P2, P3). P1fh+, P2fh+, P3fh+, P4fh+, 3Pfh+: fundamental active power+ (QI+QIV) in L1, L2, L3, L4 and net sum (of P1, P2, P3). P1fh-, P2fh-, P3fh-, P4fh-, 3Pfh-: fundamental active power- (QII+QIII) in L1, L2, L3, L4 and net sum (of P1, P2, P3). Reactive power of the fundamental harmonic Qfh [var]: Q1fh, Q2fh, Q3fh, Q4fh, 3Qfh: fundamental reactive power in L1, L2, L3, L4 and net sum (of L1, L2, L3). Q1fh+, Q2fh+, Q3fh+, Q4fh+,3Qfh+: fundamental reactive power+ (QI+QII) in L1, L2, L3, L4 and net sum (of Q1, Q2, Q3). Q1fh-, Q2fh-, Q3fh-, Q4fh-, 3Qfh-: fundamental reactive power- (QIII+QIV) in L1, L2, L3, L4 and net sum (of Q1, Q2, Q3).

75 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 74 Factors of Powers, Voltages and Currents Power Factor (true power factor) is the ratio between real power flowing to the load to the apparent power in the circuit. [IEV ] PF1, PF2, PF3, PF4: is the ratio between real power flowing to the load to the apparent power in the circuit. 3PF: is three-phase power factor, calculated from 3P and 3Q. Cos Phi (fundamental power factor; displacement power factor; active factor) is a factor of active and reactive power of the fundamental harmonic only. It is expressed with two attributes: a sign (+/-), which indicates the polarity of active power and a character (L/C), which indicates the power factor character (the polarity of reactive power relative to the active power). Quadrants QI and QIII have inductive character (L, lagging) and quadrants QII and QIV have capacitive (C, leading) character. Cosϕ1, Cosϕ2, Cosϕ3, Cosϕ4: is a cos(ϕ) of the L1, L2, L3 resp. L4. 3Cosϕ is a three-phase cos(ϕ), calculated from the 3Pfh and 3Qfh. Demand, Maximum demand (MD, AD, LD, PAvgMaxE, EMAX) Demand integration period the interval of time of an hour [half-hour] [quarter-hour] etc., over which the electricity consumed is integrated in order to determine the average hourly [halfhourly] [quarter-hourly] etc., demand [IEV ref ] Demand averaging interval - number of periods multiplied by the duration period, in minutes or seconds this is the lenght of Demand averaging method - fixed or sliding window Minimum demand required - the upper limiting value of the demand requested by the consumer [IEV ] Maximum demand required - the lower limiting value of the demand requested by the consumer [ IEV ] Demand - hourly [half-hourly] [quarter-hourly[ [n-minute] etc. demand - is a demand value for the corresponding interval [IEV ]. Maximum Demand, MD - annual [quarterly] [monthly] [weekly] [daily][since reset] maximum demand value in the corresponding interval [IEV ]. Start Time Act- time of the end of the last avaerage interval and the beginning of the current averaging interval Actual Average Demand, AD - current average value (only when fixed window is selected, otherwise NaN)

76 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 75 Last Average Demand, LD - last average value Estimated Demand, ED - Odhadovana velicina jaka asi bude na konci intervalu? (only when fixed window is selected, otherwise NaN) Symmetrical components Phase rotation: also known as phase order or direction of rotation - value 1 represents correct phase order setup (1-2-3), value -1 represents negative direction of phases (1-3-2) and value 0 marks situations where phase order can not be reliably detected (?-?-?). u 2 voltage unbalance [IEV ], negative sequence unbalance component: calculated as u 2 = U 2 U 1 100[%]. u 0 zero sequence voltage unbalance component: calculated as u 0 = U 0 U 1 100[%]. U 2 negative sequence component of three phase voltage (Fortescue) U 1 positive sequence component of three phase voltage (Fortescue) U 0 zero sequence component of three phase voltage (Fortescue) i 2 current unbalance, negative sequence current unbalance component: i 2 = I 2 I 1 100[%]. calculated as i 0 zero sequence current unbalance component: calculated as i 0 = I 0 I 1 100[%]. I 2 negative sequence component of three phase current (Fortescue) I 1 positive sequence component of three phase current (Fortescue) I 0 zero sequence component of three phase current (Fortescue) ϕ2,ϕ1,ϕ0 phase shift between each current and voltage component ϕu2,ϕu1,ϕu0 angle of negative, positive and zero voltage sequence component towards reference zero (of voltage U1 fh ) ϕi2,ϕi1,ϕi0 angle of negative, positive and zero current sequence component towards reference zero (of voltage U1 fh ) P 2,P 1,P 0 positive, negative and zero active power as defined in IEEE 1459:2010 Q 2,Q 1,Q 0 positive, negative and zero reactive power as defined in IEEE 1459:2010

77 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 76 Flicker severity indices Pst1, Pst2, Pst 3 - Short time flicker severity index Plt1, Plt2, Plt 3 - Long time flicker severity index Pinst1,max, Pinst2,max, Pinst3,max - mamimal value of the instan flicker severity index over the aggregation interval. Voltage Harmonic Amplitudes and Phase Shifts Fund. Harmonic Fundamental harmonic is a harmonic subgroup of the first harmonic (usually close to the f nom being 50 or 60 hz). U1fh, U2fh, U3fh, U4fh, UNfh: Magnitude (TRMS) value of fundamental harmonic of the given voltage U1, U2, U3, U4, UN etc. ϕu1fh, ϕu2fh, ϕu3fh, ϕu4fh: phase shift (angle) of fundamental harmonic voltage U1fh, U2fh, U3fh or U4fh referred to the U1fh phasor. U1h,n, U2h,n, U3h,n, U4h,n,...: Magnitude (TRMS) of the n-th voltage harmonic for U1, U2, U3 or U4/U N,... ϕu1h,n, ϕu2h,n, ϕu3h,n, ϕu4h,n: Relative phase angle of n-th harmonic current phasor in phase 1, 2, 3 or 4 referred to the fundamental harmonic phasor of the voltage U1. U12h,n, U23h,n, U31h,n: Magnitude (TRMS) of the n-th voltage harmonic for line-to-line voltage U12, U23, U31. U1dc, U2dc, U3dc, U4dc...: the direct voltage component (0-th harmonic) calculated as average value over the measurement period. U1ac, U2ac, U3ac, U4ac...: the alternating (harmonic) voltage component calculated as the rms value of the 1+ harmonic component over the measurement period. Urms1, Urms2, Urms3, Urms4...: voltage component calculated as the rms value of the respective Uac and Udc THDU1, THDU2, THDU3, THDU4: Total harmonic distortion of voltage U1, U2, U3 resp. U4 related to the first harmonic. THD-RU1, THD-RU2, THD-RU3: Total harmonic distortion of voltage U1, U2, U3 related to the total RMS value.

78 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 77 Current Harmonic Amplitudes and Phase Shifts I1fh, I2fh, I3fh, I4fh: Magnitude (TRMS) value of fundamental harmonic of the given current I1, I2, I3, I4 etc. ϕi1fh, ϕi2fh, ϕi3fh, ϕi4fh: phase angle of fundamental harmonic current I1fh, I2fh, I3fh, I4fh phasor referred to the Ufh1 phasor. I1h,n, I2h,n, I3h,n, I4h,n: Magnitude (TRMS) of the n-th current harmonic for I1, I2, I3, I4. ϕi1h,n, ϕi2h,n, ϕi3h,n, ϕi4h,n: Relative phase angle of the n-th harmonic current phasor in phase 1, 2, 3 or 4 referred to the fundamental harmonic phasor of the voltage U1. I1dc, I2dc, I3dc, I4dc...: the direct current component (0-th harmonic) calculated as average value over the measurement period. I1ac, I2ac, I3ac, I4ac...: the alternating (harmonic) current component calculated as the rms value of the 1+ harmonic component over the measurement period. Irms1, Irms2, Irms3, Irms4...: current component calculated as the rms value of the respective Iac and Idc THDI1, THDI2, THDI3, THDI4: Total harmonic distortion of current I1, I2, I3 resp. I4. THD-RI1, THD-RI2, THD-RI3: Total harmonic distortion of current I1, I2, I3 related to the total RMS value. Harm. Angle Phase shift between the corresponding voltage and current harmonic phasors. Pfh, Ph active power of first harmonic, active power of higher harmonic Qfh, Qh reactive power of first harmonic, reactive power of higher harmonic Slow transients U1max10ms, U2max10ms, U3max10ms, U1max20ms, U2max20ms, U3max20ms maximum value of the true half-period (10ms) or period (20ms) interval RMS value line-to-neutral voltage [V] observed during the aggregation interval. U12max10ms, U23max10ms, U31max10ms, U12max20ms, U23max20ms, U31max20ms maximum value of the true half-period (10ms) or period (20ms) interval RMS value line-toline voltage [V] observed during the aggregation interval. U1min10ms, U2min10ms, U3min10ms, U1min20ms, U2min20ms, U3min20ms minimum value of the true half-period (10ms) or period (20ms) interval RMS value line-to-neutral voltage [V] observed during the aggregation interval.

79 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 78 U12min10ms, U23min10ms, U31min10ms, U12min20ms, U23min20ms, U31min20ms minimum value of the true half-period (10ms) or period (20ms) interval RMS value line-to-line voltage [V] observed during the aggregation interval. I1max10ms, I1max20ms,...: extremes of the true half-period (10ms) or period (20ms) interval RMS of current [A] observed during the aggregation interval. U1peak+, U1peak-,...: samples maximal positive and negative value of voltage input signal (phase-to-neutral). I1peak+, I1peak-,...: samples maximal positive and negative value of current input signal Histogram archive contains two types of distinct quantities - counters and extremes. Booth types are recorded every time the histogram is saved. Extremes are stored in the min and max subfolders. These are cleared with each new histogram evaluation period. Counters are kept.in the root folder of each quantity. These are only cleared when the archive is cleared. U1...,I1...,P1...Q1...: - U,I,P and Q values calculated from values in the main archive - with the same aggregation interval. Imax1,...: extreme value of the half period values of current over the aggregation interval A.1.3 Flags and states Status group collects all information about the instruments state and health, quality of the measurement etc. Flags (all) is an aggregated indicator of all problems related to the flagging system. Includes PQ flags as well as other types, such as range switching. Flagging - marks if and which actual data measuremnt is influenced by voltage events 0x01, 0x02, 0x04, 0x08 - voltage event occured, influencing quantities in main and pq main archives such as voltage magnitude, unbalance, harmonics, interharmonics, RCS, under- and over-deviation as well as currents and powers in channel 1, x10, 0x20, 0x40, 0x80 - voltage event occured, influencing quantities in main and pq main archives such as short time flicker in channel 1, x100, 0x200, 0x400, 0x800 - voltage event occured, influencing quantities in main and pq main archives such as long time flicker in channel 1, x voltage event occured, influencing frequency in main and pq main 0x automatic current probe range switchover 0x0000 LW (loose wire) condition - indicates a state of the measured system values, corresponding to a situation where one or more voltage channels are not connected to any voltage, either by design or as a result of some failure. This function can be disabled in the advanced tab of instrument installation configuration.

80 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 79 ADC (all) is an aggregated indicator related to all the problems, related to analog part of the measurement ADC Clipping - or the verflow of Voltage or Current (Over:U1...) marks measurements where one or more samples have been observed not fitting the ADC range. ADC Zeroing - underflow of Voltage or Current (Over:U1...) marks measurements where one measured quantity is below the set treshold for minimum value. This function is only active if it is enabled in the install configuration of the instrument. Battery.PWR internal voltage of the devices main power supply in instruments which do provide a backup power supply. Battery.ACU internal voltage of the accumulator in instruments which do provide a backup power supply accu. A.1.4 Communication statistics Cleared date and time when the statistics have been cleared 485 group of statistics for RS-485 interface ETH group of statistics for Ethernet interface ETH CH group of statistics for separate Ethernet channels RX M. All number of messages received on all protocols together RX M. KMB number of messages received on KMB protocol RX M. WEB number of messages received on HTTP server RX M. All number of messages received on Modbus protocol RX M. All number of messages received on all protocols together RX Data TX Data TX Message SYN RCV SYN KMB SYN WEB SYN MODBUS A.1.5 Inputs and Outputs Digital Inputs

81 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 80 DI with Signal Logic (DI) DI1, DI2, DI3, DI4...: Digital input 1, 2, 3, 4 for input state monitoring, pulse counting (S0) or frequency controlled quantity function. DI with Power Logic (RI) RI1, RI2: rugged input for slower process state monitoring Pulse Counters (PC) PC1, PC2,...: each pulse counter is a calculated quantity for the given input - it is used for electrcity, water, heat, gas metering etc. Frequency Counters (FC) FC1, FC2, FC3: each frequency counter measures frequency of the incomming pulses and translates this to a periodic quantity - FCs are usualy used for periodic quantities such as speed, rotation, flow, wind speed etc. Analog Inputs (AI) AI1, AI2: analog inputs (0 20 ma, 4 20 ma or 0 10 V) Ti: internal temperature of the instrument ( C) Te: external temperature ( C, usually PT100 type of analog input) Digital Outputs (DO) DO1, DO2,...: programmable Digital (solid state) outputs for fast switching control or pulse ganeration (frequency or counter functions). Relay Outputs (RO) RO1, RO2,...: programmable Relay outputs for state control - slower relay switching Pulse Outputs (PO) PO1, PO2, PO3, PO4: each digital output can be assigned to generate pulses corresponding with a selected electricity meter quantity. Alarm Signal (LEDs, display symbol) A1, A2, A3, A4: signal alarm LEDs or display symbols - programmable as DI. Analog Outputs (AO) AO1, AO2: programmable analog outputs (0 20 ma or 4 20 ma)

82 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 81 A.2 Electricity meter readings Terms and abbreviations Phase values are identified by the respective number of the input. EP1,..., EQ1,...EQ4: such register contains reading of energy in phase 1 resp. Per Tariff registers are identified by letter T and number of tariff folowed by dot. T1.3EP, T2.EQ1,..T6.EQ2+. registers contain aggregated readings of energy consumption in tariffs 1, 2,...6 (TOU). 3E..., 4E... leftmost nuber 3, 4... in name of register represents sum of energy in 3, 4 or more channels of the measured three- or multi-line system. I or Imported counts active energy which was consumed by customer (network has delivered) - in quadrants QI and QIV E or Exported counts active energy which was produced by customer (network has received) - in quadrants QII and QIII L or Inductive counts reactive energy in inductive quadrants QI and QII - L corresponds to the reactive power/energy+ as defined in obis and cosem/dlms. C or Capacitive counts reactive energy in capacitive quadrants QIII and QIV - C corresponds to the reactive power/energy- as defined in obis and cosem/dlms. Quadrant definitions are specified in detail in fig. 1 of the IEEE Std 1459:2010 or the forthcomming IEC : QI: P>0, Q>0 = L+, QII: P<0, Q>0 = L-, QIII: P<0, Q<O = C-, QIV: P>0, Q<O = C+. EP Total active energy sum active energy (abs(qi+qiv)-abs(qii+qiii)) 3EP, 4EP, EP1, EP2, EP3, EP4 absolute active energy (abs(qi+qiv)+abs(qii+qiii)) 3ĒP, 4ĒP, ĒP1, ĒP2, ĒP3, ĒP4 EP+/- Active energy imported/exported (active energy +/-) active energy+ (QI+QIV): 3EP+, 4EP+, EP1+, EP2+, EP3+, EP4+ active energy- (QII+QIII): 3EP-, 4EP+, EP1-, EP2-, EP3-, EP4-

83 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 82 EQL/C Reactive energy imported/exported (inductive/capacitive or +/-) reactive energy+ (QI+QII): 3EQL, 4EQL, EQL1, EQL2, EQL3, EQL4 reactive energy- (QIII+QIV): 3EQC, 4EQC, EQC1, EQC2, EQC3, EQC4 ES+/- Apparent energy imported/exported apparent energy+ (QI+QIV): 3ES+, 4ES+, ES1+, ES2+, ES3+, ES4+ apparent energy- (QII+QIII): 3ES-, 4ES-, ES1-, ES2-, ES3-, ES4- Active energy (per quadrant QI, QII, QIII, QIV) active energy QI: 3EPL+, 4EPL+, EPL1+, EPL2+, EPL3+, EPL4+ active energy QII: 3EPL-, 4EPL-, EPL1-, EPL2-, EPL3-, EPL4- active energy QIII: 3EPC-, 4EPC-, EPC1-, EPC2-, EPC3-, EPC4- active energy QIV: 3EPC+, 4EPC+, EPC1+, EPC2+, EPC3+, EPC4+ Reactive energy (per quadrant QI, QII, QIII, QIV) reactive energy QI: 3EQL+, 4EQL+, EQL1+, EQL2+, EQL3+, EQL4+ reactive energy QII: 3EQL-, 4EQL-, EQL1-, EQL2-, EQL3-, EQL4- reactive energy QIII: 3EQC-, 4EQC-, EQC1-, EQC2-, EQC3-, EQC4- reactive energy QIV: 3EQC+, 4EQC-, EQC1+, EQC2+, EQC3+, EQC4+ TN. Energy quantities counted per tariff active energy (T1..T6) T1.3EP,...T6.3EP reactive energy (T1..T6) T1.3EQ,...T6.3EQ apparent energy (T1..T6) T1.3ES,...T6.3ES FN. Energy quantities counted per feeder F1., F2., F3., F4...F8: describes energy quantities from different feeders measured with a multifeeder monitoring system.

84 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 83 A.3 Voltage events Voltage events records maximum or minimum U rms(1/2) during the event. Events include voltage dip, voltage swell and voltage interruption U1res, U1res, U1res, 3Ures is a residual voltage during a dip U1int, U2int, U2int, 3Uint is a residual voltage during voltage interruption U1swell, U2swell, U3swell, 3Uswell is a swell voltage during the event. I1max, I2max, I3max, 3Imax records maximum I rms(1/2) (overcurrent) during the event. Rapid voltage changes monitors two distinct parrameters over the event: U1ss, U2ss, U3ss is the absolute difference between the final arithmetic mean 100/120 U rms(1/2) before and after the RVC event. 3Uss For polyphase systems (events) it is the largest Uss on any channel. U 1max, U 2max, U 3max is the maximum absolute difference between the final arithmetic mean 100/120 U rms(1/2) between any of the values during the RVC event. 3Umax For polyphase systems (events) it is the largest Umax on any channel. Unom Přepětí/Swell Hystereze/Hysteresis Hystereze/Hysteresis Podpětí/Dip(sag) Hystereze/Hysteresis Výpadek/Interruption Figure A.1: Voltage events and an illustration of its detection parameters. RMS voltage refreshed each half-cycle (Urms(½)) is a value of the r.m.s. voltage measured over 1 cycle, commencing at a fundamental zero crossing, and refreshed each half-cycle. This value is used to evaluate voltage events. RMS voltage refreshed each cycle (Urms(1)) is a value of the r.m.s. voltage measured and refreshed over 1 cycle. Nominal frequency (f nom ) is a value of frequency for which the measured system is constructed. Typically 50 Hz or 60 Hz. Its choice influences sampling of inputs and some power quality evaluation principles.

85 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 84 Nominal voltage (U nom ) is a voltage by which a system is designed - typically given by IEC standard voltage. Nominal current (I nom ) is a current by which a system is designed - typycaly this is defined by fuse or protection limit. Nominal power (P nom ) is a nominal value of the three-phase power of the system - typically defined by the supply transformer. Sliding reference voltage (Usr) is a voltage magnitude averaged over one minute, representing the voltage preceding a voltage dip or swell. Residual voltage (Ures) is a minimum value of Urms(½) recorded during a voltage dip or interruption. Overdeviation is a difference between the measured value and the nominal value of a parameter, only when the measured value of the parameter is greater than the nominal value. Underdeviation is an absolute value of the difference between the measured value and the nominal value of a parameter, only when the value of the parameter is lower than the nominal value. Voltage swell is a temporary increase of the voltage magnitude at a point in the electrical system above a threshold. Voltage dip is a temporary reduction of the voltage magnitude at a point in the electrical system below a threshold. (Voltage) interruption is reduction of the voltage at a point in the electrical system below the interruption threshold. Swell threshold is a voltage magnitude specified for the purpose of detecting the start and the end of a swell. Interruption threshold ia a voltage magnitude specified for the purpose of detecting the start and the end of a voltage interruption. Hysteresis is a difference in magnitude between the start and end thresholds for power qualitty events. Power (supply) failure is an interruption of the supply power to the measuring instrument - leads to the battery backup operation or imediate shutdown of the instrument. Rapid voltage change is a quick transition in RMS voltage between two steady-state conditions, during which the voltage does not exceed the dip/swell thresholds. A.4 Flags ( ) During a dip, swell, or interruption, the measurement algorithm for other parameters might produce an unreliable value. The flagging concept avoids counting such event more than once and indicates that an aggregated value might be unreliable.

86 APPENDIX A. QUANTITY ABBREVIATIONS AND TERMINOLOGY 85 A.4.1 GO Triggers vlna/wave 1 vlna/wave 2 Trigger pro obálku/ Wave Envelope trigger vlna/wave 1 TRMS Plovoucí trigger/ TRMS Floating trigger vlna/wave 2 Figure A.2: Trigger types Wave Envelope Trigger and raises the event when the limit is crossed. This trigger compares two consecutive wave envelopes (their surface) TRMS Floating Trigger TRMS Trigger compares each measured point of wave with it s predecessor. When it founds difference which crosses the configured limits the event is raised.

87 Appendix B Instrument status, archived logs and error codes B.1 Error Codes Error code - 32 bits indicating status of instrument operation - value 0 of bit indicates correct operation, value 1 indicates a possible problem. 0x01 RAM error 0x02 instrument configuration error 0x04 instrument callibration error 0x08 remote communication module error (Wifi/Zigbee) 0x10 clock error (RTC) 0x80 instrument archive error 0x100 flash memory error 0x200 display error B.2 Status Information B.3 Event Logging Severe errors might occur during the operation of the instrument. Calibration Table CRC Error Calibration of the instrument has been dampered. This usually means that the calibration table has to be restored from the backup copy or that it has been re-set for the default values. Watchdog Reset restarts the analyser in case of unexpected freezer of the instrument. RTC Error denotes misconfigured internal real time clock. This issue can usually be resolved by readjusting this flag. If it occurs more frequently it might signal a problem with the internal battery (see manual of the respective instrument). 86

88 APPENDIX B. INSTRUMENT STATUS, ARCHIVED LOGS AND ERROR CODES 87 DMA Sync Error, ADC Sync Error is signalized when the input processing is temporarilly disturbed. In such case actual the 200 ms aggregation is excluded from further processing and this flag is written in the LOG. The following messages are related to an inproper setup of instruments with flexible rogovski sensors: MULTIPLEX unit didn t answer, Archive configuration disagree to hardware configuration, FLEX unit is not connected, FLEX unit didn t answer. These errors most often happen due to the inproper onsite installation of the instrument and can be fixed right away by the operator. If they frequently occur during the measurement campaign, they might be caused by a failing part of the instrument (sensor or multiplexor). Archive Error Logs Whenever the internal archive of the instrument can not be read during the data acquisition one of the folowing messages is written in the LOG: PQEventTrend Archive Read Error, PQ Oscillogram Archive Read Error, P Max Archive Read Error, ELMER Archive Read Error, PQEvents Archive Read Error, PQMain Archive Read Error, Log Archive Read Error, MProfile Archive Read Error, SProfile Archive Read Error, Main Archive Read Error. Warning Logs Power Failure see section A.3 Instrument Reset is written whenever the reset occurs for a general reason. Lock Change is written whenever the lock status of the instrument is being changed. Firmware Upgrade gives information about (successful) firmware upgrade. If the upgrade process fails, instrument stops in bootloader and does not continue. Hence another attempt to upgrade can be performed. IO Change Instrument Output Change is logged whenever the state of some output is changed. Instrument Input Change is logged whenever the state of some input is changed. FLEX unit is connected is logged whenever the main instrument recognizes that a new set of FLEX (Rogowski CT) has been connected to the instrument. Config Change End of measurement, Start of measurement is recorded whenever the archive creation is blocked or unblocked (usually by a physical button or by a lock in firmware). Erase All and Set Default Config is written when the instrument is reset to default configuration.

89 APPENDIX B. INSTRUMENT STATUS, ARCHIVED LOGS AND ERROR CODES 88 Whenever the respective configuration is changed, one or more of the following flags are set in the LOG record: Config Changed, Modem String Changed, Notebook Changed, SummerTime Changed, Constant Table Changed, Meter Config Changed, IO Config Changed, Installation Config Changed, Archive Config Changed, Display Config Changed, Time Changed. Clear Flags Each internal archive of the instrument can be erased separatelly. The possible value flags written into the LOG are: Clear Main Archive, Clear PqMain Archive, Clear Log Archive, Clear MProfile Archive, Clear PQEventTrend Archive, Clear PQ Oscillogram Archive, Clear P Max Archive, Clear Elmer Archive, Clear PqEvents Archive, Clear SProfile Archive. Some instruments also have internal counters and other registers. When these are erased the information is also written into the LOG as follows: Clear min and max values, Clear Elmer, Clear PQTable, Clear PQWeek, Clear ERRCode.

90 Appendix C Frequently Asked Questions C.1 ENVIS: How To... set/change default language: In menu click Setup Application Setup Global Language and choose appropriate language from the selection list. accelerate the performance: To get maximum power of your ENVIS installation is limited by the amount of data processed in each operation. You can influence this by adjusting of the Max. Rows value accordingly. The data store performance can also significantly differ. Increasing the computer memory or using faster harddisk can drastically improve the performance as ENVIS is memory demanding application. Binary files (CEA) are generally faster than databases. If database is a must then several tuning strategies can be implemented. Consult your database administrator. A simple and effective way to increase database preformance is to store the database file and the database LOG file on a different harddisks. Also use multiple smaller databases for different groups of instruments rather than single big datastore. Record only reasonable aggregation interval and set of quantities to speed up the processing and data acquisition part. For older pc/laptop it is possible to install only ENVIS.Daq and use it to download the data directly to XLS, than simply process them using a spreadsheet software. display more records in table/chart: In menu click Setup Application Setup Global Max. Rows and adjust its value to the required amount. Adjust accordingly to the resorces of your client PC as larger value. Also make sure that the Time Interval combo box (upper right cornet of each table) is chosen appropriately. find a missing panel/chart: If you loose track of the available panels it is always most convenient to reset the ENVIS layout. Click Setup Reset Panels or use the same function from the tool bar. Pressing the CTRL-SHIFT-R keys will do the same. This operation must be confirmed in a dialog which is displayed. Individual panels can be also displayed/hidden by clicking to its respective toolbar or menu item (View...). associate CEA files with ENVIS: ENVIS is able to configure most operating systems to open its files directly from the file manager. It checks this association on startup by default but user can choose to skip this test. To enable the test go to Setup Message Boxes Associate 89

91 APPENDIX C. FREQUENTLY ASKED QUESTIONS 90 File and check Show this message again button. the association will be tested on the next startup and you will be given a choice to reassociate it. setting gmail as SMTP server in ENVIS.Online: It s necessary to set your User name and password. In case of gmail it s also necessary to set senders address similar to your User name. In some cases gmail smtp still won t work or it can stop working after some time. In both cases Google probably needs to verify human presence. You need to navigate to this page and fill in CAPTCHA 1 (Completely Automated Public Turing Test To Tell Computers and Humans Apart) code to unlock this features. When mailing suddenly stops working, try repeat this procedure at first. C.2 Instruments: How To... C.2.1 reset an instrument to its factory defaults Follow these steps to reset the instrument: 1. Clear all the internal archives in the unit with ENVIS.Daq by Clear All. 2. In Envis.Daq tab Config use option - Reset to default. 3. Unit is now in default configuration. Configure the unit again to the desired custom setup. C.2.2 enable the optional firmware modules Figure C.1: Module activation state window with the actual activation code displayed. 1 see following URL for more informations