FP_SD_READ_LINE

读取SD卡上指定文件中的一行

此FP指令从d2_dutReadLine指定的指针位置读取由s_FullFileName指定的文件，直到指定的最大字节数或直到检测到换行字符（CR、LF、CR+LF）。结果存储在d1_Out指定的区域中。

参数

输入

s_FullFileName (STRING): 文件名

输入/输出

d2_dutReadLine (FP_SD_READ_LINE_DUT): 要读取的指针位置和最大字符数

输出

d1_Out (STRING): 输出区域

标注

也请参阅有关SD卡访问的注意事项。
在SD存储卡指令的触发器EN变为TRUE后，SD存储访问活动标志（sys_bIsSDMemoryAccessActive）变为TRUE，并保持为TRUE直到执行完成。在此期间，无法执行其他SD存储卡指令。
执行指令时，SD存储访问完成标志（sys_blsSDMemoryAccessDone）为FALSE，指令完成后变为TRUE并保持TRUE。
在完成指令执行之前，请勿从输出区域读取数据。

错误标志

sys_bIsSDMemoryAccessError

FALSE：指令完成且没有错误时
TRUE：指令完成但有错误时
使用sys_iSDMemoryAccessErrorCode评估错误代码。

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

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

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

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

示例

POU头

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

	VAR
		bStart: BOOL:=FALSE;
			(*activates the instruction*)
		dutSDReadString: FP_SD_READ_LINE_DUT;
		sStringRead1: STRING[32]:='';
		@'': @'';
	END_VAR

POU本体

当变量bStart从FALSE变为TRUE时，执行此函数。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,5,1,7,3,R);
B(B_VAROUT,,dutSDReadString.udiReadCharPosition,16,2,18,4,);
B(B_VARIN,,0,8,2,10,4,);
B(B_F,E_MOVE!,,10,0,16,4,,?DEN?D?AENO?C);
L(1,2,5,2);
L(7,2,10,2);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 8 ;
        NETWORK_BODY
B(B_VARIN,,'\TestLine.csv',10,4,12,6,);
B(B_CONTACT,,bStart,2,1,4,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,10,1,12,3,N);
B(B_VARIN,,dutSDReadString,10,5,12,7,);
B(B_VAROUT,,sStringRead1,27,4,29,6,);
B(B_F,FP_SD_READ_LINE!,,12,2,27,7,,?DEN?Ds_FullFileName?Dd2_dutReadLine?Ad2_dutReadLine?AENO?Cd1_Out);
L(1,2,2,2);
L(4,2,10,2);
L(12,2,12,4);
L(1,0,1,8);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

IF DF(bStart)And not sys_bIsSDMemoryAccessActive then
    dutSDReadString.udiReadCharPosition:=0;
    FP_SD_READ_LINE(s_FullFileName := '\TestLine.csv',
                    d2_dutReadLine := dutSDReadString,
                    d1_Out => sStringRead1);
END_IF;