BNI PNT-508-105-Z067 / BNI PNT-508-105-Z077 / BNI PNT-502-102-Z078
Netzwerkschnittstelle
4
WebUI / Webinterface (Fortsetzung)
4.8.3
Abfrage von Port-Informationen
Alle relevanten Konfigurations- und Statusdaten für alle
IO-Ports eines Moduls können abgefragt werden über:
http://[ip-address]/api/balluff/v1/ports/information
Bild 4-41: Abfrage der Port-Identifikation
4.8.4
Abfragen eines IO-Link-Geräteparameters
(applicationSpedificTag)
Gerätespezifische Parameter können über folgende Adres-
sen abgefragt werden:
–
http://[ip-address]/api/balluff/v1/devices/identification
–
http://[ip-address]/iolink/v1/devices/[deviceAlias]/
identification
Die Abfrage über die generische REST API ist dabei die
Bulk-Version der identischen Abfrage über JSON for
IO-Link.
Bei einer Abfrage über JSON for IO-Link wird ein
deviceAlias mitgegeben. Dieser entspricht der Gerätebe-
zeichnung, die zuvor konfiguriert werden muss. Der Stan-
dard der Gerätebezeichnung ist Port_Xyz, wobei yz der
Portnummer entsprechen (z. B. Port_X00).
Bei erfolgreicher Ausführung wird ein JSON-Objekt mit
Eigenschaften wie vendorID, productName und applica-
tonSpecificTag als Antwort geliefert.
www.balluff.com
4.8.5
Setzen eines IO-Link-Geräteparameters
(applicationSpecificTag)
Die Verwendung einer POST-Anfrage setzt einen
Login (siehe Kapitel 4.8.1 auf Seite 42) voraus.
Das Setzen gerätespezifischer Parameter für angeschlos-
sene IO-Link-Geräte ist über folgende Adresse möglich:
http://[ip-address]/iolink/v1/devices/{deviceAlias}/parame-
ters/{index}/value
Der deviceAlias entspricht der Gerätebezeichnung des
IO-Link Geräts (z. B. Port_X00). Der Index reflektiert die zu
setzende ISDU-Parametervariable im IO-Link-Gerät, im Fall
des applicationSpecificTag wäre das der Wert 24.
Zum Setzen von Werten muss außerdem ein JSON-Objekt
mitgegeben werden, in dem entsprechende Parameter
und Werte wie im folgenden Beispiel angegeben sind:
{ "value": [
49,
50,
51,
52,
53,
54
]}
Im oben beschriebenen Fall würde Parameter 24
(applicationSpecificTag) mit dem ASCII-String 123456
beschrieben.
Eine erfolgreiche Ausführung wird nicht in Form eines
JSON-Objekts bestätigt, sondern mit einem Code 204
(Successful operation).
4.8.6
Setzen eines Masterparameters (sysName)
Die Verwendung einer POST-Anfrage setzt einen
Login (siehe Kapitel 4.8.1 auf Seite 42) voraus.
Das Setzen eines Masterparameters wie SysName ist über
folgende Adresse möglich:
http://[ip-address]/api/balluff/v1/
Dabei muss ein JSON-Objekt mit den entsprechenden
Informationen mitgegeben werden:
{
"sysName": "[SysName]"
}
Eine erfolgreiche Ausführung wird nicht in Form eines
JSON-Objekts bestätigt, sondern mit einem Code 204
(Successful operation).
Sollten Sie mit den nachfolgend aufgeführten
Beispielen und den Informationen aus den Spezifi-
kationen der REST APIs Ihren Anwendungsfall
nicht realisieren können, wenden Sie sich gerne
mit einer Beschreibung Ihres Anwendungsfalls an
uns.
Die entsprechenden Kontaktdaten finden Sie unter
www.balluff.com.
deutsch
43