# LGF_ReadPnInterfaceParameter (FB / 1.0.0)

Übersicht

Autor: Siemens Industry Support

## Kurzbeschreibung

Der Funktionsblock liefert Schnittstellenparameter wie die IP-Adresseinstellungen, MAC-Adresse und den PN-Namen.

### Baustein Schnittstelle

| LGF_ReadPnInterfaceParameter (FB) |
--- | --- | ---
Bool |  |  | execute |  | done |  |  | Bool
HW_ANY |  |  | hardwareId |  | busy |  |  | Bool
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | DWord
|  |  |  |  | address |  |  | IP_V4
|  |  |  |  | subnetMask |  |  | IP_V4
|  |  |  |  | standardGateway |  |  | IP_V4
|  |  |  |  | macAddress |  |  | Array[0..5] of Byte
|  |  |  |  | pnName |  |  | String

### Input Parameter

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
execute | Bool | FALSE | Steigende Flanke startet Aktion einmalig
hardwareId | HW_ANY | --- | Hardware-ID des Interfaces, von dem der Parameter gelesen werden soll

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
done | Bool | TRUE: Die befohlene Funktionalität wurde erfolgreich abgeschlossen
busy | Bool | TRUE: FB ist noch nicht beendet und neue Ausgabewerte können erwartet werden
error | Bool | TRUE: Bei der Ausführung des FBs ist ein Fehler aufgetreten
status | DWord | 16#0000 - 16#7FFF: Status des FB, 16#8000 - 16#FFFF: Fehlererkennung
address | IP_V4 | IP-Adresse vom Interface
subnetMask | IP_V4 | Subnetzmaske von Schnittstelle
standardGateway | IP_V4 | Standard-Gateway-Adresse von der Schnittstelle
macAddress | Array[0..5] of Byte | MAC-Adresse von der Schnittstelle
pnName | String | Profinet-Name von der Schnittstelle

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_EXECUTION_FINISHED Ausführung ohne Fehler beendet
16#7000 | STATUS_NO_CALL Kein Auftrag wird gerade bearbeitet
16#7001 | STATUS_FIRST_CALL Erster Aufruf nach Eingang eines neuen Auftrags (steigende Flanke 'execute')
16#7002 | STATUS_SUBSEQUENT_CALL Nachfolgender Aufruf bei aktiver Verarbeitung ohne weitere Angaben
16#9000 | ERR_UNDEFINED_STATE Fehler: aufgrund eines undefinierten Zustands in der Zustandsmaschine

## Funktionsbeschreibung

Die Funktion liest die Einstellungen / Parameter der Schnittstelle mit Hilfe der Systemfunktion `RDREC` (Read data record / Lese Datensatz).

Um die MAC- und IP-Adresse der Schnittstelle zu lesen, die über ihre Hardware-ID bereitgestellt wird,
ist es zwingend erforderlich, den Datensatz `PD_INTERFACE_DATA_REAL` jeder PROFINET-konformen Schnittstelle zu lesen.

Hinweis
  Ab TIA Portal V17 kann auch die Systemfunktion `CommConfig` verwendet werden, die sich im Menü `Anweisungen / Kommunikation / Offene Benutzerkommunikation (Version >= V8.1)` befindet.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Online Support
| 2022-12-16 | First released version