2016-07-07 22:52:44 +03:00
|
|
|
# Code for handling the kinematics of cartesian robots
|
2016-05-25 18:37:40 +03:00
|
|
|
#
|
|
|
|
# Copyright (C) 2016 Kevin O'Connor <kevin@koconnor.net>
|
|
|
|
#
|
|
|
|
# This file may be distributed under the terms of the GNU GPLv3 license.
|
2016-07-07 22:52:44 +03:00
|
|
|
import logging
|
|
|
|
import stepper, homing
|
2016-05-25 18:37:40 +03:00
|
|
|
|
2016-07-10 19:23:35 +03:00
|
|
|
StepList = (0, 1, 2)
|
2016-05-25 18:37:40 +03:00
|
|
|
|
2016-07-07 22:20:18 +03:00
|
|
|
class CartKinematics:
|
|
|
|
def __init__(self, printer, config):
|
2016-11-18 01:24:03 +03:00
|
|
|
self.steppers = [stepper.PrinterStepper(
|
|
|
|
printer, config.getsection('stepper_' + n), n)
|
|
|
|
for n in ['x', 'y', 'z']]
|
2016-12-01 23:29:26 +03:00
|
|
|
self.max_z_velocity = config.getfloat('max_z_velocity', 9999999.9)
|
|
|
|
self.max_z_accel = config.getfloat('max_z_accel', 9999999.9)
|
2016-11-14 21:40:35 +03:00
|
|
|
self.need_motor_enable = True
|
2016-09-30 23:00:32 +03:00
|
|
|
self.limits = [(1.0, -1.0)] * 3
|
2016-12-01 23:29:26 +03:00
|
|
|
def set_max_jerk(self, max_xy_halt_velocity, max_accel):
|
|
|
|
self.steppers[0].set_max_jerk(max_xy_halt_velocity, max_accel)
|
|
|
|
self.steppers[1].set_max_jerk(max_xy_halt_velocity, max_accel)
|
|
|
|
self.steppers[2].set_max_jerk(0., self.max_z_accel)
|
2016-07-07 22:20:18 +03:00
|
|
|
def build_config(self):
|
|
|
|
for stepper in self.steppers:
|
|
|
|
stepper.build_config()
|
|
|
|
def set_position(self, newpos):
|
2016-11-19 19:34:42 +03:00
|
|
|
for i in StepList:
|
|
|
|
s = self.steppers[i]
|
|
|
|
s.mcu_stepper.set_position(int(newpos[i]*s.inv_step_dist + 0.5))
|
2016-11-18 19:27:16 +03:00
|
|
|
def home(self, homing_state):
|
2016-07-07 22:20:18 +03:00
|
|
|
# Each axis is homed independently and in order
|
2016-11-18 19:27:16 +03:00
|
|
|
for axis in homing_state.get_axes():
|
2016-07-26 06:47:30 +03:00
|
|
|
s = self.steppers[axis]
|
2016-09-30 23:00:32 +03:00
|
|
|
self.limits[axis] = (s.position_min, s.position_max)
|
2016-07-26 06:47:30 +03:00
|
|
|
# Determine moves
|
|
|
|
if s.homing_positive_dir:
|
2016-09-15 19:20:16 +03:00
|
|
|
pos = s.position_endstop - 1.5*(
|
|
|
|
s.position_endstop - s.position_min)
|
2016-07-26 06:47:30 +03:00
|
|
|
rpos = s.position_endstop - s.homing_retract_dist
|
|
|
|
r2pos = rpos - s.homing_retract_dist
|
|
|
|
else:
|
|
|
|
pos = s.position_endstop + 1.5*(
|
|
|
|
s.position_max - s.position_endstop)
|
|
|
|
rpos = s.position_endstop + s.homing_retract_dist
|
|
|
|
r2pos = rpos + s.homing_retract_dist
|
|
|
|
# Initial homing
|
|
|
|
homepos = [None, None, None, None]
|
|
|
|
homepos[axis] = s.position_endstop
|
|
|
|
coord = [None, None, None, None]
|
|
|
|
coord[axis] = pos
|
2016-12-09 02:12:20 +03:00
|
|
|
homing_state.home(list(coord), homepos, [s], s.homing_speed)
|
2016-07-26 06:47:30 +03:00
|
|
|
# Retract
|
|
|
|
coord[axis] = rpos
|
2016-12-09 02:12:20 +03:00
|
|
|
homing_state.retract(list(coord), s.homing_speed)
|
2016-07-26 06:47:30 +03:00
|
|
|
# Home again
|
|
|
|
coord[axis] = r2pos
|
2016-12-09 02:12:20 +03:00
|
|
|
homing_state.home(
|
|
|
|
list(coord), homepos, [s], s.homing_speed/2.0, second_home=True)
|
|
|
|
# Set final homed position
|
|
|
|
coord[axis] = s.position_endstop + s.get_homed_offset()*s.step_dist
|
|
|
|
homing_state.set_homed_position(coord)
|
2016-07-07 22:20:18 +03:00
|
|
|
def motor_off(self, move_time):
|
2016-09-30 23:00:32 +03:00
|
|
|
self.limits = [(1.0, -1.0)] * 3
|
2016-07-07 22:20:18 +03:00
|
|
|
for stepper in self.steppers:
|
|
|
|
stepper.motor_enable(move_time, 0)
|
2016-11-14 21:40:35 +03:00
|
|
|
self.need_motor_enable = True
|
2016-12-09 02:14:46 +03:00
|
|
|
def _check_motor_enable(self, move_time, move):
|
2016-11-14 21:40:35 +03:00
|
|
|
need_motor_enable = False
|
|
|
|
for i in StepList:
|
|
|
|
if move.axes_d[i]:
|
|
|
|
self.steppers[i].motor_enable(move_time, 1)
|
|
|
|
need_motor_enable |= self.steppers[i].need_motor_enable
|
|
|
|
self.need_motor_enable = need_motor_enable
|
2016-12-08 20:42:12 +03:00
|
|
|
def query_endstops(self, print_time):
|
|
|
|
endstops = [(s, s.query_endstop(print_time)) for s in self.steppers]
|
|
|
|
return [(s.name, es.query_endstop_wait()) for s, es in endstops]
|
2016-12-09 02:14:46 +03:00
|
|
|
def _check_endstops(self, move):
|
2016-10-26 02:11:05 +03:00
|
|
|
end_pos = move.end_pos
|
2016-09-30 23:00:32 +03:00
|
|
|
for i in StepList:
|
|
|
|
if (move.axes_d[i]
|
2016-10-26 02:11:05 +03:00
|
|
|
and (end_pos[i] < self.limits[i][0]
|
|
|
|
or end_pos[i] > self.limits[i][1])):
|
2016-09-30 23:00:32 +03:00
|
|
|
if self.limits[i][0] > self.limits[i][1]:
|
2016-11-18 20:42:39 +03:00
|
|
|
raise homing.EndstopMoveError(
|
|
|
|
end_pos, "Must home axis first")
|
|
|
|
raise homing.EndstopMoveError(end_pos)
|
2016-09-30 21:47:45 +03:00
|
|
|
def check_move(self, move):
|
2016-09-30 23:00:32 +03:00
|
|
|
limits = self.limits
|
2016-10-26 02:11:05 +03:00
|
|
|
xpos, ypos = move.end_pos[:2]
|
2016-09-30 23:00:32 +03:00
|
|
|
if (xpos < limits[0][0] or xpos > limits[0][1]
|
|
|
|
or ypos < limits[1][0] or ypos > limits[1][1]):
|
2016-12-09 02:14:46 +03:00
|
|
|
self._check_endstops(move)
|
2016-09-30 21:47:45 +03:00
|
|
|
if not move.axes_d[2]:
|
|
|
|
# Normal XY move - use defaults
|
|
|
|
return
|
|
|
|
# Move with Z - update velocity and accel for slower Z axis
|
2016-12-09 02:14:46 +03:00
|
|
|
self._check_endstops(move)
|
2016-12-01 23:29:26 +03:00
|
|
|
z_ratio = move.move_d / abs(move.axes_d[2])
|
|
|
|
move.limit_speed(
|
|
|
|
self.max_z_velocity * z_ratio, self.max_z_accel * z_ratio)
|
2016-07-07 22:20:18 +03:00
|
|
|
def move(self, move_time, move):
|
2016-11-14 21:40:35 +03:00
|
|
|
if self.need_motor_enable:
|
2016-12-09 02:14:46 +03:00
|
|
|
self._check_motor_enable(move_time, move)
|
2016-07-07 22:20:18 +03:00
|
|
|
inv_accel = 1. / move.accel
|
|
|
|
inv_cruise_v = 1. / move.cruise_v
|
|
|
|
for i in StepList:
|
2016-11-10 20:44:04 +03:00
|
|
|
if not move.axes_d[i]:
|
2016-07-07 22:20:18 +03:00
|
|
|
continue
|
2016-11-14 21:40:35 +03:00
|
|
|
mcu_stepper = self.steppers[i].mcu_stepper
|
|
|
|
mcu_time = mcu_stepper.print_to_mcu_time(move_time)
|
2016-11-19 19:34:42 +03:00
|
|
|
step_pos = mcu_stepper.commanded_position
|
2016-11-10 20:44:04 +03:00
|
|
|
inv_step_dist = self.steppers[i].inv_step_dist
|
2016-11-19 19:34:42 +03:00
|
|
|
step_offset = step_pos - move.start_pos[i] * inv_step_dist
|
2016-10-26 04:05:31 +03:00
|
|
|
steps = move.axes_d[i] * inv_step_dist
|
2016-11-10 20:44:04 +03:00
|
|
|
move_step_d = move.move_d / abs(steps)
|
2016-07-07 22:20:18 +03:00
|
|
|
|
|
|
|
# Acceleration steps
|
2016-10-26 02:30:01 +03:00
|
|
|
accel_multiplier = 2.0 * move_step_d * inv_accel
|
2016-11-10 20:44:04 +03:00
|
|
|
if move.accel_r:
|
|
|
|
#t = sqrt(2*pos/accel + (start_v/accel)**2) - start_v/accel
|
|
|
|
accel_time_offset = move.start_v * inv_accel
|
|
|
|
accel_sqrt_offset = accel_time_offset**2
|
|
|
|
accel_steps = move.accel_r * steps
|
2016-11-14 21:40:35 +03:00
|
|
|
count = mcu_stepper.step_sqrt(
|
2016-11-10 20:44:04 +03:00
|
|
|
mcu_time - accel_time_offset, accel_steps, step_offset
|
|
|
|
, accel_sqrt_offset, accel_multiplier)
|
|
|
|
step_offset += count - accel_steps
|
|
|
|
mcu_time += move.accel_t
|
2016-07-07 22:20:18 +03:00
|
|
|
# Cruising steps
|
2016-11-10 20:44:04 +03:00
|
|
|
if move.cruise_r:
|
|
|
|
#t = pos/cruise_v
|
|
|
|
cruise_multiplier = move_step_d * inv_cruise_v
|
|
|
|
cruise_steps = move.cruise_r * steps
|
2016-11-14 21:40:35 +03:00
|
|
|
count = mcu_stepper.step_factor(
|
2016-11-10 20:44:04 +03:00
|
|
|
mcu_time, cruise_steps, step_offset, cruise_multiplier)
|
|
|
|
step_offset += count - cruise_steps
|
|
|
|
mcu_time += move.cruise_t
|
2016-07-07 22:20:18 +03:00
|
|
|
# Deceleration steps
|
2016-11-10 20:44:04 +03:00
|
|
|
if move.decel_r:
|
|
|
|
#t = cruise_v/accel - sqrt((cruise_v/accel)**2 - 2*pos/accel)
|
|
|
|
decel_time_offset = move.cruise_v * inv_accel
|
|
|
|
decel_sqrt_offset = decel_time_offset**2
|
|
|
|
decel_steps = move.decel_r * steps
|
2016-11-14 21:40:35 +03:00
|
|
|
count = mcu_stepper.step_sqrt(
|
2016-11-10 20:44:04 +03:00
|
|
|
mcu_time + decel_time_offset, decel_steps, step_offset
|
|
|
|
, decel_sqrt_offset, -accel_multiplier)
|