Abfrage Von Port-Informationen; Abfragen Eines Io-Link-Geräteparameters (Applicationspecifictag); Setzen Eines Io-Link-Geräteparameters (Applicationspecifictag); Setzen Eines Masterparameters (Sysname) - Balluff BNI EIP-508-105-Z067 Konfigurationsanleitung

BNI EIP-508-105-Z067
Netzwerkschnittstelle
6
WebUI / Webinterface (Fortsetzung)
6.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 6-41: Abfrage der Port-Identifikation
6.8.4 Abfragen eines IO-Link-Geräteparameters
(applicationSpecificTag)
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_00).
Bei erfolgreicher Ausführung wird ein JSON-Objekt mit
Eigenschaften wie vendorID, productName und applica-
tonSpecificTag als Antwort geliefert.
42 deutsch
6.8.5 Setzen eines IO-Link-Geräteparameters
(applicationSpecificTag)
Die Verwendung einer POST-Anfrage setzt einen
Login (siehe Kapitel 6.8.1 auf Seite 41) 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_00). 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).
6.8.6

Setzen eines Masterparameters (sysName)

Die Verwendung einer POST-Anfrage setzt einen
Login (siehe Kapitel 6.8.1 auf Seite 41) 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.