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