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

docs: Recommend safe_z_home over homing_override 

Update BLTouch.md, FAQ.md, and sample-probe-as-z-endstop.cfg to
recommend using a safe_z_home config section over a homing_override
config section.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2019-11-07 16:50:52 -05:00
parent ed610a6600
commit 3665e9fc53
3 changed files with 20 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
config/sample-probe-as-z-endstop.cfg
View File

@ -20,16 +20,12 @@ endstop_pin: probe:z_virtual_endstop
position_min: -2 # The Z carriage may need to travel below the Z=0 position_min: -2 # The Z carriage may need to travel below the Z=0
# homing point if the bed has a significant tilt. # homing point if the bed has a significant tilt.
# The homing_override section modifies the default G28 behavior # The safe_z_home section modifies the default G28 behavior
[homing_override] [safe_z_home]
set_position_z: 0 home_xy_position: 100,100
axes: z speed: 50
gcode: z_hop: 15
G90 z_hop_speed: 5
; G1 Z2 F600 ; Uncomment to blindly lift the Z 2mm at start
G28 X0 Y0
G1 X100 Y100 F3600
G28 Z0
# Example bed_tilt config section # Example bed_tilt config section
[bed_tilt] [bed_tilt]

24
docs/BLTouch.md
View File

@ -20,24 +20,20 @@ control_pin: P1.26
If the BL-Touch will be used to home the Z axis then set `endstop_pin: If the BL-Touch will be used to home the Z axis then set `endstop_pin:
probe:z_virtual_endstop` in the `[stepper_z]` config section and add a probe:z_virtual_endstop` in the `[stepper_z]` config section and add a
`[homing_override]` config section to raise the z-axis, home the `[safe_z_home]` config section to raise the z axis, home the xy axes,
x/y-axis, move to the center of the bed, and home the z-axis. For move to the center of the bed, and home the z axis. For example:
example:
``` ```
[homing_override] [safe_z_home]
gcode: home_xy_position: 100,100 # Change coordinates to the center of your print bed
G90 ; Use absolute position mode speed: 50
G1 Z10 ; Move up 10mm z_hop: 10 # Move up 10mm
G28 X Y z_hop_speed: 5
G1 X166 Y120 F6000 ; Change the X and Y coordinates to the center of your print bed
G28 Z
set_position_z: 0.0
``` ```
It's important that the initial Z upwards movement in the It's important that the z_hop movement in safe_z_home is high enough
homing_override is high enough that the probe doesn't hit anything that the probe doesn't hit anything even if the probe pin happens to
even if the probe pin happens to be in its lowest state. be in its lowest state.
Initial tests Initial tests
============= =============

7
docs/FAQ.md
View File

@ -211,9 +211,10 @@ the desired movement to the "custom g-code" section of your slicer.
If the printer requires some additional movement as part of the homing If the printer requires some additional movement as part of the homing
process itself (or fundamentally does not have a homing process) then process itself (or fundamentally does not have a homing process) then
consider using a homing_override section in the config file. If you consider using a safe_z_home or homing_override section in the config
need to move a stepper for diagnostic or debugging purposes then file. If you need to move a stepper for diagnostic or debugging
consider adding a force_move section to the config file. See purposes then consider adding a force_move section to the config
file. See
[example-extras.cfg](https://github.com/KevinOConnor/klipper/tree/master/config/example-extras.cfg) [example-extras.cfg](https://github.com/KevinOConnor/klipper/tree/master/config/example-extras.cfg)
for further details on these options. for further details on these options.