Technical User Manual

Transcription

1 Technical User Manual Document version Date September Limited All rights reserved - 1 -

2 What s inside the Box GreenBox 360 Data Logger Crafted to meet the needs of the modern day system integrator that requires a high degree of flexibility and scalability for data management. GPRS Antenna 3 meter GPRS antenna with magnetic base. USB Interface Micro USB to USB 2.0 host interface to connect a USB pen drive or a USB gateway to connect wireless sensors. USB Disk drive Containing full Technical Manual and Quick Guide PDF for using the GreenBox. It also contains a network configuration utility to set the IP address of the GreenBox. This application must be run from the USB disk drive on your PC. Limited All rights reserved - 2 -

3 GreenBox 360 Specification System ARM9 CPU 400 MHz clock speed RAM 256MB FLASH 2GB Supply 24V DC 2Amps Terminal Screws Communication n 1 serial port RS485 n 1 serial port RS232 n 1 Micro USB Host port n 1 Ethernet 10/100 RJ45 port SD Card Slot HSPA/3G Modem GB-BUS (I2C) up to 8 I/O expansion modules Conformity and usage Safety: EN60950 EMV: EN (9:2003), EN55024 (10:2003) Operation temperature: -25 C +75 C non condensing Protection degree: IP20 Degree of pollution: 2 Greenologic warrants that this product is free from defects in material and workmanship. This product has a 12 month warrantee from purchase date. The maximum liability under warrantee is limited to the purchase price of the product only, which is covered by the warrantee. The warrantee applies to the product only and does not cover another software or hardware which may be included with your purchase of the product. Technical Documentation & User Guides Contact Support support@greenologic.co.uk Limited All rights reserved - 3 -

4 GreenBox Hardware System Reboot Keep button held for 5 sec to apply. LED will light up to indicate reset has been activated along with a beep. Application Visual indication GreenBox application is online and ready to be accessed through the Brower. Green LED = Online OS- Operating System Visual indication that the Linux operating system is running. Green LED = Online SIM Slot Push down the button to release the SIM Carried and insert the card. SD Card Unused however in the future this slot can be used to write to and boot from future proofing the system. LAN Port Connect your Ethernet cable to your network point or directly to your PC GPRS Antenna Attach the antenna to the GreenBox to allow for good signal strength. Factory Reset Keep button held for 10 sec to apply. WARNING all system configuration will be lost and GreenBox will start at the Wizard. LED will light up to indicate reset has been activated along with a beep. Power Status Visual indication that power is being supplied to the GreenBox System Status Visual indication of any errors on GreenBox application to investigate further. Green LED = System OK Red LED = System Error Power Connection it is recommended to supply 24V DC 2Amps terminal screw connection Micro USB Port Connect the Micro USB to USB 2.0 Port to connect compatible gateways or USB Pen drive for network configuration COM2 RS232 Port Connect compatible gateways to the GreenBox. Or use as a slave port to a ModBus Master Modem Visual indication for Modem Green LED = Online Red LED = Offline COM1 RS232 Port Connect compatible gateways to the GreenBox, or convertors to make port RS485 Internet Visual indication for internet access. Green LED = Online Red LED = Offline Limited All rights reserved - 4 -

5 10 Simple setup steps to follow Step 1 Use the USB pen drive on your PC and run the network configuration application assigning a unique IP address to your GreenBox. Step 2 Power up your GreenBox and wait for the beep, insert the USB pen drive via the micro USB interface supplied. This will assign the new IP address and you will be able to access the interface in your web browser. Step 3 Follow the wizard configuration steps ensuring to complete each page successfully, you will be notified if a step has not been configured properly from the status on that page. Step 4 Once the wizard is completed the GreenBox will restart applying your setting (please be patient). You will now be able to login and start to connect to sensors. Firstly add a driver to the GreenBox icon in the devices section. Step 5 After the driver(s) have been added successfully you will be able to right click the driver and add devices which are compatible with that driver, add all devices first and ensure the values you are reading are correct. Step 6 When all the device have been joined to the driver(s) you will be presented with their ModBus register map carefully select the data points you wish to log by right clicking them to add them to the data points list. Step 7 The GreenBox now has a list of points which it is logging at your set interval assigned during the wizard configuration; you are now able to choose the export method for this data from the database export menu. Step 8 If you are sending data externally please ensure you have an internet connection by performing a comms test. You can run this test from the menu on the GreenBox interface. Step 9 Once the internet connection is successful you can set up a database export by completing the specific dialogue with the required information. GreenBox can also send locally on a network or through ModBus TCP/IP as a slave. Step 10 Check that the recipient has received the exported data from the Greenbox successfully. Ensure you read the technical manual before you start using the GreenBox. Limited All rights reserved - 5 -

6 GreenBox Interfaces The serial interfaces COM1 and COM2 are to connect a wireless sensor gateway or directly to devices. COM1 RS232 The RS232 interface COM1 (9-pole D-Sub socket) is provided on all GreenBox devices. COM2 - RS485 The GreenBox device is equipped with a RS485/422 interface in order to connect 2- and 4-wire bus systems. This interface is implemented as a 5 pin screw terminal, which is not galvanically insulated. Assignment of the RS485/422, viewed from above. NOTE: We recommend using "Twisted-Pair" cables. For RS422 and 4-wire RS485, two twisted pair cables are to be used. RS422 Connection Limited All rights reserved - 6 -

7 Accessing the DIP Switches In order to set the operating mode of the RS485/422 interface, DIP switches are to be used. These are located right beneath the COM2 interface and may be accessed after removing the terminal cover: Put a screw driver (with 3 mm blade) into the slit between case and terminal cover and rotate the screw driver a little bit. With an audible click, the terminal cover snaps out of the case and may be removed now. Below this cover, you will find the DIP switches. Their exact meaning is described in the following table. Limited All rights reserved - 7 -

8 Setting operating mode via the DIP switches Operating mode Switch 1 Switch 2 Switch 3 Switch 4 DIP 2-wire RS485 with termination wire RS485 w/o termination wire RS485 w/o termination wire RS485 with termination RS NOTE: RS485 stipulates that the cables should be terminated at both ends of the transmission section. The termination prevents signal reflections in the cables and in times of no data transmission enforces a defined idle state on the bus. This termination can be implemented using, for example, specific resistors at the screw terminal. This can also be implemented via the DIP switches on the device. RS485 2-wire connection In this operating mode, transmit cables and receive cables are interconnected. If the GreenBox device is installed at the beginning (first station) or end (last station) of the bus system, the bus system must be terminated by setting the DIP switches accordingly. The twisted pair cable is to be connected to T+ to T+ or R+ and for T- to T- or R- according to the adjacent figure. Limited All rights reserved - 8 -

9 RS485 4-wire connection The terminals of the 2 twisted-pair cables are wired in the same way as for the RS422 connection. Both twisted-pair cables must be terminated if the GreenBox device is installed at the start or end of the bus cables. The termination of the receive cables is activated via the DIP switches. The transmit cables must be terminated externally (see figure, arrow). ATTENTION: Always ensure that the end devices are terminated correctly. Incorrect or missing termination may give rise to communication faults. Limited All rights reserved - 9 -

