led-controller-version-3-device-simulated-respeaker

Ein vollständiger Software-Ersatz für die Hardware — dieselben Ports, dieselbe Rolle. Der Dienst merkt nicht, dass die Gegenstelle kein Gerät ist.

Es enthält:

• SimulatorFrameSink — überträgt den LED-Frame über einen lokalen Transport,
• SimulatorDoaProvider — liest die im Fenster eingestellte Richtung und Sprachaktivität zurück,
• die Ringanzeige als eigenständige Anwendung.

Die dienstseitige Hälfte braucht kein Qt. PySide6 ist ein Extra und wird nur gebraucht, wenn das Fenster geöffnet wird:

uv pip install "led-controller-version-3-device-simulated-respeaker[gui]"
lefx-simulator

Ohne installiertes Konsolenskript geht es als Modul. app.py direkt als Datei zu starten geht nicht — die Datei erreicht ihre Nachbarmodule über relative Importe, und eine über den Pfad gestartete Datei hat kein Paket, relativ zu dem das ginge:

uv run python -m lefx.device.simulated_respeaker

Als Exe

Für eine Maschine ohne Python-Checkout, oder um das Fenster offen zu lassen, während am Checkout gearbeitet wird:

uv sync --group build

uv run --group build python scripts/build_simulator.py

Ergebnis ist build/dist/lefx-simulator.exe (~47 MB, eine Datei). --onedir startet schneller, --windowed verbirgt die Konsole — dann sieht man allerdings auch nicht mehr, wenn der Dienst nicht erreichbar ist.

Damit lassen sich auch kontrollierte Overlays wie direction_indicator ohne angeschlossenen reSpeaker entwickeln und prüfen — der Effekt fragt nach der Fähigkeit doa und bekommt sie hier ebenso wie von der Hardware.

Transport

Der Dienst hört auf 127.0.0.1:8787, das Fenster verbindet sich dorthin. Diese Richtung entspricht der Hardware: der Dienst läuft, ob ein Gerät angeschlossen ist oder nicht, und ein später erscheinendes Fenster ist ein gewöhnliches Ereignis, kein Neustart. Das Fenster verbindet sich selbsttätig neu.

Der Port lässt sich auf beiden Seiten setzen:

uv run lefx serve --sink simulator --sink-option port=8770

Alternativ über LEFX_SIMULATOR_PORT, das beide Hälften lesen.

Grenzen

Ohne verbundenes Fenster meldet die Senke available=False und der Provider liefert None — dieselbe Bedeutung wie ein abgezogenes Kabel. Der Dienst läuft weiter, kontrollierte Overlays gehen über waiting nach failed.