# Plugin: BambuLab

Das **BambuLab-Plugin** ist ein Driver-Plugin, das FilaMan um die vollständige Integration von BambuLab 3D-Druckern erweitert. Es ermöglicht die Kommunikation über MQTT, die Verwaltung von AMS-Slots und das automatische Setzen von Filament-Einstellungen.

> ⚠️ **Wichtig:** Die Steuerung des Druckers über FilaMan (z. B. Spulen im Drucker/AMS setzen) funktioniert nur, wenn der Drucker im **LAN-only Modus** UND im **Developer Mode** betrieben wird.

**Installation:** → [Admin: Plugin-Verwaltung](/Docs/De/11-Admin#115-system-plugin-verwaltung)

---

## Übersicht

| Eigenschaft | Wert |
|-------------|------|
| **Plugin-Typ** | Driver (Druckertreiber) |
| **Autor** | FilaMan |
| **Quelle** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
| **Verbindung** | MQTT über lokales Netzwerk |
| **Fähigkeiten** | AMS-Unterstützung, RFID-Erkennung, Automatisches Filament-Matching |

---

## Unterstützte Druckermodelle

| Modell | AMS-Typ |
|--------|---------|
| **P1P / P1S** | AMS (Automatic Material System) |
| **P2S** | AMS |
| **X1C / X1E** | AMS |
| **A1 / A1 Mini** | AMS Lite |
| **H2C / H2D / H2S** | AMS |

---

## Konfiguration

Beim Hinzufügen oder Bearbeiten eines BambuLab-Druckers zeigt das Plugin folgende Konfigurationsfelder:

| Feld | Pflicht | Beschreibung |
|------|---------|-------------|
| **Printer Model** | Ja | Druckermodell (P1S, P1P, P2S, X1C, X1E, A1, A1 Mini, H2C, H2D, H2S) — bestimmt die AMS-Datenstruktur und Anzahl der Slots |
| **IP/Hostname** | Ja | IP-Adresse oder Hostname des Druckers im lokalen Netzwerk |
| **Serial Number** | Ja | Seriennummer des Druckers (auf dem Gerät oder in der Bambu Handy App) |
| **Access Code** | Ja | Zugriffscode aus den LAN-Einstellungen des Druckers |
| **Reconnect Interval** | Nein | Intervall in Minuten für automatische Neuverbindung bei Verbindungsverlust (Standard: 5, Bereich: 1–60) |

> **Tipp:** Die Seriennummer und den Zugriffscode finden Sie in der **Bambu Handy App** unter den Druckereinstellungen oder direkt auf dem Drucker unter **Einstellungen → Netzwerk → LAN-Modus**.

---

## Was wird bei der Installation erstellt?

Bei der Installation des Plugins und beim erstmaligen Start eines BambuLab-Druckers werden automatisch folgende Komponenten eingerichtet:

### Drucker-Parameter (Printer Parameters)

Das Plugin erstellt **10 Zusatzfelder** (sogenannte „Drucker-Parameter"), die speziell für BambuLab-Drucker benötigt werden. Diese Felder werden automatisch als **System Extra Fields** angelegt (sichtbar unter [Admin: Zusatzfelder](/Docs/De/11-Admin#114-zusatzfelder-extra-fields)).

| Parameter | Beschreibung | Feldtyp |
|-----------|-------------|---------|
| **Bambu Material Index** (`bambu_idx`) | Material-Index aus der BambuLab-Filamentliste — wählen Sie aus einem Dropdown das passende BambuLab-Material aus | Dropdown |
| **Tray Info Index** (`bambu_tray_idx`) | Index, der den Tray-Eintrag im BambuLab-System identifiziert | Text |
| **Setting ID** (`bambu_setting_id`) | Druckprofil-ID, die BambuLab intern für die Druckeinstellungen verwendet | Text |
| **Calibration Index** (`bambu_cali_idx`) | Kalibrierungs-Index für die Druckkalibrierung | Text |
| **K Value** (`bambu_k_value`) | K-Wert (Pressure Advance) für die Extrusionssteuerung | Zahl |
| **Flow Ratio** (`bambu_flow_ratio`) | Flussrate / Extrusionsmultiplikator | Zahl |
| **Bed Temperature** (`bambu_bed_temp`) | Druckbett-Temperatur in °C | Zahl |
| **Nozzle Temp Min** (`bambu_nozzle_temp_min`) | Minimale Düsentemperatur in °C | Zahl |
| **Nozzle Temp Max** (`bambu_nozzle_temp_max`) | Maximale Düsentemperatur in °C | Zahl |
| **Max Volumetric Speed** (`bambu_max_volumetric_speed`) | Maximale Volumenstrom-Geschwindigkeit in mm³/s | Zahl |

---

## Wo erscheinen die Drucker-Parameter?

Die Drucker-Parameter erscheinen an zwei Stellen in der Benutzeroberfläche:

### 1. Filament-Bearbeitung

Unter dem Abschnitt **„Printer Parameters"** auf der Filament-Bearbeitungsseite.

- Hier werden die **Standard-Werte** für ein Filament hinterlegt (z. B. „PLA generell bei 210–220°C")
- Diese Werte gelten als **Basis** für alle Spulen dieses Filaments
- Wenn Sie z. B. ein neues PLA-Filament anlegen, tragen Sie hier die BambuLab-Parameter ein, die für dieses Filament typisch sind

### 2. Spulen-Bearbeitung

Unter dem Abschnitt **„Printer Parameters"** auf der Spulen-Bearbeitungsseite.

- Hier können **spulenspezifische Werte** hinterlegt werden, die von den Filament-Standardwerten abweichen
- Spulen-Parameter haben **Vorrang** vor Filament-Parametern beim Senden an den Drucker
- Nützlich, wenn eine bestimmte Spule andere Kalibrierungswerte oder Temperaturen benötigt

> **Prioritätsregel:** Beim Senden von Filament-Einstellungen an den Drucker werden Spulen-Parameter und Filament-Parameter zusammengeführt. Wenn für einen Parameter sowohl auf Spulen- als auch auf Filament-Ebene ein Wert existiert, wird der **Spulen-Wert** verwendet.

---

## Drucker-Parameter befüllen

Es gibt drei Wege, die Parameter zu befüllen:

### 1. Manuell eingeben

Öffnen Sie die Filament- oder Spulen-Bearbeitung und tragen Sie die Werte im Abschnitt „Printer Parameters" ein.

- Den **Bambu Material Index** können Sie bequem aus einem Dropdown auswählen — die Liste enthält alle von BambuLab unterstützten Materialtypen
- Die übrigen Felder (Temperaturen, K-Wert etc.) können Sie direkt als Zahlen oder Text eingeben
- Diese Methode eignet sich besonders für Filamente, die Sie zum ersten Mal einrichten

### 2. Aus AMS-Slot importieren

Auf der **Spulen-Detailseite** können Sie Parameter direkt aus einem AMS-Slot übernehmen:

1. Klicken Sie auf einen AMS-Slot-Punkt in der Drucker-Slot-Übersicht
2. Wählen Sie im Kontextmenü:
   - **„In Spule importieren"** — Übernimmt die Werte (Tray-Index, Temperaturen, Kalibrierungs-ID etc.) in die Drucker-Parameter der Spule
   - **„In Spule & Filament importieren"** — Übernimmt die Werte sowohl in die Spule als auch ins zugehörige Filament

> **Tipp:** Diese Methode ist besonders praktisch, wenn Sie BambuLab-Original-Filament verwenden — alle Parameter werden automatisch vom AMS ausgelesen und übernommen.

### 3. Automatisch beim Hinzufügen eines Druckers

Wenn ein neuer BambuLab-Drucker hinzugefügt wird und bereits ein anderer BambuLab-Drucker existiert, kopiert FilaMan automatisch die Drucker-Parameter vom bestehenden Drucker. So müssen Sie die Parameter nicht erneut eintragen.

---

## AMS-Slot-Anzeige

Nach erfolgreicher Verbindung zeigt FilaMan auf der **Druckerseite** und auf der **Spulen-Detailseite** alle AMS-Slots und deren aktuellen Inhalt an:

- **AMS-Slots** — Pro AMS-Einheit bis zu 4 Slots
- **External Tray** — Die externe Spulenzuführung des Druckers
- Angezeigt werden: Filamenttyp, Farbe, Temperaturbereich und Kalibrierungsstatus
- Die Anzeige aktualisiert sich in **Echtzeit** über Server-Sent Events (SSE)

Weitere Details zum Zuweisen von Spulen an Slots: → [Drucker: Spulen setzen](/Docs/De/09-Drucker#spulen-setzen--ubersicht)

---

## Migration älterer Versionen

Falls Sie das BambuLab-Plugin von einer älteren Version aktualisieren, werden bestehende Parameter automatisch umbenannt:

| Alter Name | Neuer Name |
|-----------|-----------|
| `bambu_cali_id` | `bambu_cali_idx` |
| `bambu_k` | `bambu_k_value` |
| `bambu_max_volspeed` | `bambu_max_volumetric_speed` |
| `bambu_nozzle_temp` | `bambu_nozzle_temp_min` |

Ihre vorhandenen Daten bleiben dabei erhalten — die Umbenennung erfolgt automatisch bei der ersten Druckerverbindung nach dem Update.

> **Hinweis:** Falls Sie zuvor Spoolman mit BambuLab-Feldern verwendet haben, migriert FilaMan auch diese Daten automatisch in das neue Drucker-Parameter-Format.

---

← [Zurück: Tipps & FAQ](/Docs/De/13-Faq) | [Weiter: Plugin: SpoolmanDB Import →](/Docs/De/15-Plugin-Spoolmandb)
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9