10 Contents What s inside the Box... 2 GreenBox 360 Specification... 3 GreenBox Hardware Simple setup steps to follow... 5 GreenBox Interfaces... 6 COM1 RS COM2 - RS Accessing the DIP Switches... 7 Setting operating mode via the DIP switches... 8 RS485 2-wire connection... 8 RS485 4-wire connection... 9 Quick Guide Wizard & Start Up Step 1 Network and Communication Settings Step 2 GPRS Settings Step 3 Administrator & System Settings Step 4 Site Details Settings Step 5 Setup Summery Adding RS485 Hardwired Devices Adding Driver Adding Sensors Adding ZB-Connection Sensors Adding a Driver Adding a Device Add Repeater Adding Data Points Data Point Chart Calculation Point Data Point Types Holding Register Dialog Input Register Dialog Input Status Dialog Coil Status Dialog Limited All rights reserved

11 Device Commands Download CSV (Data Point) Data Automated CSV (Data Point) Data FTP CSV (Data Point) Data Remote Web Service Call Modbus/TCP Slave Data Points Modbus Register Map Modbus Device List Device Modbus Map Float Byte Order Main Menu System Settings Diagnostics Data Database Export ModBus Slave Main Display Area Tree Tabs Device Tab Data Point Tab Driver Device Map System Message Area Diagnostic Log System Status System Status Indicators Comms Check Network Settings Date & Time Settings NTP Time Server Time Zone User Maintenance Reboot and Shutdown Upload Definition File Update Firmware Limited All rights reserved

12 Backup Data Backup & Restore Data File System Reset Reset System Reset Data Improper Shutdown GreenBox DEXCell Integration Configuration in GreenBox Configuration in DEXCell Energy Manager GreenBox esight Integration Import Code Data Import Limited All rights reserved

13 Quick Guide Please ensure you also read the full technical manual for GreenBox 360 along with technical user manuals for sensors before removing the GreenBox from its packaging and powering it up. Important Note: When the GreenBox has been powered up, do not remove power from the GreenBox unit at any time without properly shutting it down by selecting Shutdown from the Administrator menu. As this could corrupt data and make the system unusable. Default Settings IP Address: Administrator Username: admin Administrator Password: password Important Note: Ensure you have the information to a valid and accessible SMTP Server; if authentication is required then you should have a valid username and password for the SMTP server, to ensure GreenBox can send out s. Also ensure that GreenBox has access to the internet to allow it to synchronize its date & time and communicate via s. Finally ensure each GreenBox has a unique address as you may face problems of service provider blocking s from GreenBox s with the exact same SMTP settings. Network Settings GreenBox provides a user interface via the HTTP protocol and so is only accessible via a browser from a PC or laptop. The first step is to set up GreenBox to conform to your LAN settings so that it is accessible from within your LAN: Accessing GreenBox for the first time there is more than one way to access your GreenBox for the first time: USB stick to change the IP address of the GreenBox. Insert the USB stick provided on your PC/laptop that runs on Windows OS. From the Windows Explorer, navigate to the USB drive. Double click on the GreenboxUtility.exe application to display the following Network Configuration Tool dialog. It will display the LAN settings from your PC/Laptop and you need to complete the Network Address field s last box (in green). Ensure that this number is unique for your network. Click on OK. This will generate a special file on the USB stick (called Interfaces.txt). Now safely eject the USB stick from your PC/Laptop. You can insert the USB stick in the USB slot even if it s powered up. Wait for 1-2 minutes you should hear a beep, open a Browser on your PC/Laptop and enter the URL with the new IP Address you entered in the Dialog above. Remember to also enter the port :8092 in the URL. You should now see the web interface which will be the setup wizard (see below). Direct Connection to GreenBox Connect to the GreenBox from your PC/Laptop using a standard Ethernet cable and change your PC/Laptop s static IP address to say Apply power to GreenBox and wait for a couple of minutes. You may now enter the URL and access the Web-interface which will for the first time be the setup wizard. (See below) Limited All rights reserved

14 Wizard Configuration As soon as you access the IP address the first page that you can see is the GreenBox Wizard. This Wizard will guide you through the setup steps of the GreenBox ensuring its correct operation. If you feel at any point of the setup to cancel or postpone the setup, you can do so by clicking on the shutdown button. Record the administrator password in a safe place. Recovering a lost administrator password is not a simple process. Login to GreenBox 1. When you complete the setup from the wizard then the system will reboot applying the new settings; it could take up to 2 minutes for the GreenBox unit to boot up for the first time. 2. Load a web browser on your PC, and in the address bar, type the applied GreenBox IP address. For example (default IP address) 3. You should see the GreenBox login screen. Mozilla Firefox is the recommended browser required to access the GreenBox unit. If you do not have it installed, please download this free browser first. 4. If you still do not see a login screen after 5 minutes then check your network settings and the address in the browsers address bar. 5. Log in to the GreenBox unit with the username (default will always be admin) and password you have set on the Wizard. Do not misplace the password; recovery is not a simple process. 6. When loading the system for the first time with a new gateway it can take up to 3 minutes for the Gateway to be setup and appear as connected on the interface. 7. You will then be able to add devices and data points and build your sensor network before initiating the data exports. Getting Started Adding a Driver 1. Right click on the GreenBox in the Devices Tree, and select Add Driver. Complete the form with the corresponding information. 2. Ensure that the gateway is connected and accessible to the system 3. Select the driver type from the drop-down list. 4. Enter a name for the driver. 5. Enter the Modbus Address assigned to it.(note: If this is not required then leave the default value as it will be ignored) 6. Select type of driver, serial or tcp. (This will display the appropriate fields) 7. For TCP driver, enter the IP Address and port number. For the Serial driver, select the serial port, baud rate, parity and stop bits 8. Enter the minimum and max range of ModBus addresses this driver can address. 9. Enter a short description (optional) Limited All rights reserved

15 Adding a Device 1. Ensure the device to be joined is powered up and ready to be added to the GreenBox. If the device required hard addressing then ensure the address which is set is unique. Please refer to the Add Device/Sensor section in the User Manual. Also refer to the Device user guides. 2. From the Devices tab on the left pane, right click on the Driver, click Add Device button. 3. The Add device dialogue appears, select the appropriate device product code from the drop down list. Enter the name and its unique Modbus address. Click the Submit button and wait until the device appears in the list. Some manufacturer devices will require stimulation through the joining process. (See Technical User guide and device user guides for more details) Adding a Data Point 1. Click on a device node on the Devices tree or occupancy map, the ModBus register details of the device will appear. From the details screen of the device, right click on a register row of the desired point you wish to add as a data point. 2. Select Add Data Points from the context menu. 3. A dialog will be displayed. Enter the details for the new data point. If you wish to log the point check the box and click the Submit button. The data point will now appear in the Data Points tab under the Driver folder. Ensure each data point has short unique name. 4. Creating a Calculation point whilst in the Data Points tab, right click on the Driver folder and select Add Calculation Point. A Calculation Point dialog will be displayed. With your mouse, select a data point from the Data Points tree and drag it into the first empty row in the grid on the Calculation Point dialog and release the mouse. You may repeat this for other data points if required (up to 6 data points allowed). See Technical User guide for more details Saving Data 1. When you add a data point within the dialogue you have the option to save the data. If you miss this stage then right click on the new data point within the Data Points Tree; from the context menu select Save Data. 2. A Disk icon should appear against the data point; this indicates that data will be saved at the set intervals. 3. Right click on the data point which you have saved the data for and select Show Chart to display data and to download data using the export feature. Please note that you should allow at least 1-2 hours for the chart to appear and display any data! (See Technical User guide for more details) Important Note: Data Point Naming Convention when assigning a name for a data/calculation point ensure it is meaningful, succinct and unique to differentiate between points. Use the description section to add more details. Saving Data Please ensure you are only saving data points which you require, do not save data for a point if it is not necessary. Limited All rights reserved

