changeIPAddress : modifier l'adresse IP du contrôleur

Description du bloc fonction

Le bloc fonction changeIPAddress permet de modifier dynamiquement l'adresse IP, le masque de sous-réseau et l'adresse de passerelle d'un contrôleur. Ce bloc fonction peut également enregistrer l'adresse IP pour l'utiliser lors des redémarrages ultérieurs du contrôleur.

NOTE : L'adresse IP ne peut être modifiée qu'en mode adresse IP fixe. Pour plus d'informations, consultez la rubrique Configuration de l'adresse IP.
NOTE : Pour plus d'informations sur le bloc fonction, consultez l'onglet Documentation de l'éditeur du gestionnaire de bibliothèques EcoStruxure Machine Expert. Pour plus d'informations sur l'utilisation de cet éditeur, reportez-vous au documentEcoStruxure Machine Expert - Fonctions et bibliothèques - Guide utilisateur.

Représentation graphique

Description des paramètres

Entrée

Type

Commentaire

xExecute

BOOL

  • Front montant : l'action démarre.

  • Front descendant : les sorties sont réinitialisées. Si un front descendant survient avant la fin de l'exécution du bloc fonction, les sorties fonctionnent normalement et ne sont réinitialisées que si l'action aboutit ou en cas d'erreur détectée. Dans ce cas, les valeurs de sortie correspondantes (xDone, xError et iError) sont présentes aux sorties pendant exactement un cycle.

xSave

BOOL

TRUE : enregistre la configuration pour les redémarrages ultérieurs du contrôleur.

eChannel

changeIPAddress_Channel

L'entrée eChannel correspond au port Ethernet à configurer. Selon le nombre de ports disponibles sur le contrôleur dans changeIPAddress_Channel (0 ou 1). Voir la section changeIPAddress_Channel : Port Ethernet à configurer.

i_abyIPAddress

ARRAY[0..3] OF BYTE

Nouvelle adresse IP à configurer. Format : 0.0.0.0.

NOTE : Si cette entrée est réglée sur 0.0.0.0, l'adresse IP par défaut du contrôleur est configurée.

i_abyIPMask

ARRAY[0..3] OF BYTE

Nouveau masque de sous-réseau. Format : 0.0.0.0.

i_abyIPGateway

ARRAY[0..3] OF BYTE

Nouvelle adresse de passerelle. Format : 0.0.0.0.

Sortie

Type

Commentaire

xDone

BOOL

TRUE : si les adresses IP ont été configurées ou si les adresses IP par défaut ont été configurées, car l'entrée i_abyIPAddress définie est 0.0.0.0.

xBusy

BOOL

Bloc fonction actif.

xError

BOOL

  • TRUE : erreur détectée et annulation de l'action par le bloc fonction.

  • FALSE : aucune erreur n'a été détectée.

eError

changeIPAddress_Error

Code de l'erreur détectée.

xSaved

BOOL

Configuration enregistrée pour les redémarrages ultérieurs du contrôleur.

q_abyIPAddress

ARRAY[0..3] OF BYTE

Adresse IP actuelle du contrôleur. Format : 0.0.0.0.

q_abyIPMask

ARRAY[0..3] OF BYTE

Masque de sous-réseau actuel. Format : 0.0.0.0.

q_abyIPGateway

ARRAY[0..3] OF BYTE

Adresse de passerelle actuelle. Format : 0.0.0.0.

changeIPAddress_Channel : Port Ethernet à configurer

Le type de données énumération changeIPAddress_Channel contient les valeurs suivantes :

Enumérateur

Valeur

Description

CHANNEL_ETHERNET_NETWORK

0

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

M251MESE : Port Ethernet_2

CHANNEL_DEVICE_NETWORK

1

M241 : Port Ethernet TM4ES4

M251MESE : Port Ethernet_1

changeIPAddress_Error : Codes d'erreur

Le type de données énumération changeIPAddress_Error contient les valeurs suivantes :

Enumérateur

Valeur

Description

ERR_NO_ERROR

00 hex

Aucune erreur détectée.

ERR_UNKNOWN

01 hex

Erreur interne détectée.

ERR_INVALID_MODE

02 hex

Adresse IP non configurée comme adresse IP fixe.

ERR_INVALID_IP

03 hex

Adresse IP incorrecte.

ERR_DUPLICATE_IP

04 hex

La nouvelle adresse IP est déjà utilisée sur le réseau.

ERR_WRONG_CHANNEL

05 hex

Port de communication Ethernet incorrect.

ERR_IP_BEING_SET

06 hex

Adresse IP déjà en cours de changement.

ERR_SAVING

07 hex

Adresses IP non enregistrées à cause d'une erreur ou de l'absence de mémoire non volatile.

ERR_DHCP_SERVER

08 hex

Un serveur DHCP est configuré sur ce port de communication Ethernet.