Repository navigation
π Major Updates and Improvements π
π AFC-Klipper-Add-On Documentation Has Moved
AFC-Klipper-Add-On documentation is now hosted at www.afcproject.dev, so please use this for reference going forwards.
π Toolchanger / Multi-Extruder Support (Beta)
This release merges the long-running multi_extruder branch into main, bringing toolchanger support to AFC-Klipper-Add-On. Toolchanger support is still in beta. Configurations and behavior may continue to change in upcoming releases, so please report any issues you run into. Thanks to @weemantella, @kekiefer, @lindnjoe, testers and other's for the extensive work and testing that made this possible.
- New
AFC_Toolchangerconfig as the foundation for moving away fromklipper-toolchanger - Custom load sequences, idle LED status, and infinite runout detection for multi-extruder setups (added by @weemantella)
- Per-extruder variable overrides for AFC-Klipper-Add-On macros (added by @kekiefer), and per-extruder custom macros for tool swaps
- Extruder stats and additional toolchanger states surfaced to Fluidd/Mainsail
- Standalone toolhead improvements: runout detection, temperature restore on async load, and purge-after-first-load flag, plus a fix for stale lane unload on restart (added by @kekiefer)
π New Unit Support
βοΈ OpenAMS
OpenAMS support (originally contributed by JOeB0l) has been reworked to match the existing AFC-Klipper-Add-On structure, with a new installer and support for FPS(OpenAMS)/PFS sensors.
π¨οΈ Snapmaker U1
Initial support added for the Snapmaker U1 machine, including pause/resume and power-loss-resume compatibility, side-feeder AFC load sequences, PTFE calibration toolhead movement, and automatically setting the filament color and material shown on the U1's screen when filament is loaded into the toolheads. Full support is not yet complete: more is on the way. See afcproject.dev/toolchanger/snapmaker.html for what AFC-Klipper-Add-On currently supports and what it doesn't for this printer.
The U1 firmware binary used for this integration, based on paxx12's extended firmware, can be found in the AFCProject Discord's #snapmaker channel or at the bottom of this release notes.
π¦ EMU Units
Added support for EMU units, along with a dedicated installer (added by @ejsears). PSF sensors are also supported.
π’ HTLF2-Claymore
Added support for the HTLF2-Claymore unit.
π οΈ Improvements
- π·οΈ Custom extruder naming for
AFC_extruder, available for toolchanger and non-toolchanger setups alike - βοΈ Weight-based spool runout detection (added by @ejsears)
- π‘οΈ New
AFC_SET_SPOOL_TEMPgcode command to manually set a lane's extruder temperature (added by @ejsears) - π‘οΈ Tool temperature is now checked against the temperatures in the sliced file's Moonraker metadata when printing
- π‘οΈ New
NEW_EXTRUDER_TEMPvariable and automatic temperature drop for the previous extruder onTntool changes (added by @kekiefer, #678) - π‘οΈ New
deadbandsetting for extruder heaters (configurable perAFC_extruder, default2Β°C): defines an acceptable temperature tolerance window so tool changes and print starts don't have to wait for the exact target temperature, just close enough. Also exposed as aDparameter on the M109/M104(AFC remaps the stock ones to use AFC macros) commands (e.g.M109 T1 S250 D5`) to control this per tool-change instead of relying only on the extruder's default - π‘ LED enhancements:
led_use_filament_coloroption (added by @sjordan0228),led_indexsupport spanning multiple MCUs/RGB ports (added by @thunderkeys), and newAFC_SET_TOOLHEAD_LED/AFC_SET_EXTRUDER_LEDmacros for setting toolhead LED status - π§ Hysteresis support for stepper rotation distance changes when using FPS/PSF buffers
- βοΈ Z-axis cutting support (added by @troy-jacobson) and negative rip length for cutter-above-extruder configurations (added by @kekiefer)
- π Toolhead runout protections in bypass mode (added by @cdheiser)
- π
extruder_indexadded to thelane_dataMoonraker endpoint (added by @cgarwood82) - π TD-1 support for direct lanes, enabling calibration and filament scanning (#590)
- π Tool probe detection support for KTC-based toolchangers (#615)
- π Improved
hub:directunload and eject behavior so lanes in that mode work correctly (added by @kekiefer, #720)
β οΈ Removed: AFC_STATUS Macro
The AFC_STATUS macro has been removed. Now that the Fluidd and Mainsail AFC panels cover this information, keeping a separate status macro around no longer makes sense. If you relied on AFC_STATUS, use the Fluidd/Mainsail panels instead going forward.
π Bug Fixes
- Fixed homing issue when a buffer was defined in
AFC_extruderbut its config didn't exist (#710, #711) - Fixed zero being passed into
AFC_RESETduring calibration; calibration errors now show in a popup window (#711) - Fixed spool weight calculation when using multiple toolheads
- Fixed TD-1 data being queried 4x/second, cutting idle CPU usage (#672)
- Fixed physical bypass switch not allowing a lane to be set when filament wasn't detected (#706)
- Fixed toolhead LEDs not being set correctly during PREP for toolchangers (#734)
- Fixed filament sensor creation to always return a tuple, resolving a crash when
enable_tool_runoutwas set to False (#739) - Fixed
SET_BUFFER_MULTIPLIERnot accepting lower case multiplier names (fixed by @ejsears, #696) - Fixed a pause when swapping to a toolhead before loading a lane by only enabling/disabling motor current, sync, and disable when needed (#726)
- Fixed a crash in
do_assist_movewhenafc_motor_fwdpin was not valid (#759) - Fixed lanes and units sometimes displaying out of order in Fluidd/Mainsail (#597)
- Guarded against a
NoneMoonraker dereference inin_print_reactor_timer(fixed by @SAY-5)
π Documentation & Install
- Install and update scripts now prompt before overwriting existing files instead of silently overwriting them
- Updated documentation, macro descriptions, and fixed doc errors
- Updated documentation links and Discord invite to point to afcproject.dev
- Added AI usage guidelines and an agents file for the AFCProject
- Fixed install scripts for Snapmaker U1, and added new installers for OpenAMS and EMU (added by @ejsears)
- Added Duet 2 WiFi (SAM4E8E) pin mapping for BoxTurtle (added by @rescosta)
How to Update
DO NOT UPDATE WITH MOONRAKER UPDATE MANAGER WITH THIS RELEASE
Before updating please fully unload your Box Turtle or other unit type.
To update ssh into your printer and use the following command in your AFC-Klipper-Add-On folder:
cd ~/AFC-Klipper-Add-On
git pull
./update-afc.sh
Select U to update
Don't forget to restart your printer after updating
Full Change Log
Additions
- Merging weemantella's multi extruder by @weemantella in #470
- Custom load sequence and loaded but idle led status by @weemantella in #475
- Introduce Multi-extruder infinite runout by @weemantella in #480
- Adding OpenAMS support from JOeB0l by @jimmyjon711 in #560
- [Toolchanger] Adding AFC_Toolchanger class as a starting point for moving away from klipper-toolchanger by @jimmyjon711 in #573
- Adding a check to make sure 'standalone' extruder don't have buffer for pin_tool_start defined by @jimmyjon711 in #589
- [Enhancement] Added ability to use TD-1 for direct lanes by @jimmyjon711 in #590
- [Enhancement] Adding ability to set toolhead led for status, and print leds based on mapping and extruder name by @jimmyjon711 in #601
- Adding support for tool_probe detection and fixed spoolman_set_active_spool error by @jimmyjon711 in #615
- [Update] Adding extruder stats for toolchangers, fixing afcDeltaTime start time by @jimmyjon711 in #623
- [Enhancement]: Adding ability to supply custom macros for tool swaps by @jimmyjon711 in #625
- feat: add NEW_EXTRUDER_TEMP to Tn and automatic temp drop by @kekiefer in #678
- Support led_index spanning multiple MCUs/RGB ports by @thunderkeys in #680
- Add in weight based spool runout by @ejsears in #684
- Add AFC_SET_SPOOL_TEMP by @ejsears in #687
- Add led_use_filament_color option for lane LEDs by @sjordan0228 in #681
- (feat): Adding restoring temperature when asynchronously loading standalone toolheads, and fixed unload/load sequence for standalone toolheads by @jimmyjon711 in #690
- (feat): Implement safe copy function to prevent overwriting existing β¦ by @ejsears in #693
- [feat]: Add extruder_index to lane_data moonraker endpoint by @cgarwood82 in #701
- [feat]: Adding support for EMU Units by @jimmyjon711 in #715
- Improve hub:direct unload behavior by @kekiefer in #720
- [feat]: Adding support for Snapmaker U1 machine by @jimmyjon711 in #721
- (feat): Adding detecting toolhead runout for standalone toolhead for toolchangers by @jimmyjon711 in #730
- Adding support for HTLF2-Claymore Unit by @jimmyjon711 in #733
- Reorder lanes by @jimmyjon711 in #735
- (feat): Adding setting color, material, etc into Snapmakers print_task_config object by @jimmyjon711 in #736
- (feat): Adding ability to add custom extruder name for AFC_extruder by @jimmyjon711 in #740
- (feat): Adding flag so that standalone toolhead will purge after being loaded the first time with switching to tool by @jimmyjon711 in #744
- (feat): For Snapmaker U1 printers, move toolhead when calibrating PTFE to toolhead by @jimmyjon711 in #745
- Support tollhead runout protections in bypass mode by @cdheiser in #754
- (feat): Adding support for FPS(OpenAMS)/PFS sensors to support updates for OpenAMS by @jimmyjon711 in #756
- (feat): Added ability to use AFC load sequence with Snapmaker U1 side feeders by @jimmyjon711 in #763
- (feat): Updating OpenAMS to match existing AFC structure by @jimmyjon711 in #765
- (feat): Adding Tool temp check when printing, grabs temperatures from file's moonraker metadata by @jimmyjon711 in #767
- (feat): Adding additional toolchanger states so that fluidd/mainsail can be updated correctly for toolchangers by @jimmyjon711 in #768
Bug Fixes
- fix logger in get_lane_by_map by @weemantella in #472
- TOOL_UNLOAD fix by @jimmyjon711 in #502
- Removing AFC_STATUS and fixing units from showing in mainsail/fluidd when there are no lanes assigned to units by @jimmyjon711 in #584
- multi_extruder: fix m109 ooze logic by @kekiefer in #644
- (fix): Fixing issue where AFC was using picking up AFC_hub/AFC_buffer as the unit when trying to lookup unit object by @jimmyjon711 in #651
- Correct Pin for BTT Vivid for RFID by @ikwidtech in #679
- Fix tool change not unloading stale lane on restart by @kekiefer in #682
- (fix): Fixes weight calculation for spools when using multiple toolheads by @jimmyjon711 in #688
- (fix): Fixing issue where AFC was querying TD1 data 4 times a second by @jimmyjon711 in #689
- (fix): Fixing issue where trying to get lane with self.current with None by @jimmyjon711 in #695
- (fix): Correctly parse lower case multiplier names in SET_BUFFER_MULT⦠by @ejsears in #697
- (fix): Fixing issue where standalone toolheads try to heat to zero when triggering pin_tool_start by @jimmyjon711 in #698
- [fix]: Fixing homing issue when buffer was defined in AFC_extruder but config did not exist by @jimmyjon711 in #716
- [fix]: Fixes not being able to set lane with physical bypass switch is enabled but filament not detected by @jimmyjon711 in #717
- [fix]: Fixed issue where zero was being passed into AFC_RESET during calibration, calibration errors show in popup window by @jimmyjon711 in #718
- fix: guard moonraker None deref in in_print_reactor_timer by @SAY-5 in #703
- [fix]: Updates so that Snapmaker U1 pause/resume and power loss resume works correctly with AFC by @jimmyjon711 in #728
- (fix) Fixes #734, correctly sets toolhead leds during PREP for toolchangers by @jimmyjon711 in #737
- (fix) Fixes #739, always return tuple when creating filament sensor by @jimmyjon711 in #741
- (fix): Updating code to only enable/disable motor current, sync and disable when needed by @jimmyjon711 in #746
- (fixes): Misc changes based off users feedback by @jimmyjon711 in #750
- (fix): Fixing install scripts for Snapmaker U1 by @jimmyjon711 in #752
- (fix): Fixing #759 by @jimmyjon711 in #760
- (fix): Added ability to hysteresis for changing stepper rotation distance when using FPS/PSF buffers by @jimmyjon711 in #766
Macro Changes
- macros: poop: fix querying fan speed for toolchangers by @kekiefer in #618
- Update Poop.cfg by @dragoonmc in #683
- Z Axis cutting by @troy-jacobson in #641
- Negative rip length for cutter-above-extruder by @kekiefer in #699
- feat: add per-extruder variable overrides for AFC macros by @kekiefer in #665
Misc/Install Script Changes
- Add openams installer by @ejsears in #570
- afc-debug: improve printout of USB hub topology by @kekiefer in #705
- Updating documentation, fixed errors and updated macro descriptions by @jimmyjon711 in #704
- Update git remote address by @ejsears in #707
- Update documentation links and Discord invite link by @jimmyjon711 in #725
- Emu installer by @ejsears in #732
- (chore): Merging main into DEV, updating links to point to afcproject.dev website by @jimmyjon711 in #751
- Add Duet 2 WiFi (SAM4E8E) pin mapping for BoxTurtle by @rescosta in #758
- Adding documents for use of AI within AFCProject and added agents file by @jimmyjon711 in #761
New Contributors
- @ikwidtech made their first contribution in #679
- @sjordan0228 made their first contribution in #681
- @cgarwood82 made their first contribution in #701
- @SAY-5 made their first contribution in #703
- @cdheiser made their first contribution in #754
- @rescosta made their first contribution in #758
Thanks to all the testers who helped try out these changes and provide feedback along the way.
Full Changelog: v1.1.0...v1.2.0
This document was created with AI assistance.