16 Wizard & Start Up As soon as you access the IP address of the GreenBox the first page that you can will is the Wizard for the installation. This Wizard will guide you to setup the GreenBox ensuring its correct operation. If you feel at any point of the setup to cancel or postpone the setup, you can do so by clicking on the shutdown button. When you return to the setup, the wizard will remember all the details you had provided up to the point where you decided to shut down the setup process. Limited All rights reserved

17 Step 1 Network and Communication Settings Here you are able to make changes to the network settings and IP Address of the GreenBox. This step also checks to ensure the GreenBox has access to the internet if you are using the LAN for this connection. This Step also allows you to connect to a NTP (Time Server) allowing the GreenBox to sync its time clock. This is a very important aspect for the data logger so please ensure the date and time come back correct before moving forward. Once you are satisfied with the network settings click Apply. If you make any changes to any step in the Wizard click the apply button at the bottom of the screen and move to the next page. Step 2 GPRS Settings If you require a GPRS Connection for the internet access then please ensure you have selected the check box on the first screen. Complete the form and click the Apply button to establish the connection. Be patient as it takes some time to initialize a connection. Once the GPRS has been enabled, it takes precedent on all calls to the internet and so remote calls, s, ftp transfers use this channel. Once the GPRS connection is established, it will probe for the internet access. It takes prescience on the internet connection. Ensure that the Internet Connection shows ONLINE and GPRS Connection is ACTIVE before moving to the next page. Only proceed when you are satisfied with the signal and that you have all of the correct APN details. If the APN details are incorrect the GPRS will just loop trying to connect without success; the same goes for a poor signal strength. Limited All rights reserved

18 Step 3 Administrator & System Settings Now you need to complete the Admin section, were you will provide some additional information about the user and system settings. Note: The username will always be admin. Enter the interval in minutes used by GreenBox to save data points in the internal database (min: 1 minutes - max: 60 minutes) we recommend using a minimum of 5 minute interval. Insert time zone, language, country, then click on the APPLY button to submit the settings and ensure that the time displayed is correct for your time zone in the top of the dialogue. Step 4 Site Details Settings Here you will provide some additional information about the site GreenBox is installed. Also on this step ensure that you have entered a valid SMTP server domain name to enable s, and finally click on the APPLY button to submit the settings. Consequentially, the Test button will become available to send out a test to your specified address. Click on it and a dialog box will appear asking to provide an address so the system can send a test . Once the SMTP Status is VALID and the Status is ACTIVE you can proceed further. Limited All rights reserved

19 Step 5 Setup Summery On the last step you get a summary window that displays all the setup details you have provided. Ensure you first download the PDF copy of this summery and keep it in a safe place. As the recovery of the password is not a simple process. Ensure that all of the status shown on the top of the window are all set up correctly before you select Finish. Limited All rights reserved

20 After you press Finish you will get the following window asking you whether you feel comfortable with the details you have provided and press Yes to continue. Please be patient on this step as the GreenBox needs about 2-3 minutes to apply the wizard settings, reboot and load the application, you will hear a beep from the GreenBox when it is ready for you to login. Enter the default username admin and the password you provided and click on the Login button You can now login and start using the GreenBox application Limited All rights reserved

21 Adding RS485 Hardwired Devices Adding Driver GreenBox can be connected directly to compatible ModBus slave devices connected on the RS485 port (COM2) 1. Right click on the GreenBox in the Devices Tree, and select Add Driver. Complete the form with the corresponding information. 2. Select the relevant driver type from the drop-down list (RS485). 3. Enter a name for the driver. 4. Enter the Modbus Address assigned to it.(note: If this is not required then leave the default value as it will be ignored) 5. Select type of driver - serial (This will display the appropriate fields) 6. Enter a short description (optional) Adding Sensors 1. Once the Driver is joined and to the GreenBox it will appear in the Tree Structure in the Devices Tab, you are now ready to join devices to this driver. 2. Ensure the device to be joined is powered up and ready to be added to the GreenBox. 3. From the Devices tab on the left pane, right click on the right Driver you wish to add the sensor to, click Add Device button. 4. The Add device dialogue appears, select the appropriate device product code from the drop down list. Enter the name and its unique ModBus ID. Click the Submit button and wait until the device appears in the list. (See device user guides for more details) Limited All rights reserved

22 Adding 4-noks Sensors Adding a Driver ZB-Connection range of sensors from the 4-noks product catalogue is possible to connect to the GreenBox through a number of different gateway options USB, RS485 or Ethernet. Follow the link for technical documentation on the sensor range 1. Right click on the GreenBox icon in the Devices Tree, and select Add Driver. Complete the form with the corresponding information. 2. Ensure that the ZB-Connection gateway is connected and accessible to the GreenBox. 3. Select the relevant driver type from the drop-down list. 4. Enter a name for the driver. 5. Enter the Modbus Address assigned to it.(note: If this is not required then leave the default value as it will be ignored) 6. Select type of driver, serial or tcp based on the gateway being used. (This will display the appropriate fields) 7. For TCP driver, enter the IP Address and port number. For the Serial driver, select the serial port, baud rate, parity and stop bits 8. Enter the minimum and max range of ModBus addresses this driver can address. 9. Enter a short description (optional) Adding a Device 1. Once the Driver is joined to the GreenBox it will appear in the Tree Structure in the Devices Tab, you are now ready to join devices to this gateway. 2. Ensure the device to be joined is powered up and ready to be added to the GreenBox. If the device required hard addressing then ensure the address which is set is unique. Please refer to the technical manual of the device for more information. 3. Only power up one device at a time that is being joined to this driver type. 4. From the Devices tab on the left pane, right click on the right Driver you wish to add the sensor to, click Add Device button. 5. The Add device dialogue appears, select the appropriate device product code from the drop down list. Enter the name and its unique Modbus address. Click the Submit button and wait until the device appears in the list. Some devices will require stimulation through the joining process. (See device user guides for more details) Limited All rights reserved

