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` 中所设置的控制器上可用的端口数（0 或 1）。请参阅 changeIPAddress_Channel：要配置的以太网端口。
`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_ETHERNET_NETWORK

0

M241、M251MESC、M258、LMC058、LMC078：以太网端口

M251MESE：Ethernet_2 端口

CHANNEL_DEVICE_NETWORK

1

M241：TM4ES4 以太网端口

M251MESE：Ethernet_1 端口

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 服务器在此以太网通讯端口上配置。