docs(kabelueberwachung): vollständige Endanwender-Dokumentation hinzugefügt

- Reiterstruktur (KUE Einstellung, TDR Einstellung, Knotenpunkte) dokumentiert
- Alarmtypen und Statusanzeigen erklärt
- Schleifen- und TDR-Messkurven detailliert beschrieben
- manuelle Messung per Icon (Kreispfeil) erklärt
- Dropdown-Steuerung für Zeitintervall und Messgröße ergänzt
- Markdown strukturiert und Docusaurus-kompatibel formatiert
This commit is contained in:
Ismail Ali
2025-05-04 13:14:37 +02:00
parent dedd8cb782
commit 9818e6a232
2 changed files with 137 additions and 26 deletions

View File

@@ -6,5 +6,5 @@
2: Patch oder Hotfix (Bugfixes oder kleine Änderungen).
*/
const webVersion = "1.6.342";
const webVersion = "1.6.343";
export default webVersion;

View File

@@ -1,32 +1,143 @@
# 🏠 Kabelüberwachung
Die Seite "Kabelüberwachung" zeigt bis zu 32 Slots in vier Gruppen. Sie dient zur Live-Überwachung der Kabelsysteme und bietet Zugriff auf alle Messwerte und Einstellungen.
## ⚙️ Einstellungen pro Slot
- **Kabelbezeichnung**: Freier Name für das zu überwachende Kabel
- **Isolationsgrenzwert (MOhm)**: Wert, ab dem ein Alarm ausgelöst wird
- **Schleifengrenzwert (kOhm)**: Schleifenwiderstand für Alarmdefinition
- **Filterzeit (s)**: Zeitverzögerung vor Alarmanzeige
- **Loggerintervall**: Messdaten-Speicherintervall (z. B. 5 Minuten)
- **Display einschalten**: Aktiviert die lokale Anzeige am Gerät
## ⚡ Alarme
- **Erdschluss erkannt**: Isolation unter Grenzwert
- **Aderbruch vermutet**: Schleifenmessung kritisch
## 🌐 Anzeige
- Statusanzeige in Farbe (grün, gelb, rot)
- Tooltip mit Live-Werten beim Überfahren
**Hinweis:** Alle Änderungen müssen über den "Speichern"-Button bestätigt werden, um das System zu aktualisieren.
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.
---
## 🔗 Weitere Funktionen
## ⚙️ Einstellungen pro Slot
👉 Für Details zur Entfernungsmessung siehe [📊 TDR-Einstellungen](tdr-einstellungen.md)
Beim Klick auf das ⚙️ Zahnrad-Symbol oben rechts im Slot wird ein **Modal** geöffnet.
Dieses enthält drei Reiter:
Die TDR-Funktion ist pro Slot aktivierbar und zeigt eine separate Kurvenanzeige mit Referenzvergleich.
### 🛠️ 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.
---
## 📈 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.