FP_SD_READ_LINE

Leer una línea de un archivo especificado de una tarjeta SD

Estas instrucciones FP leen el archivo especificado por s_FullFileName desde la posición del puntero especificada por d2_dutReadLine hasta un número máximo de bytes especificado o hasta detectarse uno de los caracteres de control CR, LF, CR+LF. El resultado se guarda en el área especificada por d1_Out.

Parámetros

Entrada

s_FullFileName (STRING): Nombre de archivo

Entrada/salida

d2_dutReadLine (FP_SD_READ_LINE_DUT): Posición del puntero y número máximo de caracteres a leer

Salida

d1_Out (STRING): Salidas físicas

Observaciones

Consultar también Introducción a las instrucciones de la tarjeta SD.
La bandera "acceso a memoria SD en proceso" (sys_bIsSDMemoryAccessActive) pasa a TRUE después de la que la entrada de trigger EN de las instrucciones de la tarjeta SD haya pasado a TRUE y continúe en TRUE hasta concluir la ejecución. En este intervalo, no se pueden ejecutar otras instrucciones de la tarjeta SD.
La bandera "acceso a memoria SD finalizada" (sys_blsSDMemoryAccessDone) es FALSE cuando se ejecuta la instrucción y pasa a TRUE y se mantiene TRUE después de concluir la instrucción.
No leer los datos del área de salida hasta que la ejecución de la instrucción no haya concluido.
Asegurarse de que el número de bytes leídos (especificado por uiMaxCharsToRead de FP_SD_READ_LINE_DUT,) no excede la longitud de string máxima de la variable de salida en d1_Out. De lo contrario, se sobrescribirán las variables posteriores y pueden producirse errores de operación no relacionados.

Banderas de error

sys_bIsSDMemoryAccessError

FALSE: cuando la instrucción ha finalizado sin errores
TRUE: cuando la instrucción ha finalizado con un error
Utilizar sys_iSDMemoryAccessErrorCode para evaluar el código de error.

sys_bIsOperationErrorHold (pasa a TRUE y permanece TRUE)

si el área especificada utilizando el modificador índice supera el límite.

sys_bIsOperationErrorNonHold (pasa a TRUE para un ciclo de scan)

si el área especificada utilizando el modificador índice supera el límite.

Temas relacionados

Introducción a las instrucciones de la tarjeta SD

FP_SD_READ_LINE_DUT

Instrucciones del sistema

Panel Instrucciones

Áreas de memoria

Tipos de datos

Ejemplo

Cabecera de la POU

Todas las variables de entrada y de salida utilizadas para la programación de esta función han sido declaradas en la Cabecera de la POU. Se utiliza la misma cabecera de la POU para todos los lenguajes de programación.

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

Cuerpo de la POU

Cuando la variable bStart pasa de FALSE a TRUE, se ejecuta la función.

Cuerpo 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

Cuerpo en 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;