Lane / Movement Commands
Lane and Movement Related Commands¶
These commands are used to manipulate the status of a specific lane or update settings related to either the lane or the toolhead / extruder.
[UNSET_LANE_LOADED]
[SET_LANE_LOADED]
This macro handles manually setting a lane loaded into the toolhead. This is useful when manually loading lanes during prints after AFC detects an error when loading/unloading and pauses.
If there is a lane already loaded this macro will also desync that lane extruder from the toolhead extruder and set its values and led appropriately.
Retrieves the lane specified by the 'LANE' parameter and sets the appropriate values in AFC to continue using the lane.
Usage
SET_LANE_LOADED LANE=<lane>
[LANE_UNLOAD]
[TOOL_LOAD]
This function handles the loading of a specified lane into the tool. It retrieves the lane specified by the 'LANE' parameter and calls the TOOL_LOAD method to perform the loading process.
Optionally setting PURGE_LENGTH parameter to pass a value into poop macro.
Usage
TOOL_LOAD LANE=<lane> PURGE_LENGTH=<purge_length>(optional value)
[TOOL_UNLOAD]
This function handles the unloading of a specified lane from the tool head. It retrieves the lane specified by the 'LANE' parameter or uses the currently loaded lane if no parameter is provided, and calls the TOOL_UNLOAD method to perform the unloading process.
Usage
TOOL_UNLOAD LANE=<lane>
[UPDATE_TOOLHEAD_SENSORS]
Macro call to adjust tool_stn tool_stn_unload tool_sensor_after_extruder lengths for specified extruder without having to
update config file and restart klipper.
tool_stn length is the length from the sensor before extruder gears (tool_start) to nozzle. If sensor after extruder gears(tool_end)
is set then the value if from tool_end sensor.
tool_stn_unload length is the length to unload so that filament is not in extruder gears anymore.
tool_sensor_after_extruder length is mainly used for those that have a filament sensor after extruder gears, target this
length to retract filament enough so that it's not in the extruder gears anymore.
Please pause print if you need to adjust this value while printing
Usage
UPDATE_TOOLHEAD_SENSORS EXTRUDER=<extruder> TOOL_STN=<length> TOOL_STN_UNLOAD=<length> TOOL_AFTER_EXTRUDER=<length>
[SAVE_EXTRUDER_VALUES]
[SET_SPEED_MULTIPLIER]
Macro call to update fwd_speed_multiplier or rwd_speed_multiplier values without having to set in config and restart klipper. This macro allows adjusting these values while printing. Multiplier values must be between 0.0 - 1.0
Use FWD variable to set forward multiplier, use RWD to set reverse multiplier
After running this command run SAVE_SPEED_MULTIPLIER LANE=<lane_name> to save value to config file
Usage
SET_SPEED_MULTIPLIER LANE=<lane_name> FWD=<fwd_multiplier> RWD=<rwd_multiplier>
[SAVE_SPEED_MULTIPLIER]
[SET_HUB_DIST]
This function adjusts the distance between a lanes extruder and hub. Adding +/- in front of the length will
increase/decrease length by that amount. To reset length back to config value, pass in reset for length to
reset to value in config file.
Usage
SET_HUB_DIST LANE=<lane_name> LENGTH=+/-<fwd_multiplier>
[SAVE_HUB_DIST]
[LANE_MOVE]
This function handles the manual movement of a specified lane. It retrieves the lane specified by the 'LANE' parameter and moves it by the distance specified by the 'DISTANCE' parameter.
Distance's lower than 200 moves extruder at short_move_speed/accel, values above 200 move extruder at long_move_speed/accel
Usage
LANE_MOVE LANE=<lane> DISTANCE=<distance>