Blame
|
1 | # 9. Printers |
||||||
| 2 | ||||||||
| 3 | **URL:** `http(s)://url/printers` |
|||||||
| 4 | ||||||||
| 5 |  |
|||||||
| 6 | ||||||||
| 7 | The Printers page is where you manage all **3D printers** registered in FilaMan. |
|||||||
| 8 | ||||||||
| 9 | ## Table Columns |
|||||||
| 10 | ||||||||
| 11 | | Column | Description | |
|||||||
| 12 | |--------|-------------| |
|||||||
|
13 | | **NAME** | Name of the printer (e.g. "Bambu Lab P1S #1") | |
||||||
|
14 | | **MODEL** | Printer model designation | |
||||||
| 15 | | **DRIVER** | Printer driver / connection type | |
|||||||
|
16 | | **STATUS** | Current operational status of the printer (Connected / Disconnected) | |
||||||
|
17 | | **ACTIONS** | Edit / Delete | |
||||||
| 18 | ||||||||
| 19 | ## Features |
|||||||
| 20 | ||||||||
| 21 | ### Add a Printer |
|||||||
| 22 | Click **"Add Printer"** in the top right. The form contains: |
|||||||
| 23 | - **Name** – Unique name for the printer |
|||||||
| 24 | - **Model** – Model designation |
|||||||
|
25 | - **Driver** – Driver or connection type (e.g. BambuLab, OctoPrint, Moonraker/Klipper) |
||||||
| 26 | - Additional printer-specific configuration options (depending on the driver) |
|||||||
|
27 | |||||||
| 28 | ### Printer Integration |
|||||||
|
29 | When a printer is connected, FilaMan can automatically track filament consumption and update spool fill levels, provided the printer is integrated via a compatible API. |
||||||
| 30 | ||||||||
| 31 | --- |
|||||||
| 32 | ||||||||
| 33 | ## BambuLab Integration |
|||||||
| 34 | ||||||||
| 35 | ### Supported Models |
|||||||
| 36 | FilaMan supports all BambuLab printers with an MQTT interface: |
|||||||
| 37 | - **P1P / P1S** – with AMS (Automatic Material System) |
|||||||
| 38 | - **X1 / X1C** – with AMS |
|||||||
| 39 | - **A1 / A1 Mini** – with AMS Lite |
|||||||
| 40 | ||||||||
| 41 | ### Configuration |
|||||||
| 42 | When adding a BambuLab printer, the following information is required: |
|||||||
| 43 | - **Host** – IP address of the printer on your local network |
|||||||
| 44 | - **Serial** – Serial number of the printer (found on the printer or in the Bambu Handy app) |
|||||||
| 45 | - **Access Code** – Access code (found in the printer's LAN settings) |
|||||||
| 46 | - **Printer Model** – Model designation (e.g. P1S, X1C, A1) — determines whether AMS or AMS Lite is displayed |
|||||||
| 47 | ||||||||
| 48 | ### AMS Slot Display |
|||||||
| 49 | After a successful connection, FilaMan shows all AMS slots and their current contents: |
|||||||
| 50 | - **AMS Slots** – Up to 4 slots per AMS unit (AMS) or 4 slots (AMS Lite) |
|||||||
| 51 | - **External Tray** – The printer's external spool feeder |
|||||||
| 52 | - Displayed information includes: filament type, color, temperature range, and calibration status |
|||||||
| 53 | ||||||||
| 54 | --- |
|||||||
| 55 | ||||||||
|
56 | > **Detailed information** about the BambuLab plugin (printer parameters, how to populate them, import, migration) can be found on the dedicated plugin page: → [Plugin: BambuLab](/Docs/En/14-Plugin-Bambulab) |
||||||
|
57 | |||||||
| 58 | --- |
|||||||
| 59 | ||||||||
| 60 | ## Setting Spools — Overview |
|||||||
| 61 | ||||||||
| 62 | FilaMan offers two ways to send filament settings (material type, color, temperature) to a printer slot: |
|||||||
| 63 | ||||||||
| 64 | | Method | Description | |
|||||||
| 65 | |--------|-------------| |
|||||||
| 66 | | **Manual** | The user selects a slot on the spool page and sends the settings directly | |
|||||||
| 67 | | **Automatic** | After weighing on an ESP32 scale, FilaMan detects insertion into an AMS slot and sends the settings automatically | |
|||||||
| 68 | ||||||||
| 69 | --- |
|||||||
| 70 | ||||||||
| 71 | ### Manual Assignment (Spool → Printer) |
|||||||
| 72 | ||||||||
| 73 | A spool can be manually assigned to a specific printer slot via the **spool detail page**. |
|||||||
| 74 | ||||||||
| 75 | **Prerequisites:** |
|||||||
| 76 | - The spool must be linked to a filament |
|||||||
| 77 | - At least one BambuLab printer must be connected (Status: Connected) |
|||||||
| 78 | ||||||||
| 79 | **Step by Step:** |
|||||||
| 80 | 1. Navigate to the **Spools page** (`/spools`) and open the desired spool |
|||||||
| 81 | 2. In the lower section of the spool detail page, you will see a **printer slot overview** — for each connected printer, the AMS slots are shown as colored dots: |
|||||||
| 82 | - 🟢 **Colored dot** = Slot occupied (color matches the inserted filament) |
|||||||
| 83 | - ❌ **Grey dot with X** = Slot empty |
|||||||
| 84 | 3. **Click on a slot dot** — a context menu opens with the following actions: |
|||||||
| 85 | - **"Assign spool"** — Sends this spool's filament settings to the selected slot |
|||||||
| 86 | - **"Import to spool"** — Imports the printer parameters (tray index, temperatures) from the slot into the spool |
|||||||
| 87 | - **"Import to spool & filament"** — Imports the parameters into both the spool and its associated filament |
|||||||
| 88 | 4. Select **"Assign spool"** — FilaMan automatically gathers the appropriate parameters (tray index, temperature ranges, material type, color) and sends them to the printer |
|||||||
| 89 | 5. On success, a **confirmation message** appears; on failure, an error message is shown |
|||||||
| 90 | ||||||||
| 91 | > **Note:** The sent parameters are merged from the **printer parameters** of both the spool and the filament. Spool parameters take priority over filament parameters. These can be adjusted in the respective spool or filament settings. |
|||||||
| 92 | ||||||||
| 93 | > **Tip:** The slot overview updates automatically in real time via Server-Sent Events (SSE). When a spool is inserted into or removed from an AMS slot, the display changes immediately. |
|||||||
| 94 | ||||||||
| 95 | --- |
|||||||
| 96 | ||||||||
| 97 | ### Automatic Assignment (Auto-Assignment) |
|||||||
| 98 | ||||||||
| 99 | Automatic spool assignment allows you to automatically send filament settings to the printer after weighing a spool on the ESP32 scale, as soon as the spool is inserted into an AMS slot. |
|||||||
| 100 | ||||||||
| 101 | **Prerequisites:** |
|||||||
| 102 | 1. An ESP32 device (scale) must be registered in Device Management |
|||||||
|
103 | 2. **Auto-Assign** must be enabled for the device (→ [Admin: Devices](/Docs/En/11-Admin#113-devices)) |
||||||
|
104 | 3. At least one BambuLab printer must be connected (Status: Connected) |
||||||
| 105 | ||||||||
| 106 | **Workflow:** |
|||||||
| 107 | 1. **Weighing** — A spool is placed on the ESP32 scale → weight is measured and sent to FilaMan |
|||||||
| 108 | 2. **Pending** — FilaMan identifies the spool (via RFID or manual assignment), caches the filament data (material type, color, temperatures), and sets it as "Pending" on **all** connected printers |
|||||||
| 109 | 3. **Insertion** — The spool is physically inserted into an AMS slot |
|||||||
| 110 | 4. **Detection** — FilaMan detects the tray data change via MQTT and automatically sends the correct filament settings to that specific slot |
|||||||
| 111 | 5. **Completion** — After successful transmission or timeout expiry, the pending status is cleared |
|||||||
| 112 | ||||||||
| 113 | **How does detection work?** |
|||||||
| 114 | FilaMan compares tray fields (filament type, color, calibration ID, setting ID) against the last known values with every MQTT status message. As soon as fields in a slot change (= new spool inserted), the pending filament is automatically sent to that slot. |
|||||||
| 115 | ||||||||
| 116 | > **Note:** Auto-assignment works for both AMS slots and the external spool feeder. |
|||||||
| 117 | ||||||||
|
118 | > **Important:** Auto-Assign is configured **per device** (scale), not per printer. When Auto-Assign is enabled, all connected printers are notified — the assignment happens automatically on whichever printer the spool is actually inserted into. Configuration: → [Admin: Devices](/Docs/En/11-Admin#113-devices) |
||||||
|
119 | |||||||
| 120 | --- |
|||||||
| 121 | ||||||||
|
122 | ← [Back: Locations](/Docs/En/08-Locations) | [Next: Settings →](/Docs/En/10-Settings) |
||||||