Grotti 2.2.0: Auth, API-Tokens, MCP und Doku-Trennung.

docs/Anleitung-ACE.md

@@ -0,0 +1,39 @@
+# ACE und Spulen
+
+Stand **15.10.2026**. Mehrfarb-Drucke brauchen vor dem Start eine Zuordnung Datei-Farbe → ACE-Platz und eine passende Spule am Drucker.
+
+![ACE-Zuordnung beim Senden](/static/doku/ace-zuordnung.png)
+
+## Spule einlegen
+
+1. Unter **Material → Spulen** die Rolle wählen oder anlegen.
+2. Ort = Drucker und **ACE-Platz** (1–8) oder externe Spule.
+3. Materialtyp und Farbe sollten zur Slice-Datei passen.
+
+Es gibt **kein freies Spulen-Dropdown** beim Start: Grotti nimmt die Rolle(n), die am Ziel-Drucker liegen. Material-Mismatch oder zu wenig Rest → Warnung vor dem Start.
+
+Etiketten mit QR: [Material und mehr](Anleitung-Material).
+
+## ACE-Map beim Senden
+
+Unter **Dateien → Optionen → ACE-Zuordnung**:
+
+- Jede Farbe aus der Datei (`paint_index`) einem **ACE-Platz** zuordnen
+- Ohne passende Map schreibt der Drucker oft **„cannot parse the file“** und startet nicht
+- Grotti legt die Sidecar `*.gcode.acm` an und schickt sie mit
+
+Externe Spule / keine ACE-Slots: keine `.acm` nötig.
+
+## Typische Fehler
+
+| Symptom | Check |
+| --- | --- |
+| „cannot parse the file“ | ACE-Zuordnung vollständig? Farben richtig? |
+| Material-Warnung | Eingelegte Sorte ≠ Datei — Spule wechseln oder Slice prüfen |
+| Rest zu gering | Andere Spule oder leichteres Teil |
+| ACE blinkt nicht / kein Wechsel | Spule und Platz prüfen, ggf. Druck neu starten |
+
+## Weiter
+
+- [Dateien senden](Anleitung-Dateien)
+- [Material](Anleitung-Material)