23 Device Name - Enter a meaningful name for the device. Keep it short as it will be displayed in the Tree tab in the left-pane. Device Address - Enter the ModBus address for the device. For ZB-Connection this should be between In the case of a hard address setting device, this should be the address number you have set on the device. In the case of a soft address setting device, enter a unique address in this field and GreenBox will assign this address to the device during the joining process. Description - Enter a description for the device. This is to help you identify this device Addressing Options - ignore this field. Only click on this field if you want to force the device at this address. Remember you cannot have more than one device per address field! This is only there if you are absolutely sure that there is no device at this address. Only power up one device at a time when joining them to the GreenBox. Finally click on the Submit button. During the process the following dialog may be displayed: Some devices require stimulating by pressing a button. You should do so now and then click on the OK button. Wait until the device appears in the Devices folder in the tree tab under the Devices tab. GreenBox is optimized for 4-NOKS wireless devices and removes the need of remembering the register maps of devices and makes the joining process painless! All devices that the system recognizes appear within the list of devices during the joining process. These are definition files held within the system. There is the facility to upload new definition files for missing devices if required. Limited All rights reserved

24 Add Sensor with Hard address settings This describes the steps to add a device with dipswitches to set the ModBus address, a Temperature- Humidity-Light sensor for example, the ZED-THL-M. This device requires the address to be set via dip switches. When following the steps to add the sensor to GreenBox on the Add device dialog you must enter this unique address into the device address field. (Please also refer to the ZB-Connection technical User manual for each device) Apply power to the device; in this case insert the battery in the holder. The device is ready to be joined to the network. Back on the browser, right click on the devices folder in the devices tab in the left pane and select Add Device/Sensor to the ZB-Connection Gateway Driver item in the context menu and follow the above process. Add Sensor with Soft address settings This describes the steps to add a device without dip-switches to set the ModBus address, a Plug sensor for example, the ZR-PLUG-M. This device requires the address to be set via the Add Device/Sensor dialog menu through the GreenBox. These types of sensors do not have dip switch capability but instead require a unique address to be set to the device through the GreenBox interface. You must first apply the power to the device, ensuring the device is ready to be joined. On the GreenBox interface follow the procedure to add the device and enter a unique address for the device. GreenBox displays a dialogue if the sensor requires stimulation you must press the button on the device. Once you have confirmed this action by clicking on the OK button; the device will go through the joining process and then appear in the device tree. (Please also refer to the ZB-Connection technical User manual for each device) Note: It can take up to 2 minutes for devices to be processed and added to the system Limited All rights reserved

25 Add Repeater A repeater is a special device that is not visible in the network but is introduced at strategic positions to strengthen the wireless signals. This device needs to be registered with the network and can be done from the devices context menu by right-clicking on the Devices folder in the Devices Tree. Click on the Add Repeater menu item to display the following dialog: Click on Yes button. It will take approximately 20 seconds for the joining process. As stated earlier, there is no visibility of this device in the device list. Certain Input Registers of the gateway show the number of routers present in the network, viewable from the gateway's device details page. The before and after should show an increase by one of these register. Limited All rights reserved

26 Adding Data Points Data Points are elevated device registers. What this means is that a device register whose value is deemed useful is elevated in status so that the GreenBox tracks this register for you. In addition, you can make GreenBox save the register value at regular interval (this is set in the wizard for example log data every 5 minutes). To Add a Data Point, click on the device node in the Devices tab of the tree tab. The device details tab appears in the main display area. This displays the device register details. Now right-click on a row representing the required register. A context menu will appear. Click on the Add Datapoint menu item. GreenBox will display the Add Data Point dialog: Limited All rights reserved

27 Complete the form and click submit to elevate the data point to the GreenBox. Some registers may be elevated but not logged. You can also apply and expression the value which is applied to the reading before logging. Once an expression is applied it takes precedence on the data point. There will be a default name given to the data point consisting of the device name - Register name. You may enter a meaningful name for the new data point in the Name field and a suitable description in the Description field. Check the Save Data checkbox if you want the system to save the data for this data point at the regular interval and finally click on the Submit button After a short while the new data point will appear in the Data Point section of the left hand side of the window. If you are logging the data point the following icon will appear next the register. Limited All rights reserved

28 Data Point Chart The 'Data Points' on the left-hand pane of the main display lists all of the data points. Each data point that has been marked to be saved shows the save icon. Right-click any of these data points and selecting the 'Show Chart' menu item will display the chart for that data point. The default chart is for the current day. The time axis shows all of the days saved points (visible by logging interval). You can move back and forth by clicking on the video style controls (B) or jump to the desired day by selecting the date from the date picker field (A). The metered profile check box (C) should be selected when a metered value is displayed. This will show the consumption at each interval as a bar chart. Furthermore, you can export the data as a CSV file by clicking on the EXPORT button (D) on the top right-hand side of the chart. This will display the export dialog The chart showing the days values at the number of minutes interval that was set at the beginning for a data point. The smaller chart below the main chart is the overview. From this chart you can zoom in to a specific interval by dragging the mouse from a start point to the end point. This will highlight the overview span and the main chart will zoom in to that time span. Limited All rights reserved

29 The chart above is shown displaying metered values (these are ever-increasing values) together with the profile as a bar chart. The bars are the actual consumption at the intervals super imposed on the metered values but with its own y-axis on the right. Note the charting tool is designed purely to provide a user a visual indication of the presence of data within the system. It is not designed to be an analytics platform and the user must consider exporting the data to a compatible platform for data analytics. Limited All rights reserved

30 Calculation Point When you right click on the Driver Folder in the Data Points Tree and select the "Add Calculation Point" menu item from the context menu, the "Calculation" dialog is displayed. You can now drag the required data point(s) from the tree to the Calculation dialog and drop it to the first empty row in the grid. You are allowed up to 6 data points. Start to drag the data point out to the Calculation dialog, Drop it on the first empty row in the Calculation Dialog's grid: As you drop the data point in the grid, it gets occupied by the identifier for the data point. You can repeat this for other data points. The example below shows 2 Voltage points in the grid. Limited All rights reserved

31 Below is an example of a calculation point Average temperature from three temperature values. Once you have dragged the data points you wish to use into the list complete the rest of the fields: Name - Enter a short meaningful display name for this data point Expression - Enter a valid arithmetical expression comprising of the data points and any constant values as shown above. This shows the expression that calculates the average of the two temperature values. Note that each data point is referenced by V#X where X is the position of the data point in the grid. Thus V#1 references the first data point, V#2 references the second data point and so on... Description - Enter a description for this data point Decimal - Enter the number of decimal points after the number. The example above shows 2 places. Unit Label - Enter the unit of measure. The example above shows C (Degrees Centigrade) Click on the Submit button to create the data point. Wait until it appears in the tree. Now click on the equal s button to view the result in the Result field. You can dismiss the dialog when done by clicking on the Cancel button or the X button at the top right corner of the dialog. Limited All rights reserved

