FP_SD_COPY_FILE

复制SD卡上的文件或目录

此FP指令根据s3_Format指定的参数，将s1_FullFileNameSource指定的SD卡上的文件复制到s2_FullFileNameDestination指定的文件中。

参数

输入

s1_FullFileNameSource (STRING)

源文件和目录

s2_FullFileNameDestination (STRING)

目标文件和目录

s3_Format (WORD)

文件处理和格式：

位0：

0：如果文件存在则覆盖
1：如果文件存在则异常结束

位1–15：为系统保留

标注

也请参阅有关SD卡访问的注意事项。
在SD存储卡指令的触发器EN变为TRUE后，SD存储访问活动标志（sys_bIsSDMemoryAccessActive）变为TRUE，并保持为TRUE直到执行完成。在此期间，无法执行其他SD存储卡指令。
如果为s1_FullFileNameSource指定目录，为s2_FullFileNameDestination指定文件，则发生错误3 "文件/目录名称错误"。
如果目录由s1_FullFileNameSource指定，则此目录中的所有文件都被复制到s2_FullFileNameDestination指定的目录中。不复制子目录。
写保护文件不会被覆盖。
如果s1_FullFileNameSource和s2_FullFileNameDestination相同，则无论s3_Format的值如何都会发生错误。
如果由s1_FullFileNameSource指定文件，由s2_FullFileNameDestination指定目录，则文件被复制到目录中。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果使用索引寄存器指定的区域超出限制。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果使用索引寄存器指定的区域超出限制。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bStart: BOOL:=FALSE;
			(*activates the instruction*)
	END_VAR

POU本体

当变量bStart从FALSE变为 TRUE且系统变量sys_bIsSDMemoryAccessActive不是TRUE时，执行此函数。它将目录'Test'中的文件'TestString1.csv'复制到相同目录下的文件'TestString2.csv'中。

LD本体

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本体

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