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>

wifi.py

@@ -0,0 +1,126 @@
+"""WLAN-Anbindung des XIAO ESP32-C3 (MicroPython).
+
+Die Zugangsdaten stehen in wifi_config.py, das nicht im Git liegt -- Vorlage ist
+wifi_config_example.py. Zeitverhalten kommt aus config.py.
+
+    import wifi
+    wifi.connect()          # einmal verbinden, wirft WifiError bei Misserfolg
+    wifi.ensure()           # vor jeder Abfrage: verbunden halten
+
+WifiError erbt von displayloop.LinkError, damit die Poll-Schleife den Ausfall
+selbst abfaengt und "KEIN WLAN" anzeigt, statt abzustuerzen.
+"""
+
+import time
+
+import config
+import ticks
+from displayloop import LinkError
+
+try:                        # MicroPython
+    import network
+except ImportError:         # auf dem Mac nicht vorhanden
+    network = None
+
+
+class WifiError(LinkError):
+    """WLAN nicht verfuegbar oder Zugangsdaten fehlen."""
+
+
+_wlan = None
+
+
+def credentials():
+    """(SSID, Passwort) aus wifi_config.py holen."""
+    try:
+        import wifi_config
+    except ImportError:
+        raise WifiError("wifi_config.py fehlt -- wifi_config_example.py "
+                        "kopieren, ausfuellen und auf den ESP32 kopieren")
+    try:
+        return wifi_config.SSID, wifi_config.PASSWORD
+    except AttributeError:
+        raise WifiError("wifi_config.py braucht SSID und PASSWORD")
+
+
+def station():
+    """Das WLAN-Interface im Station-Modus, aktiviert."""
+    global _wlan
+    if network is None:
+        raise WifiError("network fehlt -- laeuft dieser Code auf dem ESP32?")
+    if _wlan is None:
+        _wlan = network.WLAN(network.STA_IF)
+    if not _wlan.active():
+        _wlan.active(True)
+    return _wlan
+
+
+def connected():
+    """True, wenn eine WLAN-Verbindung steht."""
+    if network is None or _wlan is None:
+        return False
+    return _wlan.isconnected()
+
+
+def connect(timeout=None, log=None):
+    """Verbinden und warten, bis eine IP steht. Liefert die ifconfig-Tupel."""
+    if timeout is None:
+        timeout = config.WIFI_TIMEOUT
+    if log is None:
+        log = print
+
+    wlan = station()
+    if wlan.isconnected():
+        return wlan.ifconfig()
+
+    ssid, password = credentials()
+    log("WLAN: verbinde mit %s ..." % ssid)
+    wlan.connect(ssid, password)
+
+    end = ticks.deadline(timeout)
+    while not wlan.isconnected():
+        # Kurz schlafen statt hart zu pollen: der Verbindungsaufbau laeuft im
+        # Hintergrund und braucht die Rechenzeit selbst.
+        time.sleep(0.2)
+        if ticks.expired(end):
+            # Die Verbindung abbrechen, sonst versucht die Firmware im
+            # Hintergrund weiter und der naechste connect() kollidiert damit.
+            try:
+                wlan.disconnect()
+            except OSError:
+                pass
+            raise WifiError("keine Verbindung zu %s nach %g s" % (ssid, timeout))
+
+    cfg = wlan.ifconfig()
+    log("WLAN: verbunden, IP %s" % cfg[0])
+    return cfg
+
+
+def ensure(timeout=None, log=None):
+    """Sicherstellen, dass das WLAN steht -- fuer displayloop.ensure_link.
+
+    Steht die Verbindung schon, kostet der Aufruf praktisch nichts. Sonst wird
+    neu verbunden; scheitert das, fliegt WifiError (= LinkError) und die
+    Poll-Schleife zeigt "KEIN WLAN" an und versucht es beim naechsten Durchlauf
+    erneut.
+    """
+    if connected():
+        return
+    connect(timeout=timeout, log=log)
+
+
+def ifconfig():
+    """(IP, Netzmaske, Gateway, DNS) oder None, wenn nicht verbunden."""
+    return _wlan.ifconfig() if connected() else None
+
+
+def disconnect():
+    """Verbindung trennen und das Interface abschalten."""
+    global _wlan
+    if _wlan is not None:
+        try:
+            _wlan.disconnect()
+            _wlan.active(False)
+        except OSError:
+            pass
+        _wlan = None