Übersicht: IoT-Typen

16547

Der ifm-IoT-Core nutzt folgende Elementtypen:

Name Beschreibung

structure Element ist ein Strukturelement (wie ein Ordner im Dateisystem)

service Element ist ein Dienst, der aus dem Netzwerk heraus angesprochen werden kann

event Element ist ein Ereignis, das durch die Firmware ausgelöst werden kann und Benachrichtigungen verschickt data Element ist ein Datenpunkt

device Wurzelelement, das ein Gerät repräsentiert

74

>

13.2.3 Übersicht: IoT-Dienste

Inhalt

Dienst: factoryreset ...74

Dienst: gettree ...75

Dienst: getdata ...75

Dienst: getdatamulti ...76

Dienst: getidentity ...77

Dienst: getsubscriptioninfo ...78

Dienst: iolreadacyclic ...79

Dienst: iolwriteacyclic ...79

Dienst: reboot ...79

Dienst: setblock ...80

Dienst: setdata ...80

Dienst: setelementinfo ...81

Dienst: signal ...81

Dienst: subscribe ...82

Dienst: unsubscribe ...82

17708

>

Dienst: factoryreset

12188

Name: factoryreset

Beschreibung: Der Dienst setzt die Parameter des Geräts auf die Werkseinstellungen.

Anfragedaten (Feld "data"): keine Rückgabedaten (Feld "data"): keine

Beispiel:

{"code": "request", "cid": 4711, "adr": "/firmware/factoryreset"}

>

Dienst: gettree

17435

Name: gettree

Beschreibung: Der Dienst liest die komplette Gerätebeschreibung des AL1350 und gibt sie als JSON-Objekt aus.

Anfragedaten (Feld "data"): keine Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

identifier obligatorisch STRING Bezeichner des Wurzelelements

type obligatorisch STRING Typ des Elements

format optional JSON-Objekt Format des Dateninhalts

uid optional STRING

profiles optional JSON-Array

subs obligatorisch JSON-Array Unterelemente

hash optional STRING

Dienst: getdata

12223

Name: getdata

Beschreibung: Dienst liest den Wert eines Datenpunkts und gibt diesen aus.

Anfragedaten (Feld "data"): keine Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

value obligatorisch STRING Wert des Elements/Datenpunkts

76

>

Dienst: getdatamulti

17964

Name: getdatamulti

Beschreibung: Der Dienst liest sequentiell die Werte mehrerer Datenpunkte und gibt diese aus. Für jeden Datenpunkt werden der Wert und ein Diagnosecode ausgegeben.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung datatosend obligatorisch ARRAY

OF STRINGS

Liste von Datenpunkten, die abgefragt werden sollen; Datenpunkte müssen den Dienst getdata unterstützen

("datatosend":["url1","url2",...,"urlx"])

consistent optional BOOL

Rückgabedaten (Feld "data"): für jeden abgefragten Datenpunkt Datenfeld Pflichtfeld Datentyp Beschreibung

url obligatorisch STRING Datenpunkt, der abgefragt wurde

code obligatorisch INT Diagnosecode der Abfrage

data obligatorisch STRING Wert des Datenpunkts

>

Dienst: getidentity

52381

Name: getidentity

Beschreibung: Der Dienst liest die Geräteinformationen des AL1350 und gibt sie aus.

Anfragedaten (Feld "data"): keine Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

iot device Gerätebeschreibung als JSON-Objekt

iot.name obligatorisch STRING

iot.uid optional STRING

iot.version obligatorisch STRING

iot.catalogue optional ARRAY OF

OBJECTS

iot.deviceclass optional ARRAY OF

STRING

iot.serverlist optional ARRAY OF

OBJECTS

device optional AL1350

device.serialnumber optional Seriennummer

device.hwrevision optional Hardwarestand

device.swrevision optional Softwarestand

device.custom optional

security optional Sicherheitsoptionen

security.securitymode optional ENUM zeigt, ob Sicherheitsmodus aktiviert ist security.authscheme optional ENUM zeigt aktives Authentifizierungsschema security.ispasswordset optional BOOL zeigt, ob ein Passwort gesetzt wurde

security.activeconnection optional ENUM zeigt aktuell genutzte Kommunikationsschnittstelle

 tcp_if unverschlüsselte http-Verbindung an IoT-Schnittstelle, Port 80

 tls_if verschlüsselte https-Verbindung an IoT-Schnittstelle, Port 443

 fb_if unverschlüsselte http-Verbindung an Feldbus-Schnittstelle, Port 80

78

>

Dienst: getsubscriptioninfo

17436

Name: getsubscriptioninfo

Beschreibung: Der Dienst liefert Informationen über ein existierendes Abonnement (subscribe).

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

callback obligatorisch STRING Adresse, an die IoT-Core Ereignisbenachichtigungen senden soll;

komplette URL: http://ipaddress:port/path

Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

callback obligatorisch STRING Adresse, an die IoT-Core Ereignisbenachichtigungen senden soll;

komplette URL: http://ipaddress:port/path datatosend obligatorisch ARRAY

