# LGF_FileDelete (FB / 1.0.0)

Übersicht

Autor: Simatic Systems Support

## Kurzbeschreibung

Dieser Funktionsbaustein löscht eine Datei, die auf der Speicherkarte der SPS (SMC) im Ordner UserFiles gespeichert ist.

### Baustein Schnittstelle

| LGF_FileDelete (FB) |
--- | --- | ---
Bool |  |  | execute |  | done |  |  | Bool
String |  |  | fileName |  | busy |  |  | Bool
|  |  |  |  | error |  |  | Bool
|  |  |  |  | fileDoesNotExist |  |  | Bool
|  |  |  |  | status |  |  | Word
|  |  |  |  | diagnostics |  |  | LGF_typeDiagnostics

### Input Parameter

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
execute | Bool | FALSE | Steigende Flanke startet Löschen der Datei
fileName | String | '' | Name der Datei inklusiv Pfad: `UserFiles/test.dat`

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
done | Bool | TRUE: FB-Abarbeitung erfolgreich fertiggestellt
busy | Bool | TRUE: FB ist aktiv; neue Ausgabewerte können erwartet werden.
error | Bool | TRUE: Bei der Ausführung der Funktionalität ist ein Fehler aufgetreten
fileDoesNotExist | Bool | True: Die Datei oder der Pfad unter `Dateiname` existiert nicht
status | Word | 16#0000-16#7FFF: Status des FB / 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
diagnostics | LGF_typeDiagnostics | Diagnosestruktur zur Speicherung und Übertragung von Diagnoseinformationen von Blöcken über die Schnittstelle.

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_EXECUTION_FINISHED Ausführung ohne Fehler beendet
16#7000 | STATUS_NO_CALL Kein Job wird gerade verarbeitet
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#8401 | ERR_FILE_PATH Fehler: Dateipfad Fehler: der Dateipfad muss mit 'UserFiles/' beginnen.
16#8600 | ERR_UNDEFINED_STATE Fehler aufgrund eines undefinierten Zustands im Zustandsautomaten
16#8604 | ERR_FILE_DELETE_INIT Fehler: Datei von der SMC lesen - siehe `diagnostics.subFunctionStatus`
16#8605 | ERR_FILE_DELETE Fehler: Datei von SMC lesen - siehe `diagnostics.subFunctionStatus`

## Benutzer definierte Datentypen

### LGF_typeDiagnostics (UDT / V1.0.1)

Diagnosestruktur zur Speicherung und Übertragung von Diagnoseinformationen von Blöcken über die Schnittstelle.

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
status | Word | 16#0000 | Status des Bausteins oder Fehleridentifikation beim Auftreten des Fehlers
subfunctionStatus | Word | 16#0000 | Status oder Rückgabewert von aufgerufenen FB's, FC's und Systembausteinen
stateNumber | DInt | 0 | Zustand in der Zustandsmaschine des Blocks, in dem der Fehler aufgetreten ist

## Funktionsbeschreibung

Mit der Funktion `LGF_FileDelete` kann eine Datei von der SIMATIC Memory Card (SMC) gelöscht werden.

Der Dateiname muss immer vollumfänglich zusammen mit dem Ordner Namen und der Datei Erweiterung in folgendem Format angegeben werden: `UserFiles/test.dat`

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Simatic Systems Support
| 29.04.2025 | First released version