Ein Shelly-Datenpunkt gehört zum Shelly-Interface. Er ist über zwei Angaben adressiert: die Geräte-Id einer Komponente und die Funktion. Üblicherweise legt der Import im Interface die Datenpunkte an. Manuell anlegen müssen Sie sie nur in Ausnahmefällen.
Hinweis:
Allgemeine Eigenschaften von Datenpunkten (Name, Einheit, Speicherung, Flags) stehen unter Datenpunkte im Überblick.
Felder der Adresse
| Feld | Bedeutung | Hinweis |
|---|---|---|
| Geräte-Id | Kennung der Komponente innerhalb des Geräts | Pflichtfeld. Aufbau <Geräte-Id>:<Komponente>:<Nummer>, z. B. <MAC>:switch:0. Die Komponente ist switch, cover, light, input, temperature, humidity oder battery. |
| Funktion | Welcher Wert der Komponente gelesen oder geschrieben wird | Pflichtfeld, Auswahl aus der Liste unten |
Pro Interface darf jede Kombination aus Geräte-Id und Funktion nur einmal vorkommen. Sonst meldet die Prüfung: «Es existiert bereits ein Channel für diese Geräte-Id/Funktion».
Funktionen
| Funktion | Einheit | Richtung | Vorkommen |
|---|---|---|---|
| On/Off | Ein/Aus | lesen und schreiben | Schalter, Licht |
| Brightness | Prozent | lesen und schreiben | Licht, sofern das Gerät eine Helligkeit meldet |
| Position | Prozent | lesen und schreiben | Rollladen. Wert wird auf 0–100 begrenzt |
| Stop | Ein/Aus | nur schreiben | Rollladen. Hält die Fahrt an |
| Power | Watt | lesen | Schalter, Licht, Rollladen mit Messung |
| Energy | Kilowattstunden | lesen | wie Power. Aus Watt-Minuten (Gen1) bzw. Wattstunden (Gen2/Gen3) umgerechnet |
| Voltage | Volt | lesen | nur Gen2/Gen3 |
| Current | Ampere | lesen | nur Gen2/Gen3 |
| Input | Ein/Aus | lesen | Eingang |
| Temperature | Grad Celsius | lesen | Temperatursensor, teils Gerätetemperatur |
| Humidity | Prozent | lesen | Feuchtesensor |
| Battery | Prozent | lesen | Batteriestand |
Welche Funktionen ein Datenpunkt tatsächlich liefert, hängt vom Gerät ab. Der Import legt nur Datenpunkte für Werte an, die das Gerät meldet.
Lesen und Schreiben
- Der Import setzt den Modus Lesen/Schreiben mit der Einheit der Funktion. Zyklisches Lesen ist abgeschaltet, Werte kommen als Meldung vom Gerät.
- Geschrieben werden kann nur auf Schalter, Licht und Rollladen. Der Befehl geht lokal per HTTP an das Gerät.
- Ein Schreibzugriff auf Brightness schaltet das Licht zusätzlich ein.
- Schreiben auf reine Sensorwerte (Leistung, Temperatur usw.) hat keine Wirkung.
Hinweise und Grenzen
- Ein Schreibzugriff auf ein Gerät, das dem Interface nicht bekannt ist, wird ignoriert und im Log vermerkt.
- Zulässige Datenpunkt-Flags sind Nicht flüchtig, Chart-Zusammenfassung und Automatische Konfiguration (Standard).