From 9818e6a232f12c0e4e046944d172507ba7d46eab Mon Sep 17 00:00:00 2001 From: Ismail Ali Date: Sun, 4 May 2025 13:14:37 +0200 Subject: [PATCH] =?UTF-8?q?docs(kabelueberwachung):=20vollst=C3=A4ndige=20?= =?UTF-8?q?Endanwender-Dokumentation=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- config/webVersion.ts | 2 +- docusaurus/docs/kabelueberwachung.md | 161 ++++++++++++++++++++++----- 2 files changed, 137 insertions(+), 26 deletions(-) diff --git a/config/webVersion.ts b/config/webVersion.ts index 07f4ae4..9b05458 100644 --- a/config/webVersion.ts +++ b/config/webVersion.ts @@ -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; diff --git a/docusaurus/docs/kabelueberwachung.md b/docusaurus/docs/kabelueberwachung.md index 21ce965..7011be2 100644 --- a/docusaurus/docs/kabelueberwachung.md +++ b/docusaurus/docs/kabelueberwachung.md @@ -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 1–10) | +| **Verbindung** | Logische Verbindung (z. B. Link 1–2) | +| **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.