========================================================
  M1730 ANALOG-ZEIGERINSTRUMENT-STEUERUNG — KURZANLEITUNG
========================================================
(Messwerke und Vorwiderstände sind bereits eingebaut.)

ERSTE WLAN-EINRICHTUNG
  - Gerät einschalten (USB oder 5-V-Netzteil).
  - Am Handy/Laptop das WLAN mit dem Namen "M1730" auswählen.
  - Die Einrichtungsseite öffnet sich automatisch (Captive Portal).
  - Eigenes WLAN auswählen und dessen Passwort eingeben.
  - Optional einen Gerätenamen (Hostname) festlegen (Standard: m1730).
  - Auf Speichern tippen. Das Gerät verbindet sich und startet neu.

KONFIGURATIONSSEITE ÖFFNEN
  - Im Browser aufrufen:  http://m1730.local  (oder den gewählten
    Hostnamen).
  - Falls .local nicht auflöst, die beim Start im seriellen Monitor
    angezeigte IP-Adresse verwenden: http://<IP>
  - Das Info-Feld oben zeigt aktuellen Hostnamen und IP-Adresse.

MESSWERK KONFIGURIEREN
  - Über das Auswahlfeld "Meters" die Anzahl der Messwerke
    festlegen (1-10).
  - Für jedes Messwerk (als Reiter dargestellt, wenn mehr als eins):
      * Pin      - GPIO-Pin, an dem das Messwerk hängt (bereits gesetzt)
      * Name     - Bezeichnung in der Oberfläche und in Home Assistant
      * Unit     - optional (z. B. W, A, °C)
      * Min/Max  - realer Messbereich (z. B. 0-50 A)
      * Max Duty - Kalibrierung für den Vollausschlag (%)
      * Output   - Live-Schieberegler, bewegt den Zeiger sofort
  - Auf Speichern tippen, um alle Einstellungen zu sichern
    (bleiben nach Neustart erhalten).

VOLLAUSSCHLAG KALIBRIEREN (Max Duty)
  - Den Output-Schieberegler auf 100 % ziehen.
  - "Max Duty" langsam erhöhen, bis der Zeiger gerade das Ende
    der Skala erreicht. Nicht überschreiten. Speichern.

ZEIGER BEWEGEN
  - Weboberfläche: den Output-Schieberegler ziehen (0-100 %).
  - Über MQTT/Home Assistant gesendete Werte verwenden den realen
    Min-Max-Bereich (z. B. 25 an ein 0-50-Messwerk = halber
    Ausschlag).

HTTP-STEUERUNG (DIREKTE URL)
  - Einen Zeiger per GET-Anfrage aus Browser oder Skript bewegen:
        http://m1730.local/set?i=<messwerk>&v=<wert>
      * i = Index des Messwerks, beginnend bei 0 (erstes = 0)
      * v = Wert 0-100 (Prozent des Vollausschlags)
  - Beispiel: http://m1730.local/set?i=0&v=75  -> Messwerk 0 auf 75 %.
  - Wirkt sofort, wird gespeichert und an MQTT veröffentlicht.
  - Antwort: 200 OK bei Erfolg, 400 bei ungültiger Eingabe.

HOME ASSISTANT (MQTT)
  - Auf der Konfigurationsseite den Abschnitt MQTT öffnen.
  - Aktivieren, dann Broker-Host, Port (1883), Benutzer, Passwort
    und Präfix (Standard: m1730) eingeben. Speichern.
  - Jedes Messwerk erscheint automatisch in Home Assistant als
    Number-Entität, gruppiert unter einem Gerät (dem Hostnamen).

SICHERHEIT (OPTIONALES PASSWORT)
  - Im Abschnitt Security "Require password" aktivieren und ein
    Passwort setzen. Der Benutzername ist immer: admin
  - Das Passwortfeld leer lassen, um das bestehende beizubehalten.

NEUSTART
  - Schaltfläche "Reset Device" = einfacher Neustart (alle
    Einstellungen bleiben erhalten).

WERKSRESET (bei Aussperrung oder Fehlkonfiguration)
  - Gerät 5-mal schnell aus- und einschalten (oder EN drücken),
    jeweils innerhalb weniger Sekunden, bevor der Start abgeschlossen ist.
      * 5x  = löscht Einstellungen, BEHÄLT aber Pins + Kalibrierung
      * 10x = löscht alles, einschließlich gespeichertem WLAN
  - Alle Messwerke fahren 0 -> Voll -> 0 zur Bestätigung des Resets.
  - Nach einem 10x-Reset die "ERSTE WLAN-EINRICHTUNG" oben
    erneut durchführen.

HINWEISE
  - Einstellungen werden im Gerät gespeichert und überstehen
    einen Stromausfall.
  - Zeigt ein Messwerk unerwartet null an, den Pin prüfen und
    sicherstellen, dass Max Duty größer als 0 ist.
========================================================