Balluff BNI EIP-508-105-Z067, Configuration Manual

Page: 44 / 88

42 deutsch
954775_AB ∙ DE ∙ E22; Änderungen vorbehalten. Ersetzt C22.
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.
6
WebUI / Webinterface (Fortsetzung)
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 .
BNI EIP-508-105-Z067
Netzwerkschnittstelle