FP_FTP_GET_DATA_FORMAT

FTPプロトコル用データフォーマット文字列の生成

このFP命令は、入力Varのデータ型に従って、データフォーマット(FPアドレスと長さ)を指定する文字列を生成します。命令FP_FTP_SET_MODEの入力sPLCFullFileNameOrDataFormatに適合した文字列を出力変数sDataFormatに書き込みます。

パラメータ

入力

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

基本データ型とその配列。例: BOOL、INT、UINT、STRING、...

制限事項: ARRAY..OF..STRINGは許可されていません。

nSize (WORD, INT, UINT)

ワードまたは文字列のデータサイズ(バイト単位)

nColumns (WORD, INT, UINT)

.csv変換ファイル内の改行の後に加えられる項目の数

出力

sDataFormat (STRING): FP_FTP_SET_MODEの入力sPLCFullFileNameOrDataFormatのデータフォーマットを指定する文字列

解説

命令を実行する前に、FP_FTP_SET_MODEまたはFTPクライアントの設定ダイアログを使用して転送設定を指定する必要があります。
命令を実行する前にsys_bIsEthernetInitializingがFALSEであることを確認してください。命令が実行されるとsys_bIsEthernetInitializingはTRUEになります。sys_bIsEthernetInitializingがTRUEのときに命令を実行すると、エラーが発生します。
命令は、指定した転送設定用の転送要求フラグが「FALSE：転送要求なし」の場合のみ実行することができます。転送要求フラグが「TRUE：転送要求済み」の場合は、演算エラーが発生します。
この命令が正常に実行されると、システム変数sys_bIsCarryおよびsys_iEthernetConnectionErrorCodeがリセットされます。
この命令は、PLCに永続的に保存されているEthernet設定データを上書きしません。PLCの電源をオフにしてから再度オンにすると、PLCに保存されているEthernet設定データが再び使用されます。
FTPクライアントの転送設定が完了すると、FP_FTP_TRANSFER_REQUESTの実行時にデータはファイルに送信されるか、ファイルから取得されます。
エラーが発生した場合は、エラーコード番号のシステム変数sys_iEthernetConnectionErrorCodeを確認してください。

エラーフラグ

sys_bIsOperationErrorHold (TRUEになり、TRUEを保持)

接続のタイムアウトが経過した場合
IPアドレスが無効な場合

sys_bIsOperationErrorNonHold (1回のスキャンに対してTRUE)

接続のタイムアウトが経過した場合
IPアドレスが無効な場合

sys_bIsCarry (1回のスキャンに対してTRUE)

Ethernet初期化中に命令を実行した場合は、sys_iEthernetConnectionErrorCodeが「11：Ethernet初期化中」に設定されます。

例

POUヘッダ

POUヘッダには、このプログラムで使用するすべての入力変数と出力変数を宣言します。 POUヘッダは全プログラム言語で使用できます。

	VAR
		bSetModePlcData: BOOL:=FALSE;
		bSetModePlcDataError: BOOL:=FALSE;
		arrayValues: ARRAY[0..15] OF REAL:=[16(0.0)];
		iID10: INT:=10;
	END_VAR

POUボディ

bSetModePlcDataがFALSEからTRUEに変わり、sys_bIsEthernetInitializingがFALSEであると、命令が実行されます。

LDボディ

注記

入力nColumnsに値が0の定数が適用された場合、生成されたデータフォーマット文字列の改行位置は省略されます。動作モードGETDATAで、続けてFP_FTP_SET_MODE命令を使用する場合は、改行が必要です。

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

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;