Konfigurationsdateien in Doku erläutert

2025-06-16 09:44:57 +02:00
parent ec52557197
commit de2dd8077e
1 changed files with 189 additions and 7 deletions
@@ -6,10 +6,26 @@
  - [Standardmäßige Ausgabe des Programms](#standardmäßige-ausgabe-des-programms)
    - [.dxf-Datei: dxfdatei\_cables.dxf](#dxf-datei-dxfdatei_cablesdxf)
    - [Excel-Datei: xxx\_cables.xlsx](#excel-datei-xxx_cablesxlsx)
-  - [Anpassung des Verhaltens des Programms:](#anpassung-des-verhaltens-des-programms)
+- [Anpassung des Verhaltens des Programms:](#anpassung-des-verhaltens-des-programms)
+  - [Verwendete Konfigurationsdateien](#verwendete-konfigurationsdateien)
+  - [Zusammenfassung und Struktur der Konfigurationsdateien](#zusammenfassung-und-struktur-der-konfigurationsdateien)
    - [allgemein.cfg](#allgemeincfg)
+      - [`[GetPos-Layer_Racks]`](#getpos-layer_racks)
+      - [`[GetPos-Layer_Distributors]`](#getpos-layer_distributors)
+      - [`[GetPos-Layer_Tunnel]`](#getpos-layer_tunnel)
+      - [`[GetPos-Layer_Equipment]`](#getpos-layer_equipment)
+      - [`[GetPos-Geom-Sensor]`](#getpos-geom-sensor)
+      - [`[Racks]`](#racks)
+      - [`[Sensoren]`](#sensoren)
    - [BMK.cfg](#bmkcfg)
+      - [`[Routing-Include]`](#routing-include)
+      - [`[Routing-Ignore]`](#routing-ignore)
+      - [`[Cable-Mapping]`](#cable-mapping)
+      - [`[Length-Adjustments]`](#length-adjustments)
    - [kabel.cfg](#kabelcfg)
+      - [Kabelgruppen (Beispiel: `[WD_Q]`, `[WD_I]`, `[WF_B]`)](#kabelgruppen-beispiel-wd_q-wd_i-wf_b)
+      - [Sensorspezifische Gruppen](#sensorspezifische-gruppen)
+      - [`[Sivasnummern]`](#sivasnummern)
  - [Detaillierte Informationen und Programmablauf](#detaillierte-informationen-und-programmablauf)
    - [Zweck des Programms](#zweck-des-programms)
    - [Allgemeiner Programmablauf](#allgemeiner-programmablauf)
@@ -129,11 +145,13 @@ Für den Fall, dass während des Programmablaufs Fehler auftreten bzw. Fehler im
    - Sensor / Aktor nicht angebunden siehe oben.
 - ERR-Attributes:
  - Zeigt alle Blöcke an, welche Fehler in deren Attributen aufweisen
-    - Mögliche Fehler:
-      - Kein Attribut "KENNZEICHNUNG": keine Zuweisung zu Unterverteiler möglich. Element wird nicht verkabelt und nicht gezeichnet.
-      - Ungültiger Pfad in "KENNZEICHNUNG": Eingegebenes Attribut in Kennzeichnung entspricht nicht dem normalen Muster. Element wird nicht verkabelt und nicht gezeichnet.
+  - Mögliche Fehler:
+    - Kein Attribut "KENNZEICHNUNG": keine Zuweisung zu Unterverteiler möglich. Element wird nicht verkabelt und nicht gezeichnet.
+    - Ungültiger Pfad in "KENNZEICHNUNG": Eingegebenes Attribut in Kennzeichnung entspricht nicht dem normalen Muster. Element wird nicht verkabelt und nicht gezeichnet.

-## Anpassung des Verhaltens des Programms:
+# Anpassung des Verhaltens des Programms:
+
+## Verwendete Konfigurationsdateien

 Zum aktuellen Zeitpunkt verwendet bzw. berücksichtigt das Programm **drei** Konfigurationsdateien (Dateiendung .cfg). Diese steuern das verhalten des Programms und **können vom Nutzer bei Bedarf geändert** werden bzw. **müssen vom Nutzer im Falle von betrieblichen Ändeurngen aktualisiert werden** (z.B Änderung von Sachnummern), um die Funktion des Programms zu gewährleisten. In der folgenden Tabelle sind die Aufgaben bzw. inhalte der einzelnen Konfigurationsdateien aufgezeigt und in den darauffolgenden Abschnitten der jeweilige Aufbau und besonderheiten erläutert.

@@ -144,13 +162,177 @@ Zum aktuellen Zeitpunkt verwendet bzw. berücksichtigt das Programm **drei** Kon
 | kabel.cfg     | SIVAS-Nummern für die einzelnen längenabhängigen Kabel der jeweiligen Kabelkennzeichnung<br>Bezeichner für die jeweilige SIVAS-Nummer                                                                                                           |
 |               |                                                                                                                                                                                                                                                 |

+## Zusammenfassung und Struktur der Konfigurationsdateien
+
+Nachfolgende Aufzählung zeigt zeigt den Aufbau und Zweck der `.cfg`-Dateien für das Routing-Tool. Jeder Abschnitt ist dokumentiert mit:
+
+- Konfigurations-Block (Abschnittsname)
+- Beschreibung der Funktion
+- Beispielhafte Einträge
+
 ### allgemein.cfg

-Nachfolgende Aufzählung zeigt die jeweiligen Blöcke der Konfigurationsdatei und dort einzutragene Informationen:
- h
+Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranzen.
+
+#### `[GetPos-Layer_Racks]`
+**Was?** Layernamen, in denen Kabelpritschen (Racks) enthalten sind.
+
+| Layername (Beispiel)                    |
+|----------------------------------------|
+| PRITSCHE_200-60_OMNIFLO                |
+| 0-0_ILS_Pritsche_200-60_Inbound        |
+| 0-0_Omniflo_Pritsche_200-60_AMR        |
+
+---
+
+#### `[GetPos-Layer_Distributors]`
+**Was?** Layernamen, die Unterverteiler beinhalten.
+
+| Layername (Beispiel)              |
+|----------------------------------|
+| 0-0_ILS_UNTERVERTEILER           |
+| UNTERVERTEILER                   |
+
+---
+
+#### `[GetPos-Layer_Tunnel]`
+**Was?** Layernamen für Tunnel, oft identisch mit Distributor-Markern.
+
+| Layername (Beispiel)         |
+|-----------------------------|
+| Busverteiler-Kennzeichnung |
+
+---
+
+#### `[GetPos-Layer_Equipment]`
+**Was?** Layernamen von Sensoren, Motoren, IOs etc.
+
+| Layername (Beispiel)          |
+|------------------------------|
+| 0-0_ILS_MOTOR                |
+| MOTOR                        |
+| REALE_POSITION_IO            |
+
+---
+
+#### `[GetPos-Geom-Sensor]`
+**Was?** Geometrische Maße von Sensor-Markern zur Mittelpunktsberechnung.
+
+| Attribut | Wert (Beispiel) |
+|----------|-----------------|
+| Breite   | 80              |
+| Hoehe    | 90              |
+
+---
+
+#### `[Racks]`
+**Was?** Maximale Distanz (Toleranz) zwischen benachbarten Racks zum "Snappen".
+
+| Attribut         | Wert (Beispiel) |
+|------------------|-----------------|
+| SnapTolerances   | 200             |
+
+---
+
+#### `[Sensoren]`
+**Was?** Maximale Distanz zwischen Sensoren/Motoren und Racks für Verknüpfung.
+
+| Attribut             | Wert (Beispiel) |
+|----------------------|-----------------|
+| ConnectionTolerances | 3000            |
+
+---
+
 ### BMK.cfg
+
+Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing berücksichtigt werden und welche **Kabeltypen** zugewiesen sind.
+
+#### `[Routing-Include]`
+**Was?** BMK-Kürzel, die beim Routing **berücksichtigt** werden.
+
+| Kürzel | Bedeutung / Beispiel |
+|--------|----------------------|
+| MA     | Motoren              |
+| QM     | Ventile              |
+| BX     | Scanner              |
+
+---
+
+#### `[Routing-Ignore]`
+**Was?** BMKs, die ignoriert werden (z.B. Schaltschrank-Innenleben).
+
+| Kürzel | Beispielkomponente         |
+|--------|----------------------------|
+| FC     | Frequenzumrichter          |
+| QA     | Sicherungen / Schütze      |
+
+---
+
+#### `[Cable-Mapping]`
+**Was?** Verknüpfung von BMKs zu Kabelgruppen (aus `kabel.cfg`).
+
+| BMK         | Zugewiesene Kabelgruppe(n)     |
+|-------------|--------------------------------|
+| MA          | MA                             |
+| MB          | WD_Q                           |
+| BX          | WF_B, WD_I                     |
+| BG-829422026| WD_I-829422026                |
+
+---
+
+#### `[Length-Adjustments]`
+**Was?** Korrektur von Kabellängen (z.B. vorkonfektionierte Sensorleitungen).
+
+| BMK | Abzuziehende Länge (m) |
+|-----|------------------------|
+| BX  | 4                      |
+
+---
+
 ### kabel.cfg

+Diese Datei enthält die **SIVAS-Nummern je Kabellänge und -typ**, sowie die **Bezeichnungen** der SIVAS-Nummern.
+
+#### Kabelgruppen (Beispiel: `[WD_Q]`, `[WD_I]`, `[WF_B]`)
+**Was?** Zuordnung von Kabellängen zu SIVAS-Sachnummern.
+
+| Länge (m) | SIVAS-Nr.  | Beispielgruppe |
+|-----------|------------|----------------|
+| 1.0       | 722001300  | WD_Q (Ventile) |
+| 2.5       | 722001338  | WD_I (Sensoren)|
+| 5.0       | 726001045  | WF_B (Scanner) |
+
+---
+
+#### Sensorspezifische Gruppen
+**Was?** Besondere Kabellisten für spezifische Sensor-Artikelnummern.
+
+| Gruppe              | Länge (m) | SIVAS-Nr.   |
+|---------------------|-----------|-------------|
+| WD_I-829422026      | 5.0       | 722001353   |
+| WD_I-720002003      | 10.0      | 722001354   |
+
+---
+
+#### `[Sivasnummern]`
+**Was?** Menschlich lesbare Bezeichnungen der SIVAS-Nummern.
+
+| SIVAS-Nr. | Bezeichnung                      |
+|-----------|----------------------------------|
+| 722001303 | M12 St-0°/ M8 Bu-0° 5m           |
+| 726001041 | Patchkabel 2xRJ45 1,0m           |
+| 725000015 | 4G1,5mm², Steuerleitung           |
+
+---
+
+**Hinweis:**  
+Die Einträge in den `.cfg`-Dateien müssen **laufend gepflegt** werden, wenn sich:
+- Layernamen in CAD-Dateien ändern
+- Neue BMK-Kürzel eingeführt werden
+- Neue SIVAS-Artikel hinzukommen
+
+Nur so kann eine korrekte automatische Kabelberechnung und Zuordnung gewährleistet werden.
+
 ## Detaillierte Informationen und Programmablauf

 ### Zweck des Programms