Komponenten > Herstellerspezifische Treiber

Der unsichtbare Gardena-Treiber ermöglicht den Zugriff auf die smart Geräte von Gardena. Hierdurch können die importierten Geräte überwacht und gesteuert werden.

Datenpunkte der Komponente

Name	Typ	Funktion
Abfrage einmalig	Eingang	Über eine Flanke an diesem Eingang wird eine einmalige Abfrage der Geräte gestartet.
Abfrage zyklisch - Pause [h]	Bidirektional	Eine Abfrage der eingebundenen Geräte findet alle x Stunden statt. Es kann eine Zeit von 1 bis 24 Stunden eingestellt werden. Achtung: Die Abfrage ist auf 3000 Anfragen pro Monat und einmal pro 15 Minuten limitiert!
Diagnose [Text]	Ausgang	Verbunden mit dem Eingang [Signal] des Protokollfensters werden dort die Diagnoseinformationen angezeigt.
Dynamisch	Ordner	Beinhaltet die importierten Geräte und deren Datenpunkte.
- Geräteklasse	Ordner	Die Importierten Geräte sind nach Geräteklassen (Gateway, Sensor,...)sortiert.
- - Geräte	Ordner	Unterordner für jedes Gerät (benannt nach dem Gerätenamen – hier ist zu beachten, dass diese innerhalb des Gardena-Smart-Systems eindeutig benannt sein müssen, um hier korrekt angezeigt werden zu können).
- - - Funktionsgruppe	Ordner	Diese Unterordner sind nach Funktionen gruppiert. So haben batteriebetriebene Geräte stets eine Funktionsgruppe/Unterordner für Batteriedaten ect.
Erweiterte Diagnose	Eingang	(De)Aktiviert die erweiterte Debug-Ausgabe. Achtung: Diagnose oder Debug - Ausgängen sind nur für den Fehlerfall vorgesehen. Bitte nur mit Rücksprache mit dem Supportteam verwenden! Diese können bei Verwendung die Leistung des Dienstes erheblich beeinträchtigen
Treiber An/Aus	Bidirektional	Treiber Ein- oder Ausschalten.
Zyklische Aktualisierung	Bidirektional	Aktiviert/Deaktiviert die zyklische Aktualisierung

Eigenschaften der Komponente

Name	Standard	Funktion
Kanäle	0	Nachdem die Zugangsdaten eingegeben wurden, können hier die Geräte und das Gateway importiert werden.
Zugangsdaten		Hier werden die Gardena-Zugangsdaten eingegeben.
Zyklische Aktualisierung	x	Aktiviert/Deaktiviert die zyklische Aktualisierung im eingestellten Intervall
Abfrage zyklisch - Pause [h]	5	Eine Abfrage der eingebundenen Geräte findet in diesem Fall alle 5 Stunden statt. Es kann eine Zeit von 1 bis 24 Stunden eingestellt werden. Achtung: Die Abfrage ist auf 3000 Anfragen pro Monat limitiert!
Websockets erneuern		Soll bei einer Abfrage der Websocket aktualisiert werden, ist diese Option zu setzen. Das ist nur dann notwendig, wenn in der Debug Ausgabe Websocket-Verbindungen fehlschlagen.
Treiber An/Aus		Treiber Ein- oder Ausschalten.

Die meisten Datenpunkte sind Informationen (z.B. Batterieladezustand). Zu jeden dieser Datenpunkte gibt es einen weiteren, der den Zeitstempel angibt, an dem der Wert ermittelt wurde (z.B. messen die Sensoren nur alle x Minuten). Manche Geräte bieten aber die Möglichkeit, Befehle oder Parameter an das Gerät zu senden. Die entsprechenden Datenpunkte befinden sich im Unterordner „Befehl“. Ausnahme hierbei sind die Befehle, um in den Geräten eine Sensormessung zu initiieren. Diese SPs finden sich im „Befehl“ Unterordner der jeweiligen Sensor-Ordner (zum Beispiel "Bodenfeuchtigkeit messen").

Beispiele für Befehle:

Zur manuellen Kontrolle eines Bewässerungscomputers kann das gespeicherte (innerhalb des Gardena-Smart Systems konfigurierte) Scheduling überschrieben (override) werden. Hierzu kann an der Datenpunkt „Start Override (Dauer)“ ein Wert in Minuten gesendet werden.

Zum Beenden des manuellen Modus kann der Datenpunkt „Ende Override“ mit irgendeinem Wert getriggert werden.

Fehlerbehebung:

{"message":"forbidden"} = API wurde im Portal nicht hinzugefügt (connected)

{"error":"invalid_grant" ... } = Benutzername und/oder Passwort falsch

{"error":"invalid_client" ... } = APP Key falsch

{"message":"Limit Exceeded"} = Maximale Abfrage von 3000 wurde erreicht. Dies wird zum Monatswechsel wieder zurückgesetzt.

Gardena Smart System

Gardena Smart System