# 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 Zugang zu den myStrom Smart Switches über Eliona. Sie ermöglicht es den Benutzern, den aktuellen Status der Schalter zu überprüfen, Statistiken einzusehen, 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 Eliona installiert.

### Assets

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

#### Assets strukturieren

Die Asset-Typen `myStrom Root` und `myStrom Room` werden nur angelegt, um eine Struktur in Eliona zu erstellen. ​

#### Geräte

​- *Switch*: Ein WiFi Switch. 

| Attribut     | Beschreibung  | Subtyp  |
| ------------ | ------------- | ------- |
| `Power`      | Energie       | Eingabe |
| `Temp`       | Temperatur    | Eingabe |
| `RelayState` | Relay Stattus | Eingabe |
| `Relay`      | Relay         | output  |

### Konfiguration

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

| Attribut           | Beschreibung                                                                                                                                  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`           | Von myStrom bereitgestellter API-Key                                                                                                          |
| `enable`           | Flag zum Aktivieren oder Deaktivieren des Abrufs von dieser API                                                                               |
| `refreshInterval`  | Intervall in Sekunden für die Geräteerkennung. Dies ist eine teure Operation, sollte nicht kleiner als 3600 s sein                            |
| `dataPollInterval` | Häufigkeit der Abfrage für Datenaktualisierungen in Sekunden.                                                                                 |
| `requestTimeout`   | API-Abfrage-Timeout in Sekunden                                                                                                               |
| `assetFilter`      | Filter für die Asset-Erstellung, weitere Details sind in der README der App zu finden                                                         |
| `projectIDs`       | Liste der Eliona-Projekt-IDs, für die dieses Gerät Daten sammeln soll. Für jede Projekt-ID werden automatisch alle Assets in Eliona 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:

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

Konfigurationen können mit dieser Struktur in Eliona unter `Apps > myStrom > Einstellungen` erstellt werden. Wählen Sie dazu den Endpunkt /configs mit der Methode POST.

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