E-Planung -> Layout: e_planning.py, scl_skeleton --eplan, Kapitel Daten

- doc/Klassenhierarchie.md: Kapitel "Daten" - alle Daten der SCL-Referenzen
  nach Quelle (Layout, E-Planung, Namenskonvention, Parameter)
- doc/E-Planung_Bruecke.md: Bruecke ueber *_positionsdraw.json des
  Kabellaengen-Tools, Befunde an Mubea
- lib/e_planning.py + cfg/e_planning.ini + bin/e_planning.bat/.sh:
  Lagebezug E-Zeichnung -> CSV, Zuordnung BMK -> Layout-Bauteil nach Regeln
  (Abstand, Sollabstand, Nummernregel MB = BG + 1), <csv>_eplan.json + Bericht
- scl_skeleton --eplan: Separator-Sensor und Stopperventil eingesetzt,
  ohne Schalter unveraenderte Ausgabe (Golden-Files gleich)
- tests/test_e_planning.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

doc/Klassenhierarchie.md

@@ -31,6 +31,8 @@ scl_skeleton.py         (Ausgabe: SclFile -> FB_Main.scl, generisch oder per Jin
 
 material_flow.py  dxf_registration.py   (eigenständig, ohne Abhängigkeit auf obige)
 tro_overrides.py  (importiert model.Connection / model.TroCandidate)
+e_planning.py     (Brücke zur E-Planung; importiert dxf_registration, liest das
+                   CSV über material_flow; scl_context kennt nur EplanDocument)
 ```
 
 `tro_flow.py` und `tro_annotate.py` definieren keine eigenen Klassen (nur
@@ -132,6 +134,17 @@ lib/scl_context.py                           [Render-Kontext für die SCL, BaseM
 
 lib/scl_skeleton.py                          [SCL-Ausgabe]
 └── SclTemplates         (Ordner mit <fbType>.scl.j2, hält ein jinja2.Environment)
+
+lib/e_planning.py                            [Brücke Layout <-> E-Planung]
+├── EDevice(BaseModel)    (ein BMK aus *_positionsdraw.json: VERW, Bezeichnung, Position)
+├── LayoutPoint           (@dataclass: punktartiges Layout-Bauteil in CSV-Koordinaten)
+├── Rule                  (@dataclass: eine Regel aus cfg/e_planning.ini)
+├── Assignment(BaseModel) (BMK in einer Rolle an einem Layout-Bauteil, mit Abstand)
+├── Drive(BaseModel)      (Motor MA ↔ Motorschutz FC)
+└── EplanDocument(BaseModel)                  (= <csv>_eplan.json)
+    ├─ transform: Transform                   (aus dxf_registration)
+    ├─ assignments: list[Assignment]
+    └─ drives: list[Drive]
 ```
 
 ## Auffälligkeiten für ein mögliches Refactoring
@@ -414,3 +427,188 @@ generischen Aufbau (`emit_region()`).
 **Nicht Produktion:** `doc/TRO_Katalog/scl_templates/*.scl` sind die realen
 Referenz-Aufrufstellen. Gegen sie prüft `tests/test_scl_templates.py` jedes
 Template im Round-Trip; in die erzeugte SCL fliessen sie nicht ein.
+
+## Daten
+
+Bestandsaufnahme aller Daten, die in den Referenz-Aufrufstellen und FB-Schnittstellen
+unter `doc/TRO_Katalog/scl_templates/*.scl` vorkommen (Stand 2026-10-10), und woher
+der Generator sie bekommen muss. Grundlage: die sieben Aufrufstellen
+(`FB_ILS_MTRO_1Sep`, `_1Sep1Swi`, `_1Sep2Swi`, `_1Sep_SSCC`, `_PinStore_Auto`,
+`_Vario`, `_Vario_workStation_CallSite`) und die `VAR_INPUT/OUTPUT/IN_OUT`-Abschnitte der
+vier vollständig vorliegenden FBs (`FB_ILS_MTRO_2Sep1Swi`, `FB_ILS_MTRO_Vario_workStation`,
+`FB_EmptyCarrBuffer`, `FB_LoadingBoom_INBOUND`). Die Beispielwerte stammen aus diesen
+Dateien.
+
+**Quellen** (Spalte "Quelle"):
+
+| Kürzel | Quelle | Was sie liefert |
+|---|---|---|
+| **L** | Hardwarelayout (CSV-Export ILS 2.0, `data/*.csv`) | Bauteile (`TeileArt`: Separator, Scanner, Weiche, Kreisel, Strecke, Gefällestrecke, BTMT Be-/Entladung, Ein-/Ausschleuselement), `Nachbarn`/`TrackIds`, `Merkmale` (Drehrichtung, Antriebfahrtrichtung, Höhen, Längen, Anzahl Separatoren/Scanner, Zuordnung). Daraus abgeleitet: TRO-Typ, Topologie, Reihenfolge, Ziele. |
+| **E** | Elektroplanung (EA-Liste/WSCAD/TIA-Variablentabelle, siehe `doc/HundM/EA-Listen-Analyse.md`) | Betriebsmittelkennzeichen und Variablennamen (`BG…` Sensoren, `MB…` Ventile, `MA…` Motoren, `FC…` Motorschutz, `SF…` Taster, `BX…` Scanner), Hardware-Kennungen, welche optionalen Sensoren verbaut sind, Zuordnung zu Schaltschrank und Not-Halt-Kreis. |
+| **K** | Namenskonvention | Name folgt aus TRO-Nummer bzw. Staubereichs-/Weichennummer (`cMainTro<n>`, `cSep<n>.<i>`, `"DB_Interface_HMI".stTRO.TRO<n>` …). Keine externe Quelle nötig, sobald Nummernkreis und Regel feststehen. |
+| **P** | Parameter / Projektstandard | Weder Layout noch E-Planung: Zeiten, Schwellwerte, Projektkonstanten, WCS-/Inbetriebnahme-Logik. Kandidaten für Typ-Defaults (`doc/TRO_Typen.md`). |
+
+`L + E` heisst: das Layout sagt, **dass/wie viele** es gibt und **wo**, die
+E-Planung liefert den **Namen/die Adresse**. Das ist der häufigste Fall.
+
+### TRO-Kopf und Instanzaufruf
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Existenz, Anzahl, Reihenfolge der TROs | `REGION TRO 100 …` | L | `tro_flow` → `DerivedTro`; REGION-Reihenfolge `scl_context.flow_order()` |
+| TRO-Typ / FB-Typ | `FB_ILS_MTRO_1Sep1Swi` | L (→ Katalog) | Typ aus Separator-Host (`doc/500573_Mubea/TRO_Identifikation_500573.md`), FB aus `tro_catalog` |
+| TRO-Nummer, Instanzname | `#TRO107` | L + E | Anzahl aus L; Nummernkreis je Steuerung (100er = UH01, 200er = UH02 …) ist Projektvorgabe |
+| REGION-Titel | `TRO 267 (1Sep2Switch)+Scanner(BX2100)` | L + E | Typ aus L, Scanner-BMK aus E |
+| `nInMainTroNo` | `"cMainTro100"` | K | Wert der Konstante in der PLC-Konstantentabelle |
+| `nOutStateLast` | `"DB_GLOB_TroState".arTroState["cMainTro100"]` | K | |
+| `stInOutHMI` | `"DB_Interface_HMI".stTRO.TRO100` | K | PinStore/Puffer: eigener UDT `UDT_HMI_TRO_PinStore` |
+| `xInRelease` | `"DB_TRO_TEST".TRO100`, `TRUE`, WCS-Verbindung aktiv | P | Freigabe-/Testlogik, Inbetriebnahme |
+| `xInAllRdyToStart`, `xInCancel`, `xInReset` | `TRUE`, `"cTodoFalse"` | P | meist Konstante |
+| `stInSettings.xIsBorner` (`xIsBorner1/2`) | `TRUE` | L | erster TRO nach Einfahrt in die Anlage (Beladestation / Systemgrenze `SYSn`) |
+| `stInSettings.nBornerDest(1/2)` | – | P | Standardziel für neu angelegte Carrier (WCS) |
+| `stInSettings.bSepType` (`bSep1Type/2Type`) | `.%X2 := TRUE` | E + P | X0 erstes Bein halten, X1 Beladekontrolle, X2 Beladeerfassung — hängt an verbauter Sensorik und Prozess |
+| `stInSettings.nTroStopper1/2`, `nTroSwitchExit2/3` | – | L + K | Nummern der Nachbar-TROs |
+| `stInSettings.sJamSrc` / `sJamDest` | – | L + K | Namen der benachbarten Staubereiche |
+| `stInSettings.xCar2NecRight/Left` | – | L | zweiter Kreisel nötig für Richtung rechts/links (Topologie an einer Kreisel-Weiche) |
+| `tPartSenHigh`, `tInSenHigh`, `tDummyTimeNormal`, `tDummyTimeBorner` | FB-Defaults 500 ms / 3 s / 0 ms | P | Typ-Defaults |
+
+### Separator (`stInSeparator<n>`, `xOutStopper<n>`)
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Anzahl Separatoren je TRO | `stInSeparator1`, `stInSeparator2` | L | `ILS 2.0 Separator` + `Zuordnung`, Typ-Katalog `items` |
+| `Settings.nSeparatorNo` | `"cSep107.1"` | K | Layout-Separator-ID (`TeileId`) ist **nicht** diese Nummer |
+| Sensor im Stopper `stSenInSep` | `"DB_Inputs".Sensors["cInBG3242"]` | E | |
+| Sensor nach Stopper `stSenSepLeft`, Beladesensor `stSenPart`, Scan-Start `stSenStartScan` | `["cInBG4465"]` | E | nur wenn verbaut |
+| Stopperventil `xOutStopper<n>` / `xOutStopper` | `=> "MB3242"` | E | BG- und MB-Nummer sind in der E-Planung meist gleich (BG3242/MB3242) |
+| `Settings.xPluggedJam` | `TRUE` | E | Stausensor verbaut? |
+| `Settings.xPluggedPart` | `FALSE` | E | Beladesensor verbaut? |
+| `Settings.xPluggedConfirm`, `xPluggedNullBT` | `FALSE` | E | |
+| `Settings.xPluggedScanner` | `TRUE` | L | Scanner am Separator (`DerivedTro.scanners`) |
+| `Settings.tDelayToNextItem` | `"TimeForSepWaiting_Short"` / `_Medium` | P (+ L) | Wahl Short/Medium hängt am Host (Kreisel/Strecke/Gefälle) |
+| `Settings.tTrailingTime`, `tHandlingTime` | `t#600ms`, `t#200ms`, `"cTimeSepTrailing"` | P | Typ-Default, IBN |
+| `Settings.tJam` | `"TimeForSepJam"` | P | Projektkonstante |
+| `Settings.tSenFree`, `tSenWait` | `T#1500ms`, `T#4000ms` | P | |
+
+### Staubereiche (Jam)
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Anzahl Ein-/Ausgänge und Zuordnung Exit-Nr ↔ Nachbar | `arInOutJamEntr1`, `arInOutJamExit2..4` | L | je Vorgänger ein Eingang, je Nachfolger/Weichenabgang ein Ausgang (`SclJam`) |
+| Gleicher Staubereich auf beiden Seiten einer Kante | Exit von A = Entr von B | L | Identität aus der Topologie |
+| Staubereichs-DB und -Index | `"DB_JamArea0102".stJam0102_1.arCarrier` / `.stData` | K (+ E) | Nummerierung der Staubereiche ist Projektvorgabe |
+| Stausensor je Ausgang | `stInSenJam2 := "DB_Inputs".Sensors["cInBG3243"]` | E | |
+| Übergabe-Staubereich an Steuerungsgrenze | `#arCarrierHandoverJam5001`, `#stJamDataHandoverJam5001` | L + E | Steuerungsaufteilung aus der E-Planung |
+| `xInJamAtExit2/3` | – | P | NIU |
+
+### Weiche (`stInSwitch<n>`, `FC_Direction`)
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Anzahl Weichen je TRO | `stInSwitch1`, `stInSwitch2` | L | `ILS Weiche`, Ausschleuselement, Typ-Katalog |
+| `Settings.nSwitchNo` | `"cSwi107.1"` | K | |
+| `Settings.nTo1Destinations` | `3` | L | Erreichbarkeit im TRO-Graphen (`reachable_via()`); bei mehreren Weichen Planungsentscheidung |
+| Zielliste je Abgang | `cDest…` | L + P | welche Ziele: L; Zielnummern: Projekt/WCS |
+| `Settings.xPluggedExSen3/4`, `stSenExit3/4` | `FALSE` | E | Abgangssensoren verbaut? |
+| `Settings.xNewSwitch` | `TRUE` | E | Weichenbauart (ggf. über `ARTINR` im CSV prüfbar) |
+| Weichenventile `xOutSw<n>ExTo3/4`, `xOutSw1EntrTo1/2` | `=> "MB3304"` | E | |
+| `FC_Direction`-Aufruf | `nInSwitchNo := "cSwi107.1"`, `InOutCarrier := …stJam0102_1.arCarrier[1]` | K + L | Carrier aus dem Eingangs-Staubereich |
+| Vorfahrt `stInSettings.xPrioDir<n>`, `stInPriorityManagerDir<n>` | `"DB_Prozessdaten".stPriorityManager.udt_TRO107.TroIn` | L + K | Vorfahrt nötig, wo zwei Ströme zusammenlaufen (Kreuzung/Zusammenführung) |
+| `stInPriorityManager.xReleaseOk` | `TRUE` ("braucht keine Vorfahrtsregelung") | L | TRUE, wenn keine Zusammenführung |
+
+### Scanner / Barcode / SSCC
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Scanner vorhanden, Anzahl | `stInBarcodeReader`, `stInBarcodeReader1/2` | L | `ILS 2.0 Scanner`, `Anzahl_Scanner` |
+| Scanner-BMK und Index | `#arCognexInterface["cScannerBX2100"]` | E | |
+| Cognex-Variablen | `"bx2100-TriggerReady"`, `-TriggerAck`, `-Results Available`, `-General Fault`, `-TriggerEnable`, `-Trigger`, `-ResultsAck` | E | aus dem BMK nach Regel bildbar, wenn die TIA-Variablentabelle dem Muster folgt |
+| Hardware-Kennung Ergebnisse | `"=A01+UC021-BX2100~Ergebnisse_–_64_Bytes_1"` | E | |
+| Kein Scanner | `#stCognexInterfaceDummy` | L | |
+| `Settings.xActivateCheckASCI`, `tTimeout` | `TRUE`, `T#5s` | P | |
+| `Settings.nStation`, `nScannerPurpose` | `111`, `0` | P | WCS |
+| Zweck SSCC-Scanner, `xInPluggedSSCC` | `#stCognexIntfTro105` | E + P | Layout kennt den zweiten Scanner, nicht seinen Zweck |
+| `stSenEndMeasurement` | `["cInBG3281"]` | E | |
+| `FC_CARR_GLOB_CORRECTION` | `nInStation := 0`, Carrier aus Eingangs-Staubereich | P + L | |
+| WCS-Telegramm, HMI-SSCC-Ausgabe | `FC_Send_GOHDReqM`, `"DB_Interface_HMI".stSSCC.SSCC1107` | P | WCS-Schnittstelle |
+
+### Vario (`stInVario`) und Arbeitsplatz
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Vario vorhanden | `FB_ILS_MTRO_Vario` | L | angetriebene Strecke / Variofoerderer |
+| Sensoren `stSenCarrInPos`, `stSenFinger`, `stSenLastPos`, `stSenJam`, `stSenNextSep`, `stSenSepVario` | `["cInBG3026"]` … | E | |
+| Motor `xOutVarioMotor`, Motorschutz `xInMotorProtection` | `"MA0145"`, `"FC0145"` | E | |
+| Finger-Staubereich `arInOutJamFinger` | `"DB_JamArea4103".stJam4103_1` | L + K | |
+| `Settings.tConvEmpty` | `T#45000ms` | L + P | aus Förderlänge (`L_VF_m`) und Geschwindigkeit ableitbar |
+| `Settings.nCountCarrier`, `tWaitForJog`, `tWaitForStop`, `tCarrierInPosDelay`, `tCarrierInPosEdgeDelay`, `tRasterHigh/Low`, `xJamSenDelayActive`, `tJamSenDelay`, `xContinousEmptying`, `SettingsVarioFingerMonitoring` | `1`, `T#300ms` … | P | |
+| Arbeitsplatz `stInStationSensor`, `xInReleaseStation`, `fbConvVario.xBeladenError` | `["cInBG3314"]`, `#"rTrig_Workstation 1".CLK` | E | Taster/Sensor am Arbeitsplatz |
+
+### Antrieb, Sicherheit, Betriebsart
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Fördertechnik, die den TRO trägt | `xInCarouselRun1 := #fbCarousel0102.xOutConveyorFullSpeed`; Gefälle: `TRUE` | L | Host-Kreisel aus `DerivedTro.hosts`; Instanzname nach K |
+| `xInCarouselRun2` | zweiter Kreisel | L | TRO an der Berührung zweier Kreisel |
+| `xInConveyorRunIn/Out` (PinStore) | `#fbSortConv1101`, `#fbExitConv1103` | L + K | |
+| `xInSftyOk` | `"DB_InterfaceSafety".stFromSafety.EStopMainOF1.Q` | E | Not-Halt-Kreis |
+| `stInOutMachineState` | `#stInOutControlUnitCabinetOF1` | E | Schaltschrank (OF1/OF2) |
+| `xInAutomatic`, `xInErrorQuit`, `xInQuitLocal` | `#t_Automatik_OF1 AND "SF0120"`, `"SF0002"`, `"SF0121" OR "SF0117"` | E | Bedienelemente |
+| `nInTestTarget` | `"IBN".nTestTarget111` | P | |
+
+### Pin-Lager (`FB_ILS_MTRO_PinStore_Auto`) und Leerträgerpuffer (`FB_EmptyCarrBuffer`)
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Anzahl Lagerlinien | `nNoOfLines := 19`, `arInSep[1..5]` | L | Separatoren auf Kreisel mit Pinband / `Separatorlist` |
+| Positionen je Linie, Staulänge | `nNoOfPositions := 70`, `nJamLength := 4` / `"cStorage111ExitJam2"` | L + P | aus Linienlänge und Teilung |
+| Liniensensoren `arInSep[n].stSenTrolley`, `arInJamSensor[n]`, `stInSenJamExit` | `["cInBG3270"]` | E | |
+| Linienventile `arOutSeparatorStore[n]` | `"MB3270"` | E | |
+| Pin-Separator `stInSeparatorPin`, `xOutSeparatorPin` | `["cInBG3000"]`, `"MB3000"` | E | |
+| Referenzsensor "Zappler" `stInSensorReference` | `["cInBG3001"]` | E | |
+| Encoder `stInEncoderParameter` | `#fbEncoderGF2200.nOutPosActDif` | E | |
+| `nDestGeneral`, `nConvStations`, `nStationsMax`, `nStorageThreshold` | `"cDest11100"`, `"cHooksSorterMaxPin111"` | P | WCS/Projekt |
+| `nInBufferNr`, `xInBufferReq/Release/ReleaseNext`, `xInPause` | `101`/`102` | P | Pufferlogik |
+| Lager-/Stations-DBs | `"DB_Storage1.1.1".arLine`, `"DB_ConveyorStations"`, `"DB_HandshakeStorage"` | K + P | |
+| Linien-Zeiten, Simulation | `"cTimeSepHandlingStorageLine"`, `stSimu.*` | P | |
+
+### Ladeschleife (`FB_LoadingBoom_INBOUND`)
+
+| Daten | SCL-Stelle (Beispiel) | Quelle | Bemerkung |
+|---|---|---|---|
+| Ladeschleife vorhanden, Lage | – | L | Beladestation (`ILS 2.0 BTMT Beladung`), prüfen |
+| Bedienelemente `stInControl.*` | Taster, Knebel-/Schlüsselschalter | E | |
+| Ausleger/Stützfuß `stInBoom.*`, `stInFoot.*` | Endlagen, Motorschutz, Bumper | E | |
+| Analogwerte `stInTilt.wTilt`, `stInDistance.wDistance` | Neigung, Abstand | E | |
+| Sensoren `stInSen2mThreshold`, `stInSenJamEntr/Exit1/Exit2`, `stInSenStopper1/2`, `stInSenGrid` | | E | |
+| Ausgänge `stOutStopper.*`, `stOutBoom.*`, `stOutFoot.*`, `xOutLedMovement`, `xOutLight`, `xOutLedBumper`, `xOutCarousel` | | E | |
+| Schwellwerte `nDiff`, `nZeroOk`, `nStartSlow/Fast`, `nDistanceZero`, `tDiff`, `tZero`, `nTiltComp` | | P | Inbetriebnahme |
+| `stInSettings.*` Zeiten | `tBoomInput := T#3500ms` … | P | |
+| Exit-Staubereich `arInOutCarrierExit`, `stInOutCarrierExit` | | L + K | |
+
+### Zusammenfassung
+
+- **Aus dem Hardwarelayout (L)** kommt die **Struktur**: welche TROs es gibt, ihr Typ
+  und damit FB und Anzahl der Parameterblöcke (Separatoren, Weichen, Scanner, Vario,
+  Lagerlinien), Vorgänger/Nachfolger und damit Ein-/Ausgangs-Staubereiche,
+  REGION-Reihenfolge, Ziele je Weichenabgang (`nTo1Destinations`), Vorfahrt ja/nein,
+  Systemgrenzen (`xIsBorner`), die tragende Fördertechnik (`xInCarouselRun`, Gefälle →
+  `TRUE`), ob ein Scanner am Separator sitzt (`xPluggedScanner`) und Längen als
+  Grundlage für Zeiten/Staulängen. Das meiste davon ist heute in `DerivedTro` →
+  `SclTro` abgebildet; Vorfahrt, `xIsBorner` und Längen noch nicht.
+- **Aus der Elektroplanung (E)** kommen **alle Namen und Adressen**: jeder Sensor
+  (`BG`), jedes Ventil (`MB`), Motor (`MA`), Motorschutz (`FC`), Taster (`SF`), Scanner
+  (`BX`) samt Cognex-Variablen und Hardware-Kennung, die `xPlugged*`-Schalter (was ist
+  tatsächlich verbaut), Weichenbauart, Not-Halt-Kreis, Schaltschrank und
+  Steuerungsgrenzen. Im Render-Kontext sind das die `SclName` mit `todo=True`
+  (`TODO(E-Planung)`). Offen ist die Brücke: die EA-Liste kennt keine Topologie; es
+  braucht eine Zuordnung Layout-Bauteil (Separator-`TeileId`) ↔ BMK (`BG3242`/`MB3242`).
+  Diese Brücke baut `lib/e_planning.py` über die Symbolpositionen in
+  `*_positionsdraw.json` des Kabellängen-Tools (`doc/E-Planung_Bruecke.md`);
+  heute kommen damit Separator-Sensor und Stopperventil in die SCL
+  (`scl_skeleton --eplan`).
+- **Namenskonvention (K)**: `cMainTro`, `cSep`, `cSwi`, Staubereichs-DBs, HMI- und
+  State-Pfade — sobald Nummernkreise feststehen, ohne weitere Quelle erzeugbar.
+- **Parameter (P)**: Zeiten, Projektkonstanten, WCS-Ziele/Stationen, Test-/IBN-Signale —
+  weder L noch E; gehören als Typ-Defaults in den Katalog bzw. in eine
+  Projektkonfiguration.