stepper.h 3.82 KB
Newer Older
Simone Primarosa's avatar
Simone Primarosa committed
1
/**
MagoKimbra's avatar
MagoKimbra committed
2
 * MK & MK4due 3D Printer Firmware
MagoKimbra's avatar
MagoKimbra committed
3
 *
MagoKimbra's avatar
MagoKimbra committed
4 5 6
 * Based on Marlin, Sprinter and grbl
 * Copyright (C) 2011 Camiel Gubbels / Erik van der Zalm
 * Copyright (C) 2013 - 2016 Alberto Cotronei @MagoKimbra
MagoKimbra's avatar
MagoKimbra committed
7
 *
MagoKimbra's avatar
MagoKimbra committed
8
 * This program is free software: you can redistribute it and/or modify
MagoKimbra's avatar
MagoKimbra committed
9 10 11 12
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
MagoKimbra's avatar
MagoKimbra committed
13
 * This program is distributed in the hope that it will be useful,
MagoKimbra's avatar
MagoKimbra committed
14
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
MagoKimbra's avatar
MagoKimbra committed
15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
MagoKimbra's avatar
MagoKimbra committed
16
 * GNU General Public License for more details.
Simone Primarosa's avatar
Simone Primarosa committed
17
 *
MagoKimbra's avatar
MagoKimbra committed
18
 * You should have received a copy of the GNU General Public License
MagoKimbra's avatar
MagoKimbra committed
19
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
MagoKimbra's avatar
MagoKimbra committed
20
 *
Simone Primarosa's avatar
Simone Primarosa committed
21
 */
MagoKimbra's avatar
MagoKimbra committed
22

MagoKimbra's avatar
MagoKimbra committed
23 24 25
/**
 * stepper.h - stepper motor driver: executes motion plans of planner.c using the stepper motors
 */
26

MagoKimbra's avatar
MagoKimbra committed
27 28 29 30 31 32
#ifndef STEPPER_H
  #define STEPPER_H 
  
  /**
   * Axis indices as enumerated constants
   *
33 34 35
   * A_AXIS and B_AXIS are used by COREXY or COREYX printers
   * A_AXIS and C_AXIS are used by COREXZ or COREZX printers
   * X_HEAD and Y_HEAD and Z_HEAD is used for systems that don't have a 1:1 relationship between X_AXIS and X Head movement, like CoreXY bots.
MagoKimbra's avatar
MagoKimbra committed
36
   */
MagoKimbra's avatar
MagoKimbra committed
37 38
  enum AxisEnum {X_AXIS = 0, A_AXIS = 0, Y_AXIS = 1, B_AXIS = 1, Z_AXIS = 2, C_AXIS = 2, E_AXIS = 3, X_HEAD = 4, Y_HEAD = 5, Z_HEAD = 5};

MagoKimbra's avatar
MagoKimbra committed
39
  #if ENABLED(ABORT_ON_ENDSTOP_HIT_FEATURE_ENABLED)
MagoKimbra's avatar
MagoKimbra committed
40 41 42 43 44
    #if ENABLED(ABORT_ON_ENDSTOP_HIT_INIT)
      bool abort_on_endstop_hit = ABORT_ON_ENDSTOP_HIT_INIT;
    #else
      bool abort_on_endstop_hit = false;
    #endif
MagoKimbra's avatar
MagoKimbra committed
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
  #endif

  // Initialize and start the stepper motor subsystem
  void st_init();

  // Block until all buffered steps are executed
  void st_synchronize();

  // Set the stepper direction of each axis
  void set_stepper_direction(bool onlye = false);

  // Set current position in steps
  void st_set_position(const long &x, const long &y, const long &z, const long &e);
  void st_set_e_position(const long &e);

  // Get current position in steps
  long st_get_position(uint8_t axis);

  // Get current position in mm
  float st_get_axis_position_mm(AxisEnum axis);

  // The stepper subsystem goes to sleep when it runs out of things to execute. Call this
  // to notify the subsystem that it is time to go to work.
  void st_wake_up();

70 71 72 73 74
  //
  // Report the positions of the steppers, in steps
  //
  void report_positions();

MagoKimbra's avatar
MagoKimbra committed
75 76 77 78
  //
  // Handle a triggered endstop
  //
  void endstop_triggered(AxisEnum axis);
MagoKimbra's avatar
MagoKimbra committed
79

MagoKimbra's avatar
MagoKimbra committed
80 81 82 83 84 85 86 87 88
  //
  // Triggered position of an axis in mm (not core-savvy)
  //
  float triggered_position_mm(AxisEnum axis);

  //
  // The direction of a single motor
  //
  bool motor_direction(AxisEnum axis);
MagoKimbra's avatar
MagoKimbra committed
89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106

  void checkStepperErrors(); //Print errors detected by the stepper

  void enable_all_steppers();
  void disable_all_steppers();
  void finishAndDisableSteppers();

  extern block_t *current_block;  // A pointer to the block currently being traced

  void quickStop();

  void digitalPotWrite(int address, int value);
  void microstep_ms(uint8_t driver, int8_t ms1, int8_t ms2);
  void microstep_mode(uint8_t driver, uint8_t stepping);
  void digipot_init();
  void digipot_current(uint8_t driver, int current);
  void microstep_init();
  void microstep_readings();
MagoKimbra's avatar
MagoKimbra committed
107
  void kill_current_block();
MagoKimbra's avatar
MagoKimbra committed
108 109 110 111 112 113 114 115 116 117 118 119 120 121

  #if ENABLED(Z_DUAL_ENDSTOPS)
    void In_Homing_Process(bool state);
    void Lock_z_motor(bool state);
    void Lock_z2_motor(bool state);
  #endif

  #if ENABLED(BABYSTEPPING)
    void babystep(const uint8_t axis, const bool direction); // perform a short step with a single stepper motor, outside of any convention
  #endif

  #if ENABLED(NPR2) // Multiextruder
    void colorstep(long csteps, const bool direction);
  #endif
MagoKimbra's avatar
MagoKimbra committed
122

MagoKimbra's avatar
MagoKimbra committed
123 124 125 126
  #if MB(ALLIGATOR)
    extern void set_driver_current();
  #endif

127
#endif // STEPPER_H