FP_HTTP_GET_DATA_FORMAT

生成HTTP协议的数据格式字符串

此FP指令将生成指定数据格式的字符串（FP地址及长度）。此指令会将字符串写入适用于指令FP_HTTP_SET_MODE中的输入sPLCDataFormat的输出变量sDataFormat。

参数

输入

Var (STRING): 包含ASCII数据的字符串
nNumberOfCharacters (WORD, INT, UINT): 字中的数据大小，或字节单元中的字符串大小。

输出

sDataFormat (STRING): 用于FP_HTTP_SET_MODE的sPLCDataFormat输入的指定数据格式的字符串

标注

执行此指令前，需使用FP_HTTP_SET_MODE或HTTP客户端的设置对话框指定传输设置。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
仅当指定传输设置的传输请求标志为“FALSE: No transfer request”时，可以执行该指令。当传输请求标志为“TRUE: Transfer requested”时，将出现操作错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
本指令不会永久覆盖PLC中存储的以太网配置数据。当PLC关闭并再次打开时，存储在PLC中的以太网配置数据将再次被使用。
配置HTTP客户端传输设置后，执行FP_HTTP_TRANSFER_REQUEST指令时数据将实际发送或获取。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果超过连接超时
如果 IP 地址无效

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

如果超过连接超时
如果 IP 地址无效

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

如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

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

	VAR
		sStringData: STRING[31767]:='';
		iID5: INT:=5;
		bSetModeStringData: BOOL:=FALSE;
		bErrorModeStringData: BOOL:=FALSE;
	END_VAR

POU本体

如果bSetModeStringData从FALSE更改为TRUE且sys_bIsEthernetInitializing为FALSE，则执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_VARIN,,iID5,39,2,41,4,);
B(B_VARIN,,'SV0~UPLOAD;POST',39,3,41,5,);
B(B_CONTACT,,bSetModeStringData,5,1,7,3,R);
B(B_VARIN,,'/PLC?ment',39,5,41,7,);
B(B_VAROUT,,bErrorModeStringData,52,2,54,4,);
B(B_VARIN,,sStringData,8,4,10,6,);
B(B_CONTACT,,sys_bIsEthernetInitializing,16,1,18,3,N);
B(B_F,LEN!,,11,4,16,7,,?DIN?C);
B(B_F,FP_HTTP_GET_DATA_FORMAT!,,16,3,31,7,,?D@'Var'?DnNumberOfCharacters?CsDataFormat);
B(B_F,FP_HTTP_SET_MODE!,,41,0,52,7,,?DEN?DnTransferID?DsOperation?DsPLCDataFormat?DsHTTPServerURL?AENO?CbError);
L(1,2,5,2);
L(7,2,16,2);
L(11,5,11,6);
L(18,2,41,2);
L(10,5,16,5);
L(31,5,41,5);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If DF(bSetModeStringData) AND not sys_bIsEthernetInitializing Then
    FP_HTTP_SET_MODE(nTransferID := iID5,
                     sOperation := 'SV0,UPLOAD;POST',
                     sPLCDataFormat := FP_HTTP_GET_DATA_FORMAT(sStringData,
                                                               LEN(sStringData)), 
                     sHTTPServerURL := '/PLC?ment',
                     bError => bErrorModeStringData);
End_if;