32 Data Point Types Devices have a data point register map there are different types of data points associated with a device. Holding Register Dialog When you click on the Holding Register details row in the device details display, the "Holding Register Details" will be displayed: This displays the details of the device and the selected Register of the device. Since this is a writable register, you can change its value by entering a new value in the New Value field and click on the Submit button. Input Register Dialog When you click on the Input Register details row in the device details display, the "Input Register Details" window will be displayed: This displays the details of the device and the selected Register of the device. This register is read-only. Limited All rights reserved

33 Input Status Dialog When you click on the Input Status details row in the device details display, the "Input Status" window will be displayed: This displays the details of the device and the selected Register of the device. This register is read only. The example above shows the status of the High Temperature Alarm is OFF. Coil Status Dialog When you click on the Coil Status details row in the device details display, a command window will be displayed: This displays the details of the device and the selected Coil Status (Register) of the device. It will have one or more buttons that allow control of the device. This depends on the selected device, and the button(s) will have the appropriate label. The example above shows a button that will switch the load connected to the device ON and disable the Standby facility. Limited All rights reserved

34 Device Commands Device commands are an advance feature of certain devices. Right-click on a device entry in the Device Tree and select the 'Show Device Commands' menu item will display the list of the commands available for the selected device in the main display area. Clicking on a device command display a dialog, and depending on the command, with fields that need some values to be entered. The dialog is the result of clicking on the last command in the list, Set Energy Measured Counter Values. The resulting dialog shows two required fields to be completed. This will run the selected command and configure the device. This functionality should not normally be required and should only be used when you are absolutely certain of what you are doing! Information about device commands is available from the device's technical manuals. Limited All rights reserved

35 Download CSV (Data Point) Data A detailed CSV data file for all of the persisted data points can be downloaded from the Data > Download CSV menu item. This will display the dialog: The dialog allows you to enter a start date and end date for the data. Try to keep the number of days to a low value as this can take some time to assemble the data. When you click on the DOWNLOAD button, the browser will display its download dialog: You can either save the file or open it in the default application, normally Excel in Windows PC. The first column in the CSV file is the Date/Time, followed by a column for each persisted data point that exists in the system. Each data point column header has the following information: DeviceName:DeviceId:DataPointName:DataPointId:UnitOfMeasure Notice that each item of information is separated by a colon (:) Limited All rights reserved

36 Automated CSV (Data Point) Data Your system has to have the SMTP server details setup correctly for the following setup to function correctly. You can set up the SMPT details from Site Details form. In addition to this, the system should be able to resolve the SMTP domain name and you can check this from the Diagnostic->Comms menu You can set up the system to a CSV file for all of the data points at specified regular interval to a number of specified addresses from the 'Database Export Option/ CSV File menu item. When this is enabled, the system will assemble the data for all data points being saved based on the selected interval and the CSV file. To enable the CSV s, select the ' CSV File' from this menu and complete the displayed dialog. Select the system users displayed in the Registered Users. Other fields to consider: CSV Delimiter Select how you wish for the CSV file to be generated using the different options Exclude GUID - Check to remove the first two rows with the.csv file Compress File - Check to compressed file, un-check for clear file External Recipients - Enter addresses, separated by semi-colons (;). Ensure that these are valid addresses. Interval - Select the interval for the . This will determine the data content, thus for a 5 minute interval, the file will contain only one line. For 10 minute interval, there will be two lines of data (2 X 5 minutes) and so on. If there is data accumulated when the is enabled, the system, will complete each outstanding days worth of data until it has caught up with the real time. You can disable this at any time by selecting the 'Pause button from the CSV dialogue. You are also able to Resume and Delete the export from the controls. When you resume the service by selecting the Play button it will display the following dialog: Limited All rights reserved

37 It provides a choice of the resumption position: Current Position - No change resume from the last sent date time Selected Date - Resume from the selected date (Start of that day). Be sure to select the date from the Select Resume Date field. Start - Resume from the first record held in the system. Limited All rights reserved

38 FTP CSV (Data Point) Data The system provides FTP and SFTP services. FTP is the simple File Transfer Protocol and you should have all of the necessary details to hand before setting up the service. In particular you should know which mode to select, ACTIVE or PASV. Failures can result by selecting the wrong mode. Other things to consider are firewall settings and port forwarding and in the case of the hostname being a domain name, that your name server details are correct to resolve this successfully. You can check this from the Diagnostic->Comms menu SFTP is the secure transfer method via the SSH functionality. Again you should have all of the necessary details to hand before setting up this service. In this case you should be aware of any port forwarding requirements for remote servers and firewall settings and in the case of the hostname being a domain name, that your name server details are correct to resolve this successfully. You can check this from the Diagnostic->Comms menu. You can set up the system to transfer a CSV file via FTP for all of the data points from the 'Database Export > FTP CSV File menu item. When this is enabled, the system will assemble the data for all data points being saved and send the CSV file via FTP at the selected interval. To enable the CSV FTP service, complete the displayed dialog: CSV Delimiter Select how you wish for the CSV file to be generated using the different options FTP/SFTP - Select either one (SFTP is secure transfer) FTP Mode - Select ACTIVE or PASV (only applies to FTP transfers) Limited All rights reserved

39 Compress File - Check to deliver compressed file, un-check for clear file Hostname - IP address or domain name of the FTP server Port - Enter the FTP port if different from the default one Path - Enter the path to where the file is to be delivered. Username - The login user name Password - The login password Upload Interval - Select the interval. The contents of the CSV file will depend on the interval selected. You can disable this at any time by selecting the 'Pause button from the CSV dialogue. You are also able to Resume and Delete the export from the controls. When you resume the service by selecting the Play button it will display the following dialog: It provides a choice of the resumption position: Current Position - No change resume from the last sent date time Selected Date - Resume from the selected date (Start of that day). Be sure to select the date from the Select Resume Date field. Start - Resume from the first record held in the system. Limited All rights reserved

40 Remote Web Service Call Your system should have access to the Internet to be able to push data from this service. You can use the Diagnostic > Comms menu to check if the system can ping the domain name you enter in the URL for this service. Access to the internet depends on the correct network settings comprising of: IP address of the system Gateway IP Address provided for the system to use Name server (DNS) details for the system to use to resolve domain names. Only proceed when you have successfully pinged the domain name of the URL using the comms check tool in the diagnostics menu The system is capable of pushing data to a remote web service that has been implemented to the required specifications. Two protocols are available, the normal and the secure Note that the secure protocol is purely used to transmit data encrypted and no authentication takes place. When you have been given a URL for this remote web service call, you can set up the system to call this service at regular intervals. The Export Options menu has the Remote Web Service item that allows you to do that. Select the item from this menu to allow you to enter the URL: Remote Service URL - Enter the URL for the remote service. It should begin with or Connection Timeout - Enter the timeout interval, the default is 90 seconds. HTTP Proxy - Enter proxy server URL, if any, or leave blank. HTTPS Proxy - Enter proxy server URL for https, if any, or leave blank Compress Payload - Check to have the data to be compressed, uncheck for clear data push Minimal Setup Call - Check to include only the device register maps information of elevated data points in the setup call Reset Start Time - check to begin from the start with an initial setup call. (This is valid if you are changing the url) Call Interval - Select the call interval. Note that the data contents will depend on the selected interval. The first call the system makes is a setup call. I.e. it provides all of the structure details within the system, including all of the device and data point IDs. This information can be used to setup the structure of the devices and their data points at the remote end and subsequently relate the incoming data to the correct points. Limited All rights reserved

