FP_SD_COPY_FILE

Datei oder Verzeichnis auf SD-Karte kopieren

Dieser FP-Befehl kopiert auf der SD-Karte die Datei, deren Name in s1_FullFileNameSource angegeben ist, mit den durch s3_Format festgelegten Parametern in die Datei, deren Name in s2_FullFileNameDestination steht.

Parameter

Eingang

s1_FullFileNameSource (STRING)

Quelldatei und -verzeichnis

s2_FullFileNameDestination (STRING)

Zieldatei und -verzeichnis

s3_Format (WORD)

Dateihandhabung und -format

Bit 0:

0: Überschreiben, wenn Datei bereits vorhanden
1: Beendigung mit Fehler, wenn Datei bereits vorhanden

Bit 1–15: Reserviert für das System

Anmerkungen

Beachten Sie auch die Vorsichtsmaßnahmen für den SD-Kartenzugriff.
Der Merker "SD-Kartenzugriff aktiv" (sys_bIsSDMemoryAccessActive) wird auf TRUE gesetzt, nachdem der Trigger EN des SD-Kartenbefehls auf TRUE gesetzt wurde, und bleibt TRUE, bis die Ausführung beendet wurde. In dieser Zeit lassen sich keine anderen SD-Kartenbefehle ausführen.
Wenn für s1_FullFileNameSource ein Verzeichnis und für s2_FullFileNameDestination eine Datei angegeben wird, tritt der Fehler 3 "Fehler des Datei-/Verzeichnisnamens" auf.
Wenn durch s1_FullFileNameSource ein Verzeichnis festgelegt wird, werden alle Dateien in diesem Verzeichnis in das durch s2_FullFileNameDestination festgelegte Verzeichnis kopiert. Unterverzeichnisse werden nicht kopiert.
Schreibgeschützte Dateien werden nicht überschrieben.
Wenn s1_FullFileNameSource und s2_FullFileNameDestination identisch sind, tritt unabhängig von dem Wert von s3_Format ein Fehler auf.
Wenn durch s1_FullFileNameSource eine Datei und durch s2_FullFileNameDestination ein Verzeichnis festgelegt wird, wird die Datei in das Verzeichnis kopiert.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE)

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich

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

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich

Verwandte Themen

Einführung in SD-Kartenbefehle

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
		bStart: BOOL:=FALSE;
			(*activates the instruction*)
	END_VAR

POE-Rumpf

Wenn die Variable bStart von FALSE auf TRUE gesetzt wird und die Systemvariable sys_bIsSDMemoryAccessActive nicht auf TRUE gesetzt ist, wird die Funktion ausgeführt. Sie kopiert die Datei 'TestString1.csv' im Verzeichnis 'Test' in die Datei 'TestString2.csv' im gleichen Verzeichnis.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 6 ;
        NETWORK_BODY
B(B_VARIN,,0,21,4,23,6,);
B(B_CONTACT,,bStart,3,1,5,3,R);
B(B_VARIN,,'\Test\TestString1.csv',21,2,23,4,);
B(B_VARIN,,'\Test\TestString2.csv',21,3,23,5,);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,11,1,13,3,N);
B(B_F,FP_SD_COPY_FILE!,,23,0,37,6,,?DEN?Ds1_FullFileNameSource?Ds2_FullFileNameDestination?Ds3_Format?AENO);
L(1,2,3,2);
L(5,2,11,2);
L(13,2,23,2);
L(1,0,1,6);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

IF DF(bStart)AND not sys_bIsSDMemoryAccessActive then
    FP_SD_COPY_FILE('\Test\TestString1.csv', '\Test\TestString2.csv');
END_IF;