FP_NTP_SET_RETRY_SETTINGS

设置NTP服务器的重试设置

此FP指令设置NTP服务器时间同步请求的重试设置。

输入

nTimeout (WORD, INT, UINT)

超时（秒）

值：30–300秒

nNumberOfRetries (WORD, INT, UINT)

重试次数

值：0–3

nRetryInterval(DWORD, DINT, UDINT, DATE, TOD, DT)

重试间隔的长度（秒）

值：10-86400秒

输出

bError (BOOL)

当操作异常终止而不执行时设置为TRUE，例如，当sys_bIsEthernetInitializing为TRUE时

当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

标注

此指令不可用于中断程序。
根据nTimeout、nNumberOfRetries和nRetryInterval设置NTP服务器的时间同步请求的重试设置。
已在系统寄存器（[以太网] > [时间同步]）中设置的数据无效，并且NTP时间同步请求在此指令指定的时间执行。
在以下情况下，PLC从系统寄存器返回设置：
- 电源关闭。
- 您可以从[PROG模式]切换到[RUN模式]。
- 切换到另一项目。
即使执行FP_IPV4_SET_ADDRESS指令，设置数据也不会丢失。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果系统正在与NTP服务器同步时间。

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

如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果系统正在与NTP服务器同步时间。

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

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

示例

POU头

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

	VAR
		bEnable: BOOL:=FALSE;
		bError: BOOL:=FALSE;
		iTimeout: INT:=60;
		iNumberOfRetries: INT:=3;
		diRetryInterval: DINT:=600;
			END_VAR

LD本体

当系统变量sys_bIsEthernetInitializing为FALSE并且变量bEnable设置为TRUE时，执行此函数。

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 6 ;
        NETWORK_BODY
B(B_CONTACT,,sys_bIsEthernetInitializing,6,1,8,3,N);
B(B_CONTACT,,bEnable,14,1,16,3,);
B(B_F,FP_NTP_SET_RETRY_SETTINGS!,,22,0,37,6,,?DEN?DnTimeout?DnNumberOfRetries?DnRetryInterval?AENO?AbError);
B(B_VARIN,,iTimeout,20,2,22,4,);
B(B_VAROUT,,bError,37,2,39,4,);
B(B_VARIN,,iNumberOfRetries,20,3,22,5,);
B(B_VARIN,,diRetryInterval,20,4,22,6,);
L(1,0,1,6);
L(1,2,6,2);
L(8,2,14,2);
L(16,2,22,2);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

if NOT (sys_bIsEthernetInitializing) AND (bEnable) then
    FP_NTP_SET_RETRY_SETTINGS(nTimeout := iTimeout,
    nNumberOfRetries := iNumberOfRetries,
    nRetryInterval := diRetryInterval,
    bError => bError);
end_if;