# Loriot.io

### Überblick

Dieses Handbuch bietet Anweisungen zur Konfiguration, Installation und Nutzung der Loriot.io App, um Ressourcen zu verwalten und LoRaWAN Geräte zwischen Eliona und Loriot.io Diensten zu synchronisieren.

### Installation

Installieren Sie die Loriot.io App über den Eliona App Store.

### Konfiguration

Die Loriot.io App erfordert eine Konfiguration über die Eliona-Einstellungen. Im Folgenden sind die allgemeinen Schritte und Details aufgeführt, die zur effektiven Konfiguration der App erforderlich sind.

#### Registrierung der App im Loriot.io Dienst

Erstellen Sie Anmeldeinformationen im Loriot.io Dienst, um die Verbindung von Eliona zu Loriot.io Diensten herzustellen. Alle erforderlichen Anmeldeinformationen sind unten im Konfigurationsabschnitt aufgeführt.

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

#### Konfigurieren der Loriot.io App

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

| Attribut          | Beschreibung                                                |
| ----------------- | ----------------------------------------------------------- |
| `apiBaseUrl`      | URL der Loriot.io Dienste.                                  |
| `apiToken`        | API-Token zum Zugriff auf die API.                          |
| `enable`          | Flag zum Aktivieren oder Deaktivieren dieser Konfiguration. |
| `refreshInterval` | Intervall in Sekunden für die Datensynchronisierung.        |
| `requestTimeout`  | API-Abfrage Timeout in Sekunden.                            |
| `projectIDs`      | Liste der Eliona Projekt-IDs zur Datenerfassung.            |

Beispielkonfiguration in JSON:

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

Um Geräte, die von der Loriot.io App verwaltet werden, zu definieren, ist es notwendig, diese Geräte zu konfigurieren. Hier können Sie den `/devices` Endpoint 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 über OTAA v1.0 in JSON:

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

### Kontinuierliche Asset-Erstellung

Sobald die Konfiguration und die Geräteeinrichtung abgeschlossen sind, startet die App die kontinuierliche Asset-Erstellung (CAC). Entdeckte Ressourcen werden automatisch als Assets in Eliona erstellt, und Benutzer werden über das Benachrichtigungssystem von Eliona benachrichtigt.

### Zusätzliche Funktionen

#### Geräteaktualisierung

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