113 lines
4.9 KiB
Markdown
113 lines
4.9 KiB
Markdown
# CLAUDE.md — Projektübersicht HundM_Fortna
|
||
|
||
## Projektbeschreibung
|
||
|
||
Siemens TIA Portal / STEP 7 SPS-Projekt für ein Fördertechnik-Automatisierungssystem (Kunde: Hund & Metzler, System: Fortna WES/WCS).
|
||
|
||
Das Repository enthält den exportierten SCL-Quellcode (Structured Control Language, IEC 61131-3) von **5 SPS-Konfigurationen** (Steuerungen), die gemeinsam eine Förderanlage steuern.
|
||
|
||
---
|
||
|
||
## Repository-Struktur
|
||
|
||
```
|
||
HundM_Fortna/
|
||
├── =A01+UH01-KF00/ # SPS-Konfiguration UH01 (Steuerung 1)
|
||
├── =A01+UH02-KF00/ # SPS-Konfiguration UH02 (Steuerung 2)
|
||
├── =A01+UH03-KF00/ # SPS-Konfiguration UH03 (Steuerung 3)
|
||
├── =A01+UH04-KF00/ # SPS-Konfiguration UH04 (Steuerung 4)
|
||
├── =A01+UH05-KF00/ # SPS-Konfiguration UH05 (Steuerung 5)
|
||
├── .vci/ # TIA Portal VCS-Workspace-Konfiguration
|
||
└── SCL_Analyse_Standardisierung.md # Analyse: Duplikate / Standardisierungspotenzial
|
||
```
|
||
|
||
### Konfigurationsname-Schema
|
||
|
||
`=A01+UH0x-KF00`
|
||
- `A01` = Anlage / Projekt-ID
|
||
- `UH0x` = Unit Handler / Steuerungsnummer (01–05)
|
||
- `KF00` = Konfigurationsbezeichner
|
||
|
||
### Struktur je Konfiguration (Unterordner)
|
||
|
||
Jede `=A01+UH0x-KF00/`-Konfiguration enthält:
|
||
|
||
```
|
||
PLC-Datentypen/ # UDTs (User Defined Types), als .xml / .liblink
|
||
Programmbausteine/ # SCL-Bausteine (FB, FC, OB) — projektspezifisch
|
||
├── 050_Sensors/ # Sensoraufruf
|
||
├── 075_PreMain/ # Vorverarbeitung
|
||
├── 100_Main/ # Hauptprogramm
|
||
├── 200_MFR/ # Material Flow Routing
|
||
├── 400_BasicFunctions/ # Hilfsfunktionen (FC)
|
||
├── 700_Jams/ # Staubehandlung
|
||
├── 800_Storage/ # Puffer / Lagerverwaltung (nur UH02/UH03)
|
||
├── 900_Communications/ # Fortna WES-WCS Kommunikation
|
||
├── 970_Visu/ # HMI-Visualisierung
|
||
├── PROFINET/ # PROFINET-Diagnose
|
||
├── SCADA/ # OPC-UA / SCADA-Anbindung
|
||
├── Längenmessung/ # Längenmessung (UH01, UH05)
|
||
├── _AutomatedIntelligence/# KI-gestützte Lagerlogik (UH02, UH03)
|
||
├── _CPU-CPU-Exchange/ # SPS-zu-SPS-Kommunikation (UH02, UH03)
|
||
└── _IBN/ # Inbetriebnahme / Testbausteine
|
||
Bibliotheksreferenzen/ # Verweise auf externe Libs (BaseSystemLib, ILSLib)
|
||
```
|
||
|
||
---
|
||
|
||
## Verwendete Bibliotheken (bereits bibliothekarisiert)
|
||
|
||
| Bibliothek | Beschreibung |
|
||
|---|---|
|
||
| `BaseSystemLib` | Siemens-Basisbausteine: Zustandsmaschinen, Sensoren, PROFINET, Monitoring, TCP, Safety |
|
||
| `ILSLib` / `2_ILSLib` | Integrated Logistics System: Carrier-Tracking, Separator, Priority Manager, Switch |
|
||
|
||
Diese Bibliotheken sind **nicht** im Git-Repository als Quellcode enthalten, sondern nur als `.liblink`-Referenzen (Verweise auf externe Bibliotheksdateien).
|
||
|
||
---
|
||
|
||
## Technologie-Stack
|
||
|
||
| Bereich | Technologie |
|
||
|---|---|
|
||
| SPS-Plattform | Siemens S7 (TIA Portal) |
|
||
| Programmiersprache | SCL (Structured Control Language, IEC 61131-3) |
|
||
| Versionskontrolle | TIA Portal VCS (.vci), Git |
|
||
| Feldbus | PROFINET |
|
||
| SCADA | OPC-UA |
|
||
| WES/WCS-Kommunikation | TCP/IP — Fortna-Telegrammprotokoll |
|
||
| Barcode-Erkennung | Cognex DM-Scanner |
|
||
| Carrier-Tracking | ILS (Integrated Logistics System) |
|
||
|
||
---
|
||
|
||
## Wichtige Konzepte
|
||
|
||
- **Carrier**: Transporteinheit (Tablar/Tray) auf der Foerderanlage; wird mit Barcode identifiziert und durch das System geroutet
|
||
- **TRO** (Transfer Object): Datenobjekt fuer den Carrier-Transport zwischen Stationen
|
||
- **WES** (Warehouse Execution System) / **WCS** (Warehouse Control System): Uebergeordnete Leitsysteme, die per TCP-Telegramm mit den SPSen kommunizieren
|
||
- **MFR** (Material Flow Routing): Logik fuer die Weichensteuerung und Carrier-Verteilung
|
||
- **Separator**: Vereinzelungseinheit fuer Carrier
|
||
- **Jam**: Stau auf der Foerderstrecke
|
||
|
||
---
|
||
|
||
## Standardisierungsanalyse
|
||
|
||
Die Datei [SCL_Analyse_Standardisierung.md](SCL_Analyse_Standardisierung.md) dokumentiert das Ergebnis einer Duplikatanalyse ueber alle 5 Konfigurationen (Stand: 2026-06-23):
|
||
|
||
- **49 Bausteine** mit Standardisierungspotenzial identifiziert
|
||
- **22 Bausteine (P1)** sind in allen 5 Konfigurationen identisch vorhanden → sofort in gemeinsame Projektbibliothek auslagern
|
||
- **Top-5 Quick Wins**: `FC_GET_PROFINET_DEVICE_STATES`, `FB-OPC_UA_System-Stat`, `Programming error` (OB), String-Konvertierungen, `FB_CommunicationLogger`
|
||
- Sonderanalyse: Versionschaos bei `StockRemoval`-Bausteinen in UH02/UH03
|
||
|
||
---
|
||
|
||
## Arbeitsweise mit diesem Repository
|
||
|
||
- Dateien werden aus TIA Portal exportiert (SCL-Export) und per Git versioniert
|
||
- Aenderungen werden in TIA Portal gemacht, exportiert und dann committed
|
||
- `.scl`-Dateien enthalten den Quellcode der Bausteine; `.xml`-Dateien enthalten UDTs und Datenbloecke
|
||
- `.liblink`-Dateien sind nur Referenzen auf externe Bibliotheken (kein Quellcode)
|
||
- Die `.vci/`-Konfiguration steuert das TIA Portal VCS-Verhalten
|