FP_IPV4_SET_ADDRESS

使用IPv4协议设置IP地址

此FP指令通过互联网协议V4设置到由sAddress指定的IP地址的连接。

参数

输入

sAddress (STRING)

IPv4地址（须输入参数）

关键字： IP
网络掩码（可选参数）

关键字： MASK
网关（可选参数）

关键字： GWIP

不使用默认网关时，指定“0”。

示例：

将IP地址设为192.168.1.5，使用网络掩码255.255.255.0和网关192.168.1.1：'IP=192.168.1.5,MASK=255.255.255.0,GWIP=192.168.1.1'
将IP地址设为192.168.1.5，不使用网络掩码，使用网关192.168.1.1：'IP=192.168.1.5,,GWIP=192.168.1.1'

输出

bError (BOOL)

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

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

标注

建议在PLC启动时只执行一次该指令。请勿重复执行。
完成初始化需要三秒或更长时间。
字符串数据的字符数不得超过256。
此指令不可用于中断程序。
确保sAddress处的字符串不含任何空格。仅使用逗号作为分隔符。
IPv4地址是必填项。网络掩码和网关可以省略。
一部分参数可以省略。省略部分参数时不会更改设置。
大小写字符均可用于指定关键字。
请勿更改关键字的顺序。按照此处所列顺序指定关键字及其设置参数。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
执行此指令前，请确认系统变量sys_bIsEthernetIPAddressAssigned是否为TRUE。如果执行指令时为FALSE，则将出现错误。
此指令仅可在sys_bIsEthernetCableNotConnected为FALSE时执行。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果为参数指定的值超出允许的范围。
如果指定相同关键字超过一次
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。

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

如果为参数指定的值超出允许的范围。
如果指定相同关键字超过一次
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。

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

如果使用不正确的IP地址、网络掩码、网关或不正确IP地址的组合执行指令，则会将sys_iEthernetConnectionErrorCode设置为对应的错误代码(1–4)。
如果在以太网电缆断开时执行指令。 sys_iEthernetConnectionErrorCode设置为“10：Ethernet cable disconnected”。
如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

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

	VAR
		bSetIpv4Address: BOOL:=FALSE;
		bGetConnection: BOOL:=FALSE;
		bGetMac: BOOL:=FALSE;
		dutIPv4Connection: FP_IPv4_CONNECTION_DUT;
		dutIPv4MAC: FP_IPv4_MAC_DUT;
	END_VAR

POU本体

此示例设置由s_Address指定的以太网连接参数。请确保也在项目导航栏中的[系统寄存器(Y)] > [以太网] > [IP地址]下设置合适的参数。当bGetConnection设置为TRUE时，连接参数将输入到DUT FP_IPv4_CONNECTION_DUT。当bGetMac设置为TRUE时，MAC地址的参数将输入到DUT FP_IPv4_MAC_DUT。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bSetIpv4Address,4,2,6,4,R);
B(B_CONTACT,,sys_bIsEthernetInitializing,15,2,17,4,N);
B(B_F,FP_IPV4_SET_ADDRESS!,,31,1,43,5,,?DEN?DsAddress?AENO?CbError);
B(B_VARIN,,'IP=192.168.1.5~MASK=255.255.255.0~GWIP=192.168.1.1',29,3,31,5,);
B(B_VAROUT,,bError,43,3,45,5,);
L(1,0,1,5);
L(1,3,4,3);
L(6,3,15,3);
L(17,3,31,3);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bGetConnection,4,1,6,3,);
B(B_F,FP_IPV4_GET_CONNECTION!,,31,0,45,4,,?DEN?DnPort?AENO?CdutIPv4Connection);
B(B_VAROUT,,dutIPv4Connection,45,2,47,4,);
L(1,0,1,4);
L(1,2,4,2);
L(6,2,31,2);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bGetMac,4,1,6,3,);
B(B_F,FP_IPV4_GET_MAC!,,31,0,41,4,,?DEN?AENO?CdutIPv4MAC);
B(B_VAROUT,,dutIPv4MAC,41,2,43,4,);
L(1,0,1,4);
L(1,2,4,2);
L(6,2,31,2);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

IF DF(bSetIpv4Address) AND not(sys_bIsEthernetInitializing) then
    FP_IPV4_SET_ADDRESS(sAddress := 'IP=192.168.1.5,MASK=255.255.255.0,GWIP=192.168.1.1',
				bError => bError);
END_IF;
IF (bGetConnection) then
    FP_IPV4_GET_CONNECTION(nPort := SYS_ETHERNET_USER_CONNECTION_2, dutIPv4Connection => dutIPv4Connection);
END_IF;
IF (bGetMac) then
    FP_IPV4_GET_MAC(dutIPv4MAC => dutIPv4MAC);
END_IF;