afBelimoCloudFinExt

The Belimo Cloud Extension for FIN 5 is a connector for the Belimo Cloud API.

The Belimo Cloud is a great place to store and monitor all your Belimo Energy Value data. The Belimo Cloud extension shows how easy it is to connect to the Belimo Cloud API to retrieve and and analyse your device data.

Like all good FINFramework connectors, the Belimo Cloud extension provides:

• Learn functionality - browse and bind Belimo devices and datapoints from within the FINFramework Connector and Builder applications
• Current values - poll the Belimo Cloud API for datapoint current values
• History sync - download datapoint history data in bulk
• Point write - write new datapoint values to the Belimo Cloud

This connector has been developed for FIN 5 and Belimo Cloud API 3.8.

• Quick Start
• Belimo Cloud Connector Walkthrough
• Belimo Cloud API Credentials
• Acknowledgement
• Licensing
• Disclaimer

Quick Start

1. Install afBelimoCloudFinExt (use the StackHub app)
2. Create an instance of the "AfBelimoCloud" connector
3. Set your Belimo Cloud username and password
4. Set your Belimo Cloud Client (ID and Secret) Credentials with the Axon function:
   • afBelimoCloudSetClientCredentials(connectorId, "<clientId>", "<clientSecret>")
5. Bind your Belimo data points

Belimo Cloud Connector Walkthrough

Below are links to the various sections in the video (they take you to the Vimeo website).

1. 0:58 - Installation
   • 1:07 - Create New Project
   • 1:21 - Enable StackHub App
   • 1:59 - Install Belimo Cloud FIN Ext
   • 2:32 - Restart FIN
   • 2:49 - Enable Belimo Cloud FIN Ext
   • 3:14 - Configure Belimo Cloud FIN Ext
2. 5:04 - Setup
   • 5:09 - Configure Project
   • 5:52 - Bind Data Points
   • 7:17 - Sync History Data
   • 8:08 - Write Point Values
3. 9:09 - Support
   • 9:13 - Debugging
   • 10:11 - StackHub

Belimo Cloud API Credentials

The Belimo Cloud Extension has been developed according to the Belimo Cloud Developer Space directions. To use the Belimo Cloud extension, you must acquire TWO sets of credentials:

1. A Client ID and a Client Secret.

   This defines the realm of Belimo devices accessible to you. Facilities managers will receive their own unique credentials.

   Developer Client Secrets rotate on 60 day basis. Belimo provides also a static set of credentials on request.

   Client credentials are set via an (Admin level) Axon function. Run the function from the FIN Folio application:

   read(afBelimoCloudConn).afBelimoCloudSetClientCredentials("<clientId>", "<clientSecret>")

2. A Username and Password.

   This identifies you as an individual.

   Username and password are set on the Belimo Cloud connector in the usual way in the connector app.

Both sets of credentials are required by the Belimo Cloud extension, you can obtain them following the instructions at https://www.belimo.com/iot/developers.

Note, if you change any credentials - all affected Belimo Connectors need to be disabled and then re-enabled for the changes to take effect.

Acknowledgement

Fantom Factory acknowledges the gracious support of Belimo in the creation of this FINFramework connector.

Licensing

The Belimo Cloud extension for FINFramework is not open source, but it is free to download and use.

Users of the Belimo Cloud API (through this extension) accept the Terms of Use of the Belimo Cloud Services

Users of the Belimo Cloud extension accept the Fantom Factory Terms of Service.

Neither Fantom Factory Ltd nor Belimo guarantees the compatibility of this software with future versions of FIN or the Belimo Cloud API.

The developer, and owner of this software is Fantom Factory, who is free to discontinue the support or upgrade of the connector at any time. Any support or upgrades offered by Fantom Factory will be on a best endeavours basis.

Disclaimer

The software is provided "AS IS" and the author disclaims all warranties with regard to this software including all implied warranties of merchantability and fitness. In no event shall the author be liable for any special, direct, indirect, or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.