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>

test_display.py

@@ -0,0 +1,91 @@
+"""Tests fuer den Anzeigetreiber -- Zeilenaufbau und die festen Hinweistexte.
+
+    python3 -m unittest test_display
+"""
+
+import unittest
+
+import config
+import migra
+from display import Display
+from transport import FakeTransport
+
+
+def _lesbar(frame):
+    """Telegramm als lesbarer Text; Steuerzeichen werden zu '.'."""
+    return "".join(chr(b) if 32 <= b < 127 else "." for b in frame)
+
+
+class TestFesteTexte(unittest.TestCase):
+    """Die Hinweiszeilen muessen in die Anzeige passen.
+
+    Am Geraet aufgefallen: "MONTIERUNG" hat 10 Zeichen, die Anzeige fasst 9 --
+    angezeigt wurde "MONTIERUN". _emit_line schneidet stillschweigend ab, also
+    faellt so etwas sonst erst auf der Anzeige auf.
+    """
+
+    def test_hinweiszeilen_passen_in_die_zeilenbreite(self):
+        for name in ("NOLINK_LINES", "NOWIFI_LINES"):
+            for zeile in getattr(config, name):
+                self.assertLessEqual(
+                    len(zeile), config.CHARS_PER_LINE,
+                    "config.%s: %r hat %d Zeichen, die Anzeige fasst %d"
+                    % (name, zeile, len(zeile), config.CHARS_PER_LINE))
+
+    def test_es_gibt_nicht_mehr_hinweiszeilen_als_zeilen(self):
+        for name in ("NOLINK_LINES", "NOWIFI_LINES"):
+            self.assertLessEqual(len(getattr(config, name)), len(config.LINE_Y))
+
+
+class TestZeilenaufbau(unittest.TestCase):
+
+    def setUp(self):
+        self.t = FakeTransport(echo=False)
+        self.d = Display(self.t, response=True)
+
+    def _letztes(self):
+        return self.t.frames[-1]
+
+    def test_zeile_wird_auf_volle_breite_aufgefuellt(self):
+        """Ohne Auffuellen blieben Reste der vorigen Anzeige stehen.
+
+        Gleichzeitig die Regressionsprobe fuer str.ljust, das MicroPython
+        nicht kennt (am Geraet aufgefallen).
+        """
+        self.d.show_lines("AB", "CD")
+        text = _lesbar(self._letztes())
+        self.assertIn("AB" + " " * (config.CHARS_PER_LINE - 2), text)
+        self.assertIn("CD" + " " * (config.CHARS_PER_LINE - 2), text)
+
+    def test_zu_lange_zeile_wird_abgeschnitten(self):
+        """Zu breit aufgefuellt bricht das Fuell-Leerzeichen um und
+        beschaedigt die andere Zeile -- deshalb hart abschneiden."""
+        lang = "X" * (config.CHARS_PER_LINE + 5)
+        self.d.show_lines(lang)
+        text = _lesbar(self._letztes())
+        self.assertIn("X" * config.CHARS_PER_LINE, text)
+        self.assertNotIn("X" * (config.CHARS_PER_LINE + 1), text)
+
+    def test_oberste_zeile_wird_zuletzt_gezeichnet(self):
+        """Schutz der Home-Zelle: ein Zeichensatzwechsel mitten im Telegramm
+        zerstoert (0,0), die oberste Zeile muss danach kommen."""
+        self.d.show_lines("OBEN", "UNTEN")
+        text = _lesbar(self._letztes())
+        self.assertLess(text.index("UNTEN"), text.index("OBEN"))
+
+    def test_clear_erzeugt_ein_vollbild_loeschen(self):
+        self.d.show_lines("A", "B", clear=True)
+        mit = self._letztes()
+        self.d.show_lines("A", "B", clear=False)
+        ohne = self._letztes()
+        fuellen = bytes([migra.ESC]) + b"F" + config.BACKGROUND.encode("ascii")
+        self.assertIn(fuellen, mit)
+        self.assertNotIn(fuellen, ohne)
+
+    def test_mehr_zeilen_als_die_anzeige_hat(self):
+        with self.assertRaises(ValueError):
+            self.d.show_lines(*(["X"] * (len(config.LINE_Y) + 1)))
+
+
+if __name__ == "__main__":
+    unittest.main()