BACnet to MyEyedro User Guide

1.Introduction #

As part of the MyEyedro building automation system interface, the BACnet to MyEyedro User Guide provides details on how to configure the transfer of BACnet measurement data to MyEyedro (my.eyedro.com).

This is typically used to view gas, water, and electricity meter data within MyEyedro that already exists in a company’s building automation system (BAS).

The main steps include how to:

2.Access Keys #

In order to add an Eyedro BAS Device to your MyEyedro user account, you will need an Access Key which can purchased through your local Eyedro Reseller.

Once purchased, the Access Key(s) will be added to your MyEyedro account so you may assign to your new Eyedro BAS Device(s).

Screenshot of Eyedro BAS Device Access Key

This Access Key will be required when adding a BAS device in the CAS Software configuration.

3.CAS Software #

The Chipkin Automation Systems (CAS) Gateway Software is a protocol converter that sends data from a BAS device (eg. BACnet gas meter) to MyEyedro.

The gateway operates by reading data from a downstream device, then storing the received values into an internal database. If the values change, or on a specific timeout, the data is transmitted to MyEyedro.

The gateway must be preconfigured to read from specific BAS devices.

3.1.Installation #

After you have your Access Keys, you will be provided with a link to download the CAS software.

Screenshot of Chipkin Installer

Double click the file to run the installer, and follow the instructions on the Setup Wizard.

Run the CAS Gateway after successful installation to view the Gateway’s configuration settings.

3.2.Settings #

To view the gateway’s configuration settings, type the following URL into a Web browser’s address bar: http://192.168.1.113/bin/iothttp/config/ where “92.168.1.113” represents the IP address of your gateway.

Tasks Table

The tasks table is used to define the specific data that is being monitored by the IoT HTTP driver.

  • Name – Internal reference name for this task. This name is not sent to the HTTP driver and can be anything you want. Default: {Blank}
  • Scan interval – This parameter is used to define how often in seconds to send a snapshot of the current value in the database to the HTTP server. The data in the snapshot may not have changed in this time. If this value is set to zero (0) “Change of value” will be used instead of a snapshot. When in “Change of Value” is set only the values that change will be sent to the HTTP server. Default: 0 (Change of Value)
  • Data offset – The starting location of the data in the internal database. Default: 1
  • Data length – The length of data from “Data offset” that is used when sending the payload to the HTTP server. Default: 1

Screenshot of Chipkin Tasks Table

3.3.Discovering your Devices #

Follow the next steps to discover the BACnet IP devices, objects, and properties on your network that you want to send to the Eyedro system using the HTTP IoT driver.

  1. Close the CAS Gateway if it is running. You cannot have multiple BACnet clients using the same port (47808) running on the same computer at the same time.
  2. Download and install the CAS BACnet Explorer: http://www.chipkin.com/products/software/bacnet-software/cas-bacnet-explorer/
  3. Run the CAS BACnet Explorer, discover the BACnet devices, objects and properties that you are interested in. For more information on how to use the CAS BACnet Explorer, please see the CAS BACnet Explorer’s Manual.
  4. Click the “Report” button in the CAS BACnet Explorer to create an offline report of the BACnet devices, objects and properties that the CAS BACnet Explorer has discovered.

You should now have a list of BACnet devices, objects, and properties that you can use to configure the CAS Gateway BACnet IP tasks.

Screenshot of Chipkin Discovery

 

3.4.Adding your Devices #

Follow the next steps to add or insert your devices to the gateway and start collecting data.

  1. Insert the BACnet device. This will fill out columns in the Report section.

Screenshot of configuration to Insert Modbus Or BACnet Device

  1. Go to the Reports section and find the data points you want MyEyedro to save.

Screenshot of Edit Reports

  1. Enter the Access Key that was purchased from Eyedro Sales into the Name field. Each data point requires its own Access Key.

Screenshot of Edit Name Field with Access Key

3.5.Adding BACnet IP tasks #

To read values from BACnet devices, you have to create new BACnet tasks in the CAS gateway. The values will be stored in an internal database and then pushed to MyEyedro via the HTTP IoT driver.

  1. Close the CAS BACnet Explorer if it is running. You cannot have multiple BACnet clients using the same port (47808) running on the same computer at the same time.
  2. Go to the “BACnet IP Client configuration” page: http://<IPAddress:8080>/bin/bacnetipclient/config/ *
  3. Click “insert” under the BACnetIP_Tasks table.
  4. Using information from the report from the CAS BACnet Explorer add a new BACnet IP task into the CAS Gateway to read a BACnet object property.
  5. After adding your first BACnet IP task. Restart the CAS Gateway. This will enable the BACnet IP driver.

Screenshot of Adding BACnet IP tasks

  1. Go to the “Reports” page in the CAS Gateway http://<IPAddress>:8080/bin/reports/* to ensure that the BACnet IP task has been set up correctly and is receiving data.

Screenshot of Chipkin Reports

Note: Replace <IPAddress> with your IP address or “localhost”.

3.6.Adding Eyedro HTTP Task #

To send data from the internal database to MyEyedro using the IoT HTTP driver, you will have to create a new IoT HTTP task for the CAS Gateway.

  1. Goto the “Eyedro IoT HTTP Config” page: http://<IPAddress>:8080/bin/iothttp/config *
  2. Fill in the form with information provided by Eyedro. See the Settings section for more information about each field in the Tasks table.
  3. Validate that the IoT HTTP Driver is sending data to MyEyedo servers.
  4. Go to the “stats” page: http://<IPAddress>:8080/bin/system/info *
    1. ensure that the “IoTHTTP.task.###.read” tasks are increasing
    2. ensure that “IoTHTTP.task.1.read.status” has a value of “OK”

Screenshot of Chipkin Stats Page

* Note: Replace <IPAddress> with you IP address or “localhost”

4.MyEyedro #

Once your Eyedro BAS Devices are linked to your MyEyedro account, and CAS Software configuration is complete, you will be able to see your live water meter or gas meter data on your Utility Dashboard, alongside your Eyedro electricity monitor!

Screenshot of MyEyedro Utility Dashboard

For more information on how to use and configure MyEyedro, make sure to visit our online MyEyedro User Guide and the Support page.

4.1.Adding Devices #

To add your Eyedro BAS device to MyEyedro, open up “Device Settings” through the Settings Menu.

Screenshot of MyEyedro Client - Opening Device Settings

  1. Go to the “Devices” tab, and click on “Add Device“. Select “Eyedro BAS” from the list of options.NOTE: You will need to have Access Keys added to your account in order to claim an Eyedro BAS device.

Screenshot of MyEyedro Devices Settings

  1. Under “Meter Type“, specify whether you have a Modbus Water or Gas meter, or a BACnet Water or Gas meter.

Screenshot of MyEyedro BAS Device Meter Type

  1. Under “Access Key“, select the Access Key you were provided. Each device needs to have its own Access Key.

Screenshot of Eyedro BAS Device Access Key

  1. Optional: update the “Device Label” which will be used as the device’s display name in the Devices List.
  2. Click on “Claim Device“.

NOTE: A default “Display Group” will be added for each new Device claimed under your account.

4.2.Utility Dashboard #

The MyEyedro Utility Dashboard provides a high-level overview of your electricity, water, and natural gas usage.

Screenshot of MyEyedro Utility Dashboard

You can specify which “Display Groups” are associated with which utility by selecting the appropriate Display Group from the list in the footer menu bar.

MyEyedro Utility Dashboard Config

Selecting the “Options” button will allow you to make changes to the Dashboard view.

Suggest Edit