# 🏠 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 KÜes:

| 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.

---

## ⏳ Messung läuft: Per-Slot Overlay (Schleife, ISO-Abgleich, TDR)

Während aktive Messungen laufen, wird der betroffene Slot gezielt blockiert, ohne die gesamte Seite zu sperren. So können andere Module weiterhin bedient werden.

- Per-Slot Overlay erscheint nur auf dem betroffenen Modul auf der Seite „Kabelüberwachung“.
- Das Overlay zeigt für jede aktive Messart eine Fortschrittsleiste mit Prozentanzeige (ohne Restzeit):
  - Schleifenmessung (RSL, KSX) ≈ 2 Minuten
  - TDR-Messung (KSY) ≈ 30 Sekunden
  - ISO-Abgleich (KSZ) ≈ 10 Minuten
- Die Anzeige aktualisiert sich ca. jede Sekunde.
- Bei mehreren gleichzeitig aktiven Messarten werden mehrere Balken untereinander gezeigt.

Hinweise:

- Auf anderen Seiten (z. B. System) erscheint statt des per-Slot Overlays ein globales Overlay über die gesamte Anwendung. Auf der Seite „Kabelüberwachung“ ist dieses globale Overlay deaktiviert, damit die Bedienung der übrigen Slots möglich bleibt.
- Die Aktivitätsinformationen stammen vom Gerät (KSX/KSY/KSZ Ereignis-Arrays je 32 Slots) und werden zyklisch eingelesen.

---

## 🔄 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.

## 🔗 Weiterführende Bereiche

- [Übersicht / dashboard](uebersicht.md)
- [Digitale Eingänge](digitale-eingaenge.md)
- [Digitale Ausgänge](digitale-ausgaenge.md)
- [Analoge Eingänge](analoge-eingaenge.md)
- [TDR Einstellungen](tdr-einstellungen.md)
- [Meldungen](meldungen.md)
- [System](system.md)
- [Einstellungen](einstellungen.md)
