m.stangl/kabellaengen
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Anpassung + Kurzform

Browse Source
This commit is contained in:
lertlmaier
2025-07-07 15:22:31 +02:00
parent ef9a07c40e
commit 8f5e99632e
2 changed files with 551 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/Anwenderdoku.md
+89 -41
View File
@@ -6,25 +6,13 @@
- [Standardmäßige Ausgabe des Programms](#standardmäßige-ausgabe-des-programms)
- [.dxf-Datei: *dxfdatei*\_cables.dxf](#dxf-datei-dxfdatei_cablesdxf)
- [Excel-Datei: *dxfdatei*\_cables.xlsx](#excel-datei-dxfdatei_cablesxlsx)
- [Excel-Datei: *dxfdatei*\_BOM.xlsx](#excel-datei-dxfdatei_bomxlsx)
- [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)
- [bezeichner.cfg](#bezeichnercfg)
- [Anwenderhinweise zur Layouterstellung](#anwenderhinweise-zur-layouterstellung)
- [Verwendung der Layer](#verwendung-der-layer)
@@ -95,9 +83,13 @@ Drücken sie eine beliebige Taste . . .
Das Drücken einer beliebigen Taste beendet das Programm und die Ausgabe kann verwendet werden.
### :exclamation: Hinweis :exclamation: <!-- omit in toc -->
Der Dateiname darf **keine Leerzeichen oder Sonderzeichen** enthalten.
Verwende z. B. projekt_123.dxf statt mein projekt #1.dxf.
## Standardmäßige Ausgabe des Programms
In den Ordner auf dem Desktop in dem das Kabeltool liegt werden nach Beendigung der Berechnungen die Ausgabedateien abgelegt. Standardmäßig sind dies fünf Dateien, wovon letztlich drei für den Anwender bestimmt sind. In der nachfolgenden Liste steht der name *dxfdatei* stellvertretend für die eingegebene Datei des Benutzers.
In den Ordner auf dem Desktop in dem das Kabeltool liegt werden nach Beendigung der Berechnungen die Ausgabedateien abgelegt. Standardmäßig sind dies vier Dateien, wovon letztlich zwei für den Anwender bestimmt sind. In der nachfolgenden Liste steht der name *dxfdatei* stellvertretend für die eingegebene Datei des Benutzers.
| Dateiname | Details |
|---------------------------|---------------------------------------------------------------------------------------------------|
@@ -112,9 +104,10 @@ Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.dxf` e
### Excel-Datei: *dxfdatei*_cables.xlsx
Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.xlsx` enthält im fehlerfreien Fall zwei Worksheets:
Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.xlsx` enthält im fehlerfreien Fall drei Worksheets:
1. **Length by ID**: zeigt die Kabel-ID, die tatsächliche Länge des Kabels, die Kabel-Atikelnummer und zuletzt den zugeörigen (aber gekürzten Bezeicher) für das Kabel:
**Length by ID**:
zeigt die Kabel-ID, die tatsächliche Länge des Kabels, die Kabel-Atikelnummer und zuletzt den zugeörigen (aber gekürzten Bezeicher) für das Kabel:
> | Cable-ID | True Length (m) | Cable-ArtNr | Cable-Name (short) |
> |-----------------|------------------|-------------|----------------------------------|
@@ -124,7 +117,9 @@ Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.xlsx`
> | UC0101-BG3260 | 27,4471 | 722001339 | M12 St-0°/ M12 Bu-90° 30m |
> | UH01-MA0062 | 10,3015 | 725000015 | 4G1,5mm², Steuerleitung |
2. **Cables SIVAS**: zeigt die SIVAS-Nummer der Kabel und daneben die benötigte Anzahl an Kabeln in diesem Layout bzw. (für den Fall von Kabeln als Meterware, z.b. bei Motoren) die kummulierte benötigte Länge:
**Cables SIVAS**:
zeigt die SIVAS-Nummer der Kabel und daneben die benötigte Anzahl an Kabeln in diesem Layout bzw. (für den Fall von Kabeln als Meterware, z.b. bei Motoren) die kummulierte benötigte Länge:
> | Cable-ArtNr | Amount (pcs) | Cumm. Length (m) |
> |-------------|--------------|------------------|
@@ -134,6 +129,11 @@ Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.xlsx`
> | 722001339 | 1 | |
> | 725000015 | | 11 |
**Cables SIVAS**:
zeigt die Längen der einzelnen Kabeltrassen-Segmente anhand deren Nummerierung innerhalb der dxf Datei. Diese Ausgabe dient der Überprüfung der benötigten Gesamtlänge der Kabeltrassen.
#### Erweiterte Ausgabe im Fehlerfall: <!-- omit in toc -->
Für den Fall, dass während des Programmablaufs Fehler auftreten bzw. Fehler im Layout erkannt werden, werden diese in weitere Worksheets geschrieben. Diese Worksheets tragen das Präfix *ERR*
- ERR-Equipment-Connection:
@@ -153,18 +153,50 @@ Für den Fall, dass während des Programmablaufs Fehler auftreten bzw. Fehler im
- 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.
### Excel-Datei: *dxfdatei*_BOM.xlsx
Diese Datei enthält eine vollständige **Stückliste (BOM)** aller im Layout erkannten Komponenten – also sowohl aller Sensoren/Aktoren als auch der Kabel, die zum Einsatz kommen. Die Datei besteht aus zwei Tabellenblättern:
#### 1. BOM (Gesamtstückliste): <!-- omit in toc -->
Zeigt für jede verwendete Artikelnummer den Namen laut bezeichner.cfg, die Gesamtanzahl bzw. Gesamtlänge und unterscheidet dabei automatisch zwischen Sensoren und Kabeln.
> | Art.-Number | Amount (pcs) | Length (m) | Name (SIVAS) |
> |-------------|--------------|------------|----------------------------------------|
> | 722001330 | 3 | | M12 Sensorleitung 1 m, gewinkelt |
> | 725000015 | | 24 | Steuerleitung MA, 4G1,5mm² |
> | 839220147 | 5 | | Reflexionslichttaster XYZ |
Sensoren (bzw. andere Komponenten mit Artikelnr) werden über ihre Artikelnummer gezählt. Kabel werden – sofern Meterware (z.B. Steuerleitungen für Motoren) – über die summierte Länge dargestellt, andernfalls über Stückzahl.
#### 2. BOM by UV (Stückliste pro Unterverteiler): <!-- omit in toc -->
Dieses Worksheet gibt für jede Artikelnummer aus, **welchem Unterverteiler (UV)** sie zugeordnet ist und wie viele davon jeweils dorthin gehören. Kabelmeter werden wie im anderen Arbeitsblatt getrennt ausgewiesen.
> | UV | Art.-Number | Amount (pcs) | Length (m) | Name (SIVAS) |
> |--------|-------------|--------------|------------|----------------------------------|
> | UH01 | 722001330 | 1 | | M12 Sensorleitung 1 m, gewinkelt |
> | UC01 | 722001330 | 2 | | M12 Sensorleitung 1 m, gewinkelt |
> | UC01 | 725000015 | | 12 | Steuerleitung MA, 4G1,5mm² |
Hinweis: Diese Ansicht ist besonders nützlich zur **vorbereitenden Bestellplanung pro UV**.
# 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.
Zum aktuellen Zeitpunkt verwendet bzw. berücksichtigt das Programm **vier** 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.
| Datei | Inhalt |
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| allgemein.cfg | Layernamen der Kabelpritschen<br>Layenamen der Unterverteiler<br>Layernamen der Tunnel<br>Layernamen der Sensoren / Aktoren<br>Toleranz der Verbindung zw. Sensor und Kabeltrasse<br>Toleranz des "Anpinnens" zweier Kabeltrassen untereinander |
| BMK.cfg | Betriebsmittelkennzeichnung der Elemente, die im Routing berücksichtigt bzw. ignoriert werden sollen<br>Zuweisung der Kabelkennzeichnungen zur jeweiligen Betriebsmittelkennzeichnung<br>Längenanpassungen für einzelne Kabelkennzeichnungen |
| kabel.cfg | SIVAS-Nummern für die einzelnen längenabhängigen Kabel der jeweiligen Kabelkennzeichnung<br>Bezeichner für die jeweilige SIVAS-Nummer |
| | |
| `allgemein.cfg` | Layernamen der Kabelpritschen<br>Layenamen der Unterverteiler<br>Layernamen der Tunnel<br>Layernamen der Sensoren / Aktoren<br>Toleranz der Verbindung zw. Sensor und Kabeltrasse<br>Toleranz des "Anpinnens" zweier Kabeltrassen untereinander |
| `BMK.cfg` | Betriebsmittelkennzeichnung der Elemente, die im Routing berücksichtigt bzw. ignoriert werden sollen<br>Zuweisung der Kabelkennzeichnungen zur jeweiligen Betriebsmittelkennzeichnung<br>Längenanpassungen für einzelne Kabelkennzeichnungen |
| `kabel.cfg` | SIVAS-Nummern für die einzelnen längenabhängigen Kabel der jeweiligen Kabelkennzeichnung |
| `bezeichner.cfg`| Speicherung der Bezeichner zu den SIVAS-Nummern sowie automatische Pflege fehlender Artikelnummern |
### :exclamation: Hinweis :exclamation: <!-- omit in toc -->
**Änderungen an den .cfg-Dateien werden erst beim nächsten Programmlauf wirksam.
Stelle sicher, dass die Datei korrekt gespeichert wurde und keine doppelten Abschnitte enthält.**
## Zusammenfassung und Struktur der Konfigurationsdateien
@@ -178,7 +210,7 @@ Nachfolgende Aufzählung zeigt zeigt den Aufbau und Zweck der `.cfg`-Dateien fü
Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranzen.
#### `[GetPos-Layer_Racks]`
#### `[GetPos-Layer_Racks]` <!-- omit in toc -->
**Was?** Layernamen, in denen Kabelpritschen (Racks) enthalten sind.
| Layername (Beispiel) |
@@ -189,7 +221,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[GetPos-Layer_Distributors]`
#### `[GetPos-Layer_Distributors]` <!-- omit in toc -->
**Was?** Layernamen, die Unterverteiler beinhalten.
| Layername (Beispiel) |
@@ -199,8 +231,8 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[GetPos-Layer_Tunnel]`
**Was?** Layernamen für Tunnel, oft identisch mit Distributor-Markern.
#### `[GetPos-Layer_Tunnel]` <!-- omit in toc -->
**Was?** Layernamen für Tunnel.
| Layername (Beispiel) |
|-----------------------------|
@@ -208,7 +240,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[GetPos-Layer_Equipment]`
#### `[GetPos-Layer_Equipment]` <!-- omit in toc -->
**Was?** Layernamen von Sensoren, Motoren, IOs etc.
| Layername (Beispiel) |
@@ -219,7 +251,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[GetPos-Geom-Sensor]`
#### `[GetPos-Geom-Sensor]` <!-- omit in toc -->
**Was?** Geometrische Maße von Sensor-Markern zur Mittelpunktsberechnung.
| Attribut | Wert (Beispiel) |
@@ -229,7 +261,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[Racks]`
#### `[Racks]` <!-- omit in toc -->
**Was?** Maximale Distanz (Toleranz) zwischen benachbarten Racks zum "Snappen".
| Attribut | Wert (Beispiel) |
@@ -238,7 +270,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
---
#### `[Sensoren]`
#### `[Sensoren]` <!-- omit in toc -->
**Was?** Maximale Distanz zwischen Sensoren/Motoren und Racks für Verknüpfung.
| Attribut | Wert (Beispiel) |
@@ -251,7 +283,7 @@ Diese Datei steuert das Einlesen von Layern und definiert geometrische Toleranze
Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing berücksichtigt werden und welche **Kabeltypen** zugewiesen sind.
#### `[Routing-Include]`
#### `[Routing-Include]` <!-- omit in toc -->
**Was?** BMK-Kürzel, die beim Routing **berücksichtigt** werden.
| Kürzel | Bedeutung / Beispiel |
@@ -262,7 +294,7 @@ Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing ber
---
#### `[Routing-Ignore]`
#### `[Routing-Ignore]` <!-- omit in toc -->
**Was?** BMKs, die ignoriert werden (z.B. Schaltschrank-Innenleben).
| Kürzel | Beispielkomponente |
@@ -272,7 +304,7 @@ Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing ber
---
#### `[Cable-Mapping]`
#### `[Cable-Mapping]` <!-- omit in toc -->
**Was?** Verknüpfung von BMKs zu Kabelgruppen (aus `kabel.cfg`).
| BMK | Zugewiesene Kabelgruppe(n) |
@@ -284,7 +316,7 @@ Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing ber
---
#### `[Length-Adjustments]`
#### `[Length-Adjustments]` <!-- omit in toc -->
**Was?** Korrektur von Kabellängen (z.B. vorkonfektionierte Sensorleitungen).
| BMK | Abzuziehende Länge (m) |
@@ -297,7 +329,7 @@ Diese Datei steuert, **welche Betriebsmittelkennzeichen (BMK)** beim Routing ber
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]`)
#### Kabelgruppen (Beispiel: `[WD_Q]`, `[WD_I]`, `[WF_B]`) <!-- omit in toc -->
**Was?** Zuordnung von Kabellängen zu SIVAS-Sachnummern.
| Länge (m) | SIVAS-Nr. | Beispielgruppe |
@@ -308,7 +340,7 @@ Diese Datei enthält die **SIVAS-Nummern je Kabellänge und -typ**, sowie die **
---
#### Sensorspezifische Gruppen
#### Sensorspezifische Gruppen <!-- omit in toc -->
**Was?** Besondere Kabellisten für spezifische Sensor-Artikelnummern.
| Gruppe | Länge (m) | SIVAS-Nr. |
@@ -320,20 +352,36 @@ Diese Datei enthält die **SIVAS-Nummern je Kabellänge und -typ**, sowie die **
### bezeichner.cfg
Hier muss noch kurz gesagt werden, was in dieser steht. Wie das mit missing geht, SIVAS Abfrage usw....
Diese Datei enthält Bezeichner zu den verwendeten SIVAS-Artikelnummern. Sie beinhaltet sowohl die Bezeichner (laut SIVAS) für die Bauteil-Artikelnummern als auch für die Kabel. Die Datei wird im Laufe eines Routing-Prozesses bei Bedarf angepasst und mittels einer SIVAS-Datenbankabfage (bei bestehender VPN-Verbindung bzw. im lokalen Firmennetz am Standort) erweitert.
#### `[Sivasnummern]` <!-- omit in toc -->
Enthält die bekannten SIVAS-Artikelnummern mit zugehörigen Bezeichnern, z.B.:
| Sivasnummer | Bezeichner |
|-------------|-------------------------------------------------|
| 725000015 | 4G1,5mm², Steuerleitung |
| 722001300 | Verb.-Leitung M12 St-0°/ M8 Bu-0° PUR UL/CSA 1m |
| 722001301 | Verb.-Leitung M12 St-0°/ M8 Bu-0° PUR UL/CSA 2m |
#### `[Missing]` <!-- omit in toc -->
Fehlende Nummern, die im Layout verwendet wurden, aber noch keinen Bezeichner besitzen. Diese werden automatisch per SIVAS-Datenbank ergänzt (sofern erreichbar). Hierzu wird im Kommandofeld eine entsprechende Benachrichtigung angezeigt.
## :exclamation: Hinweis :exclamation: <!-- omit in toc -->
**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.
**Nur so kann eine korrekte automatische Kabelberechnung und Zuordnung gewährleistet werden.**
# Anwenderhinweise zur Layouterstellung
Im nachfolgenden Abschnitt sind die **wichtigsten** Punkte zur Erstellung der Layoutzeichnungen aufgeführt. Die Beachtung dieser Hinweise stellt sicher, dass die automatische Auswertung durch das Programm fehlerfrei und zuverlässig erfolgen kann.
Dieser Abschnitt ist durch die Fachabteilung regelmäßig zu pflegen und analog zu Konfigurationsdateien stets aktuell zu halten.
## :exclamation: Hinweis :exclamation: <!-- omit in toc -->
**Dieser Abschnitt ist durch die Fachabteilung regelmäßig zu pflegen und analog zu Konfigurationsdateien stets aktuell zu halten.**
## Verwendung der Layer
@@ -396,7 +444,7 @@ Dieser Abschnitt ist durch die Fachabteilung regelmäßig zu pflegen und analog
- **Anbindung an Kabeltrassen erfolgt immer zur nächstgelegenen Rack-Geometrie** im definierten Toleranzbereich.
- Wird ein Block zu weit entfernt vom Rack gezeichnet (bzw. `REALE_POSITION` liegt zu weit weg), erfolgt **keine automatische Verbindung**.
- Die maximale Toleranz ist über die Konfiguration (`tol_connect`) steuerbar.
- Die maximale Toleranz ist über die Konfiguration `allgemein.cfg[tol_connect]` steuerbar.
- Es ist daher darauf zu achten, dass Bauteile (bzw. deren reale Positionen) **räumlich korrekt und in sinnvoller Nähe** zu den Kabeltrassen platziert sind.