Pepperl+Fuchs ICE11-8IOL-G60L-V1D Handbuch Seite 198

ICE11-8IOL-G60L-V1D
IIoT-Funktionalität
CoAP-Konfiguration
Im Auslieferungszustand sind die CoAP-Funktionen deaktiviert. Der CoAP-Server kann konfi-
guriert werden, indem entweder das Web-Interface verwendet wird oder direkt über ein JSON-
Objekt, welches in einer "HTTP request"-Anfrage gesendet wurde.
Die Konfigurations-URL lautet: http://[ip-address]/w/config/coapd.json
Die Konfiguration kann ebenfalls als JSON-File rückgelesen werden: http://[ip-
address]/r/config/coapd.json
Die Konfiguration erfolgt in Form eines JSON-Objektes, wobei jedes JSONMember ein Konfi-
gurationselement darstellt. Das Objekt muss nicht alle Elemente beinhalten. Nur die zur Verfü-
gung gestellten Elemente werden geändert. Alle Konfigurationsänderungen greifen erst nach
einem Geräte- Neustart.
Die folgenden Konfigurationselemente sind verfügbar:
CoAP-Konfiguration
Element
enable
port
Tabelle 10.39
1. fett = Standard
CoAP-Response:
Die resultierende Antwort ist ein JSON-Objekt mit einem "status"-Feld. Der Status sollte "0"
sein, wenn kein Fehler auftritt und "-1", wenn ein Fehler auftritt.
Im Fehlerfall beinhaltet die Antwort einen Fehler-Array.
Der Fehler-Array beinhaltet ein Fehler-Objekt für jeden aufgetretenen Fehler. Das Objekt
besteht aus einem Feld "Element", welches das Konfigurationselement benennt, das den Feh-
ler verursacht hat, und aus einem Feld "Message" für die Fehlermeldung.
Beispiel
{"status": -1, "error": [{"Element": "upcua-enable", "Message":
"Boolean expected"}]}
{"status": 0}
{"status": -1, "error": [{"Element": "root", "Message": "Not a JSON
object"}]}
REST-API-Zugriff via CoAP
Die Verbindung zum CoAP-Server kann über folgende URL hergestellt werden: coap://[ip-
address]:[port]/[api]
Sie können via CoAP-Endpoint auf die folgenden REST-API-Anfragen im JSON-Format zugrei-
fen:
REST-API-Zugriff via CoAP
Typ
GET
GET
GET
GET
198
Datentyp Beschreibung
boolean Master-Switch für den
CoAP-Server
integer Port des CoAP-Servers
(0 bis
65535)
API
/r/status.lr
/r/system.lr
/info.json"
/r/config/net.json
Beispiel
1
true / false
5683
Hinweis