Mit GET-Anforderungen werden zu lesende oder zu schreibende Speicherbereiche in der URL angegeben.
GET-Anforderungen beginnen mit der IP-Adresse, Portnummer und dem Befehl plcget? und enthalten alle erforderlichen Parameter in der URL.
Um Daten von der SPS zu lesen, geben Sie den zu lesenden Speicherbereich an, z.B. DT100. Um Daten zu schreiben, geben Sie den Speicherbereich und den zu schreibenden Wert an, z.B. DT100=122.
Um die Anforderung an die im FP-I4C-Webinterface eingestellte Schnittstelle zur Steuerung der Dienste zu senden, genügt dieser Befehl: http://IP_OF_DEVICE:API_PORT/plcget?DATA
Um die Anforderung an eine andere Schnittstelle zu senden, müssen Sie die COM-Schnittstelle der SPS und die Teilnehmeradresse angeben: http://IP_OF_DEVICE:API_PORT/plcget?DATA&I=INTERFACE&A=STATION NUMBER
Lesen von D100 über die Schnittstelle zur Steuerung der Dienste:
http://192.168.100.155:2000/plcget?dt100
Lesen von DT100 über COM2 der Teilnehmeradresse 2:
http://192.168.100.155:2000/plcget?dt100&I=1&A=3
Lesen von LD100 und Schreiben von TRUE in R1F über COM3 der Teilnehmeradresse 0:
http://192.168.100.155:2000/plcget?I=2&A=0&ld100&R1F=1
IP-Adresse des FP-I4C-Moduls
Serverport, der auf der Seite REST-API/HTTP-Server eingestellt wurde
Die in der Lese- oder Schreibanforderung angegebenen Daten, z.B. DT100 oder R1F=1.
Gültige Bereiche: DT, DDT, FL (nur FP2SH), DFL (nur FP2SH), LD, DLD, WR, WX, WY, WL, R, X, Y, L
COM-Schnittstelle der SPS
Achten Sie darauf, dass die angegebene Schnittstelle auf der Seite COM-Schnittstelle aktiviert und für sie ein Port auf der Seite Port geöffnet wurde.
Wird der Parameter weg gelassen, wird die unter gewählte Schnittstelle verwendet. Geben Sie immer sowohl den Parameter INTERFACE als auch den Parameter STATION NUMBER an, da einer allein ignoriert wird.
Teilnehmeradresse: 0 bis 99 (Verwenden Sie 0 für 1:1-Verbindungen über COM1 und COM3.)
Wird der Parameter weg gelassen, wird die unter eingestellte Teilnehmeradresse verwendet. Geben Sie immer sowohl den Parameter INTERFACE als auch den Parameter STATION NUMBER an, da einer allein ignoriert wird.
Um Daten von der SPS zu lesen, verwenden Sie die allgemeine Syntax für GET-Anforderungen zusammen mit dem zu lesenden Speicherbereich (z.B. DT100, R1A, Y10).
Um mehrere Speicherbereiche in einer Anforderung zu lesen, verbinden Sie die Speicherbereiche mit "&".
http://IP_OF_DEVICE:API_PORT/plcget?MEMORY AREA(&MEMORY AREA...&MEMORY AREA)
DT100 lesen:
http://192.168.100.155:2000/plcget?dt100
DDT100, R10 und Y1B lesen:
http://192.168.100.155:2000/plcget?ddt100&R10&Y1B
IP-Adresse des FP-I4C-Moduls
API-Port, der auf der Seite REST-API/HTTP-Server eingestellt wurde
Speicherbereiche der SPS
Die Antwort auf eine GET-Leseanforderung ist eine JSON-Zeichenfolge, die Fehlerinformationen und angeforderten Daten enthält.
Jede Antwort enthält die Eigenschaften err, err_msg und data. Die Eigenschaft err ist TRUE, wenn ein Fehler aufgetreten ist, und FALSE, wenn kein Fehler aufgetreten ist. Die Eigenschaft err_msg enthält die Fehlermeldung, wenn die Eigenschaft err TRUE ist, oder sie ist leer, wenn die Eigenschaft err FALSE ist. Die Eigenschaft data ist ein Array, das die Daten in der gleichen Reihenfolge wie in der Anforderung enthält.
Antwort auf Leseanforderung für DT100
{"err":false,"err_msg":"","data":[{"err":false,"err_code":0,"int":[100],"uint":[100],"udint":[],"dint":[],"hex":["0064"],"real":[],"string":"d\u0000","request":"DT100"}]}
Antwort auf Leseanforderung für DDT100, R10 und Y1B:
{"err":false,"err_msg":"","data":[{"err":false,"err_code":0,"int":[100,23],"uint":[100,23],"udint":[1507428],"dint":[1507428],"hex":["0064","0017"],"real":[6.933650024851553e-39],"string":"d\u0000\u0017\u0000","request":"DDT100"},{"err":false,"err_code":0,"state":0,"request":"R10"},{"err":false,"err_code":0,"state":0,"request":"Y1B"}]}
Das Daten-Array der Antwort enthält die folgenden Eigenschaften.
Um Daten in die SPS zu schreiben, verwenden Sie die allgemeine Syntax für GET-Anforderungen zusammen mit dem zu schreibenden Speicherbereich (z.B. DT100, R1A, Y10).
Der Einstellwert wird mit "=“ zugewiesen. Um mehrere Speicherbereiche in einer Anforderung zu beschreiben, verbinden Sie die Speicherbereiche mit "&".
Der eingestellte Wert muss eine Dezimalzahl sein. Achten Sie darauf, dass er sich im zulässigen Bereich befindet. Andernfalls wird der Wert abgeschnitten und es wird ein falscher Wert gesetzt.
http://IP_OF_DEVICE:API_PORT/plcget?MEMORY AREA=VALUE(&MEMORY AREA=VALUE...&MEMORY AREA=VALUE)
122 in DT100 schreiben:
http://192.168.100.155:2000/plcget?dt100=122
19202 in DDT100, TRUE in R10 und FALSE in Y1B schreiben:
http://192.168.100.155:2000/plcget?ddt100=19202&R10=1&Y1B=0
Sie können Lese- und Schreibanforderungen auch kombinieren:
DT200 lesen und TRUE in Y10 schreiben:
http://192.168.100.155:2000/plcget?dt200&Y10=1
IP-Adresse des FP-I4C-Moduls
API-Port, der auf der Seite REST-API/HTTP-Server eingestellt wurde
Speicherbereiche der SPS
Einstellwert
Die Antwort auf eine GET-Schreibanforderung ist eine JSON-Zeichenfolge, die Fehlerinformationen und die Daten der Anforderung enthält.
Jede Antwort enthält die Eigenschaften err, err_msg und data. Die Eigenschaft err ist TRUE, wenn ein Fehler aufgetreten ist, und FALSE, wenn kein Fehler aufgetreten ist. Die Eigenschaft err_msg enthält die Fehlermeldung, wenn die Eigenschaft err TRUE ist, oder sie ist leer, wenn die Eigenschaft err FALSE ist. Die Eigenschaft data ist ein Array, das die Daten in der gleichen Reihenfolge wie in der Anforderung enthält.
Antwort auf Schreibanforderung für DT100
{"err":false,"err_msg":"","data":[{"err":false,"err_code":0,"request":"DT100"}]}
Antwort auf Schreibanforderung für DDT100, R10 und Y1B:
{"err":false,"err_msg":"","data":[{"err":false,"err_code":0,"request":"DDT100"},{"err":false,"err_code":0,"request":"R10"},{"err":false,"err_code":0,"request":"Y1B"}]}
Antwort auf Leseanforderung für DT200 und Schreibanforderung für Y10:
{"err":false,"err_msg":"","data":[{"err":false,"err_code":0,"int":[0],"uint":[0],"udint":[],"dint":[],"hex":["0000"],"string":"\u0000\u0000","request":"DT200"},{"err":false,"err_code":0,"request":"Y10"}]}
Das Daten-Array der Antwort enthält die folgenden Eigenschaften.