changeIPAddress: cambiar la dirección IP del controlador

Descripción del bloque de funciones

El bloque de funciones changeIPAddress proporciona la capacidad de modificar de manera dinámica la dirección IP de un controlador, su máscara de subred y su dirección de pasarela. El bloque de funciones también puede guardar la dirección IP para que se use en reinicios posteriores del controlador.

NOTA: El cambio de las direcciones IP solo es posible si la modalidad IP está configurada en Dirección IP fija. Para obtener más información, consulte Configuración de la dirección IP.
NOTA: Para obtener más información sobre el bloque de funciones, use la ficha Documentación del Editor del Administrador de bibliotecas de EcoStruxure Machine Expert. Para el uso de este editor, consulte EcoStruxure Machine Expert Guía de programación.

Representación gráfica

Descripción de parámetros

Entrada

Tipo

Comentario

xExecute

BOOL

  • Flanco ascendente: Se inicia la acción.

  • Flanco descendente: Se restablecen las salidas. Si se produce un flanco descendente antes de que el bloque de funciones haya completado su acción, las salidas funcionan de la forma habitual y solo se resetean si la acción se ha completado o en caso de que se haya detectado un error. En este caso, los correspondientes valores de salida (xDone, xError, iError) están presentes en las salidas exactamente durante un ciclo.

xSave

BOOL

TRUE: guardar la configuración para los siguientes reinicios del controlador.

eChannel

changeIPAddress_Channel

La entrada eChannel es el puerto Ethernet que se va a configurar. En función del número de puertos disponibles en el controlador, es uno de los 5 valores de changeIPAddress_Channel (0 o 1).

i_abyIPAddress

ARRAY[0..3] OF BYTE

La nueva dirección IP que se va a configurar. Formato: 0.0.0.0.

NOTA: Si esta entrada se establece en 0.0.0.0, se configurarán las direcciones IP predeterminadas del controlador.

i_abyIPMask

ARRAY[0..3] OF BYTE

La nueva máscara de subred. Formato: 0.0.0.0

i_abyIPGateway

ARRAY[0..3] OF BYTE

La nueva dirección IP de la pasarela. Formato: 0.0.0.0

Salida

Tipo

Comentario

xDone

BOOL

TRUE: si las direcciones IP se han configurado correctamente o si las direcciones IP predeterminadas se han configurado correctamente porque la entrada i_abyIPAddress se ha definido en 0.0.0.0.

xBusy

BOOL

Bloque de funciones activo.

xError

BOOL

  • TRUE: error detectado, el bloque de funciones interrumpe la acción.

  • FALSE: no se ha detectado ningún error.

eError

changeIPAddress_Error

Código del error detectado.

xSaved

BOOL

Configuración almacenada para los siguientes reinicios del controlador.

q_abyIPAddress

ARRAY[0..3] OF BYTE

Dirección IP del controlador actual. Formato: 0.0.0.0.

q_abyIPMask

ARRAY[0..3] OF BYTE

Máscara de subred actual. Formato: 0.0.0.0.

q_abyIPGateway

ARRAY[0..3] OF BYTE

Dirección de IP de la puerta de enlace actual. Formato: 0.0.0.0.

changeIPAddress_Channel: Puerto Ethernet para configurar

El tipo de datos de enumeración changeIPAddress_Channel contiene los siguientes valores:

Enumerador

Valor

Descripción

CHANNEL_ETHERNET_NETWORK

0

M241, M251MESC, M258, LMC058, LMC078: Puerto Ethernet

M251MESE: Puerto Ethernet_2

CHANNEL_DEVICE_NETWORK

1

M241: Puerto Ethernet TM4ES4

M251MESE: Puerto Ethernet_1

CHANNEL_M262_ETH1

2

Puerto Ethernet_1

CHANNEL_M262_ETH2

3

Puerto Ethernet_2

CHANNEL_M262_TMS1

4

1r Módulo TMS

changeIPAddress_Error: Códigos de error

El tipo de datos de enumeración changeIPAddress_Error contiene los siguientes valores:

Enumerador

Valor

Descripción

ERR_NO_ERROR

00 hex

No se ha detectado ningún error.

ERR_UNKNOWN

01 hex

Error interno detectado.

ERR_INVALID_MODE

02 hex

La dirección IP no se ha configurado como dirección IP fija.

ERR_INVALID_IP

03 hex

Dirección IP no válida.

ERR_DUPLICATE_IP

04 hex

La nueva dirección IP ya se ha utilizado en la red.

ERR_WRONG_CHANNEL

05 hex

Puerto de comunicación Ethernet incorrecto.

ERR_IP_BEING_SET

06 hex

La dirección IP ya se ha modificado.

ERR_SAVING

07 hex

Existen direcciones IP no almacenadas debido a un error detectado o memoria no volátil.

ERR_DHCP_SERVER

08 hex

Un servidor DHCP está configurado en este puerto de comunicación Ethernet.