FP_HTTP_TRANSFER_CONTROL

Steuerung der HTTP-Datenübertragung zu einem einzelnen Ethernet-Modul

Dieser FP-Befehl steuert die HTTP-Datenübertragung zu einem einzelnen Ethernet-Modul, das durch nTransferID (0–15) angegeben ist. Gültige Steuerungswörter sind 'ENABLE', 'DISABLE' und 'CANCEL'.

Parameter

Eingang

nTransferID (WORD, INT, UINT)

Ethernet-Modul-ID (Werte: 0–15)

sControl (STRING)

Steuerzeichen:

'ENABLE': aktiviert die HTTP-Datenübertragung zu dem Ethernet-Modul
'DISABLE': deaktiviert die HTTP-Datenübertragung zu dem Ethernet-Modul
'CANCEL': bricht die HTTP-Datenübertragung zu dem Ethernet-Modul ab

Ausgang

bError (BOOL)

Wird unter den folgenden Bedingungen auf TRUE gesetzt:

wenn eine Zeitüberschreitung der Verbindung überschritten wird,
wenn eine IP-Adresse ungültig ist

Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Anmerkungen

Die Zeichenanzahl für Zeichenfolgen darf 256 nicht überschreiten.
Dieser Befehl ist in Interrupt-Programmen nicht verfügbar.
Groß- und Kleinbuchstaben können für Operanden verwendet werden, für die eine Zeichenkonstante angegeben werden kann. "Abcd", "ABCD" und "abcd" sind gleichbedeutend, bei Dateinamen wird jedoch zwischen Groß- und Kleinschreibung unterschieden.
Bevor Sie den Befehl ausführen, müssen Sie die Datenübertragungseinstellungen mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients angeben.
Bevor Sie den Befehl ausführen, stellen Sie sicher, dass sys_bIsEthernetInitializing FALSE ist. sys_bIsEthernetInitializing wird auf TRUE gesetzt, wenn der Befehl ausgeführt wird. Wenn Sie den Befehl ausführen, während sys_bIsEthernetInitializing TRUE ist, tritt ein Fehler auf.
Wenn dieser Befehl erfolgreich ausgeführt wurde, werden die Systemvariablen sys_bIsCarry und sys_iEthernetConnectionErrorCode zurückgesetzt.
Die Bearbeitung des Auftrags zum Abbrechen der Datenübertragung nimmt einige Zeit in Anspruch. Prüfen Sie den Datenübertragungsstatus mit FP_HTTP_GET_STATUS und prüfen Sie, ob die Datenübertragung nach Ausführung des Befehls anhält.
Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE)

wenn ein Steuerzeichen außer 'ENABLE', 'DISABLE' oder 'CANCEL' für sControl angegeben ist.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird
wenn die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.
wenn eine Datenübertragungseinstellung angegeben ist, die nicht mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients konfiguriert wurde.

sys_bIsOperationErrorNonHold (wird für einen Zyklus auf TRUE gesetzt)

wenn ein Steuerzeichen außer 'ENABLE', 'DISABLE' oder 'CANCEL' für sControl angegeben ist.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird
wenn die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.
wenn eine Datenübertragungseinstellung angegeben ist, die nicht mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients konfiguriert wurde.

sys_bIsCarry (wird für einen Zyklus auf TRUE gesetzt)

wenn der Befehl während der Initialisierung des Ethernets ausgeführt wird, wird sys_iEthernetConnectionErrorCode auf "11: Ethernet wird initialisiert“ gesetzt.

Verwandte Themen

FP_HTTP_SET_MODE

HTTP-Client-Einstellungen

FP_HTTP_GET_STATUS

sys_iEthernetConnectionErrorCode

Beispiel

POE-Kopf

Im POE-Kopf werden alle Ein- und Ausgangsvariablen deklariert, die für die Programmierung dieser Funktion verwendet werden. Für alle Programmiersprachen wird der gleiche POE-Kopf verwendet.

	VAR
		bEnable: BOOL:=FALSE;
		bError: BOOL:=FALSE;
		iID5: INT:=5;
	END_VAR

POE-Rumpf

Wenn bEnable von FALSE auf TRUE gesetzt wird, wird der Befehl ausgeführt. Das Steuerungswort 'ENABLE' aktiviert die HTTP-Datenübertragung für das Ethernet-Modul 5.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_VARIN,,iID5,15,2,17,4,);
B(B_VARIN,,'ENABLE',15,3,17,5,);
B(B_CONTACT,,bEnable,4,1,6,3,R);
B(B_VAROUT,,bError,32,2,34,4,);
B(B_F,FP_HTTP_TRANSFER_CONTROL!,,17,0,32,5,,?DEN?DnTransferID?DsControl?AENO?CbError);
L(1,2,4,2);
L(6,2,17,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

If DF(bDisable) then   
    FP_HTTP_TRANSFER_CONTROL(nTransferID := iID5,
                             sControl := 'DISABLE',
                             bError => bError);
End_If;