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。
在完成指令执行之前，请勿从输出区域读取数据。
确保读取的字节数（由FP_SD_READ_LINE_DUT,的uiMaxCharsToRead指定）不超过d1_Out的输出变量的最大字符串长度。否则，后续变量将被覆盖，并可能出现不相关的操作错误。

错误标志

sys_bIsSDMemoryAccessError

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

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

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

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

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

示例

POU头

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

	VAR
		bStart: BOOL:=FALSE;
		dutReadLine: FP_SD_READ_LINE_DUT;
		sLineRead: STRING[32]:='';
	END_VAR

POU本体

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

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,4,2,6,4,R);
B(B_F,E_MOVE!,,26,1,32,5,,?DEN?D?AENO?C);
B(B_VARIN,,sLineRead,12,3,14,5,);
B(B_F,MAX_LEN!,,14,3,20,5,,?D?C);
B(B_F,TO_UINT!,,20,3,26,5,,?D?C);
B(B_VAROUT,,dutReadLine.uiMaxCharsToRead,32,3,34,5,);
L(1,0,1,5);
L(1,3,4,3);
L(6,3,26,3);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,4,1,6,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,12,1,14,3,N);
B(B_F,FP_SD_READ_LINE!,,26,0,41,5,,?DEN?Ds_FullFileName?Dd2_dutReadLine?Ad2_dutReadLine?AENO?Cd1_Out);
B(B_VARIN,,'\TestLine.csv',24,2,26,4,);
B(B_VAROUT,,sLineRead,41,2,43,4,);
B(B_VARIN,,dutReadLine,24,3,26,5,);
L(1,0,1,5);
L(1,2,4,2);
L(6,2,12,2);
L(14,2,26,2);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

IF DF(bStart) AND NOT sys_bIsSDMemoryAccessActive then

		dutSDReadString.uiMaxCharsToRead := TO_UINT(MAX_LEN(sStringRead1));
		FP_SD_READ_LINE(s_FullFileName := '\TestLine.csv',
						d2_dutReadLine := dutSDReadString,
						d1_Out => sStringRead1);

END_IF;