Kontakt.io
Installation and configuration of the Kontakt.io app
Eliona app for Kontakt.io - Digital building solutions
Kontakt.io manufactures intelligent IoT devices, cloud solutions, and powerful APIs that help turn buildings into indoor spaces useful to people on their daily journey toward achieving their goals, at work or in care, in a safe and sustainable indoor environment.
Installation
The app Kontakt.io can be installed via the App Store in Eliona.
Assets
Kontakt.io automatically creates all necessary asset types and assets that are accessible via the configured endpoints. The following asset types are created:
Day: Any type of BLE smart tag that indicates location.
Badge: A Smart Badge or Asset Tag 2 that indicates location like a tag, but has a temperature sensor and two buttons (not yet implemented).
Beacon: Beacons capture the locations of tags and badges and provide information about air quality.
Portal Beam: Like Beacons, but also counts the number of people in the room.
The following attributes are defined:
position
Position
x
x
temperature
Temperature
x
x
x
air_pressure
Air pressure
x
x
humidity
Humidity
x
x
light_intensity
Light intensity
x
x
air_quality
Air quality
x
x
people_count
People count
x
firmware
Firmware version
x
x
x
x
x
model
Model of the device
x
x
x
x
x
battery_level
Battery level
x
x
x
x
x
product
Product name
x
name
Name in Kontakt.io
x
Dashboards
Kontakt.io provides a dashboard with all automatically created assets. This can be created automatically via the Eliona frontend Copy Dashboard > Kontakt.io and then customized as desired.
Configuration
More information on configuring apps can be found ↗ here.
The Kontakt.io The app is configured by defining one or more API tokens. Each configuration requires the following data:
apiKey
API key
enable
Flag to enable or disable fetching from this API
refreshInterval
Interval in seconds for collecting data from API
requestTimeout
API query timeout in seconds
assetFilter
Filter for asset creation, more details can be found in app's README
projectIDs
List of Eliona project ids for which this device should collect data. For each project id, all smart devices are automatically created as an asset in Eliona. The mapping between Eliona is stored as an asset mapping in the Kontakt.io app.
The configuration is done using a corresponding JSON structure. The following JSON structure can be used as an example to define an endpoint:
Endpoints can be created in Eliona with this structure under Apps > Kontakt.io > Settings. To do this, select the /configs endpoint with the PUT method.
Floor height settings
Since the system refers from Kontakt.io to rooms instead of 3D coordinates of tags, the app must internally convert between the two systems in order to display assets on the map and in the BIM model in Eliona. For this, the app must know the height above the floor of each storey (the Z-coordinate).
To make this setting easier, the app retrieves all floors configured in the system Kontakt.io and displays them in a widget on the dashboard. Here, the user can set the heights of the floors that the app should use from that moment on.
Once the heights have been set, the widget can be removed. For later changes, the Asset Management section can be used.
Was this helpful?