docs Verzeichnis statt docusaurus

This commit is contained in:
ISA
2025-06-13 08:14:58 +02:00
parent 0fdd7b1495
commit 17a158e831
47 changed files with 1 additions and 17521 deletions

147
docs/kabelueberwachung.md Normal file
View File

@@ -0,0 +1,147 @@
# 🏠 Kabelüberwachung
Die Seite **Kabelüberwachung** zeigt bis zu **32 Steckplätze (Slots)**, gruppiert in **vier Racks**, zur Live-Überwachung aller angeschlossenen Kabelmodule. Jeder Slot visualisiert den aktuellen Betriebsstatus, Alarmzustände, Messwerte und erlaubt den direkten Zugriff auf Konfiguration und Messkurven.
---
![Kabelüberwachung Übersicht](/img/KabelueberwaachungEinstellungModal.png)
## ⚙️ Einstellungen pro Slot
Beim Klick auf das ⚙️ Zahnrad-Symbol oben rechts im Slot wird ein **Modal** geöffnet.
Dieses enthält drei Reiter:
### 🛠️ KUE Einstellung
| Feld | Beschreibung |
| ----------------------- | ------------------------------------------------------------- |
| **Kabelbezeichnung** | Freitextname für das überwachte Kabel |
| **Isolationsgrenzwert** | Schwellenwert (in MOhm) für Isolationsalarm |
| **Schleifengrenzwert** | Schwellenwert (in kOhm) für Schleifenwiderstand |
| **Filterzeit** | Zeitverzögerung (in Sekunden), bevor ein Alarm ausgelöst wird |
| **Loggerintervall** | Intervall zur Datenspeicherung (z.B. alle 5 Minuten) |
| **Display einschalten** | Aktiviert das lokale Display am Slot-Gerät (z.B. KÜ705-FO) |
---
### 📶 TDR-Einstellungen
Die **TDR-Funktion** (Time Domain Reflectometry) dient der **Lokalisation von Kabelfehlern**.
Sie ist **pro Slot aktivierbar** und bietet folgende Einstellungen:
| Einstellung | Beschreibung |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **TDR-Funktion** | Aktiviert/deaktiviert **sofort** die TDR-Messung. Ein Bestätigungsdialog zeigt den Status (z.B. "TDR deaktiviert"). |
| **TDR-Dämpfung (dB)** | Signalabschwächung zur Anpassung an Kabeltyp und -länge |
| **Geschwindigkeit (m/μs)** | Wellenausbreitungsgeschwindigkeit im Kabelmaterial (z.B. 112 m/μs) |
| **Trigger** | Empfindlichkeitsschwelle zur Fehlerortung (je kleiner, desto empfindlicher) |
**Bedienung:**
- **TDR-Funktion** ist ein Toggle Änderungen wirken sofort.
- **Dämpfung, Geschwindigkeit, Trigger** wirken **erst nach Klick** auf **„Einstellungen senden“**.
- Die TDR-Messung kann später als Kurvendiagramm angezeigt werden (siehe unten).
---
### 🔁 Knotenpunkte-Anzeige
Der Reiter **Knotenpunkte** zeigt die konfigurierte Struktur eines Steckplatzes:
| Feld | Beschreibung |
| -------------- | -------------------------------------------------- |
| **Knoten** | Bezeichnung der Leitungsteilabschnitte (Line 110) |
| **Verbindung** | Logische Verbindung (z.B. Link 12) |
| **Länge** | Physikalische Länge der Kabelverbindung (in Meter) |
> Diese Daten sind **nur lesbar** (Read-Only) und dienen zur Orientierung. Änderungen erfolgen systemseitig oder über das Backend.
---
## ⚡ Alarmanzeige und Fehlererkennung
Jeder Slot zeigt über zwei LEDs den Betriebs- und Alarmstatus an:
- 🟢 **Grün** Betrieb OK
- 🟡 **Gelb** Warnung (z.B. Grenzwert erreicht)
- 🔴 **Rot** Aktiver Alarm
### Mögliche Alarmtypen:
| Alarmtyp | Beschreibung |
| --------------- | ---------------------------------------------------------- |
| **Aderbruch** | Schleifenwiderstand über Grenzwert Leitungsunterbrechung |
| **Erdschluss** | Isolationswert unter Grenzwert möglicher Erdfehler |
| **Kurzschluss** | Ungewöhnlich niedriger Widerstand |
| **TDR-Alarm** | Auffällige Reflexion im Leitungssystem |
| **Überlauf** | Datenfehler oder Kommunikationsproblem |
> Alarme sind **slotbezogen**, unterscheiden **kommend/gehend** und bleiben bis zur Quittierung oder Rückkehr in den Normalzustand sichtbar.
---
## 🔄 Messungssteuerung (manuell)
Im unteren Bereich jedes Slots befindet sich ein **Kreispfeil-Icon** 🔄 (Reload-Symbol):
- Dieses startet **je nach aktivem Tab (Schleife oder TDR)** die entsprechende Messung manuell.
- Die Buttons **„Schleife“** oder **„TDR“** oberhalb steuern, welcher Modus aktiv ist (hellblau markiert).
- Die aktuelle Messung wird nach dem Klick auf **„Messkurve“** als Verlauf geöffnet.
![Kabelüberwachung Übersicht](/img/SchleifenmessungTDRstarten.png)
---
## 📈 Messkurvenanzeige: Schleife und TDR
### Tab-Auswahl
- **Schleife** (Standard) zeigt den Schleifenwiderstand in `kOhm`
- **TDR** zeigt die TDR-Reflexion mit möglicher Fehlerstelle
- Aktiver Modus = **hellblau hinterlegt**
---
### 📊 Schleifen- oder Isolationsmessung
Beim Klick auf **„Messkurve“** wird ein detailliertes Diagramm geöffnet.
#### Steuerungsmöglichkeiten:
| Einstellung | Beschreibung |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Von/Bis** | Zeitraum der Messung |
| **Werteauflösung** | Auswahl zwischen **alle Werte**, **stündlich** und **täglich** |
| **Messgröße** | Auswahl zwischen **Schleifenwiderstand (kOhm)** und **Isolationswiderstand (MOhm)** |
| **Daten laden** | Erst nach Klick werden die Messkurven mit ausgewählten Parametern angezeigt |
> Tooltips zeigen Min/Max/Durchschnittswerte pro Zeitintervall.
---
### 📉 TDR-Messung
Wenn der Tab **TDR** aktiv ist und auf **„Messkurve“** geklickt wurde, wird eine TDR-Kurve dargestellt.
#### Darstellung:
- **TDR-Kurve** (blau) zeigt reflektierte Signale im Kabel
- **Referenzkurve** (schwarz) dient dem Vergleich mit einer gespeicherten Referenz
- **Fehlerstelle** (rot) wird automatisch markiert
#### Funktionen:
- Dropdown zur Auswahl der letzten Messungen inkl. Zeitstempel und Fehlerposition
- Button **„TDR-Kurve als Referenz speichern“** ermöglicht Vergleich zukünftiger Messungen
- Achsen:
- **X-Achse** = Entfernung in Metern
- **Y-Achse** = Signalpegel
---
## 📌 Zusammenfassung
- Die Kabelüberwachung erlaubt präzise Kontrolle jedes Slots.
- Einstellungen, manuelle Messung und Fehlerdiagnose erfolgen direkt über die grafische UI.
- Alle Aktionen (Alarme, Konfiguration, Messungen) sind **slotgenau**.
- Die Darstellung ist intuitiv, modular aufgebaut und auch ohne Spezialwissen nutzbar.