changeIPAddress: Ändern der IP-Adresse der Steuerung

Beschreibung des Funktionsbausteins

Der Funktionsbaustein changeIPAddress bietet die Möglichkeit, die IP-Adresse einer Steuerung, die Subnetzmaske und die Gateway-Adresse dynamisch zu ändern. Er kann darüber hinaus die IP-Adresse speichern, damit diese auch bei nachfolgenden Neustarts der Steuerung verwendet wird.

HINWEIS: Das Ändern der IP-Adresse ist nur möglich, wenn als IP-Modus Feste IP-Adresse festgelegt ist. Weitere Informationen finden Sie unter Konfiguration der IP-Adresse.
HINWEIS: Weitere Informationen zum Funktionsbaustein finden Sie auf der Registerkarte Dokumentation des Editors des EcoStruxure Machine Expert-Bibliotheksverwalters. Informationen zur Verwendung dieses Editors finden Sie im EcoStruxure Machine Expert Benutzerhandbuch zu Funktionen und Bibliotheken.

Grafische Darstellung

Parameterbeschreibung

Eingang

Typ

Kommentar

xExecute

BOOL

  • Steigende Flanke: Die Aktion startet.

  • Fallende Flanke: Die Ausgänge werden zurückgesetzt. Wenn eine fallende Flanke eintritt, bevor der Funktionsbaustein seine Aktion abgeschlossen hat, funktionieren die Ausgänge auf normale Weise und werden nur zurückgesetzt, wenn die Aktion abgeschlossen ist oder ein Fehler auftritt. In diesem Fall sind die entsprechenden Ausgangswerte (xDone, xError, iError) an den Ausgängen für genau einen Zyklus vorhanden.

xSave

BOOL

TRUE: Die Konfiguration wird für nachfolgende Neustarts der Steuerung gespeichert.

eChannel

changeIPAddress_Channel

Der Eingang eChannel ist der zu konfigurierende Ethernet-Port. Abhängig von der Anzahl der auf der Steuerung verfügbaren Ports in changeIPAddress_Channel (0 oder 1). Siehe changeIPAddress_Channel: Zu konfigurierender Ethernet-Port.

i_abyIPAddress

ARRAY[0..3] OF BYTE

Die neue IP-Adresse, die konfiguriert werden soll. Format: 0.0.0.0.

HINWEIS: Wenn dieser Eingang auf 0.0.0.0 gesetzt wird, wird die Standard-IP-Adresse der Steuerung konfiguriert.

i_abyIPMask

ARRAY[0..3] OF BYTE

Die neue Subnetzmaske. Format: 0.0.0.0

i_abyIPGateway

ARRAY[0..3] OF BYTE

Die neue Gateway-IP-Adresse. Format: 0.0.0.0

Ausgang

Typ

Kommentar

xDone

BOOL

TRUE: Wenn IP-Adressen oder wenn Standard-IP-Adressen erfolgreich konfiguriert wurden, weil der Eingang i_abyIPAddress auf 0.0.0.0 gesetzt ist.

xBusy

BOOL

Funktionsbaustein aktiv.

xError

BOOL

  • TRUE: Fehler erkannt, der Funktionsbaustein bricht die Aktion ab.

  • FALSE: Es wurde kein Fehler festgestellt.

eError

changeIPAddress_Error

Fehlercode des identifizierten Fehlers.

xSaved

BOOL

Die Konfiguration wird für die nachfolgenden Neustarts der Steuerung gespeichert.

q_abyIPAddress

ARRAY[0..3] OF BYTE

Aktuelle IP-Adresse der Steuerung. Format: 0.0.0.0.

q_abyIPMask

ARRAY[0..3] OF BYTE

Aktuelle Subnetzmaske. Format: 0.0.0.0.

q_abyIPGateway

ARRAY[0..3] OF BYTE

Aktuelle Gateway-IP-Adresse. Format: 0.0.0.0.

changeIPAddress_Channel: Zu konfigurierender Ethernet-Port

Der Enumerationsdatentyp changeIPAddress_Channel enthält die folgenden Werte:

Enumerator

Wert

Beschreibung

CHANNEL_ETHERNET_NETWORK

0

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

M251MESE: Ethernet_2-Port

CHANNEL_DEVICE_NETWORK

1

M241: TM4ES4-Ethernet-Port

M251MESE: Ethernet_1-Port

changeIPAddress_Error Fehlercodes

Der Enumerationsdatentyp changeIPAddress_Error enthält die folgenden Werte:

Enumerator

Wert

Beschreibung

ERR_NO_ERROR

00 hex.

Kein Fehler erkannt.

ERR_UNKNOWN

01 hex.

Interner Fehler festgestellt

ERR_INVALID_MODE

02 hex.

Die IP-Adresse ist nicht als feste IP-Adresse konfiguriert.

ERR_INVALID_IP

03 hex.

Ungültige IP-Adresse.

ERR_DUPLICATE_IP

04 hex.

Die neue IP-Adresse wird bereits im Netzwerk verwendet.

ERR_WRONG_CHANNEL

05 hex.

Ungültiger Ethernet-Kommunikationsport.

ERR_IP_BEING_SET

06 hex.

IP-Adresse wird bereits geändert.

ERR_SAVING

07 hex.

IP-Adressen wurden aufgrund eines Fehlers nicht gespeichert oder weil kein nicht flüchtiger Speicher vorhanden.

ERR_DHCP_SERVER

08 hex.

Für diesem Ethernet-Kommunikationsport wird ein DHCP-Server konfiguriert.