OF STRINGS

Liste mit abonnierten Datenpunkten

Beispiel:

 Anfrageobjekt:

{

"code":"request",

"cid": 4715,

"adr":"/timer[1]/counter/datachanged/getsubscriptioninfo",

"data":{

"callback":"http://192.168.0.44:80/temp"}

}

 Rückgabeobjekt:

{

"cid": 4715,

"data":{

>

Dienst: iolreadacyclic

12222

Name: iolreadacyclic

Beschreibung: Der Dienst liest azyklisch den Parameterwert eines IO-Link Devices. Der Zugriff erfolgt über IO-Link Index und Subindex.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

index obligatorisch NUMBER IO-Link Index des Parameters subindex obligatorisch NUMBER IO-Link Subindex des Parameters

Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

value obligatorisch STRING Parameterwert; Wert im Hexadezimalformat

>

Dienst: iolwriteacyclic

11035

Name: iolwriteacyclic

Beschreibung: Der Dienst schreibt azyklisch den Parameterwert eines IO-Link Devices. Der Zugriff erfolgt über IO-Link Index und Subindex.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

index obligatorisch NUMBER IO-Link Index des Parameters subindex obligatorisch NUMBER IO-Link Subindex des Parameters

value obligatorisch STRING Neuer Wert des Parameters; Wert im Hexadezimalformat

Rückgabedaten (Feld "data"): keine

>

Dienst: reboot

10986

Name: reboot

Beschreibung: Der Dienst startet das Gerät neu.

Anfragedaten (data): keine Rückgabedaten (data): keine

80

>

Dienst: setblock

12224

Name: setblock

Beschreibung: Der Dienst setzt die Werte mehrerer Datenpunkte einer Struktur gleichzeitig.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung datatosend obligatorisch ARRAY

OF STRINGS

Liste von Datenpunkten und deren neuen Wertene; Datenpunkte müssen den Dienst setdata unterstützen

consistent optional BOOL

Rückgabedaten (Feld "data"): keine

Dienst: setdata

11036

Name: setdata

Beschreibung: Der Dienst setzt den Wert eines Datenpunkts.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

newvalue obligatorisch STRING Neuer Wert des Elements/Datenpunkts

Rückgabedaten (Feld "data"): keine

Beispiel:

{"code":"request",

"cid":4711,

"adr":"devicetag/applicationtag/setdata",

"data":{"newvalue":"ifm IO-Link master"}

}

>

Dienst: setelementinfo

7159

Name: setelementinfo

Beschreibung: Der Dienst setzt die uid eines Elements.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

url obligatorisch STRING URL des Elements, das geändert werden soll

uid optional STRING UID, die gesetzt werden soll

profiles optional JSON-Array

format optional JSON-Objekt

Rückgabedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

identifier obligatorisch STRING Bezeichner des Elements

type obligatorisch STRING Typ des Elements

format optional JSON-Objekt Format der Daten oder des Serviceinhalts

uid optional STRING

profiles optional JSON-Array

hash optional STRING

>

Dienst: signal

25406

Name: signal

Beschreibung: Der Dienst löst das Blinken der Status-LEDs des AL1350 aus.

Anfragedaten (Feld "data"): keine Rückgabedaten (Feld "data"): keine

82

>

Dienst: subscribe

10920

Name: subscribe

Beschreibung: Der Dienst abonniert die Werte von Datenpunkten. Die zu abonnierenden

Datenpunkte werden als Liste übergeben. Der IO-Link Master sendet Änderungen an die in callback definierte Datensenke.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

callback obligatorisch STRING Adresse, an die IoT-Core Ereignisbenachichtigungen senden soll; kompletter URL: http://ipaddress:port/path

datatosend obligatorisch ARRAY OF STRINGS

Liste aus URLs von Datenelementen; Elemente müssen getdata unterstützen

Rückgabedaten (Feld "data"): keine

>

Dienst: unsubscribe

16567

Name: unsubscribe

Beschreibung: Der Dienst löscht ein bestehendes Abonnement. Das unsubscribe ist erfolgreich, wenn cid und die Callback-Adresse in einem für ein Abonnement registriert sind (subscribe). Wird im callback der STRING "DELETE" übergeben, löscht der IO-Link Master alle aktiven Abonnements.

Anfragedaten (Feld "data"):

Datenfeld Pflichtfeld Datentyp Beschreibung

callback obligatorisch STRING Adresse, an die IoT-Core Ereignisbenachichtigungen senden soll; kompletter URL: http://ipaddress:port/path

Rückgabedaten (Feld "data"): keine

14 Index

A

Allgemein ... 7

Allgmeine Funktionen ... 36

Änderungshistorie ... 6

Anhang ... 62

Anwendungskennung einstellen ... 44

Auf den ifm-IoT-Core zugreifen ... 54

Ausgänge ... 64

B

Bedien- und Anzeigeelemente ... 19

Beispiel Anfrage mit Authentifikation ... 39

Bezeichnung des IO-Link Master ändern ... 44

Datenspeicher eines IO-Link Ports klonen ... 41

Ereignis abonnieren ... 51

Firmware aktualisieren ... 47

GET-Request... 54

Mehrere Parameterwerte des IO-Link Master gleichzeitig lesen ... 48

Parameterwert eines IO-Link Devices ändern... 43

Parameterwert eines IO-Link Devices lesen ... 42

Passwort rücksetzen ... 39

POST-Request ... 56

Prozessdaten eines IO-Link Devices lesen ... 45

Sicherheitsmodus aktivieren ... 38

Temperatur an MQTT-Broker veröffentlichen ... 52

Bestimmungsgemäße Verwendung ... 9

D

Diagnosedaten des AL1350 lesen ... 48

Dienst factoryreset ... 74

getdata ... 75

getdatamulti ... 76

getidentity ... 77

getsubscriptioninfo ... 78

gettree... 75

iolreadacyclic ... 79

iolwriteacyclic... 79

reboot... 79

setblock ... 80

setdata ... 80

setelementinfo ... 81

signal ... 81

subscribe ... 82

unsubscribe ... 82

Digitale Eingänge... 12

E

Eingänge ... 64

Eingänge / Ausgänge ... 63

Eingriffe in das Gerät ... 8

Einsatzbereich ... 63

Elektrische Daten ... 63

Elektrischer Anschluss ...14, 66 Gerät auf Werkseinstellungen rücksetzen ... 33

Gerät neu starten ... 34

Firmware aktualisieren ... 58

Funktion ... 10

G

Gerät anschließen ... 18

Gerät montieren ... 13

Geräte- und Diagnoseinformationen lesen ... 23

Geräteinformationen des IO-Link Devices lesen... 49

Geräteinformationen des IO-Link Masters lesen... 49

GET-Methode ... 54

H

Hinweis Sicherheitsmodus ... 37

Hinweise ...14, 26 Hinweise für Programmierer ... 53

I

ifm-IoT-Core ...35, 67 Inbetriebnahme ... 22

Info Geräteinformationen zeigen ... 33

Internet of Things (IoT) ... 11

IO-Link ... 11

IO-Link Device tauschen ... 59

IO-Link Devices für Class-A-Betrieb anschließen ... 16

IO-Link Devices für Class-B-Betrieb anschließen ... 17

IO-Link Devices konfigurieren ... 42

IO-Link Master steuern ... 46

IO-Link Ports ... 16

IO-Link Ports (Class A) ... 21

IO-Link Ports konfigurieren ... 40

IO-Link-Ports Betriebsart konfigurieren ... 31

Datenübertragung zu LR AGENT oder LR SMARTOBSERVER einstellen 30 Gerätevalidierung und Datenspeicherung einstellen ... 32

Rückfallwerte konfigurieren ... 33

IO-Link-Versorgung ... 12

IoT IP-Einstellungen konfigurieren ... 27

Schnittstelle zum LR AGENT oder LR SMARTOBSERVER konfigurieren . 29 Sicherheitsmodus konfigurieren... 28

IoT Core Allgemeine Informationen ... 53

IoT-Core Diagnosecodes ... 56

IoT-Ports ... 15

IoT-Schnittstelle ... 20

Sicherheitsmodus konfigurieren... 37

IoT-Schnittstelle konfigurieren ... 36

IT-Sicherheit ... 7

K

Kommunikation, Parametrierung, Auswertung ... 11

84

M

Mechanische Daten ... 65

Montage ... 13

MQTT-Unterstützung ... 52

N

Notwendige Vorkenntnisse ... 7

O

Offline-Parametrierung ... 26

Optische Signalisierung ... 12

P

Parametrierung ...11, 24 POST-Request ... 55

Profil blob ... 68

deviceinfo ... 69

devicetag ... 69

iolinkdevice_full ... 70

iolinkmaster ... 70

network ... 71

parameter ... 71

processdata ... 71

service ... 71

software ... 72

software/uploadedablesoftware ... 72

timer ... 72

R

Rechtliche Hinweise ... 5

Reinigung ... 57

S

Schnittstellen ... 64

Sicherheitshinweise ... 7

Sicherheitsmodus ... 11

Sicherheitssymbole auf dem Gerät ... 7

Spannungsversorgung ... 21

Status-LEDs ... 20

T

Technische Daten ... 63

U

Überblick ... 19

Übersicht IoT-Dienste ... 74

IoT-Profile ... 68

IoT-Typen ... 73

Umgebungsbedingungen ... 65

V

Verbotene Verwendung ... 9

Vorbemerkung ... 5

VPN-Verbindung ... 26

W

Wartung, Instandsetzung und Entsorgung ... 57

Werkseinstellungen ... 60

Z

Zeichenerklärung ... 6

Zubehör... 61

Zugelassene Verwendung ... 9

Zulassungen / Prüfungen ... 65

Zweck des Dokuments ... 5

Zyklische Prozessdaten lesen / schreiben ... 45

Im Dokument Betriebsanleitung. IO-Link Master mit IoT-Schnittstelle DataLine 4 Ports IP 65 / IP 66 / IP 67 AL1350 (Seite 73-0)