FP_FTP_TRANSFER_CONTROL

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

Dieser FP-Befehl steuert die FTP-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 (INT)

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

sControl (STRING)

Steuerzeichen:

'ENABLE': aktiviert die Dateiübertragung zu dem Ethernet-Modul
'DISABLE': deaktiviert die Dateiübertragung zu dem Ethernet-Modul
'CANCEL': bricht die Dateiü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_FTP_SET_MODE oder dem Einstellungsdialog des FTP-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_FTP_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_FTP_SET_MODE oder dem Einstellungsdialog des FTP-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_FTP_SET_MODE oder dem Einstellungsdialog des FTP-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

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
		bEnableFTP: BOOL:=FALSE;
		bDisableTransferError: BOOL:=FALSE;
		iID10: INT:=10;
	END_VAR

POE-Rumpf

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

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,,iID10,10,2,12,4,);
B(B_VARIN,,'ENABLE',10,3,12,5,);
B(B_VAROUT,,bEnableTransferError,27,2,29,4,);
B(B_CONTACT,,bEnableFTP,4,1,6,3,R);
B(B_F,FP_FTP_TRANSFER_CONTROL!,,12,0,27,5,,?DEN?DnTransferID?DsControl?AENO?CbError);
L(1,2,4,2);
L(6,2,12,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

If DF(bDisableAll) then
    FP_FTP_TRANSFER_CONTROL(nTransferID := iID10,
                            sControl := 'ENABLE',
                            bError => bError);
End_if;
If DF(bDisableAll) then
    FP_FTP_TRANSFER_CONTROL(nTransferID := iID10,
                            sControl := 'ENABLE',
                            bError => bError);
End_if;