3diy
/
klipper
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Improve bltouch v3 documentation 

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2019-05-20 18:38:19 -04:00
parent 7702cc2972
commit 500f37821d
2 changed files with 27 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
config/example-extras.cfg
View File

@ -62,12 +62,12 @@
# Set if the BLTouch consistently reports the probe in a "not # Set if the BLTouch consistently reports the probe in a "not
# triggered" state after a successful "pin_up" command. This should # triggered" state after a successful "pin_up" command. This should
# be True for a genuine BLTouch; some BLTouch clones may require # be True for a genuine BLTouch; some BLTouch clones may require
# False. The default is True. # False. The default is True.
#pin_up_touch_mode_reports_triggered: True #pin_up_touch_mode_reports_triggered: True
# Set if the BLTouch consistently reports a "triggered" state after # Set if the BLTouch consistently reports a "triggered" state after
# the commands "pin_up" followed by "touch_mode". This should be # the commands "pin_up" followed by "touch_mode". This should be
# True for a genuine BLTouch; some BLTouch clones may require # True for a genuine BLTouch v2 and earlier; the BLTouch v3 and some
# False. The default is True. # BLTouch clones require False. The default is True.
#x_offset: #x_offset:
#y_offset: #y_offset:
#z_offset: #z_offset:

24
docs/BLTouch.md
View File

@ -108,3 +108,27 @@ position. Carefully readjust the headless screw into place. You need
to find the right position so it is able to lower and raise the pin to find the right position so it is able to lower and raise the pin
and the red light turns on and of. Use the `reset`, `pin_up` and and the red light turns on and of. Use the `reset`, `pin_up` and
`pin_down` commands to achieve this. `pin_down` commands to achieve this.
Troubleshooting
===============
* If you are sure the wiring of the BL-Touch is correct and every
attempt to probe with the BL-Touch reports "BLTouch failed to verify
sensor state" then it may be necessary to add
`pin_up_touch_mode_reports_triggered: False` to the bltouch config
section. The BL-Touch v3 and many clones require this setting.
* A BL-Touch v3 may not work correctly when its signal wire is
connected to the Z end-stop pin on some printer boards. The symptoms
of this problem are: the BL-Touch probe deploys, the printer
descends, the probe contacts a surface, the BL-Touch raises the
probe, the BL-Touch does not successfully notify the
micro-controller, and the printer continues to descend. The Z
end-stop pin on some printer boards have a capacitor to filter the
signal which the BL-Touch v3 may not support. The simplest solution
is to connect the BL-Touch v3 sensor wire to an available pin on the
printer board that is not associated with an end-stop (and thus is
unlikely to have a capacitor). An alternative solution is to
physically alter the printer board to disable the given end-stop
capacitor or to add a hardware "pull up resistor" to the BL-Touch v3
sensor wire.