# Tacho-Anzeige
Widget type: `opendash-widget-hc-kpi-minmax` · Plugin: `@opendash/plugin-highcharts`

### Beschreibung
Das **Tacho-Anzeige Widget** (auch bekannt als Fortschrittsanzeige) dient zur intuitiven Visualisierung von kontinuierlichen Messwerten in Form eines analogen Rundinstruments oder Balkens. Es hilft IoT-Anwendern dabei, aktuelle Verbräuche, Auslastungen oder Füllstände im Verhältnis zu vordefinierten Grenzwerten auf einen Blick visuell zu erfassen.
### Voraussetzungen
* Ein Dashboard mit Administrations- oder Bearbeitungsrechten.
* Mindestens eine aktive IoT-Datenquelle (z. B. eine Maschine oder ein Stromzähler).
* Kontinuierliche numerische Datenpunkte (Zeitreihen / Telemetriedaten), wie beispielsweise Leistung in kW oder Verbrauch in kWh.
---
## 1. Konfiguration und Einrichtung
1. **Einstellungen öffnen**: Klicke oben rechts am gewünschten Widget auf die drei vertikalen Punkte und wähle im Dropdown-Menü den Punkt **Einstellungen** aus.
2. **Datenquelle zuweisen**:
* Klicke im Konfigurationsfenster auf den Reiter **Daten**.
* Klicke in das Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.** und wähle den passenden Messwert (z. B. den Verbrauch einer bestimmten Maschine) aus der Struktur deines IoT-Systems aus.
3. **Darstellungsform festlegen**:
* Wechsle oben in den Reiter **Einstellungen**.
* Wähle unter **Visualisierungsart festlegen** die Option **Messanzeige** (oder alternativ **Blockdiagramm** für eine Balkenanzeige).
4. **Speichern**: Klicke unten rechts auf die Schaltfläche **Speichern**, um die Konfiguration zu übernehmen und das Widget auf deinem Dashboard zu aktualisieren.
---
## 2. Erweiterte Einstellungen & Formatierung
In den Konfigurationsreitern stehen dir verschiedene Optionen zur Verfügung, um die Logik und das Design der Anzeige lückenlos anzupassen. Auch die im ersten Schritt nicht direkt genutzten Felder bieten mächtige Werkzeuge:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Wähle den Zeitraum...** | Dropdown- bzw. Kalenderfeld im Reiter **Daten**. | Bestimmt das Zeitfenster, aus dem die Daten für die Anzeige geladen werden sollen. |
| **Lade Live-Daten** | Kontrollkästchen im Reiter **Daten**. | Aktiviert die sofortige, kontinuierliche Aktualisierung des Zeigers/Fortschritts bei neuen Datenpunkten. |
| **Automatisch Aktualisieren** | Kontrollkästchen unter den *Sonstigen Einstellungen*. | Regelt, ob sich das Widget in festen Intervallen eigenständig neu lädt. |
| **Grenzwerte festlegen** | Schaltfläche/Bereich im Reiter **Einstellungen**. | Erlaubt das Definieren von farbigen Warnzonen (z. B. Gelb/Rot), wenn Schwellenwerte überschritten werden. |
| **Minimalwert manuell festlegen** | Kontrollkästchen mit numerischem Eingabefeld. | Definiert den festen Startpunkt der Tachoskala (wird andernfalls automatisch ermittelt). |
| **Maximalwert manuell festlegen** | Kontrollkästchen mit numerischem Eingabefeld. | Definiert den festen Endpunkt der Tachoskala (wird andernfalls automatisch ermittelt). |
| **Nachkommastellen** | Numerisches Eingabefeld (Standardwert: `2`). | Legt fest, auf wie viele Nachkommastellen der digitale Wert im Zentrum des Tachos gerundet wird. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach der erfolgreichen Konfiguration präsentiert sich das Widget als kreisrunde Fortschrittsanzeige auf deinem Dashboard. Im Zentrum der Anzeige wird der aktuelle Messwert gut lesbar und fett gedruckt mitsamt der physikalischen Einheit (z. B. **46.02 kWh**) dargestellt. Direkt darunter befindet sich ein kleiner grauer Zeitstempel der letzten Übertragung. Ein farbiger Kreisbogen visualisiert den Wert grafisch und wandert dynamisch mit, sobald neue Live-Daten im System registriert werden.
> 💡 **Praxis-Tipp:** Nutze unbedingt die Optionen **Minimalwert** und **Maximalwert manuell festlegen**. Wenn du beispielsweise den Füllstand eines 1000-Liter-Tanks überwachst, setze `0` und `1000`. Dadurch skaliert der Tacho immer exakt im Verhältnis zur tatsächlichen Kapazität und die Anzeige bleibt im Alltag maximal aussagekräftig.