diff options
| author | Kevin O'Connor <kevin@koconnor.net> | 2020-05-01 13:24:24 -0400 |
|---|---|---|
| committer | Kevin O'Connor <kevin@koconnor.net> | 2020-05-11 12:46:25 -0400 |
| commit | f0c394de8111ff7d498efd2e947d1d36788a9ad3 (patch) | |
| tree | f6621ee07a362b8a8c678865af57c8bc69c65f31 /docs | |
| parent | eebd7e6579690f279cf3693b9869c9571994f249 (diff) | |
| download | kutter-f0c394de8111ff7d498efd2e947d1d36788a9ad3.tar.gz kutter-f0c394de8111ff7d498efd2e947d1d36788a9ad3.tar.xz kutter-f0c394de8111ff7d498efd2e947d1d36788a9ad3.zip | |
docs: Add stow_on_each_sample description to BL-Touch.md
Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/BLTouch.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/BLTouch.md b/docs/BLTouch.md index ee81c08f..3a5c6ba6 100644 --- a/docs/BLTouch.md +++ b/docs/BLTouch.md @@ -168,6 +168,37 @@ probe. If configuring this value on a "clone" or older BL-Touch device, be sure to test the probe accuracy before and after setting this value (use the `PROBE_ACCURACY` command to test). +Multi-probing without stowing +============================= + +By default, Klipper will deploy the probe at the start of each probe +attempt and then stow the probe afterwards. This repetitive deploying +and stowing of the probe may increase the total time of calibration +sequences that involve many probe measurements. Klipper supports +leaving the probe deployed between consecutive probes, which can +reduce the total time of probing. This mode is enabled by configuring +`stow_on_each_sample` to False in the config file. + +Important! Setting `stow_on_each_sample` to False can lead to Klipper +making horizontal toolhead movements while the probe is deployed. Be +sure to verify all probing operations have sufficient Z clearance +prior to setting this value to False. If there is insufficient +clearance then a horizontal move may cause the pin to catch on an +obstruction and result in damage to the printer. + +Important! It is recommended to use `probe_with_touch_mode` configured +to True when using `stow_on_each_sample` configured to False. Some +"clone" devices may not detect a subsequent bed contact if +`probe_with_touch_mode` is not set. On all devices, using the +combination of these two settings simplifies the device signaling, +which can improve overall stability. + +Note, however, that some "clone" devices and the BL-Touch v2.0 (and +earlier) may have reduced accuracy when `probe_with_touch_mode` is set +to True. On these devices it is a good idea to test the probe accuracy +before and after setting `probe_with_touch_mode` (use the +`PROBE_ACCURACY` command to test). + Calibrating the BL-Touch offsets ================================ |