Home A - Z
Page Index

Blame

ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
1 
# Plugin: BambuLab
2
3
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.
4
5
**Installation:** → [Admin: Plugin-Verwaltung](./11-admin.md#115-system-plugin-verwaltung)
6
7
---
8
9
## Übersicht
10
11
| Eigenschaft | Wert |
12
|-------------|------|
13
| **Plugin-Typ** | Driver (Druckertreiber) |
14
| **Autor** | FilaMan |
15
| **Quelle** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
16
| **Verbindung** | MQTT über lokales Netzwerk |
17
| **Fähigkeiten** | AMS-Unterstützung, RFID-Erkennung, Automatisches Filament-Matching |
18
19
---
20
21
## Unterstützte Druckermodelle
22
23
| Modell | AMS-Typ |
24
|--------|---------|
25
| **P1P / P1S** | AMS (Automatic Material System) |
26
| **X1 / X1C / X1E** | AMS |
27
| **A1 / A1 Mini** | AMS Lite |
28
29
---
30
31
## Konfiguration
32
33
Beim Hinzufügen oder Bearbeiten eines BambuLab-Druckers zeigt das Plugin folgende Konfigurationsfelder:
34
35
| Feld | Pflicht | Beschreibung |
36
|------|---------|-------------|
37
| **Printer Model** | Ja | Druckermodell (P1S, P1P, X1C, X1E, A1, A1 Mini) — bestimmt die AMS-Datenstruktur und Anzahl der Slots |
38
| **IP/Hostname** | Ja | IP-Adresse oder Hostname des Druckers im lokalen Netzwerk |
39
| **Serial Number** | Ja | Seriennummer des Druckers (auf dem Gerät oder in der Bambu Handy App) |
40
| **Access Code** | Ja | Zugriffscode aus den LAN-Einstellungen des Druckers |
41
| **Reconnect Interval** | Nein | Intervall in Minuten für automatische Neuverbindung bei Verbindungsverlust (Standard: 5, Bereich: 1–60) |
42
43
> **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**.
44
45
---
46
47
## Was wird bei der Installation erstellt?
48
49
Bei der Installation des Plugins und beim erstmaligen Start eines BambuLab-Druckers werden automatisch folgende Komponenten eingerichtet:
50
51
### Drucker-Parameter (Printer Parameters)
52
53
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](./11-admin.md#114-zusatzfelder-extra-fields)).
54
55
| Parameter | Beschreibung | Feldtyp |
56
|-----------|-------------|---------|
57
| **Bambu Material Index** (`bambu_idx`) | Material-Index aus der BambuLab-Filamentliste — wählen Sie aus einem Dropdown das passende BambuLab-Material aus | Dropdown |
58
| **Tray Info Index** (`bambu_tray_idx`) | Index, der den Tray-Eintrag im BambuLab-System identifiziert | Text |
59
| **Setting ID** (`bambu_setting_id`) | Druckprofil-ID, die BambuLab intern für die Druckeinstellungen verwendet | Text |
60
| **Calibration Index** (`bambu_cali_idx`) | Kalibrierungs-Index für die Druckkalibrierung | Text |
61
| **K Value** (`bambu_k_value`) | K-Wert (Pressure Advance) für die Extrusionssteuerung | Zahl |
62
| **Flow Ratio** (`bambu_flow_ratio`) | Flussrate / Extrusionsmultiplikator | Zahl |
63
| **Bed Temperature** (`bambu_bed_temp`) | Druckbett-Temperatur in °C | Zahl |
64
| **Nozzle Temp Min** (`bambu_nozzle_temp_min`) | Minimale Düsentemperatur in °C | Zahl |
65
| **Nozzle Temp Max** (`bambu_nozzle_temp_max`) | Maximale Düsentemperatur in °C | Zahl |
66
| **Max Volumetric Speed** (`bambu_max_volumetric_speed`) | Maximale Volumenstrom-Geschwindigkeit in mm³/s | Zahl |
67
68
---
69
70
## Wo erscheinen die Drucker-Parameter?
71
72
Die Drucker-Parameter erscheinen an zwei Stellen in der Benutzeroberfläche:
73
74
### 1. Filament-Bearbeitung
75
76
Unter dem Abschnitt **„Printer Parameters"** auf der Filament-Bearbeitungsseite.
77
78
- Hier werden die **Standard-Werte** für ein Filament hinterlegt (z. B. „PLA generell bei 210–220°C")
79
- Diese Werte gelten als **Basis** für alle Spulen dieses Filaments
80
- Wenn Sie z. B. ein neues PLA-Filament anlegen, tragen Sie hier die BambuLab-Parameter ein, die für dieses Filament typisch sind
81
82
### 2. Spulen-Bearbeitung
83
84
Unter dem Abschnitt **„Printer Parameters"** auf der Spulen-Bearbeitungsseite.
85
86
- Hier können **spulenspezifische Werte** hinterlegt werden, die von den Filament-Standardwerten abweichen
87
- Spulen-Parameter haben **Vorrang** vor Filament-Parametern beim Senden an den Drucker
88
- Nützlich, wenn eine bestimmte Spule andere Kalibrierungswerte oder Temperaturen benötigt
89
90
> **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.
91
92
---
93
94
## Drucker-Parameter befüllen
95
96
Es gibt drei Wege, die Parameter zu befüllen:
97
98
### 1. Manuell eingeben
99
100
Öffnen Sie die Filament- oder Spulen-Bearbeitung und tragen Sie die Werte im Abschnitt „Printer Parameters" ein.
101
102
- Den **Bambu Material Index** können Sie bequem aus einem Dropdown auswählen — die Liste enthält alle von BambuLab unterstützten Materialtypen
103
- Die übrigen Felder (Temperaturen, K-Wert etc.) können Sie direkt als Zahlen oder Text eingeben
104
- Diese Methode eignet sich besonders für Filamente, die Sie zum ersten Mal einrichten
105
106
### 2. Aus AMS-Slot importieren
107
108
Auf der **Spulen-Detailseite** können Sie Parameter direkt aus einem AMS-Slot übernehmen:
109
110
1. Klicken Sie auf einen AMS-Slot-Punkt in der Drucker-Slot-Übersicht
111
2. Wählen Sie im Kontextmenü:
112
- **„In Spule importieren"** — Übernimmt die Werte (Tray-Index, Temperaturen, Kalibrierungs-ID etc.) in die Drucker-Parameter der Spule
113
- **„In Spule & Filament importieren"** — Übernimmt die Werte sowohl in die Spule als auch ins zugehörige Filament
114
115
> **Tipp:** Diese Methode ist besonders praktisch, wenn Sie BambuLab-Original-Filament verwenden — alle Parameter werden automatisch vom AMS ausgelesen und übernommen.
116
117
### 3. Automatisch beim Hinzufügen eines Druckers
118
119
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.
120
121
---
122
123
## AMS-Slot-Anzeige
124
125
Nach erfolgreicher Verbindung zeigt FilaMan auf der **Druckerseite** und auf der **Spulen-Detailseite** alle AMS-Slots und deren aktuellen Inhalt an:
126
127
- **AMS-Slots** — Pro AMS-Einheit bis zu 4 Slots
128
- **External Tray** — Die externe Spulenzuführung des Druckers
129
- Angezeigt werden: Filamenttyp, Farbe, Temperaturbereich und Kalibrierungsstatus
130
- Die Anzeige aktualisiert sich in **Echtzeit** über Server-Sent Events (SSE)
131
132
Weitere Details zum Zuweisen von Spulen an Slots: → [Drucker: Spulen setzen](./09-drucker.md#spulen-setzen--übersicht)
133
134
---
135
136
## Migration älterer Versionen
137
138
Falls Sie das BambuLab-Plugin von einer älteren Version aktualisieren, werden bestehende Parameter automatisch umbenannt:
139
140
| Alter Name | Neuer Name |
141
|-----------|-----------|
142
| `bambu_cali_id` | `bambu_cali_idx` |
143
| `bambu_k` | `bambu_k_value` |
144
| `bambu_max_volspeed` | `bambu_max_volumetric_speed` |
145
| `bambu_nozzle_temp` | `bambu_nozzle_temp_min` |
146
147
Ihre vorhandenen Daten bleiben dabei erhalten — die Umbenennung erfolgt automatisch bei der ersten Druckerverbindung nach dem Update.
148
149
> **Hinweis:** Falls Sie zuvor Spoolman mit BambuLab-Feldern verwendet haben, migriert FilaMan auch diese Daten automatisch in das neue Drucker-Parameter-Format.
150
151
---
152
153
← [Zurück: Tipps & FAQ](./13-faq.md) | [Weiter: Weitere Plugins →](#)