LGF_StringToTaddr (FC / V3.0.1)

Autor: Siemens Digital Industry

Kurzbeschreibung

Der Systemdatentyp TADDR_Param enthält Adressinformation, bestehend aus einer IPV4-Adresse und der Port-Nummer.

Die Funktion LGF_StringToTaddr konvertiert eine Variable vom Datentyp String in eine Variable des Systemdatentyp TADDR_Param.

Baustein Schnittstelle


String	ipAddressString	Ret_Val	TADDR_Param
String	ipAddressString	Ret_Val	TADDR_Param
		error	Bool
		error	Bool
		status	Word
		status	Word

Input Parameter

Bezeichner	Datentyp	Beschreibung
ipAddressString	String	IPV4-Adress String im Format `192.168.1.200:55047` [Port Nummer inklusive Doppelpunkt `:` ist optional]

Output Parameter

Bezeichner	Datentyp	Beschreibung
Ret_Val	TADDR_Param	IP-Adresse und Port Nummer als `TADDR_Param` Datentyp
error	Bool	FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status	Word	16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

Status & Error Meldungen

Code / Wert	Bezeichner / Beschreibung
16#0000	STATUS_FINISHED_NO_ERROR Status: Abarbeitung ohne Fehler beendet
16#8110	ERR_OCTET_WRONG_NUMBER_OF_CHAR Fehler: Zu viele Zeichen im X'ten Oktett der IP-Adresse
16#8120	ERR_OCTET_STRING_IS_EMPTY Fehler: Keine Nummer / Zeichen im X'ten Oktett der IP-Adresse - leerer String
16#8130	ERR_OCTET_EXCEEDS_MAX_IP_ADDRESS Fehler: Nummer im Oktett überschreitet den max. möglichen Bereich (255)
16#8150	ERR_PORT_WRONG_NUMBER_OF_CHAR Fehler: Zu viele Zeichen bei der Konvertierung des Port-Strings
16#8151	ERR_PORT_STRING_IS_EMPTY Fehler: Keine Nummer/ Zeichen im Port-String. Port-String ist leer
16#8152	ERR_PORT_EXCEEDS_MAX_PORT Fehler: Port-Nummer überschreitet den max. möglichen Bereich (65535)

Funktionsbeschreibung

Die Funktion konvertiert die IPV4-Adresse mit oder ohne Portnummer vom Datentyp String nach TADDR_Param.
Der String muss der folgenden Form entsprechen:

ohne Portnummer: [0..255].[0..255].[0..255].[0..255]
mit Portnummer: [0..255].[0..255].[0..255].[0..255]:[0..65535]

####### Beispiel:

Das Standard String Format für eine IPV4 Adresse ohne Port Nummer:
192.168.11.11
Das Standard String Format für eine IPV4 Adresse mit Port Nummer:
192.168.11.11:3294

Hinweis: Wenn Sie im Parameter ipAddressString keine Portnummer angeben, gibt der Parameter Ret_Val.REM_PORT_NR den Wert 0 aus.

Änderungshistorie

Version & Datum		Änderungsbeschreibung
	01.00.00	Siemens Industry Online Support
	30.01.2017	First released version
	01.00.01	Siemens Industry Online Support
	17.08.2018	Upgrade: TIA V15 Update 2
	01.00.02	Siemens Industry Online Support
	23.11.2018	Upgrade: TIA V15.1
	01.00.03	Simatic Systems Support
	10.06.2019	Standard header and block parameters update
	01.00.04	Simatic Systems Support
	10.07.2019	Code refactoring and performance improvements
	01.00.06	Simatic Systems Support
	14.11.2019	Add ENO handling
	03.00.00	Simatic Systems Support
	23.04.2020	Set version to V3.0.0 Harmonize the version of the whole library
	03.00.01	Simatic Systems Support
	23.02.2021	Insert documentation