41 Once the system is up and running and calling the service, you can pause the call by selecting Pause. This will stop the calls until you resume the service calls by clicking Play. Note that once you pause the calls, this will be in effect even when you reboot the system. To restart a paused call, simply click on the play button. The system will want to know where to resume from: Current Position - No change resume from the last sent date time Selected Date - Resume from the selected date (Start of that day). Be sure to select the date from the Select Resume Date field. Start - Resume from the first record held in the system. Limited All rights reserved

42 Modbus/TCP Slave GreenBox implements an asynchronous Modbus/TCP server at the default port number 502 that runs in the background and appears as a slave device to a master Modbus/TCP controller at the special (reserved) slave id of 2. At this location, GreenBox maps all of the Data Points as Input Registers, each occupying 2 registers. Currently only ModBus function code 4 is supported. The value of each Data Point is encoded as a 32 bit IEEE 754 floating point number, and packed in the format that you can specify by setting up the byte ordering. This options allows you to select the byte ordering that your Modbus Master expects. GreenBox provides the means to download details for the use of this functionality: Download Device List - PDF document that lists all devices accessible via ModBus calls. Download Modbus Register Map - PDF document detailing the dynamic register map of the elevated data points in the system. Download Modbus Register Map available from the same menu. Data Points Modbus Register Map The Register map for the Data Points is dynamic in nature as it is quite possible that Data Points could be added or removed at any time. GreenBox will keep the register address of Data Points static so that the registers that were occupied by a deleted Data Point will be marked as unused and always return a value of zero. Newly added Data Points will appear at newly created register addresses in a contiguous manner, thus this map will grow. It is recommended to download the Modbus Register Map document whenever such changes take place. Limited All rights reserved

43 Modbus Device List In addition to this, GreenBox will also allow the Master controller to access the registers of the devices connected to it by using the slave id assigned to the devices by GreenBox. To aid this, GreenBox will generate a list of devices connected to it with their Modbus slave ids. Device Modbus Map Access to device registers via the Modbus/TCP route should be undertaken with care as changing values for COILS or Holding Registers could change the behaviour of the device. If you click on the GreenBox at the top of the Device Tree you will be presented with the GreenBox data point list and the ability to download the dynamic ModBus Device list and ModBus Register map for integration to a third party ModBus Mater. Limited All rights reserved

44 Float Byte Order This applies to the data available from the Modbus/TCP slave at the ModBus device address (Slave id) of 2 only (see Modbus Slave). The 32-bit IEEE 745 Floating Point Number comprises of 4 bytes of data. Now the problem is one of how to arrange the bytes so that the Modbus Master can decipher and get at the floating point value as intended. Depending on the Modbus Master system, the byte ordering must conform to either Big Endian or Little Endian and their reversed ordering. To mitigate this situation, you can setup the byte ordering to suit your system from the ModBus Slave Menu. This will display the setup dialog as follows: Select your option and click on the Submit button. The effect is immediate and you will NOT have to reboot the system. If you are unsure which one applies to your system, try each one in turn! Limited All rights reserved

45 Main Menu The main menu provides calling on various functions: Logout - Logs out the user from the system and displays the Login Screen Users - Displays the Users Maintenance Dialog. System Backup System - Performs a system backup Download System Backup downloads backup Upload System Backup dialogue to upload file for backup Restore System Restores the system from backup Reboot - Reboots the system Shutdown - Shuts down the system Upload Definition File - Add a definition file Update Firmware - Updates the firmware Factory Reset - Sets system to factory defaults Settings Site/SMTP Details - Site and SMTP Settings Network - Network Settings Set Time Server NTP URL Set Date/Time - Sets the system Date/Time Change Time Zone Change country time zone GPRS - Manage GPRS Connection Diagnostics Comms - Check Network Communication System Status - Show system status Boot Log Display, , Download boot log System Log - Display, , Download current system log GPRS Log - Display, , Download GPRS log file Modem Log - Display, , Download Modem log file Limited All rights reserved

46 Data Backup - Backs up the data file Upload Backup - Upload the backup Data File Restore Data - Restores the data Reset Data - Resets the System Download CSV Generates a CSV of data Database Export CSV File - data options Remote Service Call - Push data options Ftp CSV File - Data File transfer options ModBus Slave Download ModBus Reg Map file generated Download Device List - file generated Float Byte Order setting for byte order TCP Slave - setting for TCP Slave Serial RTU Slave - setting for Serial Slave Sub Menu Devices displays driver/device list in tree Data Points displays data points in tree System Status opens System Status dialogue Refresh refreshes content in tree and in main display Limited All rights reserved

47 Main Display Area This is the central area of the screen which displays details of device register, data charts for data points that have a chart icon against them. Each details display is a tabbed item in the central display area. Device details appear when a device entry in the device tree is clicked or when an ACTIVE icon in the occupancy map is clicked. Charts are displayed when a data point in the Data Point Tree that have a save icon "Show Chart" menu item is clicked in the context menu. is right-clicked and the Data Points are created from the device details display that is a grid consisting of rows detailing the device registers. To create a Data Point, right-click on a row and select the Add Datapoint menu item from the context menu: A dialog will be displayed to create the data point. Limited All rights reserved

48 Tree Tabs The left-pane of the main display consists of the Tree Tab that has two tabs, the "Devices" and "Data Points" tabs: Device Tab This displays the list of Driver and Devices that have been registered with GreenBox under the Driver folder. From here you can add more devices by right-clicking on the Driver folder: This will display the Add Device Dialog to enable you to set the device details and register it with GreenBox. Right-click any device functionality: under the Devices folder for additional Refresh - Click to refresh the tree view Show Device Commands - Click to display device commands Connect Device - Click to make GreenBox connect to this device. Only when the device has been disconnected. Edit Details - Click to edit device details Delete - Click to unregister the device from GreenBox. This will not remove the device from the driver Download Modbus Map - Click to download the device's Modbus map document. Limited All rights reserved

49 Data Point Tab This displays the data points that have been added to GreenBox. You can only add more data points from the devices details display. Right-click on any data point provides additional functionality: Refresh - Click to refresh the tree Edit Details - Click to edit details Save Data - Click on this to start saving the data for the data point. A chart icon appears next to the data point. Delete Data - Click on this to delete the data for the data point. Show Chart - Click on this to display the data chart for the data point. Delete - Click on this to delete the data point. All logged data will also be deleted. Download Modbus Register Map - Click to download the PDF file of the dynamic register ModBus register map. Limited All rights reserved

50 Driver Device Map If you click on a specific driver a tab opens up in the main display area which shows a device map for sensors connected to that driver. Here you can easily identify available ModBus addresses or click on a device to see its register list. The connection status of a sensor will also be shown in this map making it easy at a glance to check your sensors are all connected okay to the GreenBox. Limited All rights reserved

