FP_SD_READ

Leer datos de una tarjeta SD

Estas instrucciones FP leen el número de datos especificado por n_NumberOfDataToRead de un archivo especificado por s1_FullFileName a una tarjeta SD. La DUT FP_SD_READ_DUT de s2_dutRead especifica los parámetros de lectura. El resultado se guarda en el área especificada por d_Start. El código ASCII necesita 8 bits (1 byte) para representar 1 carácter BCD. Después de la conversión a ASCII, la longitud de los datos será por tanto el doble de la longitud de los datos de origen.

Parámetros

Entrada

s1_FullFileName (STRING)

Nombre de archivo

n_NumberOfDataToRead (WORD, INT, UINT)

Número de datos a leer

Valores:

0–65535 (datos de 16 bits)
0–32767 (datos de 32 bits)
0–1999 (cadena de caracteres)

Entrada/salida

s2_dutRead (FP_SD_READ_DUT): Formato de lectura, modo de lectura, posición del puntero, etc.

Salida

d_Start (ANY): Dirección de inicio

Modo de puntero

Si se ha seleccionado un modo de puntero en FP_SD_READ_DUT de s2_dutRead (wMode=2 o wMode=3), la lectura comienza en la posición del puntero. Después de la lectura, el puntero se mueve a la posición donde ha finalizado la lectura. La siguiente operación de lectura comenzará desde este punto.La posición del puntero también puede especificarse por udiBytePosition en la DUT. En los siguientes ejemplos, las flechas indican posiciones válidas del puntero:

Datos INT de 16 bits (archivo de formato BIN):	Datos ASCII (archivo de formato CSV):

En los archivos CSV, el puntero se mueve siempre a la siguiente posición tras una coma, un espacio o una nueva línea. Los espacios, las comas y las nuevas líneas al final de los datos se omiten.

Observaciones

Consultar también las precauciones para el acceso a la tarjeta.
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.
Dos comillas dobles consecutivas ("") en cadenas de caracteres se leen como un carácter ("). Una comilla doble sola se ignora.
En los archivos CSV, los campos nulos (p. ej., partes con comas sucesivas) se cuentan como parte del número de datos a leer, pero los datos no se guardan.

Banderas de error

sys_bIsSDMemoryAccessError (pasa a TRUE y permanece TRUE)

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

FP_SD_READ_DUT

Introducción a las instrucciones de la tarjeta SD

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;
			(*activates the instruction*)
		sFile_Test_Csv: STRING[32]:='\Test.csv';
		dutFpReadTest_csv: FP_SD_READ_DUT;
		sStringRead: STRING[32]:='';
		iStringLengthRead: INT:=0;
	END_VAR

Cuerpo de la POU

Cuando la variable bStart pasa de FALSE a TRUE, y la variable del sistema sys_bIsSDMemoryAccessActive no es TRUE, se ejecuta la función.

Cuerpo LD

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 3 ;
        NETWORK_BODY
B(B_COMMENT,,ø^Read string ASCII data from SD card memory - ASCII value,3,0,58,3,);
L(1,0,1,3);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,2,1,4,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,10,1,12,3,N);
B(B_F,E_MOVE!,,17,0,23,4,,?DEN?D?AENO?C);
B(B_VARIN,,10,15,2,17,4,);
B(B_VAROUT,,dutFpReadTest_csv.wFormat,23,2,25,4,);
L(1,2,2,2);
L(4,2,10,2);
L(12,2,17,2);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_VARIN,,sFile_Test_Csv,15,3,17,5,);
B(B_VAROUT,,sStringRead,30,3,32,5,);
B(B_VARIN,,dutFpReadTest_csv,15,5,17,7,);
B(B_CONTACT,,bStart,2,1,4,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,10,1,12,3,N);
B(B_F,FP_SD_READ!,,17,1,30,7,,?DEN?Ds1_FullFileName?Dn_NumberOfDataToRead?Ds2_dutRead?As2_dutRead?AENO?Cd_Start);
B(B_VARIN,,iStringLengthRead,15,4,17,6,);
L(1,2,2,2);
L(4,2,10,2);
L(12,2,12,3);
L(12,3,17,3);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Cuerpo en ST

eneral">(* Read string ASCII data from SD card memory - ASCII value *)
IF DF(bStart)And not sys_bIsSDMemoryAccessActive then
    dutFpReadTest_csv.wFormat:=10;
    FP_SD_READ(s1_FullFileName := sFile_Test_Csv,
               n_NumberOfDataToRead := iStringLengthRead,
               s2_dutRead := dutFpReadTest_csv,
               d_Start => sStringRead);
END_IF;