aboutsummaryrefslogtreecommitdiffstats
path: root/klippy/extras
diff options
context:
space:
mode:
Diffstat (limited to 'klippy/extras')
-rw-r--r--klippy/extras/endstop_phase.py6
-rw-r--r--klippy/extras/gcode_move.py21
-rw-r--r--klippy/extras/homing.py182
-rw-r--r--klippy/extras/homing_override.py2
-rw-r--r--klippy/extras/probe.py10
-rw-r--r--klippy/extras/safe_z_home.py2
6 files changed, 199 insertions, 24 deletions
diff --git a/klippy/extras/endstop_phase.py b/klippy/extras/endstop_phase.py
index 66e9fc38..8e70be74 100644
--- a/klippy/extras/endstop_phase.py
+++ b/klippy/extras/endstop_phase.py
@@ -1,6 +1,6 @@
# Endstop accuracy improvement via stepper phase tracking
#
-# Copyright (C) 2016-2018 Kevin O'Connor <kevin@koconnor.net>
+# Copyright (C) 2016-2021 Kevin O'Connor <kevin@koconnor.net>
#
# This file may be distributed under the terms of the GNU GPLv3 license.
import math, logging
@@ -101,7 +101,7 @@ class EndstopPhase:
"Endstop %s incorrect phase (got %d vs %d)" % (
self.name, phase, self.endstop_phase))
return delta * self.step_dist
- def handle_home_rails_end(self, rails):
+ def handle_home_rails_end(self, homing_state, rails):
for rail in rails:
stepper = rail.get_steppers()[0]
if stepper.get_name() != self.name:
@@ -149,7 +149,7 @@ class EndstopPhases:
return
phase = convert_phase(driver_phase, driver_phases, len(phase_history))
phase_history[phase] += 1
- def handle_home_rails_end(self, rails):
+ def handle_home_rails_end(self, homing_state, rails):
for rail in rails:
stepper = rail.get_steppers()[0]
stepper_name = stepper.get_name()
diff --git a/klippy/extras/gcode_move.py b/klippy/extras/gcode_move.py
index 4bdfdf8b..1b9a22b7 100644
--- a/klippy/extras/gcode_move.py
+++ b/klippy/extras/gcode_move.py
@@ -4,7 +4,6 @@
#
# This file may be distributed under the terms of the GNU GPLv3 license.
import logging
-import homing
class GCodeMove:
def __init__(self, config):
@@ -19,11 +18,13 @@ class GCodeMove:
self.reset_last_position)
printer.register_event_handler("extruder:activate_extruder",
self._handle_activate_extruder)
+ printer.register_event_handler("homing:home_rails_end",
+ self._handle_home_rails_end)
self.is_printer_ready = False
# Register g-code commands
gcode = printer.lookup_object('gcode')
handlers = [
- 'G1', 'G28', 'G20', 'G21',
+ 'G1', 'G20', 'G21',
'M82', 'M83', 'G90', 'G91', 'G92', 'M220', 'M221',
'SET_GCODE_OFFSET', 'SAVE_GCODE_STATE', 'RESTORE_GCODE_STATE',
]
@@ -68,6 +69,10 @@ class GCodeMove:
self.reset_last_position()
self.extrude_factor = 1.
self.base_position[3] = self.last_position[3]
+ def _handle_home_rails_end(self, homing_state, rails):
+ self.reset_last_position()
+ for axis in homing_state.get_axes():
+ self.base_position[axis] = self.homing_position[axis]
def set_move_transform(self, transform, force=False):
if self.move_transform is not None and not force:
raise self.printer.config_error(
@@ -134,18 +139,6 @@ class GCodeMove:
raise gcmd.error("Unable to parse move '%s'"
% (gcmd.get_commandline(),))
self.move_with_transform(self.last_position, self.speed)
- def cmd_G28(self, gcmd):
- # Move to origin
- axes = []
- for pos, axis in enumerate('XYZ'):
- if gcmd.get(axis, None) is not None:
- axes.append(pos)
- if not axes:
- axes = [0, 1, 2]
- homing_state = homing.Homing(self.printer)
- homing_state.home_axes(axes)
- for axis in homing_state.get_axes():
- self.base_position[axis] = self.homing_position[axis]
# G-Code coordinate manipulation
def cmd_G20(self, gcmd):
# Set units to inches
diff --git a/klippy/extras/homing.py b/klippy/extras/homing.py
new file mode 100644
index 00000000..283e0df7
--- /dev/null
+++ b/klippy/extras/homing.py
@@ -0,0 +1,182 @@
+# Helper code for implementing homing operations
+#
+# Copyright (C) 2016-2021 Kevin O'Connor <kevin@koconnor.net>
+#
+# This file may be distributed under the terms of the GNU GPLv3 license.
+import logging, math, collections
+
+HOMING_START_DELAY = 0.001
+ENDSTOP_SAMPLE_TIME = .000015
+ENDSTOP_SAMPLE_COUNT = 4
+
+# State tracking during toolhead homing/probing operations
+class Homing:
+ def __init__(self, printer):
+ self.printer = printer
+ self.toolhead = printer.lookup_object('toolhead')
+ self.changed_axes = []
+ self.verify_retract = True
+ if self.printer.get_start_args().get("debuginput"):
+ self.verify_retract = False
+ def set_axes(self, axes):
+ self.changed_axes = axes
+ def get_axes(self):
+ return self.changed_axes
+ def _fill_coord(self, coord):
+ # Fill in any None entries in 'coord' with current toolhead position
+ thcoord = list(self.toolhead.get_position())
+ for i in range(len(coord)):
+ if coord[i] is not None:
+ thcoord[i] = coord[i]
+ return thcoord
+ def set_homed_position(self, pos):
+ self.toolhead.set_position(self._fill_coord(pos))
+ def _calc_endstop_rate(self, mcu_endstop, movepos, speed):
+ startpos = self.toolhead.get_position()
+ axes_d = [mp - sp for mp, sp in zip(movepos, startpos)]
+ move_d = math.sqrt(sum([d*d for d in axes_d[:3]]))
+ move_t = move_d / speed
+ max_steps = max([(abs(s.calc_position_from_coord(startpos)
+ - s.calc_position_from_coord(movepos))
+ / s.get_step_dist())
+ for s in mcu_endstop.get_steppers()])
+ if max_steps <= 0.:
+ return .001
+ return move_t / max_steps
+ def homing_move(self, movepos, endstops, speed,
+ probe_pos=False, verify_movement=False):
+ # Notify start of homing/probing move
+ self.printer.send_event("homing:homing_move_begin",
+ [es for es, name in endstops])
+ # Note start location
+ self.toolhead.flush_step_generation()
+ kin = self.toolhead.get_kinematics()
+ for s in kin.get_steppers():
+ s.set_tag_position(s.get_commanded_position())
+ start_mcu_pos = [(s, name, s.get_mcu_position())
+ for es, name in endstops for s in es.get_steppers()]
+ # Start endstop checking
+ print_time = self.toolhead.get_last_move_time()
+ endstop_triggers = []
+ for mcu_endstop, name in endstops:
+ rest_time = self._calc_endstop_rate(mcu_endstop, movepos, speed)
+ wait = mcu_endstop.home_start(print_time, ENDSTOP_SAMPLE_TIME,
+ ENDSTOP_SAMPLE_COUNT, rest_time)
+ endstop_triggers.append(wait)
+ all_endstop_trigger = multi_complete(self.printer, endstop_triggers)
+ self.toolhead.dwell(HOMING_START_DELAY)
+ # Issue move
+ error = None
+ try:
+ self.toolhead.drip_move(movepos, speed, all_endstop_trigger)
+ except CommandError as e:
+ error = "Error during homing move: %s" % (str(e),)
+ # Wait for endstops to trigger
+ move_end_print_time = self.toolhead.get_last_move_time()
+ for mcu_endstop, name in endstops:
+ did_trigger = mcu_endstop.home_wait(move_end_print_time)
+ if not did_trigger and error is None:
+ error = "Failed to home %s: Timeout during homing" % (name,)
+ # Determine stepper halt positions
+ self.toolhead.flush_step_generation()
+ end_mcu_pos = [(s, name, spos, s.get_mcu_position())
+ for s, name, spos in start_mcu_pos]
+ if probe_pos:
+ for s, name, spos, epos in end_mcu_pos:
+ md = (epos - spos) * s.get_step_dist()
+ s.set_tag_position(s.get_tag_position() + md)
+ self.set_homed_position(kin.calc_tag_position())
+ else:
+ self.toolhead.set_position(movepos)
+ # Signal homing/probing move complete
+ try:
+ self.printer.send_event("homing:homing_move_end",
+ [es for es, name in endstops])
+ except CommandError as e:
+ if error is None:
+ error = str(e)
+ if error is not None:
+ raise CommandError(error)
+ # Check if some movement occurred
+ if verify_movement:
+ for s, name, spos, epos in end_mcu_pos:
+ if spos == epos:
+ if probe_pos:
+ raise CommandError("Probe triggered prior to movement")
+ raise CommandError(
+ "Endstop %s still triggered after retract" % (name,))
+ def home_rails(self, rails, forcepos, movepos):
+ # Notify of upcoming homing operation
+ self.printer.send_event("homing:home_rails_begin", self, rails)
+ # Alter kinematics class to think printer is at forcepos
+ homing_axes = [axis for axis in range(3) if forcepos[axis] is not None]
+ forcepos = self._fill_coord(forcepos)
+ movepos = self._fill_coord(movepos)
+ self.toolhead.set_position(forcepos, homing_axes=homing_axes)
+ # Perform first home
+ endstops = [es for rail in rails for es in rail.get_endstops()]
+ hi = rails[0].get_homing_info()
+ self.homing_move(movepos, endstops, hi.speed)
+ # Perform second home
+ if hi.retract_dist:
+ # Retract
+ axes_d = [mp - fp for mp, fp in zip(movepos, forcepos)]
+ move_d = math.sqrt(sum([d*d for d in axes_d[:3]]))
+ retract_r = min(1., hi.retract_dist / move_d)
+ retractpos = [mp - ad * retract_r
+ for mp, ad in zip(movepos, axes_d)]
+ self.toolhead.move(retractpos, hi.retract_speed)
+ # Home again
+ forcepos = [rp - ad * retract_r
+ for rp, ad in zip(retractpos, axes_d)]
+ self.toolhead.set_position(forcepos)
+ self.homing_move(movepos, endstops, hi.second_homing_speed,
+ verify_movement=self.verify_retract)
+ # Signal home operation complete
+ self.toolhead.flush_step_generation()
+ kin = self.toolhead.get_kinematics()
+ for s in kin.get_steppers():
+ s.set_tag_position(s.get_commanded_position())
+ ret = self.printer.send_event("homing:home_rails_end", self, rails)
+ if any(ret):
+ # Apply any homing offsets
+ adjustpos = kin.calc_tag_position()
+ for axis in homing_axes:
+ movepos[axis] = adjustpos[axis]
+ self.toolhead.set_position(movepos)
+ def home_axes(self, axes):
+ self.changed_axes = axes
+ try:
+ self.toolhead.get_kinematics().home(self)
+ except CommandError:
+ self.printer.lookup_object('stepper_enable').motor_off()
+ raise
+
+# Return a completion that completes when all completions in a list complete
+def multi_complete(printer, completions):
+ if len(completions) == 1:
+ return completions[0]
+ cb = (lambda e: all([c.wait() for c in completions]))
+ return printer.get_reactor().register_callback(cb)
+
+class PrinterHoming:
+ def __init__(self, config):
+ self.printer = config.get_printer()
+ # Register g-code commands
+ gcode = self.printer.lookup_object('gcode')
+ gcode.register_command('G28', self.cmd_G28)
+ def new_homing_state(self):
+ return Homing(self.printer)
+ def cmd_G28(self, gcmd):
+ # Move to origin
+ axes = []
+ for pos, axis in enumerate('XYZ'):
+ if gcmd.get(axis, None) is not None:
+ axes.append(pos)
+ if not axes:
+ axes = [0, 1, 2]
+ homing_state = Homing(self.printer)
+ homing_state.home_axes(axes)
+
+def load_config(config):
+ return PrinterHoming(config)
diff --git a/klippy/extras/homing_override.py b/klippy/extras/homing_override.py
index 149bd022..a1cf94b5 100644
--- a/klippy/extras/homing_override.py
+++ b/klippy/extras/homing_override.py
@@ -13,7 +13,7 @@ class HomingOverride:
gcode_macro = self.printer.load_object(config, 'gcode_macro')
self.template = gcode_macro.load_template(config, 'gcode')
self.in_script = False
- self.printer.load_object(config, 'gcode_move')
+ self.printer.load_object(config, 'homing')
self.gcode = self.printer.lookup_object('gcode')
self.prev_G28 = self.gcode.register_command("G28", None)
self.gcode.register_command("G28", self.cmd_G28)
diff --git a/klippy/extras/probe.py b/klippy/extras/probe.py
index e1115e0e..fe6cb151 100644
--- a/klippy/extras/probe.py
+++ b/klippy/extras/probe.py
@@ -1,10 +1,10 @@
# Z-Probe support
#
-# Copyright (C) 2017-2020 Kevin O'Connor <kevin@koconnor.net>
+# Copyright (C) 2017-2021 Kevin O'Connor <kevin@koconnor.net>
#
# This file may be distributed under the terms of the GNU GPLv3 license.
import logging
-import pins, homing
+import pins
from . import manual_probe
HINT_TIMEOUT = """
@@ -75,11 +75,11 @@ class PrinterProbe:
def _handle_homing_move_end(self, endstops):
if self.mcu_probe in endstops:
self.mcu_probe.probe_finish()
- def _handle_home_rails_begin(self, rails):
+ def _handle_home_rails_begin(self, homing_state, rails):
endstops = [es for rail in rails for es, name in rail.get_endstops()]
if self.mcu_probe in endstops:
self.multi_probe_begin()
- def _handle_home_rails_end(self, rails):
+ def _handle_home_rails_end(self, homing_state, rails):
endstops = [es for rail in rails for es, name in rail.get_endstops()]
if self.mcu_probe in endstops:
self.multi_probe_end()
@@ -112,7 +112,7 @@ class PrinterProbe:
curtime = self.printer.get_reactor().monotonic()
if 'z' not in toolhead.get_status(curtime)['homed_axes']:
raise self.printer.command_error("Must home before probe")
- homing_state = homing.Homing(self.printer)
+ homing_state = self.printer.lookup_object('homing').new_homing_state()
pos = toolhead.get_position()
pos[2] = self.z_position
endstops = [(self.mcu_probe, "probe")]
diff --git a/klippy/extras/safe_z_home.py b/klippy/extras/safe_z_home.py
index 93536274..6dd2f292 100644
--- a/klippy/extras/safe_z_home.py
+++ b/klippy/extras/safe_z_home.py
@@ -20,7 +20,7 @@ class SafeZHoming:
self.max_z = zconfig.getfloat('position_max', note_valid=False)
self.speed = config.getfloat('speed', 50.0, above=0.)
self.move_to_previous = config.getboolean('move_to_previous', False)
- self.printer.load_object(config, 'gcode_move')
+ self.printer.load_object(config, 'homing')
self.gcode = self.printer.lookup_object('gcode')
self.prev_G28 = self.gcode.register_command("G28", None)
self.gcode.register_command("G28", self.cmd_G28)