Home - vvuk/eddy-ng GitHub Wiki
eddy-ng
eddy-ng improves the Eddy current probe support in Kalico and Klipper to add accurate Z-offset setting by physically making contact with the build surface. These probes are very accurate, but suffer from drifts due to changes in conductivity in the target surface as well as changes in coil parameters as temperatures change. Instead of doing temperature compensation, the approach eddy-ng takes a more physical approach:
- Z-homing happens via the sensor as a "coarse" Z-home -- it is not accurate enough for printing, but is sufficient for homing, gantry leveling, and other preparation.
- A precise Z-offset is calculated with a "tap" just before printing, with the bed at print temps and the nozzle warm (but not hot -- you don't want filament drooling or damage to your build plate).
There will be nozzle-to-bed contact during step 2. The maximum limit of this contact is configurable; by default, it is at most z=-0.250 (relative to the homing zero position). This is not any worse than homing and then and stepping Z down one notch too far. Successful taps will stop as soon as tap is detected and will usually not go below -0.100 or so, often much closer to the true tap position.
🛑 Make sure that you read the "quad_gantry_level"/"z_tilt_adjust" sections in the safety configuration section. Failure to set this up can cause your toolhead to crash into your build plate during these operations!
If you are using Klipper, because Klipper does not provide any easy extension or add-on mechanism you will need to be comfortable adding new files to your Klipper installation, building and flashing the Klipper firmware to your devices, and editing your printer configuration. If your current version of Klipper is too old, you may need to move to a newer version which may require updating the rest of your devices. Your Klipper installation will also show as "dirty" after this installation.
Kalico (a fork of Klipper) better supports add-ons, with easier installation and without needing to make changes to the source.
Support this work
If you find this work useful, please consider supporting me by buying me a coffee supporting my Aliexpress habit. This work is done in my free time and I appreciate the support!
Questions, Discussion, Help
Questions? Come ask on the Sovol 3D Printers Discord, which you can find under the Discover tab in Discord -> "Sovol 3d Printers". From there, post a thread in the the "eddy-ng" forum. (There's nothing Sovol-specific in eddy-ng, just where all this work started!)
You can also file issues in this eddy-ng github repo.
Requirements
eddy-ng requires a printer running recent Kalico or Klipper (using Python >= 3.8).
eddy-ng works with any LDC1612-based Eddy current probe. It has been tested with:
- BTT Eddy Duo (USB/CAN)
- BTT Eddy Coil (I2C)
- Cartographer (v3) (USB/CAN)
- Mellow FLY (USB/CAN)
It should work with other probes with additional configuration, some of which will need to be made in the code and some that can be made in config files.
Installation
Important Safety Configuration
Probe setup
- BTT Eddy
- Cartographer
- Mellow Fly
- Other LDC1612 probes