FP_FTP_GET_DATA_FORMAT

Generar cadena de formato de datos para el protocolo FTP

Esta instrucción FP genera una cadena que especifica el formato de los datos (dirección FP y longitud) de acuerdo con el tipo de datos en la entrada Var. Escribe la cadena en la variable de salida sDataFormat que es adecuada para la entrada sPLCFullFileNameOrDataFormat de la instrucción FP_FTP_SET_MODE.

Parámetros

Entrada

Var (BOOL, INT, UINT, WORD, DINT, UDINT, DWORD, REAL, DATE, TOD, DT, STRING)

Tipo de datos simples o matriz de tipos de datos simples, por ejemplo, BOOL, INT, UINT, STRING, ...

Restricción: ARRAY..OF..STRING no está permitida

nSize (WORD, INT, UINT)

Tamaño de datos en palabras o de cadenas en unidades de bytes.

nColumns (WORD, INT, UINT)

Número de elementos después de los cuales debe añadirse una nueva línea en el archivo .csv convertido

Salida

sDataFormat (STRING): Cadena que especifica el formato de datos de la entrada sPLCFullFileNameOrDataFormat de FP_FTP_SET_MODE

Observaciones

Antes de ejecutar la instrucción, necesita especificar la configuración de transferencia utilizando FP_FTP_SET_MODE o el diálogo de configuración del cliente FTP.
Antes de ejecutar la instrucción, asegurarse de que sys_bIsEthernetInitializing es FALSE. sys_bIsEthernetInitializing pasa a TRUE cuando se ejecuta la instrucción. Cuando ejecuta la instrucción mientras sys_bIsEthernetInitializing es TRUE, se produce un error.
La instrucción solo puede ejecutarse cuando la bandera de solicitud de transferencia para el ajuste de transferencia especificado es "FALSE: Ninguna solicitud de transferencia". Cuando la bandera de solicitud de transferencia es "TRUE: Transferencia solicitada", se produce un error de operación.
Cuando esta instrucción se ha ejecutado con éxito, las variables del sistema sys_bIsCarry y sys_iEthernetConnectionErrorCode se reinician.
Esta instrucción no sobrescribe los datos de configuración Ethernet almacenados en el PLC de forma permanente. Cuando el PLC ha sido apagado y encendido de nuevo, los datos de configuración Ethernet guardados en el PLC se utilizan de nuevo.
Una vez completada la configuración de transferencia del cliente FTP, los datos se envían a archivos o se obtienen de ellos cuando se ejecuta FP_FTP_TRANSFER_REQUEST.
Cuando se produce un error, consulte la variable del sistema sys_iEthernetConnectionErrorCode para conocer el número de código de error.

Banderas de error

sys_bIsOperationErrorHold (pasa a TRUE y permanece TRUE)

si se supera el tiempo de espera de la conexión
si la dirección IP no es válida

sys_bIsOperationErrorNonHold (pasa a TRUE para un ciclo de scan)

si se supera el tiempo de espera de la conexión
si la dirección IP no es válida

sys_bIsCarry (pasa a TRUE para un ciclo de scan)

si la instrucción se ejecuta durante la inicialización de Ethernet, sys_iEthernetConnectionErrorCode pasa a "11: Ethernet se está inicializando".

Temas relacionados

FP_FTP_SET_MODE

FP_FTP_SET_CONNECTION

FP_FTP_TRANSFER_REQUEST

sys_iEthernetConnectionErrorCode

Cliente FTP

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
		bSetModePlcData: BOOL:=FALSE;
		bSetModePlcDataError: BOOL:=FALSE;
		arrayValues: ARRAY[0..15] OF REAL:=[16(0.0)];
		iID10: INT:=10;
	END_VAR

Cuerpo de la POU

Si bSetModePlcData cambia de FALSE a TRUE y sys_bIsEthernetInitializing está a FALSE, se ejecuta la instrucción.

Cuerpo LD

NOTA

Cuando se aplica una constante con el valor 0 a la entrada nColumns, se omite la posición de salto de línea en la cadena de formato de datos generada. Esto es necesario si la instrucción FP_FTP_SET_MODE se utiliza posteriormente en el modo de operación GETDATA.

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 8 ;
        NETWORK_BODY
B(B_CONTACT,,bSetModePlcData,5,1,7,3,R);
B(B_VARIN,,'SV0~GETDATA~NON',40,3,42,5,);
B(B_VAROUT,,bSetModePlcDataError,60,2,62,4,);
B(B_VARIN,,'\B:\LOG\MyData.csv~END',40,5,42,7,);
B(B_VARIN,,iID10,40,2,42,4,);
B(B_CONTACT,,sys_bIsEthernetInitializing,16,1,18,3,N);
B(B_VARIN,,arrayValues,6,4,8,6,);
B(B_VARIN,,0,13,6,15,8,);
B(B_F,Size_Of_Var!,,8,5,15,7,,?D?C);
B(B_F,FP_FTP_SET_MODE!,,42,0,58,7,,?DEN?DnTransferID?DsOperation?DsPLCFullFileNameOrDataFormat?DsFTPServerFullFileName?AENO?CbError);
B(B_F,FP_FTP_GET_DATA_FORMAT!,,15,3,29,8,,?D@'Var'?DnSize?DnColumns?CsDataFormat);
L(1,2,5,2);
L(7,2,16,2);
L(8,5,8,6);
L(18,2,42,2);
L(58,3,60,3);
L(8,5,15,5);
L(29,5,42,5);
L(1,0,1,8);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Cuerpo en ST

If DF(bSetModePlcData) And not sys_bIsEthernetInitializing then
    FP_FTP_SET_MODE(nTransferID := iID10,
                    sOperation := 'SV0,GETDATA,NON',
                    sPLCFullFileNameOrDataFormat := FP_FTP_GET_DATA_FORMAT(Var := arrayValues,
                                                                           nSize := Size_Of_Var(arrayValues),
                                                                           nColumns := 0), 
                    sFTPServerFullFileName := '\B:\LOG\MyData.csv,END',
                    bError => bSetModePlcDataError);
End_if;