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>

migra.py

@@ -38,6 +38,16 @@ class MigraError(Exception):
     """Fehler im Protokoll oder von der Anzeige gemeldeter Fehlercode."""
 
 
+def _hex(data):
+    """Bytes als Hexstring, ohne sich auf bytes.hex() zu verlassen.
+
+    MicroPython 1.28 hat bytes.hex() (am Geraet nachgeprueft), aber nicht jede
+    Firmware ist damit gebaut. Wird nur in Fehlermeldungen gebraucht -- ein
+    AttributeError ausgerechnet dort wuerde den eigentlichen Fehler verdecken.
+    """
+    return "".join("%02x" % b for b in data)
+
+
 def encode_text(s):
     """Text in Anzeige-Bytes wandeln.
 
@@ -56,10 +66,16 @@ def encode_text(s):
 
 
 def _digits(value, places):
-    """Zahl als ASCII-Ziffern fester Laenge (Handbuch 3.7: alle Werte ASCII-codiert)."""
+    """Zahl als ASCII-Ziffern fester Laenge (Handbuch 3.7: alle Werte ASCII-codiert).
+
+    Von Hand aufgefuellt statt mit "%0*d". MicroPython 1.28 beherrscht die
+    dynamische Feldbreite zwar (am Geraet nachgeprueft), sie stand aber lange
+    als nicht unterstuetzt in den Docs -- so bleibt es unabhaengig davon.
+    """
     if value < 0 or value >= 10 ** places:
         raise MigraError("Wert %d passt nicht in %d Stellen" % (value, places))
-    return ("%0*d" % (places, value)).encode("ascii")
+    s = "%d" % value
+    return ("0" * (places - len(s)) + s).encode("ascii")
 
 
 class DataUnit:
@@ -175,9 +191,9 @@ def parse_response(frame, src=0):
     if not frame:
         raise MigraError("keine Antwort von der Anzeige (Timeout)")
     if len(frame) < 6 or frame[0] != STX or frame[-1] != ETX:
-        raise MigraError("unplausibles Antworttelegramm: %s" % frame.hex())
+        raise MigraError("unplausibles Antworttelegramm: %s" % _hex(frame))
     if frame[1] != (0x80 | src):
-        raise MigraError("Antwort nicht an uns adressiert: %s" % frame.hex())
+        raise MigraError("Antwort nicht an uns adressiert: %s" % _hex(frame))
 
     code = chr(frame[4])
     if code != "0":