martyn/voronklipperconfig
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add happy hare base

Browse source
This commit is contained in:
Martyn 2025-03-20 15:00:37 +00:00
parent ffc94b539c
commit ab044994e3
23 changed files with 3002 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

924
mmu/addons/blobifier.cfg Normal file
View file

@ -0,0 +1,924 @@
# Include servo hardware definition separately to allow for automatic upgrade
[include blobifier_hw.cfg]
##########################################################################################
# Sample config to be used in conjunction with Blobifier Purge Tray, Bucket & Nozzle
# Scrubber mod. Created by Dendrowen (dendrowen on Discord). The Macro is based on a
# version, and Nozzle Scrubber is made by Hernsl (hernsl#8860 on Discord). The device is
# designed around a Voron V2.4 300mm, but should work for 250mm and 350mm too. This
# version only supports the assembly on the rear-left of the bed. If you decide to change
# that, please consider contributing to the project by creating a pull request with the
# needed changes.
# IMPORTANT: The rear-left part of your bed becomes unusable by this mod because the
# toolhead needs to lower down to 0. Be sure not to use the left-rear 130x35mm.
# The goals of this combination of devices is to dispose of purged filament during a
# multicolored print without the need of a purge block and without the flurries of
# filament poops consuming your entire 3D printer room. The Blobifier achieves that by
# purging onto a retractable tray which causes the filament to turn into a tiny blob
# rather then a large spiral. This keeps the waste relatively small. The bucket should be
# able to account for up to 200 filament swaps (for the 300mm V2).
# The Blobifier uses some room at the back-left side of your printer, depending on your
# printer limits and positions. (usually max_pos.y - toolhead_y and brush_start +
# brush_width + toolhead_x). If you do place objects within this region, Blobifier will
# skip purging automatically. It does this by extending the EXCLUDE_OBJECT_* macro's, so
# make sure you have exclude objects enabled in your slicer.
# If your using Blobifier in conjunction with the filament cutter on the stealthburner
# toolhead, you can place the pin at max_pos.y - 7 (e.g., max pos y is 307, place it at
# 300). The pin will then poke through the cavity in your toolhead. (Be careful with
# manually moving the toolhead. I have broken many filament cutter pins)
# It is advised to use the start_gcode from Happy Hare. Then you will be able to fully
# and efficiently use this mod. Check the Happy Hare document at gcode_preprocessing.md
# in the Happy Hare github for more details.
###################################### DISCLAIMER ########################################
# You, and you alone, are responsible for the correct execution of these macros and
# gcodes. Any damage that may occur to your machine remains your responsibility.
# Especially when executing this macro for the first few times, keep an eye on your
# printer and the
# emergency stop.
##########################################################################################
##########################################################################################
# Main macro. Usually you should only need to call this one or place it in the Happy Hare
# _MMU_POST_LOAD macro using the variable_user_post_load_extension:
#
# variable_user_post_load_extension : `BLOBIFIER`
#
# Notes on parameters:
# PURGE_LENGTH=[float] (optional) The length to purge. If omitted (default) it will check
# the purge_volumes matrix or variable_purge_length. This can be used
# to override and for testing.
#
[gcode_macro BLOBIFIER]
# These parameters define your filament purging.
# Note that the control of retraction is set in 'mmu_macro_vars.cfg' which can be increased
# if you experience excessive oozing.
variable_purge_spd: 400 # Speed, in mm/min, of the purge.
variable_purge_temp_min: 200 # Minimum nozzle purge temperature.
variable_toolhead_x: 70 # From the nozzle to the left of your toolhead
variable_toolhead_y: 50 # From the nozzle to the front of your toolhead
# This macro will prevent a gcode movement downward while 'blobbing' if there might be a
# print in the way (e.g. You print something large and need the area where Blobifier does
# its... 'business'). However, at low heights (or at print start) this might not be
# desireable. You can force a 'safe descend' with this variable. Keep in mind that the
# height of the print is an estimation based on previous heights and certain assumptions
# so it might be wise to include a safety margin of 0.2mm
variable_force_safe_descend_height_until: 1.0
# Adjust this so that your nozzle scrubs within the brush. Be careful not to go too low!
# Start out with a high value (like, 6) and go
# down from there.
variable_brush_top: 6
# These parameters define your scrubbing, travel speeds, safe z clearance and how many
# times you want to wipe. Update as necessary.
variable_clearance_z: 2 # When traveling, but not cleaning, the
# clearance along the z-axis between nozzle
# and brush.
variable_wipe_qty: 2 # Number of complete (A complete wipe: left,
# right, left OR right, left, right) wipes.
variable_travel_spd_xy: 10000 # Travel (not cleaning) speed along x and
# y-axis in mm/min.
variable_travel_spd_z: 1000 # Travel (not cleaning) speed along z axis
# in mm/min.
variable_wipe_spd_xy: 10000 # Nozzle wipe speed in mm/min.
# The acceleration to use when using the brush action. If set to 0, it uses the already
# set acceleration. However, in some cases this is not desirable for the last motion
# could be an 'outer contour' acceleration which is usually lower.
variable_brush_accel: 0
# Blobifier sends the toolhead to the maximum y position during purge operations and
# minimum x position during shake operations. This can cause issues when skew correction
# is set up. If you have skew correction enabled and get 'move out of range' errors
# regarding blobifier while skew is enabled, try increasing this value. Keep the
# adjustments small though! (0.1mm - 0.5mm) and increase it until it works.
variable_skew_correction: 0.1
# These parameters define the size of the brush. Update as necessary. A visual reference
# is provided below.
#
# ← brush_width →
# _________________
# | | ↑ Y position is acquired from your
# brush_start (x) | | brush_depth stepper_y position_max. Adjust
# |_________________| ↓ your brush physically in Y so
# (y) that the nozzle scrubs within the
# brush_front brush.
# __________________________________________________________
# PRINTER FRONT
#
#
# Start location of the brush. Defaults for 250, 300 and 350mm are provided below.
# Uncomment as necessary
#variable_brush_start: 34 # For 250mm build
variable_brush_start: 67 # For 300mm build
#variable_brush_start: 84 # for 350mm build
# width of the brush
variable_brush_width: 35
# Location of where to purge. The tray is 15mm in length, so if you assemble it against
# the side of the bed (default), 10mm is a good location
variable_purge_x: 10
# Height of the tray. If it's below your bed, give this a negative number equal to the
# difference. If it's above your bed, give it a positive number. You can find this number
# by homing, optional QGL or equivalent, and moving you toolhead above the tray, and
# lowering it with the paper method.
variable_tray_top: 0.7
# Servo angles for tray positions
variable_tray_angle_out: 0
variable_tray_angle_in: 180
# Increase this value if the servo doesn't have enough time to fully retract or extend
variable_dwell_time: 200
# ========================================================================================
# ==================== BLOB TUNING =======================================================
# ========================================================================================
# The following section defines how the purging sequence is executed. This is where you
# tune the purging to create pretty blobs. Refer to the visual reference for a better
# understanding. The visual is populated with example values. Below are some guides
# provided to help with tuning.
#
# \_____________/
# |___|___|
# \_/ ______________ < End of third iteration.
# / \ HEIGHT: 3 x iteration_z_raise - (2 + 1) x iteration_z_change (3 x 5 - 2 x 1.2 = 11.4)
# | | EXTRUDED: 3 x max_iteration_length (3 x 50 = 150)
# / \ ______________ < End of second iteration.
# | \ HEIGHT: 2 x iteration_z_raise - 1 x iteration_z_change (2 x 5 - 1 x 1.2 = 8.8)
# / | EXTRUDED: 2 x max_iteration_length (2 x 50 = 100)
# | \ ______________ < End of first iteration.
# / \ HEIGHT: 1 x iteration_z_raise (1 x 5 = 5)
# | | EXTRUDED: 1 x max_iteration_length (1 x 50 = 50)
#___________ \ / ______________ < Start height of the nozzle. default value: 1.5mm
# |_______________\___________/_ ______________ < Bottom of the tray
# |_____________________________|
# |
#
########################### BLOB TUNING ##############################
# +-------------------------------------+----------------------------+
# | Filament sticks to the nozzle at | Incr. purge start |
# | initial purge (first few mm) | |
# +-------------------------------------+----------------------------+
# | Filament scoots out from under | Incr. temperature |
# | the nozzle at the first iteration | Decr. z_raise |
# | | Incr. purge_length_maximum |
# +-------------------------------------+----------------------------+
# | Filament scoots out from under the | Decr. purge_spd |
# | the nozzle at later iterations | Decr. z_raise_exp |
# | | Decr. z_raise |
# | | Incr. purge_length_maximum |
# +-------------------------------------+----------------------------+
# | Filament sticks to the nozzle at | Incr. z_raise_exp |
# | later iterations | (Not above 1) |
# +-------------------------------------+----------------------------+
#
# The height to raise the nozzle above the tray before purging. This allows any built up
# pressure to escape before the purge.
variable_purge_start: 0.2
# The amount to raise Z
variable_z_raise: 12
# As the nozzle gets higher and the blob wider, the Z raise needs to be reduced, this
# follows the following formula:
# (extruded_amount/max_purge_length)^z_raise_exp * z_raise
# 1 is linear, below 1 will cause z to raise less quickly over time, above 1 will make it
# raise quicker over time. 0.85 is a good starting point and you should not have it above 1
variable_z_raise_exp: 0.85
# Lift the nozzle slightly after creating the blob te release pressure on the tray.
variable_eject_hop: 1.0
# Dwell time (ms) after purging and before cleaning to relieve pressure from the nozzle.
variable_pressure_release_time: 1000
# Set the part cooling fan speed. Disabling can help prevent the nozzle from cooling down
# and stimulate flow, Enabling it can prevent blobs from sticking together. Values range
# from 0 .. 1, or -1 if you don't want it changed.
#variable_part_cooling_fan: -1 # Leave it unchanged
#variable_part_cooling_fan: 0 # Disable the fan
variable_part_cooling_fan: 1 # Run it at full speed
# Define the part fan name if you are using a fan other than [fan]
# Applies to [fan_generic] or other fan definitons
# Example would be if you are using auxiliary fan control in Orcaslicer (https://github.com/SoftFever/OrcaSlicer/wiki/Auxiliary-fan)
# If you are unsure if you need this, then probably just leave it commented out.
#variable_fan_name: "fan_generic fan0"
# ========================================================================================
# ==================== PURGE LENGTH TUNING ===============================================
# ========================================================================================
# The absolute minimum to purge, even if you don't changed tools. This is to prime the
# nozzle before printing
variable_purge_length_minimum: 30
# The maximum amount of filament (in mm¹) to purge in a single blob. Blobifier will
# automatically purge multiple blobs if the purge amount exceeds this.
variable_purge_length_maximum: 150
# Default purge length to fall back on when neither the tool map purge_volumes or
# parameter PURGE_LENGTH is set.
variable_purge_length: 150
# The slicer values often are a bit too wasteful. Tune it here to get optimal values.
# 0.6 (60%) is a good starting point.
variable_purge_length_modifier: 0.6
# Fixed length of filament to add after the purge volume calculation. Happy Hare already
# shares info on the extra amount of filament to purge based on known residual filament,
# tip cutting fragment and initial retraction setting. However this setting can add a fixed
# amount on top on that if necessary although it is recommended to start with 0 and tune
# slicer purge matrix first.
# When should you alter this value:
# INCREASE: When the dark to light swaps are good, but light to dark aren't.
# DECREASE: When the light to dark swaps are good, but dark to light aren't. Don't
# forget to increase the purge_length_modifier
variable_purge_length_addition: 0
# ========================================================================================
# ==================== BUCKET ============================================================
# ========================================================================================
# Maximum number of blobs that fit in the bucket. Pauses the print if it exceeds this
# number.
variable_max_blobs: 400
# Enable the bucket shaker. You need to have the shaker.stl installed
variable_enable_shaker: 1
# The number of back-and-forth motions of one shake
variable_bucket_shakes: 10
# During shaking acceleration can often be higher because you don't need to keep print
# quality in mind. Higher acceleration helps better with dispersing the blobs.
variable_shake_accel: 10000
# The frequency at which to shake the bucket. A decimal value ranging from 0 to 1, where 0
# is never, and 1 is every time. This way the shaking occurs more often as the bucket
# fills up. Sensible values range from 0.75 to 0.95
variable_bucket_shake_frequency: 0.95
# Height of the shaker arm. If your hotend hits your tray during shaking, increase.
variable_shaker_arm_z: 2
gcode:
# ======================================================================================
# ==================== RECORD STATE (INCL. FANS, SPEEDS, ETC...) =======================
# ======================================================================================
# General state
SAVE_GCODE_STATE NAME=BLOBIFIER_state
# ======================================================================================
# ==================== CHECK HOMING STATUS =============================================
# ======================================================================================
{% if "xyz" not in printer.toolhead.homed_axes %}
RESPOND MSG="BLOBIFIER: Not homed! Home xyz before blobbing"
{% elif printer.quad_gantry_level and printer.quad_gantry_level.applied == False %}
RESPOND MSG="BLOBIFIER: QGL not applied! run quad_gantry_level before blobbing"
{% else %}
# Part cooling fan
{% if part_cooling_fan >= 0 %}
{% set fan = fan_name|string %}
# Save the part cooling fan speed to be enabled again later
{% set backup_fan_speed = (printer[fan].speed if printer[fan] is defined else printer.fan.speed) %}
# Set part cooling fan speed
M106 S{part_cooling_fan * 255}
{% endif %}
# Set feedrate to 100% for correct speed purging
{% set backup_feedrate = printer.gcode_move.speed_factor %}
M220 S100
# ======================================================================================
# ==================== DEFINE BASIC VARIABLES ==========================================
# ======================================================================================
{% set sequence_vars = printer['gcode_macro _MMU_SEQUENCE_VARS'] %}
{% set park_vars = printer['gcode_macro _MMU_PARK'] %}
{% set filament_diameter = printer.configfile.config.extruder.filament_diameter|float %}
{% set filament_cross_section = (filament_diameter/2) ** 2 * 3.1415 %}
{% set from_tool = printer.mmu.last_tool %}
{% set to_tool = printer.mmu.tool %}
{% set bl_count = printer['gcode_macro _BLOBIFIER_COUNT'] %}
{% set pos = printer.gcode_move.gcode_position %}
{% set safe = printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'] %}
{% set ignore_safe = safe.print_height < force_safe_descend_height_until %}
{% set restore_z = [printer['gcode_macro BLOBIFIER_PARK'].restore_z,pos.z]|max %}
{% set pos_max = printer.toolhead.axis_maximum %}
{% set position_y = pos_max.y - skew_correction %}
# Get purge volumes from the slicer (if set up right. see
# https://github.com/moggieuk/Happy-Hare/wiki/Gcode-Preprocessing)
{% set pv = printer.mmu.slicer_tool_map.purge_volumes %}
# ======================================================================================
# ==================== DETERMINE PURGE LENGTH ==========================================
# ======================================================================================
{% if params.PURGE_LENGTH %} # =============== PARAM PURGE LENGTH ======================
{action_respond_info("BLOBIFIER: param PURGE_LENGTH provided")}
{% set purge_len = params.PURGE_LENGTH|float %}
{% elif from_tool == to_tool and to_tool >= 0 %} # ==== TOOL DIDN'T CHANGE =============
{action_respond_info("BLOBIFIER: Tool didn't change (T%s > T%s), %s" % (from_tool, to_tool, "priming" if purge_length_minimum else "skipping"))}
{% set purge_len = 0 %}
{% elif pv %} # ============== FETCH FROM HAPPY HARE (LIKELY FROM SLICER) ==============
{% if from_tool < 0 and to_tool >= 0%}
{action_respond_info("BLOBIFIER: from tool unknown. Finding largest value for T? > T%d" % to_tool)}
{% set purge_vol = pv|map(attribute=to_tool)|max %}
{% elif to_tool < 0 %}
{action_respond_info("BLOBIFIER: tool(s) unknown. Finding largest value")}
{% set purge_vol = pv|map('max')|max %}
{% else %}
{% set purge_vol = pv[from_tool][to_tool]|float * purge_length_modifier %}
{action_respond_info("BLOBIFIER: Swapped T%s > T%s" % (from_tool, to_tool))}
{% endif %}
{% set purge_len = purge_vol / filament_cross_section %}
{% set purge_len = purge_len + printer.mmu.extruder_filament_remaining + park_vars.retracted_length + purge_length_addition %}
{% else %} # ========================= USE CONFIG VARIABLE =============================
{action_respond_info("BLOBIFIER: No toolmap or PURGE_LENGTH. Using default")}
{% set purge_len = purge_length|float + printer.mmu.extruder_filament_remaining + park_vars.retracted_length %}
{% endif %}
# ==================================== APPLY PURGE MINIMUM =============================
{% set purge_len = [purge_len,purge_length_minimum]|max|round(0, 'ceil')|int %}
{action_respond_info("BLOBIFIER: Purging %dmm of filament" % (purge_len))}
# ======================================================================================
# ==================== PURGING SEQUENCE ================================================
# ======================================================================================
# Set to absolute positioning.
G90
# Check for purge length and purge if necessary.
{% if purge_len|float > 0 %}
# ====================================================================================
# ==================== POSITIONING ===================================================
# ====================================================================================
# Retract the tray so it is not in the way
BLOBIFIER_SERVO POS=in
# Move to the assembly, first a bit more to the right (brush_start) to avoid a
# potential filametrix pin if it's not already on the same Y coordinate.
{% if printer.toolhead.position.y != position_y %}
G1 X{[brush_start - 20, 30]|max} Y{position_y} F{travel_spd_xy}
{% endif %}
# ====================================================================================
# ==================== BUCKET SHAKE ==================================================
# ====================================================================================
{% if enable_shaker and (safe.shake or ignore_safe) %}
{% if (bl_count.current_blobs + 1) >= bl_count.next_shake %}
BLOBIFIER_SHAKE_BUCKET SHAKES={bucket_shakes}
_BLOBIFIER_CALCULATE_NEXT_SHAKE
{% endif %}
{% endif %}
# ====================================================================================
# ==================== POSITIONING ON TRAY ===========================================
# ====================================================================================
{% if safe.tray or ignore_safe %}
G1 Z{tray_top + purge_start} F{travel_spd_z}
{% endif %}
# Move over to the tray after z change (For cases when the tool is lower than the tray)
G1 X{purge_x} F{travel_spd_xy}
# Extend the tray
BLOBIFIER_SERVO POS=out
# ====================================================================================
# ==================== HEAT HOTEND ===================================================
# ====================================================================================
{% if printer.extruder.temperature < purge_temp_min %}
{% if printer.extruder.target < purge_temp_min %}
M109 S{purge_temp_min}
{% else %}
TEMPERATURE_WAIT SENSOR=extruder MINIMUM={purge_temp_min}
{% endif %}
{% endif %}
# ====================================================================================
# ==================== START ITERATING ===============================================
# ====================================================================================
# Calculate total number of iterations based on the purge length and the max_iteration
# length.
{% set blobs = (purge_len / purge_length_maximum)|round(0, 'ceil')|int %}
{% set purge_per_blob = purge_len|float / blobs %}
{% set retracts_per_blob = (purge_per_blob / 40)|round(0, 'ceil')|int %}
{% set purge_per_retract = (purge_per_blob / retracts_per_blob)|int %}
{% set pulses_per_retract = (purge_per_blob / retracts_per_blob / 5)|round(0, 'ceil')|int %}
{% set pulses_per_blob = (purge_per_blob / 5)|round(0, 'ceil')|int %}
{% set purge_per_pulse = purge_per_blob / pulses_per_blob %}
{% set pulse_time_constant = purge_per_pulse * 0.95 / purge_spd / (purge_per_pulse * 0.95 / purge_spd + purge_per_pulse * 0.05 / 50) %}
{% set pulse_duration = purge_per_pulse / purge_spd %}
# Repeat the process until purge_len is reached
{% for blob in range(blobs) %}
RESPOND MSG={"'BLOBIFIER: Blob %d of %d (%.1fmm)'" % (blob + 1, blobs, purge_per_blob)}
{% if safe.tray or ignore_safe %}
G1 Z{tray_top + purge_start} F{travel_spd_z}
{% endif %}
# relative positioning
G91
# relative extrusion
M83
# Purge filament in a pulsating motion to purge the filament quicker and better
{% for pulse in range(pulses_per_blob) %}
# Calculations to determine z-speed
{% set purged_this_blob = pulse * purge_per_pulse %}
{% set z_last_pos = purge_start + ((purged_this_blob)/purge_length_maximum)**z_raise_exp * z_raise %}
{% set z_pos = purge_start + ((purged_this_blob + purge_per_pulse)/purge_length_maximum)**z_raise_exp * z_raise %}
{% set z_up = z_pos - z_last_pos %}
{% set speed = z_up / pulse_duration %}
# Purge quickly
G1 Z{z_up * pulse_time_constant} E{purge_per_pulse * 0.95} F{speed}
# Purge a tiny bit slowly
G1 Z{z_up * (1 - pulse_time_constant)} E{purge_per_pulse * 0.05} F{speed}
# retract and unretract filament every now and then for thorough cleaning
{% if pulse % pulses_per_retract == 0 and pulse > 0 %}
G1 E-2 F1800
G1 E2 F800
{% endif %}
{% endfor %}
# Retract to match what Happy Hare is expecting
G1 E-{park_vars.retracted_length} F{sequence_vars.retract_speed * 60}
# ==================================================================================
# ==================== DEPOSIT BLOB ================================================
# ==================================================================================
{% if safe.tray or ignore_safe %}
# Raise z a bit to relieve pressure on the blob preventing it to go sideways
G1 Z{eject_hop} F{travel_spd_z}
# Retract the tray
BLOBIFIER_SERVO POS=in
# Move the toolhead down to purge_start height lowering the blob below the tray
G90 # absolute positioning
G1 Z{tray_top} F{travel_spd_z}
# Extend the tray to 'cut off' the blob and prepare for the next blob
BLOBIFIER_SERVO POS=out
BLOBIFIER_SERVO POS=in
BLOBIFIER_SERVO POS=out
# Keep track of the # of blobs
_BLOBIFIER_COUNT
{% endif %}
{% endfor %}
{% endif %}
{% if safe.tray or ignore_safe %}
G1 Z{tray_top + 1} F{travel_spd_z}
G4 P{pressure_release_time}
{% endif %}
{% if safe.brush or ignore_safe %}
BLOBIFIER_CLEAN
{% else %}
G1 X{brush_start} F{travel_spd_xy}
{% endif %}
# ======================================================================================
# ==================== RESTORE STATE ===================================================
# ======================================================================================
G90 # absolute positioning
G1 Z{restore_z} F{travel_spd_z}
{% if part_cooling_fan >= 0 %}
# Reset part cooling fan if it was changed
M106 S{(backup_fan_speed * 255)|int}
{% endif %}
M220 S{(backup_feedrate * 100)|int}
{% endif %}
# Retract the tray
BLOBIFIER_SERVO POS=in
RESTORE_GCODE_STATE NAME=BLOBIFIER_state
##########################################################################################
# Wipes the nozzle on the brass brush
#
[gcode_macro BLOBIFIER_CLEAN]
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set pos_max = printer.toolhead.axis_maximum %}
{% set position_y = pos_max.y - bl.skew_correction %}
{% set original_accel = printer.toolhead.max_accel %}
{% set original_minimum_cruise_ratio = printer.toolhead.minimum_cruise_ratio %}
{% set pos = printer.gcode_move.gcode_position %}
SAVE_GCODE_STATE NAME=BLOBIFIER_CLEAN_state
G90
{% if bl.brush_accel > 0 %}
SET_VELOCITY_LIMIT ACCEL={bl.brush_accel} MINIMUM_CRUISE_RATIO=0.1
{% endif %}
{% if pos.z < bl.brush_top + bl.clearance_z %}
G1 Z{bl.brush_top + bl.clearance_z} F{bl.travel_spd_z}
{% endif %}
G1 X{bl.brush_start} F{bl.travel_spd_xy}
G1 Y{position_y}
G1 Z{bl.brush_top + bl.clearance_z} F{bl.travel_spd_z}
# Move nozzle down into brush.
G1 Z{bl.brush_top} F{bl.travel_spd_z}
SET_VELOCITY_LIMIT ACCEL={original_accel} MINIMUM_CRUISE_RATIO={original_minimum_cruise_ratio}
# Perform wipe. Wipe direction based off bucket_pos for cool random scrubby routine.
{% for wipes in range(1, (bl.wipe_qty + 1)) %}
G1 X{bl.brush_start + bl.brush_width} F{bl.wipe_spd_xy}
G1 X{bl.brush_start} F{bl.wipe_spd_xy}
{% endfor %}
# Move away from the brush, but not onto the tray or in front of the filametrix cutter pin
G1 X{[bl.brush_start - 20, 30]|max} F{bl.travel_spd_xy}
RESTORE_GCODE_STATE NAME=BLOBIFIER_CLEAN_state
##########################################################################################
# Park the nozzle on the tray to prevent oozing during filament swaps. Place this
# extension in the post_form_tip extension in mmu_macro_vars.cfg:
# variable_user_post_form_tip_extension: "BLOBIFIER_PARK"
#
[gcode_macro BLOBIFIER_PARK]
variable_restore_z: 0
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set pos = printer.gcode_move.gcode_position %}
{% set safe = printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'] %}
{% set pos_max = printer.toolhead.axis_maximum %}
{% set position_y = pos_max.y - bl.skew_correction %}
SET_GCODE_VARIABLE MACRO=BLOBIFIER_PARK VARIABLE=restore_z VALUE={pos.z}
SAVE_GCODE_STATE NAME=blobifier_park_state
{% if "xyz" in printer.toolhead.homed_axes and printer.quad_gantry_level and printer.quad_gantry_level.applied %}
G90
# Retract the tray
BLOBIFIER_SERVO POS=in
G1 X{[bl.brush_start - 20, 30]|max} Y{position_y} F{bl.travel_spd_xy}
{% if safe.tray or ignore_safe %}
G1 Z{bl.tray_top} F{bl.travel_spd_z}
{% endif %}
G1 X{bl.purge_x} F{bl.travel_spd_xy}
# Extend the tray
BLOBIFIER_SERVO POS=out
{% else %}
RESPOND MSG="Please home (and QGL) before parking"
{% endif %}
RESTORE_GCODE_STATE NAME=blobifier_park_state
##########################################################################################
# Retract or extend the tray
# POS=[in|out] Retractor extend the tray
#
[gcode_macro BLOBIFIER_SERVO]
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set pos = params.POS %}
{% if pos == "in" %}
SET_SERVO SERVO=blobifier ANGLE={bl.tray_angle_in}
G4 P{bl.dwell_time}
{% elif pos == "out" %}
SET_SERVO SERVO=blobifier ANGLE={bl.tray_angle_out}
G4 P{bl.dwell_time}
{% else %}
{action_respond_info("BLOBIFIER: provide POS=[in|out]")}
{% endif %}
SET_SERVO SERVO=blobifier WIDTH=0
##########################################################################################
# Define exclude objects for those who haven't already
#
[exclude_object]
##########################################################################################
# Overwrite the existing EXCLUDE_OBJECT_DEFINE to also check for safe descend.
#
[gcode_macro EXCLUDE_OBJECT_DEFINE]
rename_existing: _EXCLUDE_OBJECT_DEFINE
gcode:
# only reset on the first object at the beginning of a print
{% if printer.exclude_object.objects|length < 1 %}
_BLOBIFIER_RESET_SAFE_DESCEND
{% endif %}
_EXCLUDE_OBJECT_DEFINE {rawparams}
_BLOBIFIER_SAFE_DESCEND
UPDATE_DELAYED_GCODE ID=BLOBIFIER_SHOW_SAFE_DESCEND DURATION=1
[delayed_gcode BLOBIFIER_SHOW_SAFE_DESCEND]
gcode:
{% set safe = printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'] %}
{action_respond_info(
"BLOBIFIER: Safe descend possible:\n - tray: %s\n - brush: %s\n - shake: %s" %
(
"yes" if safe.tray else "no",
"yes" if safe.brush else "no",
"yes" if safe.shake else "no"
)
)}
##########################################################################################
# Use the EXCLUDE_OBJECT_START gcode macro to record the current height
#
[gcode_macro EXCLUDE_OBJECT_START]
rename_existing: _EXCLUDE_OBJECT_START
gcode:
_EXCLUDE_OBJECT_START {rawparams}
{% if printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'].first_layer %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=first_layer VALUE=False
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=print_height VALUE={printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'].print_layer_height}
{% else %}
{% set pos = printer.gcode_move.gcode_position %}
{% set last_height = printer['gcode_macro _BLOBIFIER_SAFE_DESCEND'].print_previous_height|float %}
{% if pos.z > last_height %}
{% set last_layer = (pos.z - last_height)|round(2) %}
{% set print_height = (pos.z + last_layer)|round(2) %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=print_previous_height VALUE={pos.z}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=print_height VALUE={print_height}
{% endif %}
{% endif %}
##########################################################################################
# Reset the safe descend variables.
#
[gcode_macro _BLOBIFIER_RESET_SAFE_DESCEND]
gcode:
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=tray VALUE=True
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=brush VALUE=True
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=shake VALUE=True
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=first_layer VALUE=True
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=print_height VALUE=0
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=print_previous_height VALUE=0
##########################################################################################
# Determine if it is safe to drop the toolhead (e.g. not hit a print)
#
[gcode_macro _BLOBIFIER_SAFE_DESCEND]
variable_tray: True # Assume it is safe
variable_brush: True
variable_shake: True
variable_first_layer: True
variable_print_height: 0
variable_print_previous_height: 0
variable_print_layer_height: 0.3
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set pos_max = printer.toolhead.axis_maximum %}
{% set position_y = pos_max.y - bl.skew_correction %}
{% set tray = [bl.purge_x + bl.toolhead_x, position_y - bl.toolhead_y] %}
{% set brush = [bl.brush_start + bl.brush_width + bl.toolhead_x, position_y - bl.toolhead_y] %}
{% set shake = [bl.purge_x + bl.toolhead_x, position_y - bl.toolhead_y - 4] %}
{% set objects = printer.exclude_object.objects | map(attribute='polygon') %}
{% for polygon in objects %}
{% for point in polygon %}
{% if point[0] < tray[0] and point[1] > tray[1] %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=tray VALUE=False
{% endif %}
{% if point[0] < brush[0] and point[1] > brush[1] %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=brush VALUE=False
{% endif %}
{% if point[0] < shake[0] and point[1] > shake[1] %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_SAFE_DESCEND VARIABLE=shake VALUE=False
{% endif %}
{% endfor %}
{% endfor %}
##########################################################################################
# Increment the blob count with 1 and check if the bucket is full. Pause
# the printer if it is.
#
[gcode_macro _BLOBIFIER_COUNT]
# Don't change these variables
variable_current_blobs: 0
variable_last_shake: 0
variable_next_shake: 0
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set count = printer['gcode_macro _BLOBIFIER_COUNT'] %}
{% if current_blobs >= bl.max_blobs %}
{action_respond_info("BLOBIFIER: Empty purge bucket!")}
M117 Empty purge bucket!
MMU_PAUSE MSG="Empty purge bucket!"
{% else %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=current_blobs VALUE={current_blobs + 1}
_BLOBIFIER_SAVE_STATE
{action_respond_info(
"BLOBIFIER: Blobs in bucket: %s/%s. Next shake @ %s"
% (current_blobs + 1, bl.max_blobs, next_shake)
)}
{% endif %}
##########################################################################################
# Reset the blob count to 0
#
[gcode_macro _BLOBIFIER_COUNT_RESET]
gcode:
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=current_blobs VALUE=0
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=last_shake VALUE=0
_BLOBIFIER_SAVE_STATE
_BLOBIFIER_CALCULATE_NEXT_SHAKE
##########################################################################################
# Shake the blob bucket to disperse the blobs
#
[gcode_macro BLOBIFIER_SHAKE_BUCKET]
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set count = printer['gcode_macro _BLOBIFIER_COUNT'] %}
{% set original_accel = printer.toolhead.max_accel %}
{% set original_minimum_cruise_ratio = printer.toolhead.minimum_cruise_ratio %}
{% set position_x = bl.skew_correction %}
{% if "xyz" not in printer.toolhead.homed_axes %}
{action_raise_error("BLOBIFIER: Not homed. Home xyz first")}
{% endif %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=last_shake VALUE={count.current_blobs}
_BLOBIFIER_SAVE_STATE
SAVE_GCODE_STATE NAME=shake_bucket
M400
M117 (^_^)
G90
{% set shakes = params.SHAKES|default(10)|int %}
{% set pos_max = printer.toolhead.axis_maximum %}
{% set position_y = pos_max.y - bl.skew_correction %}
# move to save y if not already there
{% if printer.toolhead.position.y != position_y %}
G1 X{bl.brush_start} Y{position_y} F{bl.travel_spd_xy}
{% endif %}
# Retract the tray
BLOBIFIER_SERVO POS=in
# move up a bit to prevent oozing on base
G1 Z{bl.shaker_arm_z} F{bl.travel_spd_z}
# slide into the slot
G1 X{position_x} F{bl.travel_spd_xy}
M400
M117 (+(+_+)+)
SET_VELOCITY_LIMIT ACCEL={bl.shake_accel} MINIMUM_CRUISE_RATIO=0.1
# Shake away!
{% for shake in range(1, shakes) %}
G1 Y{position_y - 4}
G1 Y{position_y}
{% endfor %}
SET_VELOCITY_LIMIT ACCEL={original_accel} MINIMUM_CRUISE_RATIO={original_minimum_cruise_ratio}
# move out of slot
G1 X{bl.purge_x}
M400
M117 (X_x)
RESTORE_GCODE_STATE NAME=shake_bucket
##########################################################################################
# Calculate when the bucket should be shaken.
#
[gcode_macro _BLOBIFIER_CALCULATE_NEXT_SHAKE]
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
{% set count = printer['gcode_macro _BLOBIFIER_COUNT'] %}
{% set remaining_blobs = bl.max_blobs - count.last_shake %}
{% set next_shake = (1 - bl.bucket_shake_frequency) * remaining_blobs + count.last_shake %}
_BLOBIFIER_SAVE_STATE
_BLOBIFIER_SET_NEXT_SHAKE VALUE={next_shake|int}
##########################################################################################
# Set when the bucket should be shaken next
# VALUE=[int] At what amount of blobs should it be shaken
#
[gcode_macro _BLOBIFIER_SET_NEXT_SHAKE]
gcode:
{% if params.VALUE %}
{% set next_shake = params.VALUE %}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=next_shake VALUE={next_shake}
_BLOBIFIER_SAVE_STATE
{% else %}
{action_respond_info("BLOBIFIER: Provide parameter VALUE=")}
{% endif %}
##########################################################################################
# Some sanity checks
#
[delayed_gcode BLOBIFIER_INIT]
initial_duration: 5.0
gcode:
_BLOBIFIER_INIT
# Extend and retract the tray to test
BLOBIFIER_SERVO POS=out
BLOBIFIER_SERVO POS=in
[gcode_macro _BLOBIFIER_INIT]
gcode:
{% set bl = printer['gcode_macro BLOBIFIER'] %}
# Valid part cooling fan setting
{% if bl.part_cooling_fan != -1 and (bl.part_cooling_fan < 0 or bl.part_cooling_fan > 1) %}
{action_emergency_stop("BLOBIFIER: Value %f is invalid for variable part_cooling_fan. Either -1 or a value from 0 .. 1 is valid." % (bl.part_cooling_fan))}
{% endif %}
# Valid bucket shake frequency
{% if bl.bucket_shake_frequency < 0 or bl.bucket_shake_frequency > 1 %}
{action_emergency_stop("BLOBIFIER: Value %f is invalid for variable bucket_shake_frequency. Change it to a value between 0 .. 1" % (bl.bucket_shake_frequency))}
{% endif %}
# Check if position is on 'next'
{% if printer.mmu %}
{% if printer['gcode_macro _MMU_SEQUENCE_VARS'].restore_xy_pos != 'next' %}
{action_respond_info("BLOBIFIER: If not using a wipe tower, consider setting restore_xy_pos: 'next' in mmu_macro_vars.cfg")}
{% endif %}
{% endif %}
# Check the z_raise variable for normal values
{% if bl.z_raise < 3 %}
{action_respond_info("BLOBIFIER: variable_z_raise: %f is very low. This is the value z raises in total on a single blob. Make sure the value is correct before continuing." % (bl.z_raise))}
{% endif %}
# Z raise exponent
{% if bl.z_raise_exp > 1 or bl.z_raise_exp < 0.5 %}
{action_respond_info("BLOBIFIER: variable_z_raise_exp has value: %f. This value is out of spec (0.5 ... 1.0)." % (bl.z_raise_exp))}
{% endif %}
# cap user defined accels at printer max_accel if greater
{% if bl.shake_accel > printer.configfile.config.printer.max_accel|int %}
{action_respond_info("BLOBIFIER: variable_shake_accel has value: %d which is higher than your printer limit of %d. Reduce this if your printer skips steps." % (bl.shake_accel,printer.configfile.config.printer.max_accel|int))}
{% endif %}
{% if bl.brush_accel > printer.configfile.config.printer.max_accel|int %}
{action_respond_info("BLOBIFIER: variable_brush_accel has value: %d which is higher than your printer limit of %d. Reduce this if your printer skips steps." % (bl.brush_accel,printer.configfile.config.printer.max_accel|int))}
{% endif %}
[delayed_gcode BLOBIFIER_LOAD_STATE]
initial_duration: 2.0 # Give it some time to boot up
gcode:
{% set sv = printer.save_variables.variables.blobifier %}
{% if sv %}
# Restore state
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=last_shake VALUE={sv.last_shake}
SET_GCODE_VARIABLE MACRO=_BLOBIFIER_COUNT VARIABLE=current_blobs VALUE={sv.current_blobs}
{% endif %}
_BLOBIFIER_CALCULATE_NEXT_SHAKE
[gcode_macro _BLOBIFIER_SAVE_STATE]
gcode:
{% set count = printer['gcode_macro _BLOBIFIER_COUNT'] %}
{% set sv = {'current_blobs': count.current_blobs, 'last_shake': count.last_shake} %}
SAVE_VARIABLE VARIABLE=blobifier VALUE="{sv}"

28
mmu/addons/blobifier_hw.cfg Normal file
View file

@ -0,0 +1,28 @@
##########################################################################################
# The servo hardware configuration. Change the values to your needs.
#
[mmu_servo blobifier]
# Pin for the servo.
pin: PG14
# Adjust this value until a 'BLOBIFIER_SERVO POS=out' extends the tray fully without a
# buzzing sound
minimum_pulse_width: 0.00053
# Adjust this value until a 'BLOBIFIER_SERVO POS=in' retracts the tray fully without a
# buzzing sound
maximum_pulse_width: 0.0023
# Leave this value at 180
maximum_servo_angle: 180
##########################################################################################
# The bucket hardware configuration. Change the pin to whatever pin you've connected the
# switch to.
#
[gcode_button bucket]
pin: ^PG15 # The pullup ( ^ ) is important here.
press_gcode:
M117 bucket installed
release_gcode:
M117 bucket removed
_BLOBIFIER_COUNT_RESET

202
mmu/addons/dc_espooler.cfg Normal file
View file

@ -0,0 +1,202 @@
####################################
# Variables for the eSpooler macros
#
# Configure these for your setup.
#
[gcode_macro _MMU_ESPOOLER_VARS]
# Prefix of name of the `output_pin` for the eSpooler.
# The `output_pin` name must follow the pattern {prefix}_rwd_{gate}
# and {prefix}_en_{gate}. By default we prefix it with an underscore
# to prevent them from being shown in UI applications (like mainsail).
#
variable_pin_prefix: '_mmu_dc_espooler'
# Default max number of seconds for eSpooler to run
# Note: Each time any eSpooler **starts** it will restart the timeout
#
variable_default_timeout: 60
# The step speed where you want to max out the eSpooler to run at full speed.
#
variable_max_step_speed: 200
# Minimum distance of a move required to activate the eSpooler
# The lowest valid value for this is 50 because eSpooler macros
# will not even be considered if the distance is less than 50.
#
variable_min_distance: 200
# Adjusts the speed conversion ratio
# For the following examples, let's assume max_step_speed = 50.
# And remember actual eSpooler speed values are between 0.0 (off) and 1.0 (full speed) (inclusive)
#
# The formula looks like this:
# ({step_speed} / {max_step_speed}) ^ {step_speed_exponent}
#
# With step_speed_exponent of 1 would have a linear ratio:
# If I am running with a step speed of 50mm/s, the eSpooler would run at full speed (1.0)
# Calculated via (50/50)^1
# If I am running with a step speed of 25mm/s, the eSpooler would run at half speed (0.5)
# Calculated via (25/50)^1
#
# With step_speed_exponent of 0.2 would have a linear ratio:
# If I am running with a step speed of 50mm/s, the eSpooler would run at full speed (1.0)
# Calculated via (50/50)^0.2
# If I am running with a step speed of 25mm/s, the eSpooler would run at half speed (0.87)
# Calculated via (25/50)^0.2
#
variable_step_speed_exponent: 0.5
# Internal variable for tracking the gates with eSpoolers
variable_espooler_gates: ''
gcode: # Leave empty
###########################################################################
# Include DC motor pin definitions
#
# This should be after the eSpooler vars macro to ensure the users
# custom vars override our default ones.
#
[include dc_espooler_hw.cfg]
###########################################################################
# Macro to actuate the correct DC motor for the gate being unloaded
#
# Easiest integration is to set this in mmu_parameters.cfg:
#
# eSpooler_start_macro: MMU_ESPOOLER_START
#
[gcode_macro MMU_ESPOOLER_START]
gcode:
_MMU_ESPOOLER_CTL {rawparams}
# Param hints UI
{% set dummy = None if True else "
{% set d = params.GATE|default(current_gate)|int %}
{% set d = params.SCALE|default(cfg_scale)|float %}
{% set d = params.TIMEOUT|default(default_timeout)|float %}
" %} # End param hints for UI
###########################################################################
# Macro to stop the DC eSpooler motor
#
# Easiest integration is to set this in mmu_macro_vars.cfg:
#
# eSpooler_stop_macro: MMU_ESPOOLER_STOP
#
[gcode_macro MMU_ESPOOLER_STOP]
gcode:
_MMU_ESPOOLER_CTL {rawparams} SPEED={0}
# Param hints UI
{% set dummy = None if True else "
{% set d = params.GATE|default(current_gate)|int %}
" %} # End param hints for UI
###########################################################################
# Macro to control the DC eSpooler motor
#
# Used by both the start and stop eSpooler macros
#
[gcode_macro _MMU_ESPOOLER_CTL]
gcode:
{% set vars = printer["gcode_macro _MMU_ESPOOLER_VARS"] %}
{% set current_gate = printer['mmu'].gate %}
{% set gate = params.GATE|default(current_gate)|int %}
{% set step_speed = params.STEP_SPEED|default(-1)|float %}
{% set expected_distance = params.MAX_DISTANCE|default(-1)|float %}
{% set homing_move = params.HOMING_MOVE|default(0)|int %}
{% set speed = params.SPEED|default(-1)|float %}
{% set pin_prefix = vars.pin_prefix %}
{% set pin = ('%s_rwd_%d' % (pin_prefix, gate)) if printer['output_pin %s_rwd_%d' % (pin_prefix, gate)] else None %}
{% set en_pin = ('%s_en_%d' % (pin_prefix, gate)) if printer['output_pin %s_en_%d' % (pin_prefix, gate)] else None %}
{% set pin_cfg = ('output_pin %s' % pin) if pin else None %}
{% set pwm = (printer.configfile.settings[pin_cfg].scale) if pin_cfg else False %}
{% set default_timeout = vars.default_timeout %}
{% set timeout = params.TIMEOUT|default(default_timeout)|float %}
# Convert speed
{% if speed < 0 and step_speed >= 0 %}
# determine speed from step speed
{% if not pwm %}
# TODO: something special for long slow (tbd) moves?
# delayed start so it runs after the stepper has run for a little bit?
# or just don't run on long slow moves?
{% set speed = 1 %}
{% elif step_speed > vars.max_step_speed %}
{% set speed = 1 %}
{% else %}
{% set speed = (step_speed / vars.max_step_speed) ** vars.step_speed_exponent %}
{% endif %}
{% elif speed < 0 %}
{% set speed = 1 %}
{% endif %}
{% if gate < 0 %}
RESPOND TYPE=error MSG="No active gate. Cannot start espooler."
{% elif not pin %}
RESPOND TYPE=error MSG="{pin_cfg} does not exist. Cannot start espooler."
{% elif expected_distance >= 0 and expected_distance < vars.min_distance %}
MMU_LOG DEBUG=1 MSG="Travel distance ({expected_distance}) is shorter than the configured min distance ({vars.min_distance}). Ignoring espooler activation."
{% else %}
MMU_LOG DEBUG=1 MSG="Setting espooler {pin} to {speed}"
{% set cfg_scale = printer.configfile.settings[pin_cfg].scale|default(1)|float %}
{% set scale = params.SCALE|default(cfg_scale)|float %}
{% if en_pin and speed > 0 %}
SET_PIN PIN="{en_pin}" value="{1}"
{% endif %}
SET_PIN PIN="{pin}" value="{speed * cfg_scale * scale}"
{% if timeout > 0 and speed > 0 and printer[pin_cfg].value == 0 %}
UPDATE_DELAYED_GCODE ID=mmu_espooler_timeout DURATION={timeout}
{% elif speed == 0 %}
# Cancel delayed gcode...if all are turned off
{% set values = [] %}
{% for igate in (vars.espooler_gates) %}
{% set value = printer['output_pin %s_rwd_%d' % (pin_prefix, igate)].value %}
{% set value = 0 if (igate == gate or value == 0) else value %}
{% set d = values.append(value) %}
{% endfor %}
{% if values|sum == 0 %}
UPDATE_DELAYED_GCODE ID=mmu_espooler_timeout DURATION=0
{% endif %}
{% endif %}
{% if en_pin and speed == 0 %}
SET_PIN PIN="{en_pin}" value="{0}"
{% endif %}
{% endif %}
###########################################################################
# Delayed gcode to run on startup to identify all the eSpoolers which
# will be used after espooler timeout to ensure all eSpoolers have
# stopped.
#
[delayed_gcode mmu_espooler_startup]
initial_duration: 1.
gcode:
{% set vars = printer["gcode_macro _MMU_ESPOOLER_VARS"] %}
{% set pin_prefix = vars.pin_prefix %}
{% set pin_cfg_prefix = 'output_pin %s_rwd_' % pin_prefix %}
{% set espooler_gates = [] %}
{% for key in printer %}
{% if key.startswith(pin_cfg_prefix) %}
{% set gate = key | replace(pin_cfg_prefix, '') | int %}
{% set d = espooler_gates.append(gate | string) %}
{% endif %}
{% endfor %}
SET_GCODE_VARIABLE MACRO=_MMU_ESPOOLER_VARS VARIABLE=espooler_gates VALUE={espooler_gates|join(',')}
###########################################################################
# Delayed gcode to stop all eSpooler after timeout. This is used as a
# failsafe (unless explicitly disabled by setting a timeout of 0) to ensure
# the eSpoolers do not run indefinitely.
#
[delayed_gcode mmu_espooler_timeout]
gcode:
{% set vars = printer["gcode_macro _MMU_ESPOOLER_VARS"] %}
{% for gate in (vars.espooler_gates) %}
MMU_ESPOOLER_STOP GATE={gate}
{% endfor %}

75
mmu/addons/dc_espooler_hw.cfg Normal file
View file

@ -0,0 +1,75 @@
###########################################################################################
# Define the pins for DC motor based eSpooler. Create a section for each gate of your MMU.
#
# With pwm enabled, setting the scale parameter (between 0.0 and 1.0) to adjust the top
# speed of the eSpooler.
#
# Some setups may require an "enable" pin to activate the motor driver. Uncomment those
# pins as needed for each gate.
#
# See https://www.klipper3d.org/Config_Reference.html#output_pin
#
##################
# Gate 0 eSpooler
#
# Rewind pin
[output_pin _mmu_dc_espooler_rwd_0]
pin: mmu:MMU_DC_MOT_1_A
value: 0
pwm: True
scale: 1
# Enable pin
# [output_pin _mmu_dc_espooler_en_0]
# pin: mmu:MMU_DC_MOT_1_EN
# value: 0
##################
# Gate 1 eSpooler
#
# Rewind pin
[output_pin _mmu_dc_espooler_rwd_1]
pin: mmu:MMU_DC_MOT_2_A
value: 0
pwm: True
scale: 1
# Enable pin
# [output_pin _mmu_dc_espooler_en_1]
# pin: mmu:MMU_DC_MOT_2_EN
# value: 0
##################
# Gate 2 eSpooler
#
# Rewind pin
[output_pin _mmu_dc_espooler_rwd_2]
pin: mmu:MMU_DC_MOT_3_A
value: 0
pwm: True
scale: 1
# Enable pin
# [output_pin _mmu_dc_espooler_en_2]
# pin: mmu:MMU_DC_MOT_3_EN
# value: 0
##################
# Gate 3 eSpooler
#
# Rewind pin
[output_pin _mmu_dc_espooler_rwd_3]
pin: mmu:MMU_DC_MOT_4_A
value: 0
pwm: True
scale: 1
# Enable pin
# [output_pin _mmu_dc_espooler_en_3]
# pin: mmu:MMU_DC_MOT_4_EN
# value: 0

31
mmu/addons/mmu_eject_buttons.cfg Normal file
View file

@ -0,0 +1,31 @@
# Include servo hardware definition separately to allow for automatic upgrade
[include mmu_eject_buttons_hw.cfg]
###########################################################################
# Optional hardware MMU eject buttons (e.g. QuattroBox)
#
# This is the supplementary macro to support dedicated per-gate eject
# buttons for easy unloading. It is complimentary to the built-in auto
# preload of filament
#
# To configure:
# 1. Add this to your printer.cfg:
#
# [include mmu/addons/mmu_eject_buttons.cfg]
#
###########################################################################
# Macro to simply call MMU_EJECT for the specified gate
#
# This logic is separated from actual button h/w setup to facilitate upgrades
# and to allow addition of logic (perhaps validation or warning logic)
#
[gcode_macro _MMU_EJECT_BUTTON]
description: Wrapper around ejecting filament via dedicated hardware buttons
gcode:
{% set gate = params.GATE|default(-1)|int %}
{% set mmu = printer['mmu'] %}
{% set current_gate = mmu.gate %}
# TODO add validation and warning logic
MMU_EJECT GATE={gate}

21
mmu/addons/mmu_eject_buttons_hw.cfg Normal file
View file

@ -0,0 +1,21 @@
##########################################################################################
# The eject button hardware configuration. Change the values to your needs and number
# of gates
#
[gcode_button mmu_eject_button_0]
pin: mmu:EJECT_BUTTON_0
press_gcode: _MMU_EJECT_BUTTON GATE=0
[gcode_button mmu_eject_button_1]
pin: mmu:EJECT_BUTTON_1
press_gcode: _MMU_EJECT_BUTTON GATE=1
[gcode_button mmu_eject_button_2]
pin: mmu:EJECT_BUTTON_2
press_gcode: _MMU_EJECT_BUTTON GATE=2
[gcode_button mmu_eject_button_3]
pin: mmu:EJECT_BUTTON_3
press_gcode: _MMU_EJECT_BUTTON GATE=3

91
mmu/addons/mmu_erec_cutter.cfg Normal file
View file

@ -0,0 +1,91 @@
# Include servo hardware definition separately to allow for automatic upgrade
[include mmu_erec_cutter_hw.cfg]
###########################################################################
# Optional EREC Filament Cutter Support
#
# https://github.com/kevinakasam/ERCF_Filament_Cutter
#
# This is the supplementary macro to support filament cutting at the MMU
# on a ERCF design.
#
# To configure:
# 1. Add this to your printer.cfg:
#
# [include mmu/addons/mmu_erec_cutter.cfg]
#
# 2. In mmu_macro_vars.cfg, change this line:
#
# variable_user_post_unload_extension : "EREC_CUTTER_ACTION"
#
# 3. Tune the servo configuration and macro "variables" below
#
# EREC CUTTER CONFIGURATION -----------------------------------------------
# (addons/mmu_erec_cutter.cfg)
#
[gcode_macro _EREC_VARS]
description: Empty macro to store the variables
gcode: # Leave empty
# These variables control the servo movement
variable_servo_closed_angle : 70 ; Servo angle for closed position with bowden aligned MMU
variable_servo_open_angle : 10 ; Servo angle to open up the cutter and move bowden away from MMU
variable_servo_duration : 1.5 ; Time (s) of PWM pulse train to activate servo
variable_servo_idle_time : 1.8 ; Time (s) to let the servo to reach it's position
# Controls for feed and cut lengths
variable_feed_length : 48 ; Distance in mm from gate parking position to blade (ERCFv1.1: 58, v2/other: 48)
variable_cut_length : 10 ; Amount in mm of filament to cut
variable_cut_attempts : 1 ; Number of times the cutter tries to cut the filament
###########################################################################
# Macro to perform the cutting step. Designed to be included to the
# _MMU_POST_UNLOAD step
#
[gcode_macro EREC_CUTTER_ACTION]
description: Cut off the filament tip at the MMU after the unload sequence is complete
gcode:
{% set vars = printer["gcode_macro _EREC_VARS"] %}
MMU_LOG MSG="Cutting filament tip..."
_CUTTER_OPEN
_MMU_STEP_MOVE MOVE={vars.feed_length + vars.cut_length}
{% for i in range(vars.cut_attempts - 1) %}
_CUTTER_CLOSE
_CUTTER_OPEN
{% endfor %}
_MMU_STEP_MOVE MOVE=-1
_CUTTER_CLOSE
_MMU_EVENT EVENT="filament_cut" # Count as one cut for consumption counter
_MMU_STEP_SET_FILAMENT STATE=2 # FILAMENT_POS_START_BOWDEN
_MMU_STEP_UNLOAD_GATE # Repeat gate parking move
_MMU_M400 # Wait on both move queues
[gcode_macro _CUTTER_ANGLE]
description: Helper macro to set cutter servo angle
gcode:
{% set angle = params.ANGLE|default(0)|int %}
SET_SERVO SERVO=cut_servo ANGLE={angle}
[gcode_macro _CUTTER_CLOSE]
description: Helper macro to set cutting servo the closed position
gcode:
{% set vars = printer["gcode_macro _EREC_VARS"] %}
SET_SERVO SERVO=cut_servo ANGLE={vars.servo_closed_angle} DURATION={vars.servo_duration}
G4 P{vars.servo_idle_time * 1000}
RESPOND MSG="EREC Cutter closed"
M400
[gcode_macro _CUTTER_OPEN]
description: Helper macro to set cutting servo the open position
gcode:
{% set vars = printer["gcode_macro _EREC_VARS"] %}
SET_SERVO SERVO=cut_servo ANGLE={vars.servo_open_angle} DURATION={vars.servo_duration}
G4 P{vars.servo_idle_time * 1000}
RESPOND MSG="EREC Cutter open"
M400

10
mmu/addons/mmu_erec_cutter_hw.cfg Normal file
View file

@ -0,0 +1,10 @@
##########################################################################################
# The servo hardware configuration. Change the values to your needs.
#
[mmu_servo cut_servo]
pin: mmu:PA7 # Extra Pin on the ERCF easy Board
maximum_servo_angle: 180 # Set this to 60 for a 60° Servo
minimum_pulse_width: 0.0005 # Adapt these for your servo
maximum_pulse_width: 0.0025 # Adapt these for your servo

101
mmu/base/mmu.cfg Normal file
View file

@ -0,0 +1,101 @@
########################################################################################################################
# Happy Hare MMU Software
#
# EDIT THIS FILE BASED ON YOUR SETUP
#
# Copyright (C) 2022-2025 moggieuk#6538 (discord)
# moggieuk@hotmail.com
# This file may be distributed under the terms of the GNU GPLv3 license.
#
# Goal: Happy Hare MMU hardware pin config
#
# (\_/)
# ( *,*)
# (")_(") Happy Hare Ready
#
#
# This contains aliases for pins for MCU type MMB11
#
[mcu mmu]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_210044000150335331383520-if00 # Change to `canbus_uuid: 1234567890` for CANbus setups
# PIN ALIASES FOR MMU MCU BOARD ----------------------------------------------------------------------------------------
# ██████╗ ██╗███╗ ██╗ █████╗ ██╗ ██╗ █████╗ ███████╗
# ██╔══██╗██║████╗ ██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝
# ██████╔╝██║██╔██╗ ██║ ███████║██║ ██║███████║███████╗
# ██╔═══╝ ██║██║╚██╗██║ ██╔══██║██║ ██║██╔══██║╚════██║
# ██║ ██║██║ ╚████║ ██║ ██║███████╗██║██║ ██║███████║
# ╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═╝ ╚═╝╚══════╝╚═╝╚═╝ ╚═╝╚══════╝
# Section to create alias for pins used by MMU for easier integration into Klippain and RatOS. The names match those
# referenced in the mmu_hardware.cfg file. If you get into difficulty you can also comment out this aliases definition
# completely and configure the pin names directly into mmu_hardware.cfg. However, use of aliases is encouraged.
# Note: that aliases are not created for TOOLHEAD_SENSOR, EXTRUDER_SENSOR or SYNC_FEEDBACK_SENSORS because those are
# most likely on the printer's main mcu. These should be set directly in mmu_hardware.cfg
#
[board_pins mmu]
mcu: mmu # Assumes using an external / extra mcu dedicated to MMU
aliases:
MMU_GEAR_UART=PA10,
MMU_GEAR_STEP=PB15,
MMU_GEAR_DIR=PB14,
MMU_GEAR_ENABLE=PB8,
MMU_GEAR_DIAG=PA3,
MMU_GEAR_UART_1=,
MMU_GEAR_STEP_1=,
MMU_GEAR_DIR_1=,
MMU_GEAR_ENABLE_1=,
MMU_GEAR_DIAG_1=,
MMU_GEAR_UART_2=,
MMU_GEAR_STEP_2=,
MMU_GEAR_DIR_2=,
MMU_GEAR_ENABLE_2=,
MMU_GEAR_DIAG_2=,
MMU_GEAR_UART_3=,
MMU_GEAR_STEP_3=,
MMU_GEAR_DIR_3=,
MMU_GEAR_ENABLE_3=,
MMU_GEAR_DIAG_3=,
MMU_SEL_UART=PC7,
MMU_SEL_STEP=PD2,
MMU_SEL_DIR=PB13,
MMU_SEL_ENABLE=PD1,
MMU_SEL_DIAG=PA4,
MMU_SEL_ENDSTOP=PB2,
MMU_SEL_SERVO=PA0,
MMU_ENCODER=PA1,
MMU_GATE_SENSOR=,
MMU_NEOPIXEL=PA2,
MMU_PRE_GATE_0=PB9,
MMU_PRE_GATE_1=PA8,
MMU_PRE_GATE_2=PC15,
MMU_PRE_GATE_3=PC13,
MMU_PRE_GATE_4=PC14,
MMU_PRE_GATE_5=PB12,
MMU_PRE_GATE_6=PB11,
MMU_PRE_GATE_7=PB10,
MMU_PRE_GATE_8=,
MMU_PRE_GATE_9=,
MMU_PRE_GATE_10=,
MMU_PRE_GATE_11=,
MMU_POST_GEAR_0=,
MMU_POST_GEAR_1=,
MMU_POST_GEAR_2=,
MMU_POST_GEAR_3=,
MMU_POST_GEAR_4=,
MMU_POST_GEAR_5=,
MMU_POST_GEAR_6=,
MMU_POST_GEAR_7=,
MMU_POST_GEAR_8=,
MMU_POST_GEAR_9=,
MMU_POST_GEAR_10=,
MMU_POST_GEAR_11=,

1
mmu/base/mmu_cut_tip.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_cut_tip.cfg

1
mmu/base/mmu_form_tip.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_form_tip.cfg

368
mmu/base/mmu_hardware.cfg Normal file
View file

@ -0,0 +1,368 @@
########################################################################################################################
# Happy Hare MMU Software
#
# EDIT THIS FILE BASED ON YOUR SETUP
#
# Copyright (C) 2022-2025 moggieuk#6538 (discord)
# moggieuk@hotmail.com
# This file may be distributed under the terms of the GNU GPLv3 license.
#
# Goal: Happy Hare MMU hardware config file with config for MMB11 MCU board
#
# (\_/)
# ( *,*)
# (")_(") Happy Hare Ready
#
#
# Notes about setup of common external MCUs can be found here:
# https://github.com/moggieuk/Happy-Hare/blob/main/doc/mcu_notes.md
#
# Note about "touch" endstops: Happy Hare provides extremely flexible homing options using both single steppers or
# synced steppers. The "touch" option leverages stallguard and thus requires the appropriate 'diag_pin' and stallguard
# parameters set on the TMC driver section. If you have the diag_pin exposed, it is harmless to define this because
# they will only be used when explicitly needed and configured.
#
# Touch option for each stepper provides these benefits / possibilities (experimental):
# - on extruder stepper allows for the automatic detection of the nozzle!
# - on selector stepper allows for the automatic detection of filament stuck in the gate and subsequent recovery
# - on gear stepper allows for the automatic detection of the extruder entrance
#
# These sound wonderful right? They are, but there are caveats:
# - Some external MCUs are terrible at detecting stallguard and often result in an "undervoltage error"
# It is generally possible to get selector touch (TMC2209) tuned especially if you set 'stealthchop_threshold'
# to a value greater than homing speeds and less than move speed. I.e. the stepper runs in stealthchop mode when
# homing. [klipper experts will know that it switches the chip mode automatically to stealthchop and then back for
# Stallguard2 support, however the automatic switching back to spreadcycle at the end homing move seems to provoke
# the error condition and setting 'stealthchop_threshold' appropriately avoids this condition. More than you wanted
# to know I'm sure!
# - I have not had much luck with touch (stallguard) on the gear stepper with EASY-BRD and ERB MCUs and you really
# want the extra torque of spreadcycle so adjusting 'stealthchop_threshold' is not really an option
# - Enabling on the extruder stepper is viable but you will likely have to change jumpers on your main mcu to expose
# the DIAG pin for whichever driver the extruder stepper is connected to.
#
# In summary, "touch" homing with your MMU is an advanced option that requires patience and careful tuning. Everything
# works with regular endstops and there are workaround options for certain homing points (like extruder entry) in
# the absence of any endstop. I'm really interested in creative setups. Ping me on Discord (moggieuk#6538)
#
# See 'mmu.cfg' for serial definition and pins aliases
#
# HOMING CAPABLE EXTRUDER (VERY ADVANCED) -----------------------------------------------------------------------------
# With Happy Hare installed even the extruder can be homed. You will find the usual 'endstop' parameters can be added
# to your '[extruder]' section. Useless you have some clever load cell attached to your nozzle it only really makes
# sense to configure stallguard style "touch" homing. To do this add lines similar to this to your existing
# '[extruder]' definition in printer.cfg.
#
# [extruder]
# endstop_pin: tmc2209_extruder:virtual_endstop
#
# Also be sure to add the appropriate stallguard config to the TMC section, e.g.
#
# [tmc2209 extruder]
# diag_pin: E_DIAG # Set to MCU pin connected to TMC DIAG pin for extruder
# driver_SGTHRS: 100 # 255 is most sensitive value, 0 is least sensitive
#
# Happy Hare will take care of the rest and add a 'mmu_ext_touch' endstop automatically
#
# MMU MACHINE / TYPE ---------------------------------------------------------------------------------------------------
# ███╗ ███╗███╗ ███╗██╗ ██╗ ███╗ ███╗ █████╗ ██████╗██╗ ██╗██╗███╗ ██╗███████╗
# ████╗ ████║████╗ ████║██║ ██║ ████╗ ████║██╔══██╗██╔════╝██║ ██║██║████╗ ██║██╔════╝
# ██╔████╔██║██╔████╔██║██║ ██║ ██╔████╔██║███████║██║ ███████║██║██╔██╗ ██║█████╗
# ██║╚██╔╝██║██║╚██╔╝██║██║ ██║ ██║╚██╔╝██║██╔══██║██║ ██╔══██║██║██║╚██╗██║██╔══╝
# ██║ ╚═╝ ██║██║ ╚═╝ ██║╚██████╔╝ ██║ ╚═╝ ██║██║ ██║╚██████╗██║ ██║██║██║ ╚████║███████╗
# ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝╚══════╝
[mmu_machine]
# Number of selectable gate on (each) MMU. Generally this is a single number, but with multi-mmu (type-B) setups
# it can be a comma separated list of the number of gates per unit.
# E.g. 'num_gates: 4,4,2' for a 2xBox Turtle and 1xNight Owl multiplexed setup
#
num_gates: 8
# MMU Vendor & Version is used to automatically configure some parameters and validate configuration
# If custom set to "Other" and uncomment the additional parameters below
#
# ERCF 1.1 add "s" suffix for Springy, "b" for Binky, "t" for Triple-Decky
# e.g. "1.1sb" for v1.1 with Springy mod and Binky encoder
# ERCF 2.0 community edition ERCFv2
# Tradrack 1.0 add "e" if encoder is fitted (assumed to be Binky)
# AngryBeaver 1.0
# BoxTurtle 1.0
# NightOwl 1.0
# 3MS 1.0
# 3D Chameleon 1.0
# Prusa 3.0 NOT YET SUPPORTED - COMING SOON
# Other Generic setup that may require further customization of 'cad' parameters. See doc in mmu_parameters.cfg
#
mmu_vendor: ERCF # MMU family
mmu_version: 2.0 # MMU hardware version number (add mod suffix documented above)
# The following attributes are set internally from vendor/version above. Only uncomment to customize the vendor
# default or for custom ("Other") designs
#
#selector_type: LinearSelector # E.g. LinearSelector (type-A), VirtualSelector (type-B), MacroSelector, RotarySelector, ...
#variable_bowden_lengths: 0 # 1 = If MMU design has different bowden lengths per gate, 0 = bowden length is the same
#variable_rotation_distances: 1 # 1 = If MMU design has dissimilar drive/BMG gears, thus rotation distance, 0 = One drive gear (e.g. Tradrack)
#require_bowden_move: 1 # 1 = If MMU design has bowden move that is included in load/unload, 0 = zero length bowden (skip bowden move)
#filament_always_gripped: 0 # 1 = Filament is always trapped by MMU (most type-B designs), 0 = MMU can release filament
#has_bypass: 0 # 1 = Bypass gate available, 0 = No filament bypass possible
# Uncomment to change the display name in UI's. Defaults to the vendor name
#display_name: My Precious
homing_extruder: 1 # CAUTION: Normally this should be 1. 0 will disable the homing extruder capability
# FILAMENT DRIVE GEAR STEPPER(S) --------------------------------------------------------------------------------------
# ██████╗ ███████╗ █████╗ ██████╗
# ██╔════╝ ██╔════╝██╔══██╗██╔══██╗
# ██║ ███╗█████╗ ███████║██████╔╝
# ██║ ██║██╔══╝ ██╔══██║██╔══██╗
# ╚██████╔╝███████╗██║ ██║██║ ██║
# ╚═════╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
# Note that 'toolhead' & 'mmu_gear' endstops will automatically be added if a toolhead sensor or gate sensor is defined
#
# The default values are tested with the ERCF BOM NEMA14 motor. Please adapt these values to the motor you are using
# Example : for NEMA17 motors, you'll usually use higher current
#
[tmc2209 stepper_mmu_gear]
uart_pin: mmu:MMU_GEAR_UART
run_current: 0.5 # ERCF BOM NEMA14 motor
hold_current: 0.1 # Recommend to be small if not using "touch" or move (TMC stallguard)
interpolate: True
sense_resistor: 0.110 # Usually 0.11, 0.15 for BTT TMC2226
stealthchop_threshold: 0 # Spreadcycle has more torque and better at speed
#
# Uncomment two lines below if you have TMC and want the ability to use filament "touch" homing with gear stepper
#diag_pin: ^mmu:MMU_GEAR_DIAG # Set to MCU pin connected to TMC DIAG pin for gear stepper
#driver_SGTHRS: 60 # 255 is most sensitive value, 0 is least sensitive
[stepper_mmu_gear]
step_pin: mmu:MMU_GEAR_STEP
dir_pin: !mmu:MMU_GEAR_DIR
enable_pin: !mmu:MMU_GEAR_ENABLE
rotation_distance: 22.7316868 # Bondtech 5mm Drive Gears. Overridden by 'mmu_gear_rotation_distance' in mmu_vars.cfg
gear_ratio: 80:20 # E.g. ERCF 80:20, Tradrack 50:17
microsteps: 16 # Recommend 16. Increase only if you "step compress" issues when syncing
full_steps_per_rotation: 200 # 200 for 1.8 degree, 400 for 0.9 degree
#
# Uncomment the two lines below to enable filament "touch" homing option with gear motor
#extra_endstop_pins: tmc2209_stepper_mmu_gear:virtual_endstop
#extra_endstop_names: mmu_gear_touch
# SELECTOR STEPPER ----------------------------------------------------------------------------------------------------
# ███████╗███████╗██╗ ███████╗ ██████╗████████╗ ██████╗ ██████╗
# ██╔════╝██╔════╝██║ ██╔════╝██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗
# ███████╗█████╗ ██║ █████╗ ██║ ██║ ██║ ██║██████╔╝
# ╚════██║██╔══╝ ██║ ██╔══╝ ██║ ██║ ██║ ██║██╔══██╗
# ███████║███████╗███████╗███████╗╚██████╗ ██║ ╚██████╔╝██║ ██║
# ╚══════╝╚══════╝╚══════╝╚══════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
# Consult doc if you want to setup selector for "touch" homing instead or physical endstop
#
[tmc2209 stepper_mmu_selector]
uart_pin: mmu:MMU_SEL_UART
run_current: 0.4 # ERCF BOM NEMA17 motor
hold_current: 0.2 # Can be small if not using "touch" movement (TMC stallguard)
interpolate: True
sense_resistor: 0.110
stealthchop_threshold: 100 # Stallguard "touch" movement (slower speeds) best done with stealthchop
#
# Uncomment two lines below if you have TMC and want to use selector "touch" movement
#diag_pin: ^mmu:MMU_SEL_DIAG # Set to MCU pin connected to TMC DIAG pin for selector stepper
#driver_SGTHRS: 75 # 255 is most sensitive value, 0 is least sensitive
[stepper_mmu_selector]
step_pin: mmu:MMU_SEL_STEP
dir_pin: !mmu:MMU_SEL_DIR
enable_pin: !mmu:MMU_SEL_ENABLE
rotation_distance: 40
microsteps: 16 # Don't need high fidelity
full_steps_per_rotation: 200 # 200 for 1.8 degree, 400 for 0.9 degree
endstop_pin: ^mmu:MMU_SEL_ENDSTOP # Selector microswitch
endstop_name: mmu_sel_home
# Uncomment this line only if default endstop above is using stallguard
#homing_retract_dist: 0
#
# Uncomment two lines below to give option of selector "touch" movement
#extra_endstop_pins: tmc2209_stepper_mmu_selector:virtual_endstop
#extra_endstop_names: mmu_sel_touch
# SERVOS ---------------------------------------------------------------------------------------------------------------
# ███████╗███████╗██████╗ ██╗ ██╗ ██████╗ ███████╗
# ██╔════╝██╔════╝██╔══██╗██║ ██║██╔═══██╗██╔════╝
# ███████╗█████╗ ██████╔╝██║ ██║██║ ██║███████╗
# ╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██║ ██║╚════██║
# ███████║███████╗██║ ██║ ╚████╔╝ ╚██████╔╝███████║
# ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚═════╝ ╚══════╝
# Basic servo PWM setup. If these values are changed then the angles defined for different positions will also change
#
# SELECTOR SERVO -------------------------------------------------------------------------------------------------------
#
[mmu_servo selector_servo]
pin: mmu:MMU_SEL_SERVO
maximum_servo_angle: 180
minimum_pulse_width: 0.00085
maximum_pulse_width: 0.00215
#
# OPTIONAL GANTRY SERVO FOR TOOLHEAD FILAMENT CUTTER ------------------------------------------------------------------
#
# (uncomment this section if you have a gantry servo for toolhead cutter pin)
#[mmu_servo mmu_gantry_servo]
#pin:
#maximum_servo_angle:180
#minimum_pulse_width: 0.00075
#maximum_pulse_width: 0.00225
#initial_angle: 180
# FILAMENT SENSORS -----------------------------------------------------------------------------------------------------
# ███████╗███████╗███╗ ██╗███████╗ ██████╗ ██████╗ ███████╗
# ██╔════╝██╔════╝████╗ ██║██╔════╝██╔═══██╗██╔══██╗██╔════╝
# ███████╗█████╗ ██╔██╗ ██║███████╗██║ ██║██████╔╝███████╗
# ╚════██║██╔══╝ ██║╚██╗██║╚════██║██║ ██║██╔══██╗╚════██║
# ███████║███████╗██║ ╚████║███████║╚██████╔╝██║ ██║███████║
# ╚══════╝╚══════╝╚═╝ ╚═══╝╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝
# Define the pins for optional sensors in the filament path. All but the pre-gate sensors will be automatically setup as
# both endstops (for homing) and sensors for visibility purposes.
#
# 'pre_gate_switch_pin_X' .. 'mmu_pre_gate_X' sensor detects filament at entry to MMU. X=gate number (0..N)
# 'gate_switch_pin' .. 'mmu_gate' shared sensor detects filament past the gate of the MMU
# or
# 'post_gear_switch_pin_X' .. 'mmu_gear_X' post gear sensor for each filament
# 'extruder_switch_pin' .. 'extruder' sensor detects filament just before the extruder entry
# 'toolhead_switch_pin' .. 'toolhead' sensor detects filament after extruder entry
#
# Sync motor feedback will typically have a tension switch (most important for syncing) or both tension and compression.
# Note that compression switch is useful for use as a endstop to detect hitting the extruder entrance
# 'sync_feedback_tension_pin' .. pin for switch activated when filament is under tension
# 'sync_feedback_compression_pin' .. pin for switch activated when filament is under compression
#
# Configuration is flexible: Simply define pins for any sensor you want to enable, if pin is not set (or the alias is empty)
# it will be ignored. You can also just comment out what you are not using.
#
[mmu_sensors]
pre_gate_switch_pin_0: ^mmu:MMU_PRE_GATE_0
pre_gate_switch_pin_1: ^mmu:MMU_PRE_GATE_1
pre_gate_switch_pin_2: ^mmu:MMU_PRE_GATE_2
pre_gate_switch_pin_3: ^mmu:MMU_PRE_GATE_3
pre_gate_switch_pin_4: ^mmu:MMU_PRE_GATE_4
pre_gate_switch_pin_5: ^mmu:MMU_PRE_GATE_5
pre_gate_switch_pin_6: ^mmu:MMU_PRE_GATE_6
pre_gate_switch_pin_7: ^mmu:MMU_PRE_GATE_7
pre_gate_switch_pin_8: ^mmu:MMU_PRE_GATE_8
pre_gate_switch_pin_9: ^mmu:MMU_PRE_GATE_9
pre_gate_switch_pin_10: ^mmu:MMU_PRE_GATE_10
pre_gate_switch_pin_11: ^mmu:MMU_PRE_GATE_11
post_gear_switch_pin_0: ^mmu:MMU_POST_GEAR_0
post_gear_switch_pin_1: ^mmu:MMU_POST_GEAR_1
post_gear_switch_pin_2: ^mmu:MMU_POST_GEAR_2
post_gear_switch_pin_3: ^mmu:MMU_POST_GEAR_3
post_gear_switch_pin_4: ^mmu:MMU_POST_GEAR_4
post_gear_switch_pin_5: ^mmu:MMU_POST_GEAR_5
post_gear_switch_pin_6: ^mmu:MMU_POST_GEAR_6
post_gear_switch_pin_7: ^mmu:MMU_POST_GEAR_7
post_gear_switch_pin_8: ^mmu:MMU_POST_GEAR_8
post_gear_switch_pin_9: ^mmu:MMU_POST_GEAR_9
post_gear_switch_pin_10: ^mmu:MMU_POST_GEAR_10
post_gear_switch_pin_11: ^mmu:MMU_POST_GEAR_11
# These sensors can be replicated in a multi-mmu, type-B setup (see num_gates comment).
# If so, then use a comma separated list of per-unit pins instead of single pin
gate_switch_pin: ^mmu:MMU_GATE_SENSOR
sync_feedback_tension_pin:
sync_feedback_compression_pin:
# These sensors are on the toolhead and often controlled by the main printer mcu
extruder_switch_pin:
toolhead_switch_pin:
# ENCODER -------------------------------------------------------------------------------------------------------------
# ███████╗███╗ ██╗ ██████╗ ██████╗ ██████╗ ███████╗██████╗
# ██╔════╝████╗ ██║██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔══██╗
# █████╗ ██╔██╗ ██║██║ ██║ ██║██║ ██║█████╗ ██████╔╝
# ██╔══╝ ██║╚██╗██║██║ ██║ ██║██║ ██║██╔══╝ ██╔══██╗
# ███████╗██║ ╚████║╚██████╗╚██████╔╝██████╔╝███████╗██║ ██║
# ╚══════╝╚═╝ ╚═══╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝
# Encoder measures distance, monitors for runout and clogging and constantly calculates % flow rate
# Note that the encoder_resolution set here is purely a default to get started. It will be correcly set after calibration
# with the value stored in mmu_vars.cfg
#
# The encoder resolution will be calibrated but it needs a default approximation
# If BMG gear based:
# resolution = bmg_circumfrance / (2 * teeth)
# 24 / (2 * 17) = 0.7059 for TRCT5000 based sensor
# 24 / (2 * 12) = 1.0 for Binky with 12 tooth disc
#
[mmu_encoder mmu_encoder]
encoder_pin: ^mmu:MMU_ENCODER
encoder_resolution: 1.0 # This is just a starter value. Overriden by calibrated 'mmu_encoder_resolution' in mmm_vars.cfg
desired_headroom: 5.0 # The clog/runout headroom that MMU attempts to maintain (closest point to triggering runout)
average_samples: 4 # The "damping" effect of last measurement (higher value means slower automatic clog_length reduction)
flowrate_samples: 20 # How many "movements" of the extruder to measure average flowrate over
# MMU OPTIONAL NEOPIXEL LED SUPPORT ------------------------------------------------------------------------------------
# ██╗ ███████╗██████╗ ███████╗
# ██║ ██╔════╝██╔══██╗██╔════╝
# ██║ █████╗ ██║ ██║███████╗
# ██║ ██╔══╝ ██║ ██║╚════██║
# ███████╗███████╗██████╔╝███████║
# ╚══════╝╚══════╝╚═════╝ ╚══════╝
# Define the led connection, type and length
#
# (comment out this section if you don't have leds or have them defined elsewhere)
[neopixel mmu_leds]
pin: mmu:MMU_NEOPIXEL
chain_count: 18 # Need number gates x1 or x2 + status leds
color_order: GRBW # Set based on your particular neopixel specification (can be comma separated list)
# MMU LED EFFECT SEGMENTS ----------------------------------------------------------------------------------------------
# Define neopixel LEDs for your MMU. The chain_count must be large enough for your desired ranges:
# exit .. this set of LEDs, one for every gate, usually would be mounted at the exit point of the gate
# entry .. this set of LEDs, one for every gate, could be mounted at the entry point of filament into the MMU/buffer
# status .. these LED. represents the status of the MMU (and selected filament). More than one status LED is possible
# logo .. these LEDs don't change during operation and are designed for driving a logo. More than one logo LED is possible
#
# Note that all sets are optional. You can opt to just have the 'exit' set for example. The advantage to having
# both entry and exit LEDs is, for example, so that 'entry' can display gate status while 'exit' displays the color
#
# The animation effects requires the installation of Julian Schill's awesome LED effect module otherwise the LEDs
# will be static:
# https://github.com/julianschill/klipper-led_effect
#
# LED's are indexed in the chain from 1..N. Thus to set up LED's on 'exit' and a single 'status' LED on a 4 gate MMU:
#
# exit_leds: neopixel:mmu_leds (1,2,3,4)
# status_leds: neopixel:mmu_leds (5)
#
# In this example no 'entry' set is configured. Note that constructs like "mmu_leds (1-3,4)" are also valid
#
# The range is completely flexible and can be comprised of different led strips, individual LEDs, or combinations of
# both on different pins. In addition, the ordering is flexible based on your wiring, thus (1-4) and (4-1) both represent
# the same LED range but mapped to increasing or decreasing gates respectively. E.g if you have two Box Turtle MMUs, one
# with a chain of LEDs wired in reverse order and another with individual LEDs, to define 8 exit LEDs:
#
# exit_leds: neopixel:bt_1 (4-1)
# neopixel:bt_2a
# neopixel:bt_2b
# neopixel:bt_2c
# neopixel:bt_2d
#
# Note the use of separate lines for each part of the definition,
#
# ADVANCED: Happy Hare provides a convenience wrapper [mmu_led_effect] that not only creates an effect on each of the
# [mmu_leds] specified segments as a whole but also each individual LED for atomic control. See mmu_leds.cfg for examples
#
# (comment out this whole section if you don't have/want leds; uncomment/edit LEDs fitted on your MMU)
[mmu_leds]
exit_leds: neopixel:mmu_leds (1-8)
#entry_leds: neopixel:mmu_leds (9-16)
#status_leds: neopixel:mmu_leds (17)
#logo_leds: neopixel:mmu_leds (18)
frame_rate: 24

1
mmu/base/mmu_leds.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_leds.cfg

506
mmu/base/mmu_macro_vars.cfg Normal file
View file

@ -0,0 +1,506 @@
########################################################################################################################
# Happy Hare MMU Software
#
# EDIT THIS FILE BASED ON YOUR SETUP
#
# Copyright (C) 2022-2025 moggieuk#6538 (discord)
# moggieuk@hotmail.com
# This file may be distributed under the terms of the GNU GPLv3 license.
#
# Goal: Happy Hare supporting MACRO configuration
#
# (\_/)
# ( *,*)
# (")_(") Happy Hare Ready
#
#
# Supporting set of macros supplied with Happy Hare can be customized by editing the macro "variables" declared here.
#
# This configuration will automatically retained and upgraded between releases (a backup of previous config files will
# always be made for your reference). If you want to customize macros beyond what is possible through these variables
# it is highly recommended you copy the macro to a new name and change the callback macro name in 'mmu_parameters.cfg'
# That way the default macros can still be upgraded but your customization will be left intact
#
# PERSISTED STATE ---------------------------------------------------------
# Happy Hare stores configuration and state in the klipper variables file.
# Since klipper can only be a single 'save_variables' file, if you already
# have one you will need to merge the two and point this appropriately.
#
[save_variables]
filename: ~/printer_data/config/mmu/mmu_vars.cfg
# NECESSARY KLIPPER OVERRIDES ---------------------------------------------
# ██╗ ██╗██╗ ██╗██████╗ ██████╗ ███████╗██████╗
# ██║ ██╔╝██║ ██║██╔══██╗██╔══██╗██╔════╝██╔══██╗
# █████╔╝ ██║ ██║██████╔╝██████╔╝█████╗ ██████╔╝
# ██╔═██╗ ██║ ██║██╔═══╝ ██╔═══╝ ██╔══╝ ██╔══██╗
# ██║ ██╗███████╗██║██║ ██║ ███████╗██║ ██║
# ╚═╝ ╚═╝╚══════╝╚═╝╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
#
# These supplemental settings essentially disable klipper's built in
# extrusion limits and is necessary when using an MMU
[extruder]
max_extrude_only_distance: 200
max_extrude_cross_section: 50
# For dialog prompts and progress in Mainsail. Requires Mainsail version >= v2.9.0
[respond]
# Other Happy Hare prerequisites. Harmless if already defined elsewhere in user config
[display_status]
[pause_resume]
[virtual_sdcard]
path: ~/printer_data/gcodes
#on_error_gcode: CANCEL_PRINT
# PRINT START/END ---------------------------------------------------------
# ██████╗ ██████╗ ██╗███╗ ██╗████████╗ ███████╗████████╗ █████╗ ██████╗ ████████╗
# ██╔══██╗██╔══██╗██║████╗ ██║╚══██╔══╝ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝
# ██████╔╝██████╔╝██║██╔██╗ ██║ ██║ ███████╗ ██║ ███████║██████╔╝ ██║
# ██╔═══╝ ██╔══██╗██║██║╚██╗██║ ██║ ╚════██║ ██║ ██╔══██║██╔══██╗ ██║
# ██║ ██║ ██║██║██║ ╚████║ ██║ ███████║ ██║ ██║ ██║██║ ██║ ██║
# ╚═╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝ ╚═╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝
# (base/mmu_software.cfg)
#
[gcode_macro _MMU_SOFTWARE_VARS]
description: Happy Hare optional configuration for print start/end checks
gcode: # Leave empty
# These variables control the behavior of the MMU_START_SETUP and MMU_START_LOAD_INITIAL_TOOL macros
variable_user_pre_initialize_extension : '' ; Executed at start of MMU_START_SETUP. Commonly G28 to home
variable_home_mmu : False ; True/False, Whether to home mmu before print starts
variable_check_gates : True ; True/False, Whether to check filament is loaded in all gates used
variable_load_initial_tool : True ; True/False, Whether to automatically load initial tool
#
# Automapping strategy to apply slicer tool map to find matching MMU gate (will adjust tool-to-gate map). Options are:
# 'none' - don't automap (i.e. don't update tool-to-gate map)
# 'filament_name' - exactly match on case insensitive filament name
# 'material' - exactly match on material
# 'color' - exactly match on color (with same material)
# 'closest_color' - match to closest available filament color (with same material)
# 'spool_id' - exactly match on spool_id [FUTURE]
variable_automap_strategy : "none" ; none|filament_name|material|color|closest_color|spool_id
# These variables control the behavior of the MMU_END macro
variable_user_print_end_extension : '' ; Executed at start of MMU_END. Good place to move off print
variable_unload_tool : True ; True/False, Whether to unload the tool at the end of the print
variable_reset_ttg : False ; True/False, Whether reset TTG map at end of print
variable_dump_stats : True ; True/False, Whether to display print stats at end of print
# STATE MACHINE CHANGES ---------------------------------------------------
# ███████╗████████╗ █████╗ ████████╗███████╗ ██████╗██╗ ██╗ █████╗ ███╗ ██╗ ██████╗ ███████╗
# ██╔════╝╚══██╔══╝██╔══██╗╚══██╔══╝██╔════╝ ██╔════╝██║ ██║██╔══██╗████╗ ██║██╔════╝ ██╔════╝
# ███████╗ ██║ ███████║ ██║ █████╗ ██║ ███████║███████║██╔██╗ ██║██║ ███╗█████╗
# ╚════██║ ██║ ██╔══██║ ██║ ██╔══╝ ██║ ██╔══██║██╔══██║██║╚██╗██║██║ ██║██╔══╝
# ███████║ ██║ ██║ ██║ ██║ ███████╗ ╚██████╗██║ ██║██║ ██║██║ ╚████║╚██████╔╝███████╗
# ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ ╚══════╝
# (base/mmu_state.cfg)
#
[gcode_macro _MMU_STATE_VARS]
description: Happy Hare configuration for state change hooks
gcode: # Leave empty
# You can extend functionality to all Happy Hare state change or event
# macros by adding a command (or call to your gcode macro).
# E.g for additional LED logic or consumption counters
variable_user_action_changed_extension : '' ; Executed after default logic with duplicate params
variable_user_print_state_changed_extension : '' ; Executed after default logic with duplicate params
variable_user_mmu_event_extension : '' ; Executed after default logic with duplicate params
# Maintenance warning limits (consumption counters)
variable_servo_down_limit : 5000 ; Set to -1 for no limit / disable warning
variable_cutter_blade_limit : 3000 ; Set to -1 for no limit / disable warning
# LED CONTROL -------------------------------------------------------------
# ██╗ ███████╗██████╗ ███████╗
# ██║ ██╔════╝██╔══██╗██╔════╝
# ██║ █████╗ ██║ ██║███████╗
# ██║ ██╔══╝ ██║ ██║╚════██║
# ███████╗███████╗██████╔╝███████║
# ╚══════╝╚══════╝╚═════╝ ╚══════╝
# Only configure if you have LEDs installed. The led_effects option is
# automatically ignored if led-effects klipper module is not installed
# (base/mmu_led.cfg)
#
[gcode_macro _MMU_LED_VARS]
description: Happy Hare led macro configuration variables
gcode: # Leave empty
# Default effects for LED segments when not providing action status
# 'off' - LED's off
# 'on' - LED's white
# 'gate_status' - indicate gate availability / status (printer.mmu.gate_status)
# 'filament_color' - display filament color defined in gate map (printer.mmu.gate_color_rgb)
# 'slicer_color' - display slicer defined set color for each gate (printer.mmu.slicer_color_rgb)
# 'r,g,b' - display static r,g,b color e.g. "0,0,0.3" for dim blue
# '_effect_' - display the named led effect
#
variable_led_enable : True ; True = LEDs are enabled at startup (MMU_LED can control), False = Disabled
variable_led_animation : True ; True = Use led-animation-effects, False = Static LEDs
variable_default_exit_effect : "gate_status" ; off|gate_status|filament_color|slicer_color|r,g,b|_effect_
variable_default_entry_effect : "filament_color" ; off|gate_status|filament_color|slicer_color|r,g,b|_effect_
variable_default_status_effect : "filament_color" ; on|off|gate_status|filament_color|slicer_color|r,g,b|_effect_
variable_default_logo_effect : "0,0,.3" ; off |r,g,b|_effect_
variable_white_light : (1, 1, 1) ; RGB color for static white light
variable_black_light : (.01, 0, .02) ; RGB color used to represent "black" (filament)
variable_empty_light : (0, 0, 0) ; RGB color used to represent empty gate
# SEQUENCE MACRO - PARKING MOVEMENT AND TOOLCHANGE CONTROL ----------------
# ███╗ ███╗ ██████╗ ██╗ ██╗███████╗███╗ ███╗███████╗███╗ ██╗████████╗
# ████╗ ████║██╔═══██╗██║ ██║██╔════╝████╗ ████║██╔════╝████╗ ██║╚══██╔══╝
# ██╔████╔██║██║ ██║██║ ██║█████╗ ██╔████╔██║█████╗ ██╔██╗ ██║ ██║
# ██║╚██╔╝██║██║ ██║╚██╗ ██╔╝██╔══╝ ██║╚██╔╝██║██╔══╝ ██║╚██╗██║ ██║
# ██║ ╚═╝ ██║╚██████╔╝ ╚████╔╝ ███████╗██║ ╚═╝ ██║███████╗██║ ╚████║ ██║
# ╚═╝ ╚═╝ ╚═════╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═══╝ ╚═╝
# Configure carefully if you 'enable_park: True'
# (base/mmu_sequence.cfg)
#
[gcode_macro _MMU_SEQUENCE_VARS]
description: Happy Hare sequence macro configuration variables
gcode: # Leave empty
# Parking and movement controls:
# Happy Hare defines 7 operations that may require parking. You can specify
# whether to park for each of those operations both during a print and
# standalone (not printing) with Happy Hare or when HH is disabled:
#
# enable_park_printing
# This is a list of the operations that should result in toolhead parking
# while in a print. There are really two main starting points from which
# you can customize. If using the slicer to form tips (and toolchange is
# over the wipetower) you don't want to park on "toolchange" but you would
# want to on "runout" which is a forced toolchange unknown by the slicer.
# Typically you would also want to park at least on pause, cancel and
# complete if not done elsewhere
#
# enabled_park_standalone
# List of the operations that should result in toolhead parking when not
# printing, for example, just manipulating the MMU manually or via
# Klipperscreen. Really it is up to you to choose based on personal
# workflow preferences but this defaults to just 'pause,cancel'
# (i.e. disabled for toolchange)
#
# enabled_park_disabled
# List of the operations that should result in toolhead parking when MMU is
# disabled (MMU ENABLE=0) and using Happy Hare client macros. Note that only
# pause and cancel can occur in this mode and would typically be enabled
#
# The operations are as follows:
# toolchange - normal toolchange initiated with Tx or MMU_CHANGE_TOOL command
# runout - when a forced toolchange occurs as a result of runout
# load - individual MMU_LOAD operation
# unload - individual MMU_UNLOAD/MMU_EJECT operation
# complete - when print is complete (Happy Hare enabled)
# pause - a regular klipper PAUSE
# cancel - a regular klipper CANCEL_PRINT
#
# It is possible to call the parking macro manually in this form should you wish
# to include in your macros.
#
# _MMU_PARK FORCE_PARK=1 X=10 Y=10 Z_HOP=5
#
# restore_xy_pos
# Controls where the toolhead (x,y) is returned to after an operation that
# invokes a parking move:
# last - return to original position before park (frequently the default)
# next - return to next print position if possible else last logic will be applied.
# In print this reduces dwell time at the last position reducing blobbing
# and unnecessary movement. Only applied to "toolchange" operation
# none - the toolhead is left wherever it ends up after change. In a print the
# next gcode command will restore toolhead x,y position
#
# Notes:
# - The starting z-height will always be restored, thus the different between 'next'
# and 'none' is the z-height at which the (x,y) move occurs and the location of
# of any un-retract
# - The default parking logic is a straight line move to the 'park_*' position.
# To implement fancy movement and control you can specify your own
# 'user_park_move_macro' to use instead of default straight line move
#
# Retraction can be used to optimize stringing and blobs that can occur when
# changing tools and are active only during a print.
# IMPORTANT: For toolchanging the config order would be:
# 1. In mmu_parameters.cfg configure extruder dimensions like
# 'toolhead_extruder_to_nozzle',etc. These are based on geometry.
# 2. In mmu_parameters.cfg tweak 'toolhead_ooze_reduction' only if necessary
# so that filament _just_ appears at the nozzle on load
# 3. Only then, adjust retraction to control stringing and blobs when
# changing tool in a print
variable_enable_park_printing : 'toolchange,runout,load,unload,complete,pause,cancel' ; Empty '' to disable parking
variable_enable_park_standalone : 'toolchange,load,unload,pause,cancel' ; Empty '' to disable parking
variable_enable_park_disabled : 'pause,cancel' ; Empty '' to disable parking
variable_min_toolchange_z : 1.0 ; The absolute minimum safety floor (z-height) for ALL parking moves
# These specify the parking location, z_hop and retraction for all enabled operation
# types. Each must be 5 values:
# x_coord, y_coord, z_hop(delta), z_hop_ramp, retraction length
# Use -1,-1 for no x,y move (you can just have z_hop). Use 0 for no z_hop
# The z_hop ramp is the horizontal distance in mm to travel during the lift. The
# direction is automatic and only applied if lifting the first time from print.
# This move is useful to help break the filament "string"
variable_park_toolchange : -1, -1, 1, 5, 2 ; x,y,z-hop,z_hop_ramp,retract for "toolchange" operations (toolchange,load,unload)
variable_park_runout : -1, -1, 1, 5, 2 ; x,y,z-hop,z_hop_ramp,retract
variable_park_pause : 50, 50, 5, 0, 2 ; x,y,z-hop,z_hop_ramp,retract (park position when mmu error occurs)
variable_park_cancel : -1, -1, 10, 0, 5 ; x,y,z-hop,z_hop_ramp,retract
variable_park_complete : 50, 50, 10, 0, 5 ; x,y,z-hop,z_hop_ramp,retract
# For toolchange operations, this allows to you to specify additional parking moves
# at various stages of the toolchange. Each must have 3 values:
# x_coord, y_coord, z_hop(delta)
# Use -1,-1,0 for no movement at that stage (no-op).
# All movement will be at the established movement plane (z-height)
variable_pre_unload_position : -1, -1, 0 ; x,y,z-hop position before unloading starts
variable_post_form_tip_position : -1, -1, 0 ; x,y,z-hop position after form/cut tip on unload
variable_pre_load_position : -1, -1, 0 ; x,y,z-hop position before loading starts
variable_restore_xy_pos : "last" ; last|next|none - What x,y position the toolhead should travel to after a "toolchange"
variable_park_travel_speed : 200 ; Speed for any travel movement XY(Z) in mm/s
variable_park_lift_speed : 15 ; Z-only travel speed in mm/s
variable_retract_speed : 30 ; Speed of the retract move in mm/s
variable_unretract_speed : 30 ; Speed of the unretract move in mm/s
# ADVANCED: Normally x,y moves default to 'G1 X Y' to park position. This allows
# you to create exotic movements. Macro will be provided the following parameters:
# YOUR_MOVE_MACRO X=<x_coord> Y=<y_coord> F=<speed>
# when restoring the from parked postion the same macro is called but passed a RESTORE=1 parameter, along with co-ordinates to restore to
# YOUR_MOVE_MACRO RESTORE=1 X=<x_coord> Y=<y_coord> F=<speed>
variable_user_park_move_macro : '' ; Executed instead of default 'G1 X Y move' to park position
variable_auto_home : True ; True = automatically home if necessary, False = disable
variable_timelapse : False ; True = take frame snapshot after load, False = disable
# Instead of completely defining your your own macros you can can extend functionality
# of default sequence macros by adding a command (or call to your gcode macro)
variable_user_mmu_error_extension : '' ; Executed after default logic when mmu error condition occurs
variable_user_pre_unload_extension : '' ; Executed after default logic
variable_user_post_form_tip_extension : '' ; Executed after default logic
variable_user_post_unload_extension : '' ; Executed after default logic
variable_user_pre_load_extension : '' ; Executed after default logic
variable_user_post_load_extension : '' ; Executed after default logic but before restoring toolhead position
# CUT_TIP -----------------------------------------------------------------
# ██████╗██╗ ██╗████████╗ ████████╗██╗██████╗
# ██╔════╝██║ ██║╚══██╔══╝ ╚══██╔══╝██║██╔══██╗
# ██║ ██║ ██║ ██║ ██║ ██║██████╔╝
# ██║ ██║ ██║ ██║ ██║ ██║██╔═══╝
# ╚██████╗╚██████╔╝ ██║ ██║ ██║██║
# ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚═╝
# Don't need to configure if using tip forming
# (base/mmu_cut_tip.cfg)
#
[gcode_macro _MMU_CUT_TIP_VARS]
description: Happy Hare toolhead tip cutting macro configuration variables
gcode: # Leave empty
# Whether the toolhead tip cutting macro will return toolhead to initial position
# after the cut is complete. If using parking logic it is better to disable this
variable_restore_position : False ; True = return to initial position, False = don't return
# Distance from the internal nozzle tip to the cutting blade. This dimension
# is based on your toolhead and should not be used for tuning
# Note: If you have a toolhead sensor this variable can be automatically determined!
# Read https://github.com/moggieuk/Happy-Hare/wiki/Blobing-and-Stringing
variable_blade_pos : 37.5 ; TUNE ME: Distance in mm from internal nozzle tip
# Distance to retract prior to making the cut, measured from the internal nozzle
# tip. This reduces wasted filament (left behind in extruder) but might cause a
# clog if set too large. This must be less than 'blade_pos'
# Note: the residual filament left in nozzle ('toolhead_ooze_reduction') is
# subtracted from this value so make sure toolhead is calibrated
variable_retract_length : 32.5 ; TUNE ME: 5mm less than 'blade_pos' is a good starting point
# Whether to perform a simple tip forming move after the initial retraction
# Enabling this adds gives some additional cooling time of molten filament and
# may help avoid potential clogging on some hotends
variable_simple_tip_forming : True ; True = Perform simple tip forming, False = skip
# This should be the position of the toolhead where the cutter arm just
# lightly touches the depressor pin
variable_cutting_axis : "x" ; "x" or "y". Determines cut direction (axis) during cut motion, used for park distance
variable_pin_loc_xy : 14, 250 ; x,y coordinates of depressor pin
# This distance is added to "pin_loc_x" or "pin_loc_y" depending on the 'cutting_axis'
# to determine the starting position and to create a small safety distance that aids
# in generating momentum
variable_pin_park_dist : 5.0 ; Distance in mm
# Position of the toolhead when the cutter is fully compressed. Should leave a small headroom from the
# extremes of your printer edges (e.g. it should be a bit larger than 0, or whatever Xmin is) to avoid
# banging the toolhead or gantry. Typically x position will match x in pin_loc_xy if cutting in y direction
# or y position will match y in pin_loc_xy if cutting in x direction, but diagonal cuts are possible
variable_pin_loc_compressed_xy : 0.5, 250 ; x,y coordinates of fully depressed location
# Retract length and speed after the cut so that the cutter blade doesn't
# get stuck on return to origin position
variable_rip_length : 1.0 ; Distance in mm to retract to aid lever decompression (>= 0)
variable_rip_speed : 3 ; Speed mm/s
# Pushback of the remaining tip from the cold end into the hotend. This does
# not have to push back all the way, just sufficient to ensure filament fragment
# stays in hot end and the "nail head" of the cut is pushed back past the
# PTFE/metal junction so it cannot cause clogging problems on future loads.
# Cannot be larger than 'retract_length' - `toolhead_ooze_reduction`
variable_pushback_length : 15.0 ; TUNE ME: PTFE tube length + 3mm is good starting point
variable_pushback_dwell_time : 0 ; Time in ms to dwell after the pushback
# Speed related settings for tip cutting
# Note that if the cut speed is too fast, the steppers can lose steps.
# Therefore, for a cut:
# - We first make a fast move to accumulate some momentum and get the cut
# blade to the initial contact with the filament
# - We then make a slow move for the actual cut to happen
variable_travel_speed : 150 ; Speed mm/s
variable_cut_fast_move_speed : 32 ; Speed mm/s
variable_cut_slow_move_speed : 8 ; Speed mm/s
variable_evacuate_speed : 150 ; Speed mm/s
variable_cut_dwell_time : 50 ; Time in ms to dwell at the cut point
variable_cut_fast_move_fraction : 1.0 ; Fraction of the move that uses fast move
variable_extruder_move_speed : 25 ; Speed mm/s for all extruder movement
# Safety margin for fast vs slow travel. When traveling to the pin location
# we make a safer but longer move if we are closer to the pin than this
# specified margin. Usually setting these to the size of the toolhead
# (plus a small margin) should be good enough
variable_safe_margin_xy : 30, 30 ; Approx toolhead width +5mm, height +5mm)
# If gantry servo option is installed, enable the servo and set up and down
# angle positions
variable_gantry_servo_enabled : False ; True = enabled, False = disabled
variable_gantry_servo_down_angle: 55 ; Angle for when pin is deployed
variable_gantry_servo_up_angle : 180 ; Angle for when pin is retracted
# FORM_TIP ----------------------------------------------------------------
# ███████╗ ██████╗ ██████╗ ███╗ ███╗ ████████╗██╗██████╗
# ██╔════╝██╔═══██╗██╔══██╗████╗ ████║ ╚══██╔══╝██║██╔══██╗
# █████╗ ██║ ██║██████╔╝██╔████╔██║ ██║ ██║██████╔╝
# ██╔══╝ ██║ ██║██╔══██╗██║╚██╔╝██║ ██║ ██║██╔═══╝
# ██║ ╚██████╔╝██║ ██║██║ ╚═╝ ██║ ██║ ██║██║
# ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝
# Don't need to configure if using tip cutting
# (base/mmu_form_tip.cfg)
#
[gcode_macro _MMU_FORM_TIP_VARS]
description: Happy Hare tip forming macro configuration variables
gcode: # Leave empty
# Step 1 - Ramming
# Ramming is the initial squeeze of filament prior to cooling moves and is
# described in terms of total volume and progression of squeeze intensity
# printing/standalone. This can be separately controlled when printing or
# standalone
variable_ramming_volume : 0 ; Volume in mm^3, 0 = disabled (optionally let slicer do it)
variable_ramming_volume_standalone : 0 ; Volume in mm^3, 0 = disabled
# Optionally set for temperature change (reduction). The wait will occur
# before nozzle separation if 'use_fast_skinnydip: False' else after cooling
# moves. Temperature will be restored after tip creation is complete
variable_toolchange_temp : 0 ; 0 = don't change temp, else temp to set
variable_toolchange_fan_assist : False ; Whether to use part cooling fan for quicker temp change
variable_toolchange_fan_speed : 50 ; Fan speed % if using fan_assist enabled
# Step 2 - Nozzle Separation
# The filament is then quickly separated from the meltzone by a fast movement
# before then slowing to travel the remaining distance to cooling tube. The
# initial fast movement should be as fast as extruder can comfortably perform.
# A good starting point# for slower move is unloading_speed_start/cooling_moves.
# Too fast a slower movement can lead to excessively long tips or hairs
variable_unloading_speed_start : 80 ; Speed in mm/s for initial fast movement
variable_unloading_speed : 18 ; Speed in mm/s for slow move to cooling zone
# Step 3 - Cooling Moves
# The cooling move allows the filament to harden while constantly moving back
# and forth in the cooling tube portion of the extruder to prevent a bulbous
# tip forming. The cooling tube position is measured from the internal nozzle
# to just past the top of the heater block (often it is beneficial to add a
# couple of mm to ensure the tip is in the cooling section. The cooling tube
# length is then the distance from here to top of heatsink (this is the length
# length of the cooling moves). The final cooling move is a fast movement to
# break the string formed.
variable_cooling_tube_position : 35 ; Start of cooling tube. DragonST:35, DragonHF:30, Mosquito:30, Revo:35, RapidoHF:27
variable_cooling_tube_length : 10 ; Movement length. DragonST:15, DragonHF:10, Mosquito:20, Revo:10, RapidoHF:10
variable_initial_cooling_speed : 10 ; Initial slow movement (mm/s) to solidify tip and cool string if formed
variable_final_cooling_speed : 50 ; Fast movement (mm/s) Too fast: tip deformation on eject, Too Slow: long string/no separation
variable_cooling_moves : 4 ; Number of back and forth cooling moves to make (2-4 is a good start)
# Step 4 - Skinnydip
# Skinnydip is an advanced final move that may have benefit with some
# material like PLA to burn off persistent very fine hairs. To work the
# depth of insertion is critical (start with it disabled and tune last)
# For reference the internal nozzle would be at a distance of
# cooling_tube_position + cooling_tube_length, the top of the heater
# block would be cooling_tube_length away.
variable_use_skinnydip : False ; True = enable skinnydip, False = skinnydip move disabled
variable_skinnydip_distance : 30 ; Distance to reinsert filament into hotend starting from end of cooling tube
variable_dip_insertion_speed : 30 ; Medium/Slow insertion speed mm/s - Just long enough to melt the fine hairs, too slow will pull up molten filament
variable_dip_extraction_speed : 70 ; Speed mm/s - Around 2x Insertion speed to prevents forming new hairs
variable_melt_zone_pause : 0 ; Pause if melt zone in ms. Default 0
variable_cooling_zone_pause : 0 ; Pause if cooling zone after dip in ms. Default 0
variable_use_fast_skinnydip : False ; False = Skip the toolhead temp change wait during skinnydip move
# Step 5 - Parking
# Park filament ready to eject
variable_parking_distance : 0 ; Position mm to park the filament at end of tip forming, 0 = leave where filament ends up after tip forming
variable_extruder_eject_speed : 25 ; Speed mm/s used for parking_distance (and final_eject when testing)
# CLIENT MACROS -----------------------------------------------------------
# ██████╗ █████╗ ██╗ ██╗███████╗███████╗ ██████╗ ███████╗███████╗██╗ ██╗███╗ ███╗███████╗
# ██╔══██╗██╔══██╗██║ ██║██╔════╝██╔════╝ ██╔══██╗██╔════╝██╔════╝██║ ██║████╗ ████║██╔════╝
# ██████╔╝███████║██║ ██║███████╗█████╗ ██████╔╝█████╗ ███████╗██║ ██║██╔████╔██║█████╗
# ██╔═══╝ ██╔══██║██║ ██║╚════██║██╔══╝ ██╔══██╗██╔══╝ ╚════██║██║ ██║██║╚██╔╝██║██╔══╝
# ██║ ██║ ██║╚██████╔╝███████║███████╗ ██║ ██║███████╗███████║╚██████╔╝██║ ╚═╝ ██║███████╗
# ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚══════╝ ╚═╝ ╚═╝╚══════╝╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝
# If using the recommended PAUSE/RESUME/CANCEL_PRINT macros shipped with
# Happy Hare these variables allow for customization and basic extension
# Note that most parameters are pulled from the "movement" (sequence)
# macro above and thus these are supplemental a
# (optional/client_macros.cfg)
#
[gcode_macro _MMU_CLIENT_VARS]
description: Happy Hare client macro configuration variables
gcode: # Leave empty
variable_reset_ttg_on_cancel : False ; True/False, Whether reset TTG map if print is canceled
variable_unload_tool_on_cancel : False ; True/False, Whether to unload the tool on cancel
# You can extend functionality by adding a command (or call to your gcode macro)
variable_user_pause_extension : '' ; Executed after the klipper base pause
variable_user_resume_extension : '' ; Executed before the klipper base resume
variable_user_cancel_extension : '' ; Executed before the klipper base cancel_print
###########################################################################
# Tool change macros
# This is automatically created on installation but you can increase or
# reduce this list to match your number of tools in operation
# Note: it is annoying to have to do this but interfaces like Mainsail rely
# on real macro definitions for tools to be visible in the UI
#
[gcode_macro T0]
gcode: MMU_CHANGE_TOOL TOOL=0
[gcode_macro T1]
gcode: MMU_CHANGE_TOOL TOOL=1
[gcode_macro T2]
gcode: MMU_CHANGE_TOOL TOOL=2
[gcode_macro T3]
gcode: MMU_CHANGE_TOOL TOOL=3
[gcode_macro T4]
gcode: MMU_CHANGE_TOOL TOOL=4
[gcode_macro T5]
gcode: MMU_CHANGE_TOOL TOOL=5
[gcode_macro T6]
gcode: MMU_CHANGE_TOOL TOOL=6
[gcode_macro T7]
gcode: MMU_CHANGE_TOOL TOOL=7

613
mmu/base/mmu_parameters.cfg Normal file
View file

@ -0,0 +1,613 @@
########################################################################################################################
# Happy Hare MMU Software
#
# EDIT THIS FILE BASED ON YOUR SETUP
#
# Copyright (C) 2022-2025 moggieuk#6538 (discord)
# moggieuk@hotmail.com
# This file may be distributed under the terms of the GNU GPLv3 license.
#
# Goal: Main configuration parameters for the klipper module
#
# (\_/)
# ( *,*)
# (")_(") Happy Hare Ready
#
# Notes:
# Macro configuration is specified separately in 'mmu_macro_vars.cfg'.
# Full details in https://github.com/moggieuk/Happy-Hare/tree/main/doc/configuration.md
#
[mmu]
happy_hare_version: 3.1 # Don't mess, used for upgrade detection
# MMU Hardware Limits --------------------------------------------------------------------------------------------------
# ██╗ ██╗███╗ ███╗██╗████████╗███████╗
# ██║ ██║████╗ ████║██║╚══██╔══╝██╔════╝
# ██║ ██║██╔████╔██║██║ ██║ ███████╗
# ██║ ██║██║╚██╔╝██║██║ ██║ ╚════██║
# ███████╗██║██║ ╚═╝ ██║██║ ██║ ███████║
# ╚══════╝╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝
#
# Define the physical limits of your MMU. These settings will be respected regardless of individual speed settings.
#
gear_max_velocity: 300 # Never to be exceeded gear velocity regardless of specific parameters
gear_max_accel: 1500 # Never to be exceeded gear acceleration regardless of specific parameters
selector_max_velocity: 250 # Never to be exceeded selector velocity regardless of specific parameters
selector_max_accel: 1200 # Never to be exceeded selector acceleration regardless of specific parameters
# Servo configuration -------------------------------------------------------------------------------------------------
# ███████╗███████╗██████╗ ██╗ ██╗ ██████╗
# ██╔════╝██╔════╝██╔══██╗██║ ██║██╔═══██╗
# ███████╗█████╗ ██████╔╝██║ ██║██║ ██║
# ╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██║ ██║
# ███████║███████╗██║ ██║ ╚████╔╝ ╚██████╔╝
# ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚═════╝
#
# Angle of the servo in three named positions
# up = tool is selected and filament is allowed to freely move through gate
# down = to grip filament
# move = ready the servo for selector move (optional - defaults to up)
# V2.4.0 on: These positions are only for initial config they are replaced with calibrated servo positions in `mmu_vars.cfg`
#
# Note that leaving the servo active when down can stress the electronics and is not recommended with EASY-BRD or ERB board
# unless the 5v power supply has been improved and it is not necessary with standard ERCF builds
# Make sure your hardware is suitable for the job!
#
servo_up_angle: 140 # ERCF: MG90S: 30 ; SAVOX SH0255MG: 140 ; Tradrack: 145
servo_down_angle: 30 # ERCF: MG90S: 140 ; SAVOX SH0255MG: 30 ; Tradrack: 1
servo_move_angle: 109 # Optional angle used when selector is moved (defaults to up position)
servo_duration: 0.4 # Duration of PWM burst sent to servo (default non-active mode, automatically turns off)
servo_dwell: 0.5 # Minimum time given to servo to complete movement prior to next move
servo_always_active: 0 # CAUTION - WILL DAMAGE COMMON SERVOS, PLEASE USE AT YOUR OWN RISK: 1=Force servo to always stay active, 0=Release after movement
servo_active_down: 0 # CAUTION - WILL DAMAGE COMMON SERVOS, PLEASE USE AT YOUR OWN RISK: 1=Force servo to stay active when down only, 0=Release after movement
servo_buzz_gear_on_down: 1 # Whether to "buzz" the gear stepper on down to aid engagement
# Logging --------------------------------------------------------------------------------------------------------------
# ██╗ ██████╗ ██████╗ ██████╗ ██╗███╗ ██╗ ██████╗
# ██║ ██╔═══██╗██╔════╝ ██╔════╝ ██║████╗ ██║██╔════╝
# ██║ ██║ ██║██║ ███╗██║ ███╗██║██╔██╗ ██║██║ ███╗
# ██║ ██║ ██║██║ ██║██║ ██║██║██║╚██╗██║██║ ██║
# ███████╗╚██████╔╝╚██████╔╝╚██████╔╝██║██║ ╚████║╚██████╔╝
# ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝
#
# log_level & logfile_level can be set to one of (0 = essential, 1 = info, 2 = debug, 3 = trace, 4 = stepper moves)
# Generally you can keep console logging to a minimal whilst still sending debug output to the mmu.log file
# Increasing the console log level is only really useful during initial setup to save having to constantly open the log file
# Note: that it is not recommended to keep logging at level greater that 2 (debug) if not debugging an issue because
# of the additional overhead
#
log_level: 1
log_file_level: 2 # Can also be set to -1 to disable log file completely
log_statistics: 1 # 1 to log statistics on every toolchange (default), 0 to disable (but still recorded)
log_visual: 1 # 1 log visual representation of filament, 0 = disable
log_startup_status: 1 # Whether to log tool to gate status on startup, 1 = summary (default), 0 = disable
# Movement speeds ------------------------------------------------------------------------------------------------------
# ███████╗██████╗ ███████╗███████╗██████╗ ███████╗
# ██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗██╔════╝
# ███████╗██████╔╝█████╗ █████╗ ██║ ██║███████╗
# ╚════██║██╔═══╝ ██╔══╝ ██╔══╝ ██║ ██║╚════██║
# ███████║██║ ███████╗███████╗██████╔╝███████║
# ╚══════╝╚═╝ ╚══════╝╚══════╝╚═════╝ ╚══════╝
#
# Long moves are faster than the small ones and used for the bulk of the bowden movement. You can set two fast load speeds
# depending on whether pulling from the spool or filament buffer (if fitted and not the first time load). This can be helpful
# in allowing faster loading from buffer and slower when pulling from the spool because of the additional friction (prevents
# loosing steps). Unloading speed can be tuning if you have a rewinder system that imposes additional limits.
# NOTE: Encoder cannot keep up much above 450mm/s so make sure 'bowden_apply_correction' is off at very high speeds!
#
gear_from_spool_speed: 80 # mm/s Speed when loading from the spool (for the first time if has_filament_buffer: 1)
gear_from_spool_accel: 100 # Acceleration when loading from spool
gear_from_buffer_speed: 150 # mm/s Speed when loading filament from buffer. Conservative is 100mm/s, Max around 400mm/s
gear_from_buffer_accel: 400 # Normal acceleration when loading filament
gear_unload_speed: 80 # mm/s Use (lower) speed when unloading filament (defaults to "from spool" speed)
gear_unload_accel: 100 # Acceleration when unloading filament (defaults to "from spool" accel)
#
gear_short_move_speed: 80 # mm/s Speed when making short moves (like incremental retracts with encoder)
gear_short_move_accel: 600 # Usually the same as gear_from_buffer_accel (for short movements)
gear_short_move_threshold: 70 # Move distance that controls application of 'short_move' speed/accel
gear_homing_speed: 50 # mm/s Speed of gear stepper only homing moves (e.g. homing to gate or extruder)
# Speeds of extruder movement. The 'sync' speeds will be used when gear and extruder steppers are moving in sync
#
extruder_load_speed: 16 # mm/s speed of load move inside extruder from homing position to meltzone
extruder_unload_speed: 16 # mm/s speed of unload moves inside of extruder (very initial move from meltzone is 50% of this)
extruder_sync_load_speed: 18 # mm/s speed of synchronized extruder load moves
extruder_sync_unload_speed: 18 # mm/s speed of synchronized extruder unload moves
extruder_homing_speed: 18 # mm/s speed of extruder only homing moves (e.g. to toolhead sensor)
# Selector movement speeds. (Acceleration is defined by physical MMU limits set above and passed to selector stepper driver)
#
selector_move_speed: 200 # mm/s speed of selector movement (not touch)
selector_homing_speed: 60 # mm/s speed of initial selector homing move (not touch)
selector_touch_speed: 80 # mm/s speed of all touch selector moves (if stallguard configured)
# Selector touch (stallguard) operation. If stallguard is configured, then this can be used to switch on touch movement which
# can detect blocked filament path and try to recover automatically but it is more difficult to set up
#
selector_touch_enable: 0 # If selector touch operation configured this can be used to disable it 1=enabled, 0=disabled
# When Happy Hare calls out to a macro for user customization and for parking moves these settings are applied and the previous
# values automatically restored afterwards. This allows for deterministic movement speed regardless of the starting state.
#
macro_toolhead_max_accel: 0 # Default printer toolhead acceleration applied when macros are run. 0 = use printer max
macro_toolhead_min_cruise_ratio: 0.5 # Default printer cruise ratio applied when macros are run
# Gate loading/unloading -----------------------------------------------------------------------------------------------
# ██████╗ █████╗ ████████╗███████╗ ██╗ ██████╗ █████╗ ██████╗
# ██╔════╝ ██╔══██╗╚══██╔══╝██╔════╝ ██║ ██╔═══██╗██╔══██╗██╔══██╗
# ██║ ███╗███████║ ██║ █████╗ ██║ ██║ ██║███████║██║ ██║
# ██║ ██║██╔══██║ ██║ ██╔══╝ ██║ ██║ ██║██╔══██║██║ ██║
# ╚██████╔╝██║ ██║ ██║ ███████╗ ███████╗╚██████╔╝██║ ██║██████╔╝
# ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚═════╝
#
# These settings control the loading and unloading filament at the gate which is the parking position inside the MMU.
# Typically this would be switch sensor but you can also use an encoder. Even with encoder the endstop can be a switch
# and the encoder used for move verifcation (see advanced 'gate_endstop_to_encoder' option). Note that the `encoder`
# method, due to the nature of its operation will overshoot a little. This is not a problem in practice because the
# overshoot will simply be compensated for in the subsequent move. A +ve parking distance moves towards the MMU, -ve
# moves back through the endstop towards the toolhead. If the MMU has multiple bowden tubes then it is possible to home
# at the extruder sensor and avoid long bowden moves!
#
# Possible gate_homing_endstop names:
# encoder - Detect filament position using movement of the encoder
# mmu_gate - Use gate endstop
# mmu_gear - Use individual per-gate endstop (type-B MMU's)
# extruder - Use extruder entry sensor (Only for some type-B designs, see [mmu_machine] require_bowden_move setting)
#
gate_homing_endstop: encoder # Name of gate endstop, "encoder" forces use of encoder for parking
gate_homing_max: 70 # Maximum move distance to home to the gate (or actual move distance for encoder parking)
gate_preload_homing_max: 70 # Maximum homing distance to the mmu_gear endstop (if MMU is fitted with one)
gate_unload_buffer: 50 # Amount to reduce the fast unload so that filament doesn't overshoot when parking
gate_load_retries: 2 # Number of times MMU will attempt to grab the filament on initial load (type-A designs)
gate_parking_distance: 13 # Parking position in the gate (distance back from homing point, -ve value means move forward)
gate_endstop_to_encoder: 10 # Distance between gate endstop and encoder (IF both fitted. +ve if encoder after endstop)
gate_autoload: 1 # If pre-gate sensor fitted this controls the automatic loading of the gate
gate_final_eject_distance: 0 # Distance to eject filament on MMU_EJECT (Ignored by MMU_UNLOAD)
# Bowden tube loading/unloading ----------------------------------------------------------------------------------------
# ██████╗ ██████╗ ██╗ ██╗██████╗ ███████╗███╗ ██╗ ██╗ ██████╗ █████╗ ██████╗
# ██╔══██╗██╔═══██╗██║ ██║██╔══██╗██╔════╝████╗ ██║ ██║ ██╔═══██╗██╔══██╗██╔══██╗
# ██████╔╝██║ ██║██║ █╗ ██║██║ ██║█████╗ ██╔██╗ ██║ ██║ ██║ ██║███████║██║ ██║
# ██╔══██╗██║ ██║██║███╗██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ██║ ██║██╔══██║██║ ██║
# ██████╔╝╚██████╔╝╚███╔███╔╝██████╔╝███████╗██║ ╚████║ ███████╗╚██████╔╝██║ ██║██████╔╝
# ╚═════╝ ╚═════╝ ╚══╝╚══╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚═════╝
#
# In addition to different bowden loading speeds for buffer and non-buffered filament it is possible to detect missed
# steps caused by "jerking" on a heavy spool. If bowden correction is enabled the driver with "believe" the encoder
# reading and make correction moves to bring the filament to within the 'bowden_allowable_load_delta' of the end of
# bowden position (this does require a reliable encoder and is not recommended for very high speed loading >350mm/s)
#
bowden_apply_correction: 0 # 1 to enable, 0 disabled. Requires Encoder
bowden_allowable_load_delta: 20.0 # How close in mm the correction moves will attempt to get to target. Requires Encoder
# This test verifies the filament is free of extruder before the fast bowden movement to reduce possibility of grinding filament
bowden_pre_unload_test: 1 # 1 to check for bowden movement before full pull (slower), 0 don't check (faster). Requires Encoder
# ADVANCED: If pre-unload test is enabled, this controls the detection of successful bowden pre-unload test and represents
# the fraction of allowable mismatch between actual movement and that seen by encoder. Setting to 50% tolerance usually
# works well. Increasing will make test more tolerant. Value of 100% essentially disables error detection
bowden_pre_unload_error_tolerance: 50
# Extruder homing -----------------------------------------------------------------------------------------------------
# ███████╗██╗ ██╗████████╗ ██╗ ██╗ ██████╗ ███╗ ███╗██╗███╗ ██╗ ██████╗
# ██╔════╝╚██╗██╔╝╚══██╔══╝ ██║ ██║██╔═══██╗████╗ ████║██║████╗ ██║██╔════╝
# █████╗ ╚███╔╝ ██║ ███████║██║ ██║██╔████╔██║██║██╔██╗ ██║██║ ███╗
# ██╔══╝ ██╔██╗ ██║ ██╔══██║██║ ██║██║╚██╔╝██║██║██║╚██╗██║██║ ██║
# ███████╗██╔╝ ██╗ ██║██╗ ██║ ██║╚██████╔╝██║ ╚═╝ ██║██║██║ ╚████║╚██████╔╝
# ╚══════╝╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝ ╚═════╝
#
# Happy Hare needs a reference "homing point" close to the extruder from which to accurately complete the loading of
# the toolhead. This homing operation takes place after the fast bowden load and it is anticipated that that load
# operation will leave the filament just shy of the homing point. If using a toolhead sensor this initial extruder
# homing is unnecessary (but can be forced) because the homing will occur inside the extruder for the optimum in accuracy.
# You still should set this homing method because it is also used for the determination and calibration of bowden length.
#
# In addition to an entry sensor "extruder" it is possible for Happy Hare to "feel" for the extruder gear entry
# by colliding with it. This can be done with encoder based collision detection, the compression of the sync-feedback
# (aka buffer) sensor or using "touch" (stallguard) on the gear stepper. Note that encoder collision detection is not
# completely deterministic and you will have to find the sweetspot for your setup by adjusting the TMC current reduction.
# Note that reduced current during collision detection can also prevent unecessary filament griding.
#
# Possible extruder_homing_endtop names:
# collision - Detect the collision with the extruder gear by monitoring encoder movement (Requires encoder)
# Fast bowden load will move to the extruder gears
# mmu_gear_touch - Use touch detection when the gear stepper hits the extruder (Requires stallguard)
# Fast bowden load will move to extruder_homing_buffer distance before extruder gear, then home
# extruder - If you have a "filament entry" endstop configured (Requires 'extruder' endstop)
# Fast bowden load will move to extruder_homing_buffer distance before sensor, then home
# filament_compression - If you have a "sync-feedback" sensor with compression switch configured
# Fast bowden load will move to extruder_homing_buffer distance before extruder gear, then home
# none - Don't attempt to home. Only possibiliy if lacking all sensor options
# Fast bowden load will move to the extruder gears. Option is fine if using toolhead sensor
# Note: The homing_endstop will be ignored ("none") if a toolhead sensor is available unless "extruder_force_homing: 1"
#
extruder_homing_max: 80 # Maximum distance to advance in order to attempt to home the extruder
extruder_homing_endstop: collision # Filament homing method/endstop name (fallback if toolhead sensor not available)
extruder_homing_buffer: 25 # Amount to reduce the fast bowden load so filament doesn't overshoot the extruder homing point
extruder_collision_homing_current: 30 # % gear_stepper current (10%-100%) to use when homing to extruder homing (100 to disable)
# If you have a toolhead sensor it will always be used as a homing point making the homing outside of the extruder
# potentially unnecessary. However you can still force this initial homing step by setting this option in which case
# the filament will home to the extruder and then home to the toolhead sensor in two steps
#
extruder_force_homing: 0
# Toolhead loading and unloading --------------------------------------------------------------------------------------
# ████████╗ ██████╗ ██████╗ ██╗ ██╗ ██╗███████╗ █████╗ ██████╗ ██╗ ██████╗ █████╗ ██████╗
# ╚══██╔══╝██╔═══██╗██╔═══██╗██║ ██║ ██║██╔════╝██╔══██╗██╔══██╗ ██║ ██╔═══██╗██╔══██╗██╔══██╗
# ██║ ██║ ██║██║ ██║██║ ███████║█████╗ ███████║██║ ██║ ██║ ██║ ██║███████║██║ ██║
# ██║ ██║ ██║██║ ██║██║ ██╔══██║██╔══╝ ██╔══██║██║ ██║ ██║ ██║ ██║██╔══██║██║ ██║
# ██║ ╚██████╔╝╚██████╔╝███████╗██║ ██║███████╗██║ ██║██████╔╝ ███████╗╚██████╔╝██║ ██║██████╔╝
# ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═════╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚═════╝
#
# It is possible to define highly customized loading and unloading sequences, however, unless you have a specialized
# setup it is probably easier to opt for the built-in toolhead loading and unloading sequence which already offers a
# high degree of customization. If you need even more control then edit the _MMU_LOAD_SEQUENCE and _MMU_UNLOAD_SEQUENCE
# macros in mmu_sequence.cfg - but be careful!
#
# An MMU must have a known point at the end of the bowden from which it can precisely load the extruder. Generally this
# will either be the extruder entrance (which is controlled with settings above) or by homing to toolhead sensor. If
# you have toolhead sensor it is past the extruder gear and the driver needs to know the max distance (from end of
# bowden move) to attempt homing
#
toolhead_homing_max: 40 # Maximum distance to advance in order to attempt to home to defined homing endstop
# IMPORTANT: These next three settings are based on the physical dimensions of your toolhead
# Once a homing position is determined, Happy Hare needs to know the final move distance to the nozzle. There is only
# one correct value for your setup - use 'toolhead_ooze_reduction' (which corresponds to the residual filament left in
# your nozzle) to control excessive oozing on load. See doc for table of proposed values for common configurations.
#
# NOTE: If you have a toolhead sensor you can automate the calculation of these parameters! Read about the
# `MMU_CALIBRATE_TOOLHEAD` command (https://github.com/moggieuk/Happy-Hare/wiki/Blobbing-and-Stringing#---calibrating-toolhead)
#
toolhead_extruder_to_nozzle: 72 # Distance from extruder gears (entrance) to nozzle
toolhead_sensor_to_nozzle: 62 # Distance from toolhead sensor to nozzle (ignored if not fitted)
toolhead_entry_to_extruder: 8 # Distance from extruder "entry" sensor to extruder gears (ignored if not fitted)
# This setting represents how much residual filament is left behind in the nozzle when filament is removed, it is thus
# used to reduce the extruder loading length and prevent excessive blobbing but also in the calculation of purge volume.
# Note that this value can also be measured with the `MMU_CALIBRATE_TOOLHEAD` procedure
#
toolhead_residual_filament: 0 # Reduction in extruder loading length because of residual filament left behind
# TUNING: Finally, this is the last resort tuning value to fix blobbing. It is expected that this value is NEAR ZERO as
# it represents a further reduction in extruder load length to fix blobbing. If using a wipetower and you experience blobs
# on it, increase this value (reduce the quantity of filament loaded). If you experience gaps, decrease this value. If gaps
# and already at 0 then perhaps the 'toolhead_extruder_to_nozzle' or 'toolhead_residual_filament' settings are incorrect.
# Similarly a value >+5mm also suggests the four settings above are not correct. Also see 'retract' setting in
# 'mmu_macro_vars.cfg' for final in-print ooze tuning.
#
toolhead_ooze_reduction: 0 # Reduction in extruder loading length to prevent ooze (represents filament remaining)
# Distance added to the extruder unload movement to ensure filament is free of extruder. This adds some degree of tolerance
# to slightly incorrect configuration or extruder slippage. However don't use as an excuse for incorrect toolhead settings
#
toolhead_unload_safety_margin: 10 # Extra movement safety margin (default: 10mm)
# If not synchronizing gear and extruder and you experience a "false" clog detection immediately after the tool change
# it might be because of a long bowden and/or large internal diameter that causes slack in the filament. This optional
# move will tighten the filament after a load by % of current clog detection length. Gear stepper will run at 50% current
#
toolhead_post_load_tighten: 60 # % of clog detection length, 0 to disable. Ignored if 'sync_to_extruder: 1'
# ADVANCED: Controls the detection of successful extruder load/unload movement and represents the fraction of allowable
# mismatch between actual movement and that seen by encoder. Setting to 100% tolerance effectively turns off checking.
# Some designs of extruder have a short move distance that may not be picked up by encoder and cause false errors. This
# allows masking of those errors. However the error often indicates that your extruder load speed is too high or the
# friction is too high on the filament and in that case masking the error is not a good idea. Try reducing friction
# and lowering speed first!
#
toolhead_move_error_tolerance: 60
# Tip forming ---------------------------------------------------------------------------------------------------------
# ████████╗██╗██████╗ ███████╗ ██████╗ ██████╗ ███╗ ███╗██╗███╗ ██╗ ██████╗
# ╚══██╔══╝██║██╔══██╗ ██╔════╝██╔═══██╗██╔══██╗████╗ ████║██║████╗ ██║██╔════╝
# ██║ ██║██████╔╝ █████╗ ██║ ██║██████╔╝██╔████╔██║██║██╔██╗ ██║██║ ███╗
# ██║ ██║██╔═══╝ ██╔══╝ ██║ ██║██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██║ ██║
# ██║ ██║██║ ██║ ╚██████╔╝██║ ██║██║ ╚═╝ ██║██║██║ ╚████║╚██████╔╝
# ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝ ╚═════╝
#
# Tip forming responsibility can be split between slicer (in-print) and standalone macro (not in-print) or forced to always
# be done by Happy Hare's standalone macro. Since you always need the option to form tips without the slicer so it is
# generally easier to completely turn off the slicer, force "standalone" tip forming and tune only in Happy Hare.
#
# When Happy Hare is asked to form a tip it will run the referenced macro. Two are reference examples are provided but
# you can implement your own:
# _MMU_FORM_TIP .. default tip forming similar to popular slicers like Superslicer and Prusaslicer
# _MMU_CUT_TIP .. for Filametrix (ERCFv2) or similar style toolhead filament cutting system
#
# Often it is useful to increase the extruder current for the rapid movement to ensure high torque and no skipped steps
#
# If opting for slicer tip forming you MUST configure where the slicer leaves the filament in the extruder since
# there is no way to determine this. This can be ignored if all tip forming is performed by Happy Hare
#
force_form_tip_standalone: 1 # 0 = Slicer in print else standalone, 1 = Always standalone tip forming (TURN SLICER OFF!)
form_tip_macro: _MMU_FORM_TIP # Name of macro to call to perform the tip forming (or cutting) operation
extruder_form_tip_current: 100 # % of extruder current (100%-150%) to use when forming tip (100 to disable)
slicer_tip_park_pos: 0 # This specifies the position of filament in extruder after slicer completes tip forming
# Synchronized gear/extruder movement ----------------------------------------------------------------------------------
# ███╗ ███╗ ██████╗ ████████╗ ██████╗ ██████╗ ███████╗██╗ ██╗███╗ ██╗ ██████╗
# ████╗ ████║██╔═══██╗╚══██╔══╝██╔═══██╗██╔══██╗ ██╔════╝╚██╗ ██╔╝████╗ ██║██╔════╝
# ██╔████╔██║██║ ██║ ██║ ██║ ██║██████╔╝ ███████╗ ╚████╔╝ ██╔██╗ ██║██║
# ██║╚██╔╝██║██║ ██║ ██║ ██║ ██║██╔══██╗ ╚════██║ ╚██╔╝ ██║╚██╗██║██║
# ██║ ╚═╝ ██║╚██████╔╝ ██║ ╚██████╔╝██║ ██║ ███████║ ██║ ██║ ╚████║╚██████╗
# ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚══════╝ ╚═╝ ╚═╝ ╚═══╝ ╚═════╝
#
# This controls whether the extruder and gear steppers are synchronized during printing operations
# If you normally run with maxed out gear stepper current consider reducing it with 'sync_gear_current'
# If equipped with TMC drivers the current of the gear and extruder motors can be controlled to optimize performance.
# This can be useful to control gear stepper temperature when printing with synchronized motor
#
sync_to_extruder: 0 # Gear motor is synchronized to extruder during print
sync_gear_current: 70 # % of gear_stepper current (10%-100%) to use when syncing with extruder during print
sync_form_tip: 0 # Synchronize during standalone tip formation (initial part of unload)
# Optionally it is possible to leverage feedback for a "compression/expansion" sensor in the bowden path from MMU to
# extruder to ensure that the two motors are kept in sync as viewed by the filament (the signal feedback state can be
# binary supplied by one or two switches: -1 (expanded) and 1 (compressed) of proportional value between -1.0 and 1.0
# Requires [mmu_sensors] setting
#
sync_feedback_enable: 0 # 0 = Turn off (even with fitted sensor), 1 = Turn on
sync_multiplier_high: 1.05 # Maximum factor to apply to gear stepper 'rotation_distance'
sync_multiplier_low: 0.95 # Minimum factor to apply
# Filament Management Options ----------------------------------------------------------------------------------------
# ███████╗██╗██╗ ███╗ ███╗ ██████╗ ███╗ ███╗████████╗
# ██╔════╝██║██║ ████╗ ████║██╔════╝ ████╗ ████║╚══██╔══╝
# █████╗ ██║██║ ██╔████╔██║██║ ███╗██╔████╔██║ ██║
# ██╔══╝ ██║██║ ██║╚██╔╝██║██║ ██║██║╚██╔╝██║ ██║
# ██║ ██║███████╗██╗ ██║ ╚═╝ ██║╚██████╔╝██║ ╚═╝ ██║ ██║
# ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝
#
# - Clog detection is available when encoder is fitted and it can detect when filament is not moving and pause the print
# - EndlessSpool feature allows detection of runout on one spool and the automatic mapping of tool to an alternative
# gate (spool). Set to '1', this feature requires clog detection or gate sensor or pre-gate sensors. EndlessSpool
# functionality can optionally be extended to attempt to load an empty gate with 'endless_spool_on_load'. On some MMU
# designs (with linear selector) it can also be configured to eject filament remains to a designated gate rather than
# defaulting to current gate. A custom gate will disable pre-gate runout detection for EndlessSpool because filament
# end must completely pass through the gate for selector to move
#
enable_clog_detection: 2 # 0 = disable, 1 = static length clog detection, 2 = automatic length clog detection
enable_endless_spool: 1 # 0 = disable, 1 = enable endless spool
endless_spool_on_load: 0 # 0 = don't apply endless spool on load, 1 = run endless spool if gate is empty
endless_spool_eject_gate: -1 # Which gate to eject the filament remains. -1 = current gate
#endless_spool_groups: # Default EndlessSpool groups (see later in file)
#
# Spoolman support requires you to correctly enable spoolman with moonraker first. If enabled, the gate SpoolId will
# be used to load filament details and color from the spoolman database and Happy Hare will activate/deactivate
# spools as they are used. The enabled variation allows for either the local map or the spoolman map to be the
# source of truth as well as just fetching filament attributes. See this table for explanation:
#
# | Activate/ | Fetch filament attributes | Filament gate | Filament gate |
# spoolman_support | Deactivate | attributes from spoolman | assignment shown | assignment pulled |
# | spool? | based on spool_id? | in spoolman db? | from spoolman db? |
# -----------------+------------+---------------------------+------------------+-------------------+
# off | no | no | no | no |
# readonly | yes | yes | no | no |
# push | yes | yes | yes | no |
# pull | yes | yes | yes | yes |
#
spoolman_support: off # off = disabled, readonly = enabled, push = local gate map, pull = remote gate map
pending_spool_id_timeout: 20 # Seconds after which this pending spool_id (set with rfid) is voided
#
# Mainsail/Fluid UI can visualize the color of filaments next to the extruder/tool chooser. The color is dynamic and
# can be customized to your choice:
#
# slicer - Color from slicer tool map (what the slicer expects)
# allgates - Color from all the tools in the gate map after running through the TTG map
# gatemap - As per gatemap but hide empty tools
# off - Turns off support
#
# Note: Happy Hare will also add the 'spool_id' variable to the Tx macro if spoolman is enabled
#
t_macro_color: slicer # 'slicer' = default | 'allgates' = mmu | 'gatemap' = mmu without empty gates | 'off'
# Print Statistics ---------------------------------------------------------------------------------------------------
# ███████╗████████╗ █████╗ ████████╗███████╗
# ██╔════╝╚══██╔══╝██╔══██╗╚══██╔══╝██╔════╝
# ███████╗ ██║ ███████║ ██║ ███████╗
# ╚════██║ ██║ ██╔══██║ ██║ ╚════██║
# ███████║ ██║ ██║ ██║ ██║ ███████║
# ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝
#
# These parameters determine how print statistic data is shown in the console. This table can show a lot of data,
# probably more than you'd want to see. Below you can enable/disable options to your needs.
#
# +-----------+---------------------+----------------------+----------+
# | 114(46) | unloading | loading | complete |
# | swaps | pre | - | post | pre | - | post | swap |
# +-----------+------+-------+------+------+-------+-------+----------+
# | all time | 0:07 | 47:19 | 0:00 | 0:01 | 37:11 | 33:39 | 2:00:38 |
# | - avg | 0:00 | 0:24 | 0:00 | 0:00 | 0:19 | 0:17 | 1:03 |
# | this job | 0:00 | 10:27 | 0:00 | 0:00 | 8:29 | 8:30 | 28:02 |
# | - avg | 0:00 | 0:13 | 0:00 | 0:00 | 0:11 | 0:11 | 0:36 |
# | last | 0:00 | 0:12 | 0:00 | 0:00 | 0:10 | 0:14 | 0:39 |
# +-----------+------+-------+------+------+-------+-------+----------+
# Note: Only formats correctly on Python3
#
# Comma separated list of desired columns
# Options: pre_unload, unload, post_unload, pre_load, load, post_load, total
console_stat_columns: unload, load, post_load, total
# Comma separated list of rows. The order determines the order in which they're shown.
# Options: total, total_average, job, job_average, last
console_stat_rows: total, total_average, job, job_average, last
# How you'd want to see the state of the gates and how they're performing
# string - poor, good, perfect, etc..
# percentage - rate of success
# emoticon - fun sad to happy faces (python3 only)
console_gate_stat: emoticon
# Always display the full statistics table
console_always_output_full: 1 # 1 = Show full table, 0 = Only show totals out of print
# Miscellaneous, but you should review -------------------------------------------------------------------------------
# ███╗ ███╗██╗███████╗ ██████╗
# ████╗ ████║██║██╔════╝██╔════╝
# ██╔████╔██║██║███████╗██║
# ██║╚██╔╝██║██║╚════██║██║
# ██║ ╚═╝ ██║██║███████║╚██████╗
# ╚═╝ ╚═╝╚═╝╚══════╝ ╚═════╝
#
# Important you verify these work for you setup/workflow. Temperature and timeouts
#
timeout_pause: 72000 # Idle time out (printer shuts down) in seconds used when in MMU pause state
disable_heater: 600 # Delay in seconds after which the hotend heater is disabled in the MMU_PAUSE state
default_extruder_temp: 200 # Default temperature for performing swaps and forming tips when not in print (overridden by gate map)
extruder_temp_variance: 2 # When waiting for extruder temperature this is the +/- permissible variance in degrees (>= 1)
#
# These are auto calibration/tuning settings. Once the gear rotation_distance and encoder are calibrated, enabling these options
# will lessen the initial calibration and will automatically tune bowden length and individual gate rotation_distance differences.
# Note: What can be tuned is based on "variable_rotation_distance" and "variable_bowden_lengths" settings in mmu_hardware.cfg
# E.g. with fixed bowden and multiple BMG gears and encoder like the ERCF, the bowden length is tuned on gate#0 and
# rotation_distance (MMU_CALIBRATE_GATE) is tuned for other gates.
#
autotune_bowden_length: 0 # Automated bowden length calibration/tuning. 1=automatic, 0=manual/off
autotune_rotation_distance: 0 # Automated gate calibration/tuning (requires encoder). 1=automatic, 0=manual/off
#
# Other workflow options
#
startup_home_if_unloaded: 0 # 1 = force mmu homing on startup if unloaded, 0 = do nothing
startup_reset_ttg_map: 0 # 1 = reset TTG map on startup, 0 = do nothing
show_error_dialog: 0 # 1 = show pop-up dialog in addition to console message, 0 = show error in console
preload_attempts: 5 # How many "grabbing" attempts are made to pick up the filament with preload feature
strict_filament_recovery: 0 # If enabled with MMU with toolhead sensor, this will cause filament position recovery to
# perform extra moves to look for filament trapped in the space after extruder but before sensor
filament_recovery_on_pause: 1 # 1 = Run a quick check to determine current filament position on pause/error, 0 = disable
retry_tool_change_on_error: 0 # Whether to automatically retry a failed tool change. If enabled Happy Hare will perform
# the equivalent of 'MMU_RECOVER' + 'Tx' commands which usually is all that is necessary
# to recover. Note that enabling this can mask problems with your MMU
bypass_autoload: 1 # If extruder sensor fitted this controls the automatic loading of extruder for bypass operation
has_filament_buffer: 1 # Whether the MMU has a filament buffer. Set to 0 if using Filamentalist or DC eSpooler, etc
#
# Advanced options. Don't mess unless you fully understand. Read documentation.
#
encoder_move_validation: 1 # ADVANCED: 1 = Normally Encoder validates move distances are within given tolerance
# 0 = Validation is disabled (eliminates slight pause between moves but less safe)
print_start_detection: 1 # ADVANCED: Enabled for Happy Hare to automatically detect start and end of print and call
# ADVANCED: MMU_PRINT_START and MMU_PRINT_END automatically. Harmless to leave enabled but can disable
# if you think it is causing problems and known START/END is covered in your macros
extruder: extruder # ADVANCED: Name of the toolhead extruder that MMU is using
gcode_load_sequence: 0 # VERY ADVANCED: Gcode loading sequence 1=enabled, 0=internal logic (default)
gcode_unload_sequence: 0 # VERY ADVANCED: Gcode unloading sequence, 1=enabled, 0=internal logic (default)
# ADVANCED: Klipper tuning -------------------------------------------------------------------------------------------
# ██╗ ██╗██╗ ██╗██████╗ ██████╗ ███████╗██████╗
# ██║ ██╔╝██║ ██║██╔══██╗██╔══██╗██╔════╝██╔══██╗
# █████╔╝ ██║ ██║██████╔╝██████╔╝█████╗ ██████╔╝
# ██╔═██╗ ██║ ██║██╔═══╝ ██╔═══╝ ██╔══╝ ██╔══██╗
# ██║ ██╗███████╗██║██║ ██║ ███████╗██║ ██║
# ╚═╝ ╚═╝╚══════╝╚═╝╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
#
# Timer too close is a catch all error, however it has been found to occur on some systems during homing and probing
# operations especially so with CANbus connected MCUs. Happy Hare uses many homing moves for reliable extruder loading
# and unloading and enabling this option affords klipper more tolerance and avoids this dreaded error
#
update_trsync: 0 # 1 = Increase TRSYNC_TIMEOUT, 0 = Leave the klipper default
#
# Some CANbus boards are prone to this but it have been seen on regular USB boards where a comms timeout will kill
# the print. Since it seems to occur only on homing moves they can be safely retried to workaround. This has been
# working well in practice
canbus_comms_retries: 3 # Number of retries. Recommend the default of 3.
#
# Older neopixels have very finicky timing and can generate lots of "Unable to obtain 'neopixel_result' response"
# errors in klippy.log. An often cited workaround is to increase BIT_MAX_TIME in neopixel.py. This option does that
# automatically for you to save dirtying klipper
update_bit_max_time: 1 # 1 = Increase BIT_MAX_TIME, 0 = Leave the klipper default
# ADVANCED: MMU macro overrides --- ONLY SET IF YOU'RE COMFORTABLE WITH KLIPPER MACROS -------------------------------
# ███╗ ███╗ █████╗ ██████╗██████╗ ██████╗ ███████╗
# ████╗ ████║██╔══██╗██╔════╝██╔══██╗██╔═══██╗██╔════╝
# ██╔████╔██║███████║██║ ██████╔╝██║ ██║███████╗
# ██║╚██╔╝██║██╔══██║██║ ██╔══██╗██║ ██║╚════██║
# ██║ ╚═╝ ██║██║ ██║╚██████╗██║ ██║╚██████╔╝███████║
# ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
#
# 'pause_macro' defines what macro to call on MMU error (must put printer in paused state)
# Other macros are detailed in 'mmu_sequence.cfg'
# Also see form_tip_macro in Tip Forming section
#
pause_macro: PAUSE # What macro to call to pause the print
action_changed_macro: _MMU_ACTION_CHANGED # Called when action (printer.mmu.action) changes
print_state_changed_macro: _MMU_PRINT_STATE_CHANGED # Called when print state (printer.mmu.print_state) changes
mmu_event_macro: _MMU_EVENT # Called on useful MMU events
pre_unload_macro: _MMU_PRE_UNLOAD # Called before starting the unload
post_form_tip_macro: _MMU_POST_FORM_TIP # Called immediately after tip forming
post_unload_macro: _MMU_POST_UNLOAD # Called after unload completes
pre_load_macro: _MMU_PRE_LOAD # Called before starting the load
post_load_macro: _MMU_POST_LOAD # Called after the load is complete
unload_sequence_macro: _MMU_UNLOAD_SEQUENCE # VERY ADVANCED: Optionally called based on 'gcode_unload_sequence'
load_sequence_macro: _MMU_LOAD_SEQUENCE # VERY ADVANCED: Optionally called based on 'gcode_load_sequence'
espooler_start_macro: '' # Called to start eSpooler if fitted (params: GATE, STEP_SPEED, MAX_DISTANCE, HOMING)
espooler_stop_macro: '' # Called to stop eSpooler if fitted (params: GATE, DISTANCE)
# ADVANCED: See documentation for use of these -----------------------------------------------------------------------
# ██████╗ ███████╗███████╗███████╗████████╗ ██████╗ ███████╗███████╗███████╗
# ██╔══██╗██╔════╝██╔════╝██╔════╝╚══██╔══╝ ██╔══██╗██╔════╝██╔════╝██╔════╝
# ██████╔╝█████╗ ███████╗█████╗ ██║ ██║ ██║█████╗ █████╗ ███████╗
# ██╔══██╗██╔══╝ ╚════██║██╔══╝ ██║ ██║ ██║██╔══╝ ██╔══╝ ╚════██║
# ██║ ██║███████╗███████║███████╗ ██║ ██████╔╝███████╗██║ ███████║
# ╚═╝ ╚═╝╚══════╝╚══════╝╚══════╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚══════╝
#
# These are the values that the various "RESET" commands will reset too rather than the built-in defaults. The lenght
# of the lists must match the number of gates on your MMU
#
# e.g. MMU_GATE_MAP RESET=1 - will use all the 'gate_XXX' values
# MMU_TTG_MAP RESET=1 - will use the 'tool_to_gate_map'
# MMU_ENDLESS_SPOOL_GROUPS RESET=1 - will use the 'endless_spool_groups'
#
# Gate: #0 #1 #2 #3 #4 #5 #6 #7 #8
#gate_status: 1, 0, 1, 2, 2, -1, -1, 0, 1
#gate_filament_name: one, two, three, four, five, six, seven, eight, nine
#gate_material: PLA, ABS, ABS, ABS+, PLA, PLA, PETG, TPU, ABS
#gate_color: red, black, yellow, green, blue, indigo, ffffff, grey, black
#gate_temperature: 210, 240, 235, 245, 210, 200, 215, 240, 240
#gate_spool_id: 3, 2, 1, 4, 5, 6, 7, -1, 9
#gate_speed_override: 100, 100, 100, 100, 100, 100, 100, 50, 100
#endless_spool_groups: 0, 1, 2, 1, 0, 0, 3, 4, 1
#
# Tool: T0 T1 T2 T3 T4 T5 T6 T7 T8
#tool_to_gate_map: 0, 1, 2, 3, 4, 5, 6, 7, 8
# ADVANCED/CUSTOM MMU: See documentation for use of these ------------------------------------------------------------
# ██████╗██╗ ██╗███████╗████████╗ ██████╗ ███╗ ███╗ ███╗ ███╗███╗ ███╗██╗ ██╗
# ██╔════╝██║ ██║██╔════╝╚══██╔══╝██╔═══██╗████╗ ████║ ████╗ ████║████╗ ████║██║ ██║
# ██║ ██║ ██║███████╗ ██║ ██║ ██║██╔████╔██║ ██╔████╔██║██╔████╔██║██║ ██║
# ██║ ██║ ██║╚════██║ ██║ ██║ ██║██║╚██╔╝██║ ██║╚██╔╝██║██║╚██╔╝██║██║ ██║
# ╚██████╗╚██████╔╝███████║ ██║ ╚██████╔╝██║ ╚═╝ ██║ ██║ ╚═╝ ██║██║ ╚═╝ ██║╚██████╔╝
# ╚═════╝ ╚═════╝ ╚══════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝
#
# Normally all these settings are set based on your choice of 'mmu_vendor' and 'mmu_version' in mmu_hardware.cfg, but they
# can be overridden. If you have selected a vendor of "Other" and your MMU has a selector you must set these CAD based
# dimensions else you will get arbitrary defaults. You may also need to set additional attributes in '[mmu_machine]'
# section of mmu_hardware.cfg.
#
#cad_gate0_pos: 4.2 # Approximate distance from endstop to first gate. Used for rough calibration only
#cad_gate_width: 21.0 # Width of each gate
#cad_bypass_offset: 0 # Distance from limit of travel back to the bypass (e.g. ERCF v2.0)
#cad_last_gate_offset: 2.0 # Distance from limit of travel back to last gate
#cad_selector_tolerance: 10.0 # How much extra selector movement to allow for calibration
#cad_gate_directions = [1, 1, 0, 0] # Directions of gear depending on gate (3DChameleon)
#cad_release_gates = [2, 3, 0, 1] # Gate to move to when releasing filament (3DChameleon)
# SUPPLEMENTAL USER CONFIG retained after upgrade --------------------------------------------------------------------
#

1
mmu/base/mmu_sequence.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_sequence.cfg

1
mmu/base/mmu_software.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_software.cfg

1
mmu/base/mmu_state.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/base/mmu_state.cfg

8
mmu/mmu_vars.cfg Normal file
View file

@ -0,0 +1,8 @@
# This is the template file for storing Happy Hare state and calibration variables. It is pointed to
# with the [save_variables] block in 'mmu_macro_vars.cfg'
#
# If you want to use an existing "variables" file, then that is fine but make sure you copy the
# "mmu__revision" line to it because Happy Hare will look for this to validate correct setup
#
[Variables]
mmu__revision = 0

1
mmu/optional/client_macros.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/optional/client_macros.cfg

1
mmu/optional/mmu_menu.cfg Symbolic link
View file

@ -0,0 +1 @@
/home/pi/Happy-Hare/config/optional/mmu_menu.cfg

13
moonraker.conf
View file

@ -85,3 +85,16 @@ managed_services: klipper
info_tags: info_tags:
desc=Cartographer Probe desc=Cartographer Probe
[update_manager happy-hare]
type: git_repo
path: ~/Happy-Hare
origin: https://github.com/moggieuk/Happy-Hare.git
primary_branch: main
managed_services: klipper
[mmu_server]
enable_file_preprocessor: True
enable_toolchange_next_pos: True
update_spoolman_location: True

3
printer.cfg
View file

@ -1,3 +1,6 @@
[include mmu/base/*.cfg]
[include mmu/optional/client_macros.cfg]
[include mmu/optional/mmu_menu.cfg]
# This file contains common pin mappings for the BigTreeTech Octopus V1. # This file contains common pin mappings for the BigTreeTech Octopus V1.
# To use this config, the firmware should be compiled for the STM32F446 with a "32KiB bootloader" # To use this config, the firmware should be compiled for the STM32F446 with a "32KiB bootloader"
# Enable "extra low-level configuration options" and select the "12MHz crystal" as clock reference # Enable "extra low-level configuration options" and select the "12MHz crystal" as clock reference