changeIPAddress：更改控制器的 IP 地址。

功能块描述

changeIPAddress 功能块提供动态更改控制器 IP 地址及其子网掩码和网关地址的功能。该功能块还能保存 IP 地址，以便用于控制器的后续重启。

注：只有将 IP 模式配置为固定 IP 地址，才能更改 IP 地址。有关更多详细信息，请参阅 IP 地址配置。

注：有关此功能块的详细信息，请使用 EcoStruxure Machine Expert 库管理器编辑器的文档选项卡。有关此编辑器的用法，请参阅 EcoStruxure Machine Expert 编程指南。

输入	类型	注释
xExecute	BOOL	上升沿：操作开始。下降沿：复位输出。如果在功能块完成其操作前即出现下降沿，则输出将按通常方式进行操作，仅当操作完成或检测到错误时才复位。在这种情况下，会在恰好一个循环的时间内在输出上提供对应的输出值（xDone、xError、iError）。
xSave	BOOL	TRUE：保存配置以用于控制器的后续重启。
eChannel	changeIPAddress_Channel	输入 eChannel 是要配置的以太网端口。根据控制器上可用的端口数，它是 changeIPAddress_Channel 中的 5 个值之一（0 或 1）。
i_abyIPAddress	ARRAY[0..3] OF BYTE	要配置的新 IP 地址。格式：0.0.0.0。注：如果此输入设置为 0.0.0.0，则配置控制器缺省 IP 地址。
i_abyIPMask	ARRAY[0..3] OF BYTE	新子网掩码。格式：0.0.0.0
i_abyIPGateway	ARRAY[0..3] OF BYTE	新网关 IP 地址。格式：0.0.0.0

输出	类型	注释
xDone	BOOL	TRUE：如果已成功配置 IP 地址，或者因为输入 i_abyIPAddress 设置为 0.0.0.0 而成功配置缺省 IP 地址。
xBusy	BOOL	功能块处于活动状态。
xError	BOOL	TRUE：检测到错误，功能块中止操作。 FALSE：未检测到错误。
eError	changeIPAddress_Error	检测到的错误代码。
xSaved	BOOL	保存用于控制器后续重启的配置。
q_abyIPAddress	ARRAY[0..3] OF BYTE	当前控制器的 IP 地址。格式：0.0.0.0。
q_abyIPMask	ARRAY[0..3] OF BYTE	当前子网掩码。格式：0.0.0.0。
q_abyIPGateway	ARRAY[0..3] OF BYTE	当前网关 IP 地址。格式：0.0.0.0。

changeIPAddress_Channel 枚举数据类型包含以下值：

枚举器	值	描述
CHANNEL_ETHERNET_NETWORK	0	M241、M251MESC、M258、LMC058、LMC078：以太网端口 M251MESE：Ethernet_2 端口
CHANNEL_DEVICE_NETWORK	1	M241：TM4ES4 以太网端口 M251MESE：Ethernet_1 端口
CHANNEL_M262_ETH1	2	Ethernet_1 端口
CHANNEL_M262_ETH2	3	Ethernet_2 端口
CHANNEL_M262_TMS1	4	第 1 个 TMS 模块

changeIPAddress_Error 枚举数据类型包含以下值：

枚举器	值	描述
ERR_NO_ERROR	00（十六进制）	未检测到错误。
ERR_UNKNOWN	01（十六进制）	检测到内部错误。
ERR_INVALID_MODE	02（十六进制）	IP 地址未配置为固定 IP 地址。
ERR_INVALID_IP	03（十六进制）	IP 地址无效。
ERR_DUPLICATE_IP	04（十六进制）	已在网络中使用新 IP 地址。
ERR_WRONG_CHANNEL	05（十六进制）	以太网通讯端口错误。
ERR_IP_BEING_SET	06（十六进制）	已经在更改 IP 地址。
ERR_SAVING	07（十六进制）	由于检测到错误或不存在非易失性存储器而未保存 IP 地址。
ERR_DHCP_SERVER	08（十六进制）	DHCP 服务器在此以太网通讯端口上配置。