# myStrom-App

> Der Smart WiFi Switch schaltet angeschlossene Geräte ein und aus, spart Energie und schützt Ihr Zuhause. Entwickelt in der Schweiz.

Diese Anwendung bietet direkten Zugriff auf die myStrom Smart Switches über BuildingPro Suites. Sie ermöglicht es Benutzern, den aktuellen Status der Schalter zu prüfen, Statistiken anzuzeigen, die Smart Switches zu verwalten und vor allem myStrom-Geräte mit Systemen verschiedener anderer Marken zu verbinden.

#### Installation

Die myStrom App wird über den App Store in BuildingPro Suites installiert.

#### Assets

Die myStrom App erstellt automatisch alle erforderlichen Asset-Typen und Assets.

#### Struktur-Assets

Die Asset-Typen `myStrom Root` und `myStrom Room` werden nur erstellt, um eine Struktur in BuildingPro Suites zu erzeugen.

#### Geräte

* *Schalter*: Ein WiFi-Schalter.

| Attribut     | Beschreibung | Untertyp |
| ------------ | ------------ | -------- |
| `Leistung`   | Energie      | Eingang  |
| `Temp`       | Temperatur   | Eingang  |
| `RelayState` | Relaisstatus | Eingang  |
| `Relais`     | Relais       | Ausgang  |

#### Konfiguration

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

| Attribut           | Beschreibung                                                                                                                                                               |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`           | Von myStrom bereitgestellter API-Schlüssel                                                                                                                                 |
| `enable`           | Kennzeichen zum Aktivieren oder Deaktivieren des Abrufs über diese API                                                                                                     |
| `refreshInterval`  | Intervall in Sekunden für die Geräteerkennung. Dies ist ein aufwendiger Vorgang und sollte nicht weniger als 3600 s betragen                                               |
| `dataPollInterval` | Abfragefrequenz für Datenaktualisierungen in Sekunden.                                                                                                                     |
| `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 erfassen soll. Für jede Mandanten-ID werden alle Assets automatisch in BuildingPro Suites erstellt. |

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

```json
{
    "apiKey": "api.key",
    "enable": true,
    "refreshInterval": 3600,
    "dataPollInterval": 60,
    "requestTimeout": 120,
    "assetFilter": [],
    "tenantIDs": [
        "10"
    ]
}
```

Konfigurationen können mit dieser Struktur in BuildingPro Suites unter `Apps > myStrom > Einstellungen`. Dazu wählen Sie den Endpunkt /configs mit der POST-Methode aus.

Nach Abschluss der Konfiguration startet die App die fortlaufende Asset-Erstellung. Wenn alle erkannten Geräte erstellt wurden, wird der Benutzer darüber über das Benachrichtigungssystem von BuildingPro Suites informiert.