Kontakt.io

Installation und Konfiguration der App Kontakt.io

Eliona App für Kontakt.io - Digitale Gebäudelösungen

Kontakt.io stellt intelligente IoT-Geräte, Cloud-Lösungen und leistungsstarke APIs her, die dabei helfen, Gebäude in Innenräume zu verwandeln, die den Menschen auf ihrem täglichen Weg zur Erreichung ihrer Ziele, bei der Arbeit oder bei der Pflege in einer sicheren und nachhaltigen Innenraumumgebung nützlich sind.

Installation

Die App Kontakt.io kann über den App Store in Eliona installiert werden.

Assets

Kontakt.io erstellt automatisch alle notwendigen Asset-Typen und Assets, die über die konfigurierten Endpunkte zugänglich sind. Die folgenden Asset-Typen werden erstellt:

• Tag: Jeder Typ eines BLE-Smarttags, der den Standort angibt.

• Badge: Ein Smart Badge oder Asset Tag 2, der den Standort wie ein Tag angibt, aber einen Temperatursensor und zwei Tasten hat (noch nicht implementiert).

• Beacon: Beacons erfassen die Standorte der Tags und Badges und liefern Informationen zur Luftqualität.

• Portal Beam: Wie Beacons, zählt aber auch die Anzahl der Personen im Raum.

Folgende Attribute sind definiert:

Attribute	Description	Tag	Badge	Beacon	Portal Beam	Filtrierbar
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	Produktname					x
name	Name in Kontakt.io					x

Dashboards

Kontakt.io bietet ein Dashboard mit allen automatisch erstellten Assets. Dieses kann automatisch über das Eliona Frontend erstellt werden Copy Dashboard > Kontakt.io und dann wie gewünscht angepasst werden.

Konfiguration

Mehr Informationen zur Konfiguration von Apps finden Sie ↗ hier.

Die Kontakt.io App wird durch die Definition eines oder mehrerer API-Tokens konfiguriert. Jede Konfiguration benötigt die folgenden Daten:

Attribute	Description
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.

Die Konfiguration erfolgt über eine entsprechende JSON-Struktur. Als Beispiel kann die folgende JSON-Struktur verwendet werden, um einen Endpunkt zu definieren:

{
  "apiKey": "VGhlIGNvbmZpZ3VyYXRpb24gaXMgZG9uZSB2",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "assetFilter": [
    [{ "parameter": "Product", "regex": ".*Tag.*" }, { "parameter": "Product", "regex": ".*Beacon.*" }],
    [{ "parameter": "Mac", "regex": "(70:82:0E:12:28:CC|70:56:06:12:.*)" }],
    [{ "parameter": "Name", "regex": ".*Lobby.*" }]
  ],
  "projectIDs": [
    "99"
  ]
}

Endpunkte können mit dieser Struktur in Eliona unter Apps > Kontakt.io > Settings. Wählen Sie dazu den Endpunkt /configs mit der Methode PUT.

Höheneinstellungen der Stockwerke

Da das System von Kontakt.io auf Räume statt auf 3D-Koordinaten von Tags verweist, muss die App intern zwischen den beiden Systemen konvertieren, um Assets auf der Karte und im BIM-Modell in Eliona anzuzeigen. Dazu muss die App die Höhe über dem Boden jedes Stockwerks (die Z-Koordinate) kennen.

Um diese Einstellung zu erleichtern, ruft die App alle im System Kontakt.io eingerichteten Stockwerke ab und zeigt sie in einem Widget auf dem Dashboard an. Hier kann der Benutzer die Höhen der Stockwerke einstellen, die von der App von diesem Moment an verwendet werden sollen.

Sobald die Höhen festgelegt sind, kann das Widget entfernt werden. Für spätere Änderungen kann der Abschnitt Asset Management verwendet werden.