51 System Message Area This is located at the bottom of the screen and displays the system messages and exceptions. An example of such a message would be the failure of the remote call. The system messages will provide initial diagnostics of any failures or issues with the GreenBox. Limited All rights reserved

52 Diagnostic Log The system logs can be viewed by selecting the 'View Log' from the Diagnostic menu. This displays the logs dialog. There is also the functionality to each of these files as well as downloading the file to the local machine. The Boot log file can be useful to aid diagnosing power failures. The System log file can be used to diagnose overall system issues. The GPRS log can assist identifying issues from the SIM provider The Modem log is useful to understand if the modem is operating properly You can also the log file to the ADMIN user's address. Click on YES to the file to the ADMIN user. Limited All rights reserved

53 System Status The system status dialog can be invoked from the 'Diagnostic' menu by selecting the 'System Status' menu item. This displays a dialog that shows various system status. It is a great tool for diagnostics and understanding and identifying issues or that the system is running ok. It shows the Disk Usage, Memory usage, the size of the data file and the activity duration of available processes including system uptime. The service health check dashboard lists the activity and status of each of the available process in real time. If any of the services are in error then the red Thumbs Down icon will appear and you can identify which service is at fault. The GPRS section will show the SIM details and signal strength including the IP Address. The system status screen is one of the most important screens as it gives you a clear picture of the setup of your GreenBox. Note that 'na' means not available. Limited All rights reserved

54 System Status Indicators At the bottom of the main display area consists all of the system indicators, they will allow you at a glance to see what services are active and they status: Device Scan Status: Scan running Scan processing Scan Error Data Save Status Data save running Data save processing Data save error System Status: Running OK with no errors System fault requires further Investigation. CSV Export running Export paused Export error FTP CSV Export running Export paused Export error Remote Service Export running Export paused Export error ModBus Slave Export running Export error GPRS Connection Once activated the signal strength indication will appear Ethernet (LAN) Connection If the primary Internet connection is via the LAN the status show Processing If GPRS is activated the status changes Any time a process is running on one the services Limited All rights reserved

55 Comms Check Comms check allows you to ascertain your connection is able to access the internet. The system should be able to access domain names, which means that it should be able to access e.g. domain names such as google.com etc. This is normally tested with pinging a domain name or IP address. This is what this check allows you to do. Select Diagnostic/Comms menu item to display the Comms Check dialog: In the case above, the dialog shows that we have a GPRS connection since there is a GPRS IP Address value. We now have to check if this connection is able to resolve domain names so that we can use it to send data out successfully. The first thing to do is to enter a domain name in the IP Address/Domain Name field and click on the PING button. We see that there is a tick on the PING button which tells us that the system is able to resolve domain names via the GPRS connection. You must enter the domain names you are likely to use such as your SMPT server name or its IP address and ensure that it can be reached by the system. The SMTP details are set from the Site Settings Dialog Next we can try to ping an IP address. To do that click on the RESET button to clear and enable the field and then enter an IP address (say ) in the field and click on the PING button. Limited All rights reserved

56 Again this shows a success by a tick mark on the PING button. Failures are shown as cross on the PING button. In cases of failures, you must ensure that this is corrected before proceeding any further. Domain names are resolved by having the proper name server entries in your server. In cases of GPRS these are provided by your service provider when a connection is made. If these fail to ping properly then you must inform your service provider. In cases where there is no GPRS connection, the name server s entries will be your responsibility. These can be entered from the Network Settings Dialog. Once you have done this, then you must run the above checks again Limited All rights reserved

57 Network Settings It is very important to set up the system network details for it to function correctly. The system should not be allowed to function if this setting is missing or incomplete. This setting allows the system to set its time accurately, in addition to allowing it to send and receive data from remote sites. Sending of s to alert users also depends on this setting. To recap, the correct settings allow the system: To set its date and time accurately To be available from a browser To call on remote service to push data To be able to the Daily CSV file To be able to alert users via s To be accessible to remote services to take control of devices via their registers. At start-up for the first time, the LAN settings, comprising of the IP address, Net mask and gateway IP address will have been set from the USB interface or through the Wizard. On rebooting the system applies this new settings so that it becomes available from a browser via its new IP address. Remember that the system can only be accessed from the port: 8092! Now it s time to set up the name servers for the LAN so that the system can resolve domain names such as google.com. Select the 'Network' menu item from the 'Settings' menu to display the network dialog: Limited All rights reserved

58 This will display the current settings that apply to the system. The first three are probably right as they were set from the USB method. You now have to enter the correct DNS (name server addresses) that are relevant to your LAN settings. This information should come from your system administrator. You must enter at least the DNS-1 field and optionally the next one (DNS-2) if you are given two addresses. If you only have one then enter this in the first field (DNS-1) and leave the second one blank. Click on the SUBMIT button when done. To check if all is well you must use the 'Comms' menu item from the 'Diagnostic' menu to check if you can ping various domain names and IP addresses. Only move forward when you can do so, otherwise spend time to resolve this issue to avoid any problems afterwards. Limited All rights reserved

59 Date & Time Settings You can set the system date and time if you need to by selecting the 'Set Date/Time' menu item from the 'Settings' menu. You would not normally do this as the system will update its time automatically from the internet. Complete the fields as shown in the dialog and be sure to enter the correct information. You can make the system unusable if you enter wrong details! Make doubly sure that all values are correct before Submitting the form. NTP Time Server A Time Server is a remote machine that enables the system to maintain accurate date and time. By default, the system uses facilities provided on the internet. If there are restrictions in place that prohibit the access to these facilities on the internet then you can replace this by adding a local Time Server service. Limited All rights reserved

60 Time Zone Your time zone is shown below in the Time zone field. The time zone should have already been set from the setup wizard. Proceed with caution as changing the time zone affects the time used by the system and the data that is being saved. Limited All rights reserved

61 User Maintenance From the main menu you can select the "User" item to display the users dialog: GreenBox is a single user system. You must at least change the default password for this user when you start GreenBox for the first time. You may edit other details except for the username. You must provide a valid address for this user. To test that the for a user is working, you must click on the Send button after you have saved the user by clicking on the Submit button. Apart from the valid address, the will only work if you have set a valid SMTP server address and authentication details in Site Settings Limited All rights reserved

62 Reboot and Shutdown You should never pull the plug from GreenBox!!! This could corrupt the data or make the system unusable. Always use this functionality to either reboot or shut down the system. Select System/Reboot or System/Shutdown from the main menu: You will be presented with the Reboot/Shutdown dialog: Click on the OK button and you will be presented with the final reminder as the system reboots or shuts down: Follow the instructions in the final reminder. Remember to wait for at least 2-3 minutes before pulling the plug from GreenBox if you have shut down the system. Limited All rights reserved

