# Loriot.io

### Übersicht

Dieses Handbuch enthält Anweisungen zum Konfigurieren, Installieren und Verwenden der Loriot.io App zur Verwaltung von Ressourcen und zur Synchronisierung von LoRaWAN-Geräten zwischen BuildingPro Suites und Loriot.io-Diensten.

### Installation

Installieren Sie die Loriot.io App über den BuildingPro Suites App Store.

### Konfiguration

Die Loriot.io App erfordert eine Konfiguration über die Einstellungen von BuildingPro Suites. Im Folgenden werden die allgemeinen Schritte und erforderlichen Details beschrieben, um die App effektiv zu konfigurieren.

#### Registrierung der App beim Loriot.io-Dienst

Erstellen Sie Anmeldedaten im Loriot.io-Dienst, um die Verbindung von BuildingPro Suites zu den Loriot.io-Diensten herzustellen. Alle erforderlichen Anmeldedaten sind im Konfigurationsabschnitt unten aufgeführt.

Um eine Verbindung zur [Loriot.io API](https://docs.loriot.io/space/LNS/6231610/User+API+7.0)herzustellen, müssen Sie Ihren Anbieter nach einem API-Schlüssel fragen.

#### Konfigurieren der Loriot.io App

Konfigurationen können in BuildingPro Suites unter `Apps > Loriot.io > Einstellungen`, wodurch die App- [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps). Hier können Sie den `/configs` -Endpunkt mit der POST-Methode verwenden. Jede Konfiguration erfordert die folgenden Daten:

| Attribut          | Beschreibung                                                       |
| ----------------- | ------------------------------------------------------------------ |
| `apiBaseUrl`      | URL der Loriot.io-Dienste.                                         |
| `apiToken`        | API-Token für den Zugriff auf die API.                             |
| `enable`          | Schalter zum Aktivieren oder Deaktivieren dieser Konfiguration.    |
| `refreshInterval` | Intervall in Sekunden für die Datensynchronisierung.               |
| `requestTimeout`  | API-Abfrage-Timeout in Sekunden.                                   |
| `tenantIDs`       | Liste der BuildingPro Suites Mandanten-IDs für die Datenerfassung. |

Beispielkonfiguration in JSON:

```json
{
  "apiBaseUrl": "http://service/v1",
  "apiToken": "53cr3t",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "tenantIDs": [
    "10"
  ]
}
```

Um von der Loriot.io App verwaltete Geräte zu definieren, ist es notwendig, diese Geräte zu konfigurieren. Hier können Sie den `/devices` Endpunkt mit der POST-Methode verwenden. Wenn das Gerät noch nicht existiert, wird es auch in Loriot.io registriert.

Beispiel für die Gerätekonfiguration per OTAA v1.0 in JSON:

```json
{
    "devEUI": "0123456789ABCDEF",
    "appID": "1234ABCD",
    "assetTypeName": "Gerät",
    "configID": 1,
    "title": "LoRaWAN Testgerät",
    "description": "Dies ist ein LoRaWAN Testgerät",
    "appEUI": "1000000000000000",
    "appKey": "geheim"
}
```

### Kontinuierliche Asset-Erstellung

Sobald die Konfiguration und Einrichtung der Geräte abgeschlossen sind, startet die App die Continuous Asset Creation (CAC). Erkannte Ressourcen werden automatisch als Assets in BuildingPro Suites erstellt, und die Benutzer werden über das Benachrichtigungssystem von BuildingPro Suites benachrichtigt.

### Zusätzliche Funktionen

#### Geräteaktualisierungen

Sie können den Titel und die Beschreibung eines Geräte-Assets in BuildingPro Suites ändern. Diese Änderungen werden automatisch in Loriot.io synchronisiert. Wenn Sie ein Asset in BuildingPro Suites löschen, wird das entsprechende Gerät auch in Loriot.io deregistriert.