# LGF_GpsDDToGps (FC / 3.0.2)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Die Funktion konvertiert einen gegebenen GPS-DD Datentyp (Dezimalgrad) in einen GPS-Datentyp (Richtung, Grad, Minuten und Sekunden).

GPS Dezimalgrad nach GPS "native".

### Baustein Schnittstelle

| LGF_GpsDDToGps (FC) |
--- | --- | ---
LGF_typeGPS_DD |  |  | gps |  | Ret_Val |  |  | LGF_typeGPS
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
gps | LGF_typeGPS_DD | Zu konvertierende GPS-Daten (Dezimalgrad), z. B. 52.520817 13.40945

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | LGF_typeGPS | Konvertierte GPS-Daten (Richtung, Grad, Minuten und Sekunden), z. B. N52° 31′ 14.941″ E13° 24′ 34.020″
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_EXECUTION_FINISHED_NO_ERROR Abarbeitung ohne Fehler beendet
16#8201 | ERR_LATITUDE_VALUE Fehler: Breitengrad Wert
16#8203 | ERR_LONGITUDE_VALUE Fehler: Längengrad Wert

## Benutzer definierte Datentypen

### LGF_typeGPS_DD (UDT / V3.0.1)

Datentyp für GPS-Koordinaten im Format Dezimalgrad.
Für Breitengrad (Latitude) und Längengrad (Longitude).
Datentyp für einen gesamten GPS Datensatz.

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
latitude | Real | 0.0 | Breitengrad (Latitude) in Grad mit Nachkommastellen (Einheit: Grad dezimal), Norden = positiv; Süden = negativ) gültiger Wertebereich [-90.00000..90.00000]
longitude | Real | 0.0 | Längengrad (Longitude) in Grad mit Nachkommastellen (Einheit: Grad dezimal), Osten = positiv; Westen = negativ) gültiger Wertebereich [-180.0000..180.0000]

### LGF_typeGPS (UDT / V3.0.1)

Datentyp für GPS-Koordinaten Breitengrad (Latitude) und Längengrad (Longitude).
Subdatentypen im Format Grad, Minuten, Sekunden und Richtung.
Datentyp für einen gesamten GPS Datensatz.

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
latitude | LGF_typeGPS_DMS | --- | Breitengrad Element (Latitude)
longitude | LGF_typeGPS_DMS | --- | Längengrad Element (Longitude)

### LGF_typeGPS_DMS (UDT / V3.0.1)

Datentyp für GPS-Koordinaten im Format Grad, Minuten, Sekunden und Richtung.
Er wird sowohl für den Längengrad (Latitude) wie auch für den Britengrad (Longitude) genutzt.
Der Datentyp wird z.B. `LGF_typeGPS` genutzt.

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
dir | Char | '' | Richtung [N, S, E, W, n, s, e, w]
deg | UInt | 0 | Grad; Breitengrad (Latitude) [-89..+ 89]; Längengrad (Longitude) [-179..+179]
min | UInt | 0 | Minuten [0..+59]
sec | UInt | 0 | Sekunden [0..+59]

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | SIMATIC Systems Support
| 2019.09.11 | First released version
| 3.0.0 | Siemens Industry Support
| 2019.04.23 | Set version to V3.0.0 harmonize the version of the whole library
| 3.0.2 | Simatic Systems Support
| 20.01.2021 | Fix `tempStatus` initialization Insert documentation