63 Upload Definition File The system has pre-defined device definition files that allow you to easily add devices that show up with their registers and their values. At times you may have a device that has no definition file present in the system. In this instance, you cannot add the device to the system. It requires a definition file. When you have a valid and pre-tested definition file for your device, you can upload it and register it with the system by selecting the 'Upload Definition File' menu item from the System menu. The definition file should be located on your PC and should not have been touched in any way. You MUST NOT rename the file or it will not be of any use. Select the 'Upload Definition File' menu item from the 'Settings' menu to display the Upload Definition File dialog. You can click on the BROWSE button on this dialog to locate the definition file on your PC. Finally clicking the SUBMIT button starts the upload process. Remember this can take some time and you should be patient. The upload dialog will display the progress and tell you if the upload was successful. The Upload dialog after you select the Upload Definition File from the Settings menu: Upload dialog preparing to upload the file. Be patient as this may take a while: Upload dialog uploading file showing its progress - wait... Upload dialog shows file being validated and processed: Once the upload and processing has been completed, you should now see the device in the drop down box of devices in the Add Device Dialog. Limited All rights reserved

64 Update Firmware You can update the firmware when it is available. The firmware binary file should be located on your PC. Select the 'Update Firmware' menu item from the System menu to display the Update Firmware dialog. You can click on the BROWSE button on this dialog to locate the firmware binary file on your PC. Finally clicking the SUBMIT button starts the upload process. Remember this can take some time and you should be patient. The upload dialog will display the progress and tell you if the upload was successful. Remember you MUST REBOOT the system for the update to complete. The system will not reboot at the end of the upload! The Upload dialog after you select the Update Firmware from the Settings Menu: When Upload dialog is preparing to upload the file. Be patient as this may take a while: Limited All rights reserved

65 Upload dialog uploading file showing its progress - wait... Upload dialog shows file being validated and processed Please continue to wait. Limited All rights reserved

66 Upload dialog indicates success. You MUST remember to reboot the system for the update to take effect. Limited All rights reserved

67 Backup Data To back up the system data select the Data/Backup/Backup Data from the main menu. Now wait while the system creates the backup file. When the process has completed the system will display the dialog: Remember to Download the Data Backup File this file from the same menu, and store this on your PC to upload at a later date when required. Limited All rights reserved

68 Backup & Restore Data File You can upload a previously downloaded data backup file. This is required when you need to restore it to the backup file you have. The data backup file should be located on your PC. Select the Restore Data menu item from the menu to display the Upload Backup File dialog. You can click on the BROWSE button on this dialog to locate the backup file on your PC. Finally clicking the SUBMIT button starts the upload process. Remember this can take some time and you should be patient. The upload dialog will display the progress and tell you if the upload was successful. The Upload dialog after you select the Upload Backup File from the Data/Restore Menu: Upload dialog preparing to upload the file. Be patient as this may take a while: Limited All rights reserved

69 Upload dialog uploading file showing its progress Please wait... Upload dialog shows file being validated and processed. The system will require you to restore it from the uploaded backup file for the backup to take effect; only once the dialogue advises you it has complete its operation. Limited All rights reserved

70 System Reset There are two types of resets, System and Data. Reset System A System reset results in a completely clean system as it was when it left the factory! This action will delete all of the system data and service profiles. This action should be used with care as all contents of the system are lost! If you must do a system reset, select it from the System menu. This will display the System Reset Dialog shown below: Click on the OK button and after a pause the shutdown dialog will be displayed. On reboot you will be redirected to the Wizard configuration Limited All rights reserved

71 Reset Data This will erase all data from GreenBox so use it with care! If you must reset the System, select Data/Reset Data from the main menu. You will be presented with the warning dialog and a chance to reverse your decision! : It's your choice OK or Cancel! If you select OK, all the data will be erased. You will be presented with the reboot/shutdown dialog while the system reboots. You must now wait for 2-3 minutes before refreshing the browser. Limited All rights reserved

72 Improper Shutdown Please ensure you always shut the GreenBox down from the system menu. Failure to do so may cause you to lose certain records or corruption. The GreenBox has been designed to allow the database to repair itself should it experience any form of corruption. It does this by removing records which have been corrupted during improper shut down when it reboots. This modification to how the system is designed will allow the GreenBox to continue its operation and will ensure there is no downtime on the system. Only data which has been corrupted is removed. This is why it is very important that the GreenBox export any logged data to a remote location for safe storage. GreenBox is able to take advantage of multiple export methods running simultaneously. It is also important to take a backup of the system once you have set everything up. This backup will allow you to restore the database should the complete database become corrupted. This feature also will restore any data held on the box from the date of last back up. ATTENTION: It is highly recommended you use a UPS (uninterrupted power supply) if the site has a fluctuating power supply. GreenBox is venerable to data corruption which result in data loss or system down time. Although there are measures in place to protect the system Greenologic accept no liability for loss of data or downtime. You must ensure that the system it set to export data to a remote location to for data security. Limited All rights reserved

73 GreenBox DEXCell Integration DEXCell Energy Manager is compatible with the Greenologic GreenBox. To properly configure this gateway to send data to DEXCell Energy Manager, follow this steps: Configuration in GreenBox 1. Log in into your GreenBox 2. Go to "Database Export" menu 3. Select "Remote Service Call" > "Add Remote URL" Limited All rights reserved

74 4. Add the following URL: 5. Select the call interval (Normally 15 minutes) 6. Submit the configuration Important note: Before going to DEXCell Energy Manager, write down the HUB ID. This code is needed to link your DEXCell Energy Manager account with this gateway. To find the HUB ID, go to "Settings" > "Site/STMP details" Limited All rights reserved

75 The Hub ID will appear at the top of the dialog. Copy it in a notepad: Limited All rights reserved

76 Configuration in DEXCell Energy Manager Once you have set up the Live Data Export inside the GreenBox, it s time to go to your DEXCell Energy Manager account and register the GreenBox gateway. 1. Go to and log in with your username / password 2. Go to the "Settings" area > "Gateways". 3. Click on "Register a new gateway" 4. Select the GreenBox one and click on "next". 5. Now, simply type a name for the gateway (Ex: Building gateway) and copy the HUB ID in the Identifier field. Finally, save the configuration and wait 15 minutes until the GreenBox starts sending data. Limited All rights reserved

77 GreenBox esight Integration To configure esight to accept data from GreenBox there are two separate steps required. Firstly, the meters import code needs to be configured and secondly the data import needs to be configured. These are described below: Import Code The Import Code within esight s meter configuration is used to link the esight meter point to the data from the GreenBox. The field required is the Import Code as shown below: In the example above, data passed from the GreenBox with a meter reference of SiteElectricity will be passed to this meter point within esight. Data Import Data is passed form the GreenBox and loaded into the esight database. The GreenBox must be configured to upload the file to a folder located on the same server as esight. esight is then configured to process files in this folder by creating an auto import. This is done using the Data Exchange->Auto Imports menu option. Limited All rights reserved

78 Once in the List Data Imports page, click the Add button to add a new import. Enter the folder on the server that the GreenBox is placing the import file and select a file type of Multi Column and click the Add button. esight will now import any files placed in the appropriate folder on the esight server and data will be immediately available for analysis. Limited All rights reserved