flexi-bot/docs/marlin/_setting/extruder.md

label	brief	category	tags	pagetype	settings
Extruders	Extruder settings.	wip	hardware extruder	toc	name type default since brief long options example EXTRUDERS int 1 1.0.0 Total number of extruders. The number of addressable extruder tools that can be selected with `T0`, `T1`, etc. 0 1 2 3 4 5 6 7 8 value 2 name type since brief long example DEFAULT_NOMINAL_FILAMENT_DIA float 1.1.9 Default nominal filament diameter The expected filament diameter (1.75, 2.85, 3.0, ...). Used for Volumetric, Filament Width Sensor, etc. value 1.75 name disabled brief long subopts SINGLENOZZLE true Single nozzle with multiple steppers. Enable this option for a Cyclops extruder or any "multi-extruder" that shares a single nozzle. This option may be enabled automatically for certain types of extruder. name since disabled brief long SINGLENOZZLE_STANDBY_TEMP 2.0.0 true Single nozzle standby temperature. Save and restore the nozzle temperature when doing a tool-change. Set standby temperature for the unselected tool using `M104 T` or `M109 T`. name since disabled brief long SINGLENOZZLE_STANDBY_FAN 2.0.0 true Single nozzle standby fan speed. Save and restore the fan speed when doing a tool-change. Set standby fan speed for the unselected tool using `M106 T`. name since disabled brief long subopts SWITCHING_EXTRUDER 1.1.0 true Dual extruder sharing a single stepper motor. Various extruder designs exist allowing a single stepper motor to be shared with more than one extruder, usually by using a servo to move a pinch-wheel so that it engages a different filament input. Enable this option if you have one of these devices. name type brief default long SWITCHING_EXTRUDER_SERVO_NR int Switching Extruder servo number. 0 The servo used to switch extruder stepper motors. name type brief long default SWITCHING_EXTRUDER_SERVO_ANGLES { angle, angle … } Angles for E0, E1[, E2, E3] The servo angles applying to each E stepper motor. { 0, 90 } name type brief long default requires SWITCHING_EXTRUDER_E23_SERVO_NR int Switching Extruder servo number for E2 and E3. The servo used to switch extruder E2 and E3 stepper motors, if separate. 1 EXTRUDERS > 3 name brief long MECHANICAL_SWITCHING_EXTRUDER Switching extruder using movement. Switch extruders by bumping the toolhead. Requires `EVENT_GCODE_TOOLCHANGE_#`. name since brief long subopts SWITCHING_NOZZLE 1.1.2 Switching Nozzle A dual-nozzle that uses a servomotor to raise/lower one (or both) of the nozzles. Can be combined with `SWITCHING_EXTRUDER`. name type default SWITCHING_NOZZLE_SERVO_NR index 0 name type disabled default long SWITCHING_NOZZLE_E1_SERVO_NR index true 1 If two servos are used, the index of the second. name type disabled default long SWITCHING_NOZZLE_SERVO_ANGLES { angle, angle … } true { 0, 90 } Angles for E0, E1 (single servo) or lowered/raised (dual servo). name type disabled default long SWITCHING_NOZZLE_SERVO_DWELL ms true 2500 Dwell time to wait for servo to make physical move. name brief long MECHANICAL_SWITCHING_NOZZLE Mechanical Switching Nozzle Switch nozzles by bumping the toolhead. Requires `EVENT_GCODE_TOOLCHANGE_#`. name brief disabled long subopts PARKING_EXTRUDER Parking Extruder true Two separate X-carriages with extruders that connect to a moving part via a solenoid docking mechanism. Requires `SOL1_PIN` and `SOL2_PIN`. name type default brief PARKING_EXTRUDER_PARKING_X { mm, mm … } { -78, 184 } X positions for parking the extruders. name type default brief PARKING_EXTRUDER_GRAB_DISTANCE mm 1 Distance to move beyond the parking point to grab the extruder. name brief PARKING_EXTRUDER_SOLENOIDS_INVERT If enabled, the solenoid is NOT magnetized with applied voltage. name type default brief PARKING_EXTRUDER_SOLENOIDS_PINS_ACTIVE state LOW LOW or HIGH pin signal energizes the coil. name type default brief PARKING_EXTRUDER_SOLENOIDS_DELAY ms 250 Delay for magnetic field. No delay if 0 or not defined. name brief disabled MANUAL_SOLENOID_CONTROL Manual control of docking solenoids with `M380 S` / `M381`. true name brief disabled long links subopts MAGNETIC_PARKING_EXTRUDER Magnetic Parking Extruder true Two separate X-carriages with extruders that connect to a moving part via a magnetic docking mechanism using movements and no solenoid. label url Project https://www.thingiverse.com/thing:3080893 label url Movements Video 1 https://youtu.be/0xCEiG9VS3k label url Movements Video 2 https://youtu.be/Bqbcs0CU2FE name type default brief PARKING_EXTRUDER_PARKING_X { mm, mm … } { -78, 184 } X positions for parking the extruders. name type default brief PARKING_EXTRUDER_GRAB_DISTANCE mm 1 Distance to move beyond the parking point to grab the extruder. name type default brief MPE_FAST_SPEED mm/min 9000 Speed for travel before last distance point. name type default brief MPE_SLOW_SPEED mm/min 4500 Speed for last distance travel to park and couple. name type default brief MPE_TRAVEL_DISTANCE mm 10 Last distance point. name type default brief MPE_COMPENSATION int 0 Offset Compensation -1 , 0 , 1 (multiplier) only for coupling. name disabled brief long subopts SWITCHING_TOOLHEAD true Switching Toolhead Support for swappable and dockable toolheads, such as the E3D Tool Changer. Toolheads are locked with a servo. name type default brief SWITCHING_TOOLHEAD_Y_POS mm 235 Y position of the toolhead dock. name type default brief SWITCHING_TOOLHEAD_Y_SECURITY mm 10 Security distance Y axis. name type default brief SWITCHING_TOOLHEAD_Y_CLEAR mm 60 Minimum distance from dock for unobstructed X axis. name type default brief SWITCHING_TOOLHEAD_X_POS { mm, mm } { 215, 0 } X positions for parking the extruders. name type default brief SWITCHING_TOOLHEAD_SERVO_NR index 2 Index of the servo connector. name type default brief SWITCHING_TOOLHEAD_SERVO_ANGLES { angle, angle } { 0, 180 } Angles for Lock, Unlock. name disabled brief long subopts MAGNETIC_SWITCHING_TOOLHEAD true Magnetic Switching Toolhead Support swappable and dockable toolheads with a magnetic docking mechanism using movement and no servo. name type default brief SWITCHING_TOOLHEAD_Y_POS mm 235 Y position of the toolhead dock. name type default brief SWITCHING_TOOLHEAD_Y_SECURITY mm 10 Security distance Y axis. name type default brief SWITCHING_TOOLHEAD_Y_CLEAR mm 60 Minimum distance from dock for unobstructed X axis. name type default brief SWITCHING_TOOLHEAD_X_POS { mm, mm } { 215, 0 } X positions for parking the extruders. name type default brief SWITCHING_TOOLHEAD_Y_RELEASE mm 5 Security distance Y axis. name type default brief SWITCHING_TOOLHEAD_X_SECURITY { mm, mm } { 90, 150 } Security distance X axis (T0,T1). name brief disabled subopts PRIME_BEFORE_REMOVE Prime the nozzle before release from the dock. true name type default brief SWITCHING_TOOLHEAD_PRIME_MM mm 20 Extruder prime length. name type default brief SWITCHING_TOOLHEAD_RETRACT_MM mm 10 Retract after priming length. name type default brief SWITCHING_TOOLHEAD_PRIME_FEEDRATE mm/min 300 Extruder prime feedrate. name type default brief SWITCHING_TOOLHEAD_RETRACT_FEEDRATE mm/min 2400 Extruder retract feedrate. name disabled brief long subopts ELECTROMAGNETIC_SWITCHING_TOOLHEAD true Electromagnetic Switching Toolhead Parking for CoreXY / HBot kinematics. Toolheads are parked at one edge and held with an electromagnet. Supports more than 2 Toolheads. ([Video Demonstration](https://youtu.be/JolbsAKTKf4)). name type default brief SWITCHING_TOOLHEAD_Z_HOP mm 2 Z raise for switching. name since disabled brief long subopts MIXING_EXTRUDER 1.1.0 true Mixing Extruder - Adds G-codes `M163` and `M164` to set and "commit" the current mix factors. - Extends the stepping routines to move multiple steppers in proportion to the mix. - Optional support for Repetier Firmware's '`M164 S<index>`' supporting virtual tools. - This implementation supports up to two mixing extruders. - Enable `DIRECT_MIXING_IN_G1` for `M165` and mixing in `G1` (from Pia Taubert's reference implementation). name type default brief MIXING_STEPPERS int 2 Number of stepper motors in the mixing extruder. name type default brief MIXING_VIRTUAL_TOOLS int 16 Use the Virtual Tool method with `M163` and `M164`. name disabled brief DIRECT_MIXING_IN_G1 true Allow ABCDHI mix factors in `G1` movement commands. name disabled brief MIXING_PRESETS true Assign 8 default V-tool presets for 2 or 3 `MIXING_STEPPERS`. name disabled brief subopts GRADIENT_MIX true Support for gradient mixing with `M166` and LCD. name disabled brief GRADIENT_VTOOL true Add `M166 T` to use a V-tool index as a Gradient alias. name type disabled requires default long HOTEND_OFFSET_X { mm, mm … } true EXTRUDERS > 1 { 0.0, 20.00 } (mm) Relative X-offset for each nozzle. - Offset of the extruders (uncomment if using more than one and relying on firmware to position when changing). - The offset has to be 0 for the extruder 0 hotend (default extruder). - For the other hotends it is their distance from the extruder 0 hotend. name type disabled requires default long HOTEND_OFFSET_Y { mm, mm … } true EXTRUDERS > 1 { 0.0, 5.00 } (mm) Relative Y-offset for each nozzle. - Offset of the extruders (uncomment if using more than one and relying on firmware to position when changing). - The offset has to be 0 for the extruder 0 hotend (default extruder). - For the other hotends it is their distance from the extruder 0 hotend. name type disabled requires default long HOTEND_OFFSET_Z { mm, mm … } true EXTRUDERS > 1 { 0.0, 0.00 } (mm) Relative Z-offset for each nozzle. Used to precisely align Z with extruders that move out of the way. - Offset of the extruders (uncomment if using more than one and relying on firmware to position when changing). - The offset has to be 0 for the extruder 0 hotend (default extruder). - For the other hotends it is their distance from the extruder 0 hotend.

An extruder is a combination of one or more motors and heaters that push molten plastic to build objects.