sps_skel/doc/Datenquellen_Layout_Hardwareplanung.md

Datenquellen für TROs und SCL: mechanisches Layout und Hardwareplanung

Stand 2026-10-11. Welche Angaben für die TRO-Liste und die erzeugten .scl-Bausteine aus dem mechanischen Layout kommen, welche aus der Hardwareplanung (EA-Liste und TIA-Import), und was als Defaultvorbelegung gesetzt wird. Die vollständige Liste der Rohangaben beider Quellen (Spalten, Merkmale, Attribute) steht in doc/Klassenhierarchie.md, Kapitel "Daten", Abschnitte "Angaben 1" und "Angaben 2"; die Zuordnung jedes SCL-Parameters zu seiner Quelle in den Tabellen danach. Wie beide Quellen künftig über eine gemeinsame JSON zum SCL werden: doc/Konzept_Layout_Hardware_SCL.md.

Die drei Quellen

Quelle	Dateien	Liefert im Kern
Mechanisches Layout (Anlagen-Hardware)	CSV-Export ILS 2.0 (data/*.csv), aus der BricsCAD-Layoutzeichnung	Struktur: welche Bauteile, wer folgt auf wen, Drehrichtung, Längen und Höhen, Anzahl Separatoren/Scanner
Hardwareplanung (E-Planung)	<projekt>-<n>_EA.xlsx, <projekt>-<n>_TIA.xlsx (PLC Tags + Constants), <projekt>-<n>_WSCAD.xlsx, <zeichnung>_positionsdraw.json	Namen und Adressen: jedes Signal mit BMK, Adresse, Index-Konstante, Rolle, Steuerung, Schaltschrank; mit positionsdraw auch die Lage
Defaultvorbelegung	Typ-Katalog (lib/tro_catalog.py), Namensregeln (scl_context.py), Projektkonstanten	alles, was weder Layout noch E-Planung kennen: Zeiten, Konstanten-Namen nach Regel, Freigaben, WCS-Ziele

Die Schlüssel zwischen den Quellen:

Layout-Bauteil (TeileId) --[Lage, e_planning.py]--> E-Symbol (BMK, positionsdraw)
E-Symbol (BMK)           --[Name]-----------------> TIA PLC Tag  (Adresse, Kommentar)
                         --[cIn<BMK>]--------------> TIA Constant (Index in DB_Inputs)
E/A-Adresse              --[Anschluss]-------------> WSCAD Bezug  (Feldstation, Karte)

EA-Liste und TIA-Import allein haben keine Lage, positionsdraw hat keine Adresse. Erst über das BMK als gemeinsamen Schlüssel wird aus "Sensor neben Separator 0008" ein vollständiger SCL-Eintrag mit Adresse und Indexkonstante.

Was die Hardwareplanung liefert

Für die TROs

Angabe	aus	Regel
Signal gehört zu welchem Layout-Bauteil	positionsdraw pos	räumlich, cfg/e_planning.ini (heute umgesetzt)
Rolle des Signals im TRO	positionsdraw VERW; ersatzweise Kommentar der EA/TIA-Liste	IN SEP → Sensor im Separator, SEP → Stopperventil, STAU_REF-LT → Stausensor, AE ABZWEIG → Ausschleusventil, BT BELADEN → Beladesensor, MT in Position/ABFR.FINGER/conveyor full → Vario
Welche optionalen Sensoren verbaut sind	vorhanden / nicht vorhanden je Rolle	ergibt die xPlugged*-Schalter
Fördereinheit (M-Nummer)	Kommentar (ILS-CV M0108), BEZEICHNUNG KR-K0102	Instanzname des Antriebs (#fbCarousel0102), Name der Staubereiche (DB_JamArea0102)
Steuerung, TRO-Nummernkreis	KENNZEICHNUNG =A1+UH01-KF102, Dateinummer -<n>, mappings	UH01 → TRO 1xx
Schaltschrank / Bedienfeld	KENNZEICHNUNG, WSCAD Bezug, schaltschrank_elemente	stInOutMachineState, Taster SF…
Motor ↔ Motorschutz	MA/FC mit gleicher Nummer	xOutVarioMotor, xInMotorProtection
Safety-Signale	WSCAD Bezug auf F-Karte (KF1FDQ…)	Not-Halt-Kreis, nur Hinweis
Plausibilisierung des TRO-Typs	Anzahl "in Separator n", "AE Abzweig", "Pin Abfrage" je M-Nummer	Gegenprüfung des aus dem Layout abgeleiteten Typs

Für die SCL-Dateien

Ziel	aus	Bemerkung
Namen in FB_Main (=> "MB3306", := "FC0145", "SF0002")	TIA PLC Tags Name	1:1
Sensor-Indizes "DB_Inputs".Sensors["cInBG3306"]	TIA Constants cIn<BMK>	1:1; jede Konstante, die der Generator schreibt, muss in diesem Blatt stehen → Prüfung möglich
FB_CallSensors, Größe DB_Inputs	alle cInBG…/cInFC… mit Value	noch nicht generiert
Variablen- und Konstantentabelle im TIA Portal	der TIA-Import selbst	wird nicht generiert, sondern importiert
stInOutMachineState, xInAutomatic, xInErrorQuit	Schrankelemente SF…, KENNZEICHNUNG	heute TODO(E-Planung)
xInSftyOk	Safety-Programm; WSCAD nur als Hinweis	heute TODO(E-Planung)
Scanner BX…, Cognex-Variablen	nicht in EA/TIA-Tagliste (PROFINET)	TIA-Gerätekonfiguration oder positionsdraw mit BX

Was das mechanische Layout liefert

Für die TROs

Angabe	aus	Regel / Modul
Existenz und Grenzen der TROs	Separatoren (ILS 2.0 Separator) und ihr Host (Zuordnung, TrackIds)	tro_flow.analyse_tros()
TRO-Typ und damit FB	Host Kreisel/Strecke/Gefälle, Weiche, Aus-/Einschleuselement, Scanner	doc/500573_Mubea/TRO_Identifikation_500573.md, tro_catalog
Anzahl Separatoren, Weichen, Scanner je TRO	Zuordnung, Naechster Separator, Weichen-Merkmale	Parameterblöcke stInSeparator<n>, stInSwitch<n>
Vorgänger/Nachfolger	Nachbarn (mit Bahn -L/-R), TrackIds, Drehrichtung	material_flow → Kanten, Ein-/Ausgangs-Staubereiche
Systemgrenzen	BTMT Beladung/Entladung, Eingang/Ausgang	SYSn, xIsBorner
Ziele je Weichenabgang	Erreichbarkeit im TRO-Graphen	nTo1Destinations, Zielliste
Vorfahrt nötig	Einschleuselement / zwei Ströme in einen Staubereich	xPrioDir, xReleaseOk
Tragende Fördertechnik	Host-Kreisel bzw. Gefälle	xInCarouselRun1/2
angetriebene Strecke	L_VF_m, Antriebfahrtrichtung Auf	Vario
Längen	L_VF_m, L_GF_m, Kreiselabstand	Grundlage für tConvEmpty, Staulängen

Für die SCL-Dateien

REGION-Reihenfolge, FB-Typ, Instanzname, Zahl und Reihenfolge der Parameterzeilen, Staubereichs-Verkettung (Exit von A = Entr von B), FC_Direction-Aufruf mit dem Carrier aus dem Eingangs-Staubereich, nTo1Destinations, Cognex-Dummy bei TROs ohne Scanner. Das ist heute der Teil, den scl_skeleton.py schon ohne E-Planung füllt.

Überschneidungen: gegenseitige Prüfung

Beide Quellen beschreiben dieselbe Anlage, aber unabhängig voneinander. Wo sie sich überschneiden, prüft die eine die andere:

Angabe	Layout	Hardwareplanung
Separatoren je Strecke/Kreisel	Anzahl_Separator, Zuordnung	Anzahl IN SEP/"in Separator n" je M-Nummer
Weiche/Abzweig vorhanden	ILS Weiche, ILS Ausschleuselement	AE ABZWEIG, ABZWEIG-K104, ES branch
Scanner	ILS 2.0 Scanner	BX… (nur in positionsdraw mancher Projekte)
angetriebene Strecke	L_VF_m, Auf	MA…/FC… mit Bezeichnung der Strecke
Lage	Position	pos (nach Lagebezug dxf_registration)

Ein Widerspruch (z. B. Layout 6 Separatoren, E-Planung 5 IN SEP) heißt meist: unterschiedliche Planungsstände. Er gehört in den Bericht <csv>_eplan.md, nicht stillschweigend in die SCL.

Beispielzeilen mit Herkunft

Zwei reale Aufrufstellen aus doc/TRO_Katalog/scl_templates/ (UH01), Zeile für Zeile mit der Quelle als Kommentar:

• Layout = mechanisches Layout (CSV)
• HW-Planung = Hardwareplanung (EA-Liste, TIA-Import, WSCAD, positionsdraw)
• Default = Defaultvorbelegung (Typ-Default, Namensregel, Projektkonstante)

Bei zwei Quellen steht die führende zuerst: "HW-Planung + Layout" heißt, der Name kommt aus der Hardwareplanung, die Zuordnung zu diesem TRO bzw. Ausgang aus dem Layout. Der Status heute (Generator setzt / TODO(E-Planung)) steht in den Tabellen von doc/Klassenhierarchie.md.

Die Codeblöcke sind als pascal ausgezeichnet: Markdown-Renderer (VS Code, GitHub, Gitea) kennen kein scl, und SCL ist Pascal-basiert. So werden Schlüsselwörter, Zuweisungen, Zahlen und //-Kommentare hervorgehoben.

FB_ILS_MTRO_1Sep1Swi (TRO 107, Separator mit Weiche am Kreisel)

REGION TRO 107(1Sep1Swi)                                                  // Layout: Typ aus Separator am Kreisel + Ausschleuselement; Nummer 107: Default (Nummernkreis UH01 aus HW-Planung)
    #TRO107.stInSeparator1.Settings.nSeparatorNo := "cSep107.1";          // Default: Namensregel cSep<TRO>.<n>; Anzahl Separatoren: Layout
    #TRO107.stInSeparator1.Settings.tDelayToNextItem := "TimeForSepWaiting_Short"; // Default; Short/Medium je Host (Kreisel/Strecke): Layout
    #TRO107.stInSeparator1.Settings.tTrailingTime := t#100ms;             // Default: Typ-Default, bei IBN prüfen
    #TRO107.stInSeparator1.Settings.tHandlingTime := t#50ms;              // Default: Typ-Default, bei IBN prüfen
    #TRO107.stInSeparator1.Settings.tJam := "TimeForSepJam";              // Default: Projektkonstante
    #TRO107.stInSeparator1.Settings.xPluggedJam := TRUE;                  // HW-Planung: Stausensor (VERW STAU_REF-LT) vorhanden
    #TRO107.stInSeparator1.Settings.xPluggedPart := FALSE;                // HW-Planung: kein Beladesensor (VERW BT BELADEN)
    #TRO107.stInSeparator1.Settings.xPluggedScanner := FALSE;             // Layout: kein ILS 2.0 Scanner mit "Naechster Separator" = dieser
    #TRO107.stInSeparator1.stSenInSep := "DB_Inputs".Sensors["cInBG3306"]; // HW-Planung + Layout: BG mit VERW IN SEP am Separator; cInBG3306 aus TIA Constants
    #TRO107.stInSenJam2 := "DB_Inputs".Sensors["cInBG3305"];              // HW-Planung + Layout: Stausensor; Ausgang 2 = Weiterfahrt auf dem Kreisel
    #TRO107.stInSenJam3 := "DB_Inputs".Sensors["cInBG3330"];              // HW-Planung + Layout: Stausensor; Ausgang 3 = Abzweig am Ausschleuselement

    #TRO107.stInSwitch1.Settings.nSwitchNo := "cSwi107.1";                // Default: Namensregel cSwi<TRO>.<n>; Anzahl Weichen: Layout
    #TRO107.stInSwitch1.Settings.xPluggedExSen3 := FALSE;                 // HW-Planung: Abgangssensor Exit 3 verbaut?
    #TRO107.stInSwitch1.Settings.xPluggedExSen4 := FALSE;                 // HW-Planung: Abgangssensor Exit 4 verbaut?
    #TRO107.stInSwitch1.Settings.nTo1Destinations := 3;                   // Layout: über Abgang 1 erreichbare Ziele (reachable_via)

    #TRO107.stInSettings.xPrioDir2 := TRUE;                               // Layout: Zusammenführung vor Ausgang 2 -> Vorfahrt nötig
    #TRO107(stInPriorityManagerDir2 := "DB_Prozessdaten".stPriorityManager.udt_TRO107.TroIn,   // Default: Namensregel udt_TRO<n>; ob nötig: Layout
            stOutPriorityManagerDir2 => "DB_Prozessdaten".stPriorityManager.udt_TRO107.TroOut, // Default: Namensregel
            nInMainTroNo := "cMainTro107",                                // Default: Namensregel cMainTro<n>
            xInSftyOk := "DB_InterfaceSafety".stFromSafety.EStopMainOF1.Q, // HW-Planung: Not-Halt-Kreis OF1 (Safety-Programm, F-Karten im WSCAD)
            xInAllRdyToStart := TRUE,                                     // Default
            xInCarouselRun1 := #fbCarousel0102.xOutConveyorFullSpeed,     // Layout: Host-Kreisel; Name 0102: HW-Planung (KR-K0102, MA/FC-Bezeichnung)
            xInRelease := TRUE,                                           // Default: Freigabe/Testlogik
            stInOutMachineState := #stInOutControlUnitCabinetOF1,         // HW-Planung: Schaltschrank OF1 (KENNZEICHNUNG, WSCAD Bezug)
            stInOutCognexInterface := #stCognexInterfaceDummy,            // Layout: kein Scanner am TRO
            arInOutJamEntr1 := "DB_JamArea0102".stJam0102_1.arCarrier,    // Layout: Vorgänger-Staubereich; DB-Name 0102: HW-Planung (Kreisel K0102) + Default (Index _1)
            stInOutJamEntr1 := "DB_JamArea0102".stJam0102_1.stData,       // wie oben
            arInOutJamExit2 := "DB_JamArea0103".stJam0103_1.arCarrier,    // Layout: Nachfolger an Ausgang 2; DB-Name: HW-Planung + Default
            stInOutJamExit2 := "DB_JamArea0103".stJam0103_1.stData,       // wie oben
            arInOutJamExit3 := "DB_JamArea0102".stJam0102_2.arCarrier,    // Layout: Nachfolger an Ausgang 3; DB-Name: HW-Planung + Default
            stInOutJamExit3 := "DB_JamArea0102".stJam0102_2.stData,       // wie oben
            stInOutHMI := "DB_Interface_HMI".stTRO.TRO107,                // Default: Namensregel
            nOutStateLast => "DB_GLOB_TroState".arTroState["cMainTro107"], // Default: Namensregel
            xOutStopper1 => "MB3306",                                     // HW-Planung: MB mit VERW SEP, Nummernregel ab BG3306 (TIA PLC Tag)
            xOutSw1ExTo3 => "MB3304");                                    // HW-Planung + Layout: MB AE ABZWEIG am Ausschleuselement von Ausgang 3

    REGION Direction
        "FC_Direction"(nInSwitchNo := "cSwi107.1",                        // Default: Namensregel
                       nOutDirection => #TRO107.nInDirection,             // Default: fest
                       InOutCarrier := "DB_JamArea0102".stJam0102_1.arCarrier[1]); // Layout: Carrier aus dem Eingangs-Staubereich

    END_REGION
END_REGION

FB_ILS_MTRO_Vario (TRO 115, angetriebene Strecke mit Separator)

REGION TRO 115 (Vario)                                                    // Layout: Strecke mit L_VF_m / Antriebfahrtrichtung "Auf"; HW-Planung bestätigt (MA, MT in Position)
    #TRO115.stInSeparator1.Settings.nSeparatorNo := "cSep115.1";          // Default: Namensregel; Anzahl Separatoren: Layout
    #TRO115.stInSeparator1.Settings.tDelayToNextItem := "TimeForSepWaiting_Short"; // Default; Wahl je Host: Layout
    #TRO115.stInSeparator1.Settings.tTrailingTime := t#800ms;             // Default: Typ-Default Vario, bei IBN prüfen
    #TRO115.stInSeparator1.Settings.tHandlingTime := t#300ms;             // Default: Typ-Default Vario, bei IBN prüfen
    #TRO115.stInSeparator1.Settings.tJam := "TimeForSepJam";              // Default: Projektkonstante
    #TRO115.stInSeparator1.Settings.xPluggedJam := FALSE;                 // HW-Planung: kein Stausensor am Separator
    #TRO115.stInSeparator1.Settings.xPluggedPart := FALSE;                // HW-Planung: kein Beladesensor
    #TRO115.stInSeparator1.Settings.xPluggedScanner := FALSE;             // Layout: kein Scanner
    #TRO115.stInSeparator1.stSenInSep := "DB_Inputs".Sensors["cInBG3025"]; // HW-Planung + Layout: BG IN SEP am Separator; Index aus TIA Constants

    #TRO115.stInSeparator1.Settings.tSenFree := t#2000ms;                 // Default: Typ-Default
    #TRO115.stInSeparator1.Settings.tSenWait := T#5000ms;                 // Default: Typ-Default

    #TRO115.stInVario.Settings.xContinousEmptying := FALSE;               // Default: Prozessentscheidung
    #TRO115.stInVario.Settings.tWaitForJog := T#300ms;                    // Default: Typ-Default
    #TRO115.stInVario.Settings.tConvEmpty := T#45000ms;                   // Layout: Förderlänge L_VF_m / Geschwindigkeit (Default) -> heute fest
    #TRO115.stInVario.Settings.nCountCarrier := 1;                        // Default: Prozessentscheidung
    #TRO115.stInVario.Settings.tWaitForStop := t#3s;                      // Default: Typ-Default

    #TRO115.stInVario.Settings.tCarrierInPosDelay := t#1200ms;            // Default: Typ-Default
    #TRO115.stInVario.Settings.tCarrierInPosEdgeDelay := t#100ms;         // Default: Typ-Default

    #TRO115.stInVario.Settings.tRasterHigh := t#5s;                       // Default: Typ-Default
    #TRO115.stInVario.Settings.tRasterLow := t#5s;                        // Default: Typ-Default

    #TRO115.stInVario.stSenCarrInPos := "DB_Inputs".Sensors["cInBG3026"]; // HW-Planung: VERW "MT in Position" an dieser Strecke
    #TRO115.stInVario.stSenFinger := "DB_Inputs".Sensors["cInBG3027"];    // HW-Planung: VERW "Finger in position" / ABFR.FINGER
    #TRO115.stInVario.stSenLastPos := "DB_Inputs".Sensors["cInBG3000"];   // HW-Planung: VERW "conveyor full"
    #TRO115.stInVario.stSenJam := "DB_Inputs".Sensors["cInBG3001"];       // HW-Planung: VERW "Jam detector" / STAU_REF-LT

    #TRO115.stInPriorityManager.xReleaseOk := TRUE;                       // Layout: keine Zusammenführung -> keine Vorfahrt
    #TRO115.stInVario.Settings.xJamSenDelayActive := TRUE;                // Default (nur sinnvoll, wenn HW-Planung einen Stausensor hat)
    #TRO115.stInVario.Settings.tJamSenDelay := T#2s;                      // Default: Typ-Default

    #TRO115.stInSettings.xIsBorner := TRUE;                               // Layout: erster TRO nach Systemgrenze (Beladung/Eingang)

    #TRO115(nInMainTroNo := "cMainTro115",                                // Default: Namensregel
            xInSftyOk := "DB_InterfaceSafety".stFromSafety.EStopMainOF1.Q, // HW-Planung: Not-Halt-Kreis
            xInMotorProtection := "FC0145",                               // HW-Planung: FC mit Nummer des Motors (schaltschrank_elemente, TIA "Meldekontakt Motorschutzschalter")
            xInAllRdyToStart := TRUE,                                     // Default
            xInReset := "cTodoFalse",                                     // Default
            xInErrorQuit := "SF0002",                                     // HW-Planung: Quittiertaster (SF, Schrank)
            xInAutomatic := #t_Automatik_OF1 AND "SF0120",                // HW-Planung: Schlüsselschalter SF0120; Verknüpfung: Default
            xInRelease := "DB_TRO_TEST".TRO115,                           // Default: Test-/IBN-Freigabe
            arInOutJamEntr := "DB_JamArea4104".stJam4104_1.arCarrier,     // Layout: Vorgänger-Staubereich; Nummer: HW-Planung (M-Nummer) + Default
            stInOutJamEntr := "DB_JamArea4104".stJam4104_1.stData,        // wie oben
            arInOutJamFinger := "DB_JamArea4103".stJam4103_1.arCarrier,   // Layout: Staubereich auf der Vario-Strecke selbst; Nummer: HW-Planung + Default
            stInOutJamFinger := "DB_JamArea4103".stJam4103_1.stData,      // wie oben
            stInOutMachineState := #stInOutControlUnitCabinetOF1,         // HW-Planung: Schaltschrank OF1
            stInOutCognexInterface := #stCognexInterfaceDummy,            // Layout: kein Scanner
            stInOutHMI := "DB_Interface_HMI".stTRO.TRO115,                // Default: Namensregel
            nOutStateLast => "DB_GLOB_TroState".arTroState["cMainTro115"], // Default: Namensregel
            xOutStopper => "MB3025",                                      // HW-Planung: MB VERW SEP, Nummernregel ab BG3025
            xOutVarioMotor => "MA0145");                                  // HW-Planung + Layout: MA an dieser angetriebenen Strecke (Lage bzw. Bezeichnung)
END_REGION

Auszählung der beiden Beispiele

Führende Quelle	1Sep1Swi (39 Zeilen)	Vario (47 Zeilen)
Layout	13	10
HW-Planung	11	14
Default	15	23

Gezählt sind alle kommentierten Zeilen (Zuweisungen und REGION-Kopf) nach der zuerst genannten Quelle; "wie oben" zählt wie die Zeile davor. Die Struktur (welche Zeilen es gibt, wie oft, in welcher Reihenfolge) kommt immer aus dem Layout; die Tabelle zählt, woher der Wert einer Zeile kommt. Der Großteil der Defaults sind Namensregeln und Zeiten, die nach dem Typ-Katalog vorbelegt und bei der Inbetriebnahme geprüft werden. Fast alle HW-Planung-Zeilen lassen sich aus TIA-Import und positionsdraw füllen; offen bleiben xInSftyOk (Safety-Programm) und die Scanner (PROFINET, nicht im Tag-Import).