# Kontakt.io

### BuildingPro Suites App für Kontakt.io - Digitale Gebäudelösungen

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

### Installation

Die *Kontakt.io* App kann über den BuildingPro Suites App Store installiert werden.

### Assets

*Kontakt.io* erstellt automatisch alle erforderlichen Asset-Typen und Assets (CAC), die über die konfigurierten Endpunkte erreichbar sind. Die folgenden Asset-Typen werden erstellt:

* *Tag*: Jeder Typ von BLE-Smart-Tag, der den Standort angibt.
* *Ausweis*: Ein Smart Badge oder Asset Tag 2, der den Standort wie ein Tag angibt, aber über einen Temperatursensor und zwei Tasten verfügt (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 zusätzlich die Anzahl der Personen im Raum.

Die folgenden Attribute sind definiert:

<table><thead><tr><th width="224">Attribut</th><th width="157">Beschreibung</th><th width="40">Tag</th><th>Ausweis</th><th>Beacon</th><th>Portal Beam</th><th>Filterbar</th></tr></thead><tbody><tr><td><code>position</code></td><td>Position</td><td>x</td><td>x</td><td></td><td></td><td></td></tr><tr><td><code>Temperatur</code></td><td>Temperatur</td><td></td><td>x</td><td>x</td><td>x</td><td></td></tr><tr><td><code>air_pressure</code></td><td>Luftdruck</td><td></td><td></td><td>x</td><td>x</td><td></td></tr><tr><td><code>Luftfeuchtigkeit</code></td><td>Luftfeuchtigkeit</td><td></td><td></td><td>x</td><td>x</td><td></td></tr><tr><td><code>light_intensity</code></td><td>Lichtintensität</td><td></td><td></td><td>x</td><td>x</td><td></td></tr><tr><td><code>air_quality</code></td><td>Luftqualität</td><td></td><td></td><td>x</td><td>x</td><td></td></tr><tr><td><code>people_count</code></td><td>Anzahl der Personen</td><td></td><td></td><td></td><td>x</td><td></td></tr><tr><td><code>firmware</code></td><td>Firmware-Version</td><td>x</td><td>x</td><td>x</td><td>x</td><td>x</td></tr><tr><td><code>model</code></td><td>Modell des Geräts</td><td>x</td><td>x</td><td>x</td><td>x</td><td>x</td></tr><tr><td><code>battery_level</code></td><td>Akkustand</td><td>x</td><td>x</td><td>x</td><td>x</td><td>x</td></tr><tr><td><code>product</code></td><td>Produktname</td><td></td><td></td><td></td><td></td><td>x</td></tr><tr><td><code>name</code></td><td>Name in Kontakt.io</td><td></td><td></td><td></td><td></td><td>x</td></tr></tbody></table>

### Dashboards

*Kontakt.io* bietet ein Dashboard mit allen automatisch erstellten Assets. Dieses kann automatisch über das BuildingPro Suites Frontend erstellt werden `Dashboard kopieren > Kontakt.io` und dann nach Wunsch angepasst werden.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FMJgv3ypiNJuzL8XPT0oL%2Fimage.png?alt=media&#x26;token=ff4a1243-37d1-4bc6-9e07-09b806a1a093" alt=""><figcaption></figcaption></figure>

### Konfiguration

{% hint style="info" %}
Weitere Informationen zur App-Konfiguration finden Sie [↗ hier](https://doc.eliona.io/collection/dokumentation/einstellungen/apps).
{% endhint %}

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

| Attribut          | Beschreibung                                                                                                                                                                                                                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `apiKey`          | API-Schlüssel                                                                                                                                                                                                                                                                                    |
| `enable`          | Schalter zum Aktivieren oder Deaktivieren des Abrufs über diese API                                                                                                                                                                                                                              |
| `refreshInterval` | Intervall in Sekunden für das Sammeln von Daten aus der API                                                                                                                                                                                                                                      |
| `requestTimeout`  | Zeitüberschreitung für API-Abfragen in Sekunden                                                                                                                                                                                                                                                  |
| `assetFilter`     | Filter für die Asset-Erstellung, weitere Details finden Sie in der README der App                                                                                                                                                                                                                |
| `tenantIDs`       | Liste der BuildingPro Suites Mandanten-IDs, für die dieses Gerät Daten sammeln soll. Für jede Mandanten-ID werden alle Smart Devices automatisch als Asset in BuildingPro Suites erstellt. Die Zuordnung zwischen BuildingPro Suites wird in der Kontakt.io-App als Asset-Zuordnung gespeichert. |

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

```json
{
"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." }]
],
"tenantIDs": [
"99"
]
}
```

Endpunkte können mit dieser Struktur in BuildingPro Suites unter folgendem Pfad erstellt werden `Apps > Kontakt.io > Einstellungen`. Wählen Sie dazu den Endpunkt /configs mit der Methode PUT aus.

### Höheneinstellungen für Stockwerke

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

Um diese Einstellung zu erleichtern, ruft die App alle im *Kontakt.io* System eingerichteten Stockwerke ab und zeigt sie in einem Widget auf dem Dashboard an. Dort kann der Benutzer die Höhen der Stockwerke festlegen, die die App von diesem Moment an verwenden soll.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FO5SXmSt5MKyfHcz2Oe0V%2Fimage.png?alt=media&#x26;token=2664db21-e45d-4e67-ba68-04c4ee5b5109" alt=""><figcaption></figcaption></figure>

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