Portierung auf den XIAO ESP32-C3 (MicroPython)

Die Kette laeuft auf dem Geraet gegen den Mock auf dem Mac. Getestet mit
MicroPython 1.28.0 (ESP32_GENERIC_C3): alle Module importieren, Telegrammbau
und Koordinaten-Formatierung sind byte-identisch zum Mac (inkl. Gradzeichen),
Poll-Schleife 22 Abfragen in 20 s ohne Aussetzer, Ausfall und Reconnect
verhalten sich wie vorgesehen. Offen bleibt allein die RS232-Strecke zur
Anzeige -- der Steckbrettaufbau mit MAX3232 fehlt noch.

Gemeinsamer Kern statt zweier Programme:
- displayloop.py: die Poll-Schleife, herausgeloest aus run_display. Mac und
  ESP32 fahren jetzt denselben Ablauf; drumherum liegt nur die Kommandozeile
  (run_display.py) bzw. das WLAN-Setup (run_esp32.py).
- ticks.py: Timeouts fuer beide Plattformen. time.ticks_ms() laeuft nach ~12
  Tagen ueber; das bisherige "jetzt + Timeout" haette eine Warteschleife
  danach tagelang haengen lassen. Jetzt ueber ticks_diff.
- wifi.py, run_esp32.py, wifi_config.py (gitignored, Vorlage dabei), deploy.sh.

Pinbelegung aus dem KiCad-Schaltplan uebernommen, nicht geraten: UART1 mit
TX=GPIO21 (Pad 7/D6) und RX=GPIO20 (Pad 8/D7) ueber den MAX3232, LDR an
GPIO2 (Pad 1/A0). UART0 bleibt die REPL.

LDR-Kennlinie ist auf der Platine umgekehrt: der Teiler lautet
3V3-[2k]-A0-[LDR]-GND, die Spannung faellt also mit steigender Helligkeit --
andersherum als beim MSP430, auf den die Schwellen zugeschnitten sind. Wird
im Code gespiegelt (config.LDR_INVERTED, brightness.raw_to_ldr). Die
Schwellen selbst muessen am realen Aufbau noch nachgemessen werden.

Am Geraet gefundene Fehler, die den Attrappen-Tests entgehen mussten, weil
CPython sie nicht hat:
- MicroPython kennt kein str.ljust (auch kein rjust/center/zfill).
  display._emit_line fuellt von Hand auf.
- NOLINK_LINES hatte 10 Zeichen bei 9 Zeichen Zeilenbreite und erschien als
  "MONTIERUN". Jetzt "KEIN LINK"/"TELESKOP".
Dagegen: TestMicropythonVertraeglichkeit prueft die deployten Dateien statisch
auf solche Methoden und auf modulweites argparse/threading und haelt die
Dateiliste mit deploy.sh synchron; test_display.py prueft die Breite fester
Anzeigetexte.

Weitere Portabilitaet: mount_client nutzt getaddrinfo und eine Sendeschleife
statt sendall (MicroPython laesst dessen Verhalten mit Timeout offen);
argparse in brightness wandert in die Funktion; migra._digits und die
Hex-Ausgabe verlassen sich nicht mehr auf %0*d bzw. bytes.hex(). Beides kann
1.28 zwar doch -- am Geraet nachgeprueft, die Kommentare sagen es jetzt richtig.

Widerspruch in der Dokumentation bereinigt: die Zeichenbreite stand an vier
Stellen als 9 oder 10. Gemessen sind 9; die Erklaerung duerfte sein, dass die
Sperrschrift 7 px pro Zelle braucht (9*7 = 63 von 64 px) und nicht 6, wie es
eine 5x7-Matrix mit 1 px Luecke waere. Nachgeprueft ist das nicht -- dafuer
gibt es jetzt "probe.py pitch", das den Auto-Vorschub gegen feste
Pixelabstaende stellt, statt am Umbruch abzuzaehlen.

mount_mock.py --lan bindet auf 0.0.0.0 und nennt die einzutragende LAN-IP,
damit der ESP32 den Mock erreicht.

92 Tests gruen.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

run_display.py

@@ -13,19 +13,12 @@ Hintergrund erneut verbunden.
 
 import argparse
 import sys
-import time
 
 import config
-import coords
-import migra
+import displayloop
 from brightness import BrightnessController
 from display import open_display
-from mount_client import MountClient, MountError
-
-
-def _format(ra_raw, dec_raw):
-    """Rohstrings der Montierung fuer die Anzeige aufbereiten."""
-    return coords.format_ra(ra_raw), coords.format_dec(dec_raw)
+from mount_client import MountClient
 
 
 def main(argv=None):
@@ -56,54 +49,20 @@ def main(argv=None):
 
     d = open_display(fake=args.dry_run)
     client = MountClient(host, port, timeout=config.MOUNT_TIMEOUT)
-    last_shown = None
 
-    # Helligkeitsregelung: derzeit ein fester LDR-Wert von der Kommandozeile;
-    # spaeter (ESP32) wird hier pro Durchlauf der ADC gelesen.
-    dimmer = BrightnessController() if args.ldr is not None else None
+    # Helligkeitsregelung: hier ein fester LDR-Wert von der Kommandozeile; auf
+    # dem ESP32 liest run_esp32.py stattdessen den ADC.
+    dimmer = read_ldr = None
+    if args.ldr is not None:
+        dimmer = BrightnessController()
+        read_ldr = lambda: args.ldr
 
     try:
-        while True:
-            try:
-                if not client.connected:
-                    client.connect()
-
-                # Helligkeit nachfuehren (nur senden, wenn sich die Stufe aendert)
-                if dimmer is not None:
-                    level, percent, changed = dimmer.update(args.ldr)
-                    if changed:
-                        d.set_brightness(percent)
-                        print("LDR %d -> Helligkeit Stufe %d = %d %%"
-                              % (args.ldr, level, percent))
-
-                ra_raw, dec_raw = client.get_coordinates()
-                ra_line, dec_line = _format(ra_raw, dec_raw)
-
-                if (ra_line, dec_line) != last_shown:
-                    # Bei jeder Aenderung beide Zeilen neu zeichnen. Kein Vollbild-
-                    # Loeschen (kein Flimmern); die umgekehrte Zeilenreihenfolge in
-                    # show_lines schuetzt die Home-Zelle vor dem Gradzeichen-
-                    # Zeichensatzwechsel, auch bei staendiger Aktualisierung.
-                    first = last_shown is None or last_shown == config.NOLINK_LINES
-                    d.show_lines(ra_line, dec_line, clear=first)
-                    last_shown = (ra_line, dec_line)
-                    print("RA %-11s DEC %-12s -> %s | %s"
-                          % (ra_raw, dec_raw, ra_line, dec_line))
-            except migra.MigraError as e:
-                # Anzeige-/Antwortfehler (z.B. gestoerte Antwort): nicht abstuerzen,
-                # nur melden und beim naechsten Durchlauf neu zeichnen.
-                print("Anzeige: %s" % e, file=sys.stderr)
-                last_shown = None
-            except (MountError, ValueError) as e:
-                print("Montierung: %s" % e, file=sys.stderr)
-                client.close()
-                if config.NOLINK_LINES != last_shown:
-                    d.show_lines(*config.NOLINK_LINES, clear=True)
-                    last_shown = config.NOLINK_LINES
-
-            if args.once:
-                break
-            time.sleep(args.interval)
+        displayloop.poll_loop(d, client,
+                              interval=args.interval,
+                              once=args.once,
+                              read_ldr=read_ldr,
+                              dimmer=dimmer)
     except KeyboardInterrupt:
         print("\nbeendet")
     finally: