kxgauge/README.md

KXGauge

Ein rundes Gesicht für deinen 3D-Drucker.

KXGauge nimmt Live-Daten von KX-Bridge entgegen — Temperatur, Druckfortschritt, Layer, Status — und übersetzt sie auf einem kleinen runden Display (GC9A01, 240×240) in ein Gesicht, das reagiert: es freut sich, wenn der Druck läuft, bekommt Schweißperlen und irgendwann eine Sonnenbrille, wenn das Hotend heißläuft, und zeigt die aktuelle Temperatur als wachsenden Farbring am Rand. Statt auf ein Diagramm zu starren, wirft man einen Blick auf ein Gesicht und weiß, wie es dem Drucker gerade geht.

🚧 Work in Progress. Die Anbindung an KX-Bridge existiert noch nicht — aktuell läuft KXGauge als eigenständiges Gerät mit einer HTTP-API, über die sich Emotionen, Farben und die Temperaturanzeige von Hand oder per Skript ansteuern lassen (siehe API.md und test_emotions.sh). Die Bridge-Kopplung ist der nächste Schritt.

---

Die Idee

KX-Bridge spricht das Moonraker-Protokoll mit einem Anycubic Kobra X und kennt in Echtzeit Temperatur, Fortschritt, Layer, Restzeit und Status eines Drucks. KXGauge soll diese Daten abonnieren und in etwas übersetzen, das man auf einen Blick liest — ohne Dashboard, ohne Bildschirm am Rechner:

• Emotion = Status. Druck läuft rund → zufriedenes Gesicht. Fehler oder Filament-Runout → ein Ausdruck, der sofort auffällt. Druck fertig → eine Emotion, die das zeigt.
• Der Ring am Rand = Temperatur. Füllt sich symmetrisch von unten, Farbverlauf Blau → Grün → Gelb → Orange → Rot, skalierbar auf eine Zielmarke (z. B. Solltemperatur des Hotends). Bei hohen Temperaturen bekommt das Gesicht Schweißtropfen — und wenn's richtig heiß wird, eine Sonnenbrille.
• Text für die Zahlen, die wichtig sind. Aktuelle Temperatur direkt über dem Gesicht, gut lesbar, ohne dass man ein Menü aufklappen muss.

Kein Anspruch auf Vollständigkeit eines echten Dashboards — KXGauge ist der schnelle, emotionale Blick von der Seite, während das Detail-Interface weiter bei KX-Bridge liegt.

---

Was heute schon geht

Das Gesicht selbst ist fertig und läuft stabil auf echter Hardware:

• 24 Emotionen — von klassisch (neutral, happy, angry, tired, surprised …) bis Cozmo-inspiriert (skeptic, furious, awe, unimpressed …), jede mit eigenem Augen- und Mundausdruck
• Temperatur-Ring mit Farbverlauf, Zielmarke und Live-Zahl über dem Gesicht
• Schweiß, Tränen, Sonnenbrille, Puls- und Glitch-Effekte — unabhängig von der Emotion ansteuerbar und miteinander kombinierbar
• HTTP-API über WLAN, dokumentiert in API.md
• Kein Framework, keine Cloud — MicroPython auf einem ESP32-C3, direkt SPI zum Display

Alles davon ist über simple GET-Requests ansteuerbar — das ist die Schnittstelle, an die KX-Bridge später andocken wird.

---

Hardware

• ESP32-C3 Super Mini
• GC9A01, 1.28", 240×240, rund

Details zu Pinbelegung, Firmware und Architekturentscheidungen: siehe agents.md (lokal, nicht Teil dieses Repos).

Schnellstart (aktueller Stand, ohne Bridge)

# secrets.py aus der Vorlage anlegen
cp secrets.example.py secrets.py
# WIFI_SSID / WIFI_PASSWORD eintragen

# auf das Board spielen (mpremote)
mpremote connect /dev/ttyACM0 cp *.py :
mpremote connect /dev/ttyACM0 reset

# Emotionen und Effekte durchtesten
./test_emotions.sh          # automatisch
./test_emotions.sh -i       # interaktiv

Roadmap

• KX-Bridge-Client: Moonraker-Status abonnieren (WebSocket)
• Mapping Druckerstatus → Emotion (idle, printing, paused, error, complete, filament-runout …)
• Hotend-/Bett-Temperatur → Heat-Ring (aktueller Wert + Zielwert aus dem Slicer-Profil)
• Fortschritt/Restzeit als zweite Anzeige
• Mehrere Drucker (KX-Bridge unterstützt Multi-Printer) → Umschalten oder mehrere KXGauge-Geräte