OpenBOS
The OpenBOS app provides integration and synchronization between Eliona and ABB Ability™ Buildings (OpenBOS).
Overview
This guide provides instructions on configuring, installing, and using the OpenBOS app to manage resources and synchronize data between Eliona and OpenBOS edge.
Installation
Install the OpenBOS app via the Eliona App Store.
Configuration
The OpenBOS app requires configuration through Eliona’s settings interface. Below are the steps needed to configure the app.
Registering the app in OpenBOS
To connect Eliona to your OpenBOS edge, the edge has to be configured to allow API connections. Contact ABB support for more information. You will need to provide them with Eliona's public API URL, which is https://{your-eliona-domain.io}/apps-public/open-bos.
Eliona needs the gateway ID, client ID and client secret for authentication.
Configure the OpenBOS app
Configurations can be created in Eliona under Settings > Apps > OpenBOS which opens the app's Generic Frontend. Here you can use the appropriate endpoint with the POST method. Each configuration requires the following data:
gwid
The ID of the gateway device used in the API requests.
clientID
The client ID used for OAuth 2.0 authentication.
clientSecret
The client secret used for OAuth 2.0 authentication.
appPublicAPIURL
URL of this app's public API. Inferred automatically from request. Example: "https://{your-eliona-instance.io}/apps-public/open-bos".
enable
Flag to enable or disable fetching from this API. Default: true.
refreshInterval
Interval in seconds for collecting data from API. Default: 60.
requestTimeout
API query timeout in seconds. Default: 120.
active
Set to true by the app when running and to false when app is stopped. Read-only.
projectIDs
List of Eliona project IDs for data collection. For each project ID, all smart devices are automatically created as assets in Eliona, with mappings stored in the KentixONE app. Example: ["42", "99"].
Example full configuration JSON:
Some fields have defaults, so the minimal configuration JSON can be simplified:
Continuous Asset Creation
Once configured, the app starts Continuous Asset Creation (CAC). Discovered resources are automatically created as assets in Eliona, and user who configured the app is notified via Eliona’s notification system.
Asset filtering
In case it's not desired to import all assets from OpenBOS to Eliona, it's possible to write an asset filter that would include only matching assets. This app is able to filter the assets by: ID, Name and Template ID (for both assets and spaces).
If you want to filter out just a few assets, you can as well let the app create all the assets in Eliona and then archive the unwanted ones. The app will not create them again.
Asset types
Asset types are automatically created and synchronized from OpenBOS asset templates.
Asset type
Asset template
Attribute - Input
Datapoint with direction "Feedback"
Attribute - Output
Datapoint with direction "Command" or "CommandAndFeedback"
Attribute - Info
Property
Limits
Min/Max
Unit
Unit
Value mapping
Enums
Complex data types from OpenBOS are split into separate attributes in Eliona.
Orphan datapoints
In case an asset is deleted from OpenBOS and there is still an alarm linked to that datapoint, OpenBOS leaves that datapoint in the ontology. Eliona respects that behaviour, and assigns those datapoints to a root asset.
Alarms
Alarms triggered in OpenBOS are synchronized to Eliona. These are created in Eliona as alarm rules of type "External", and are managed by updates received from OpenBOS -> if an alarm is triggered in OpenBOS, it will be triggered in Eliona as well. Similarly if the alarm is gone.
If the alarm needs to be acknowledged, users can acknowledge it in Eliona, and this acknowledgement will get synchronized to OpenBOS.
Last updated