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, consultez la documentation EcoStruxure Machine Expert - Guide de programmation.

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. Elle prend l'une des 5 valeurs définies dans changeIPAddress_Channel (0 ou 1), selon le nombre de ports disponibles sur le contrôleur.
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
CHANNEL_M262_ETH1	2	Port Ethernet_1
CHANNEL_M262_ETH2	3	Port Ethernet_2
CHANNEL_M262_TMS1	4	1^er module TMS

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.