planner.h 7.23 KB
Newer Older
MagoKimbra's avatar
MagoKimbra committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/*
  planner.h - buffers movement commands and manages the acceleration profile plan
  Part of Grbl

  Copyright (c) 2009-2011 Simen Svale Skogsrud

  Grbl is free software: you can redistribute it and/or modify
  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.

  Grbl is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with Grbl.  If not, see <http://www.gnu.org/licenses/>.
*/

MagoKimbra's avatar
MagoKimbra committed
21
// This module is to be considered a sub-module of stepper.c. Please don't include
MagoKimbra's avatar
MagoKimbra committed
22 23 24 25 26
// this file from any other module.

#ifndef PLANNER_H
#define PLANNER_H

MagoKimbra's avatar
MagoKimbra committed
27
// This struct is used when buffering the setup for each linear movement "nominal" values are as specified in
MagoKimbra's avatar
MagoKimbra committed
28
// the source g-code and may never actually be reached if acceleration management is active.
MagoKimbra's avatar
MagoKimbra committed
29
typedef struct {
MagoKimbra's avatar
MagoKimbra committed
30 31 32 33 34 35 36 37
  // Fields used by the bresenham algorithm for tracing the line
  long steps[NUM_AXIS];                     // Step count along each axis
  unsigned long step_event_count;           // The number of step events required to complete this block
  long accelerate_until;                    // The index of the step event on which to stop acceleration
  long decelerate_after;                    // The index of the step event on which to start decelerating
  long acceleration_rate;                   // The acceleration rate used for acceleration calculation
  unsigned char direction_bits;             // The direction bit set for this block (refers to *_DIRECTION_BIT in config.h)
  unsigned char active_driver;              // Selects the active driver
MagoKimbra's avatar
MagoKimbra committed
38
  #if ENABLED(ADVANCE)
MagoKimbra's avatar
MagoKimbra committed
39 40 41 42 43 44 45 46
    long advance_rate;
    volatile long initial_advance;
    volatile long final_advance;
    float advance;
  #endif

  // Fields used by the motion planner to manage acceleration
  // float speed_x, speed_y, speed_z, speed_e;       // Nominal mm/sec for each axis
MagoKimbra's avatar
MagoKimbra committed
47
  float nominal_speed;                               // The nominal speed for this block in mm/sec
MagoKimbra's avatar
MagoKimbra committed
48 49 50 51 52 53 54 55
  float entry_speed;                                 // Entry speed at previous-current junction in mm/sec
  float max_entry_speed;                             // Maximum allowable junction entry speed in mm/sec
  float millimeters;                                 // The total travel of this block in mm
  float acceleration;                                // acceleration mm/sec^2
  unsigned char recalculate_flag;                    // Planner flag to recalculate trapezoids on entry junction
  unsigned char nominal_length_flag;                 // Planner flag for nominal speed always reached

  // Settings for the trapezoid generator
MagoKimbra's avatar
MagoKimbra committed
56 57
  unsigned long nominal_rate;                        // The nominal step rate for this block in step_events/sec
  unsigned long initial_rate;                        // The jerk-adjusted step rate at start of block
MagoKimbra's avatar
MagoKimbra committed
58 59 60
  unsigned long final_rate;                          // The minimal rate at exit
  unsigned long acceleration_st;                     // acceleration steps/sec^2
  unsigned long fan_speed;
MagoKimbra's avatar
MagoKimbra committed
61
  #if ENABLED(BARICUDA)
MagoKimbra's avatar
MagoKimbra committed
62 63 64
    unsigned long valve_pressure;
    unsigned long e_to_p_pressure;
  #endif
MagoKimbra's avatar
MagoKimbra committed
65
  #if ENABLED(LASERBEAM)
MagoKimbra's avatar
MagoKimbra committed
66 67 68
    unsigned long laser_ttlmodulation;
  #endif
  volatile char busy;
MagoKimbra's avatar
MagoKimbra committed
69 70
} block_t;

MagoKimbra's avatar
MagoKimbra committed
71 72
#define BLOCK_MOD(n) ((n)&(BLOCK_BUFFER_SIZE-1))

MagoKimbra's avatar
MagoKimbra committed
73
// Initialize the motion plan subsystem
MagoKimbra's avatar
MagoKimbra committed
74 75 76 77 78 79 80 81 82
void plan_init();

void check_axes_activity();

// Get the number of buffered moves
extern volatile unsigned char block_buffer_head;
extern volatile unsigned char block_buffer_tail;
FORCE_INLINE uint8_t movesplanned() { return BLOCK_MOD(block_buffer_head - block_buffer_tail + BLOCK_BUFFER_SIZE); }

MagoKimbra's avatar
MagoKimbra committed
83
#if ENABLED(AUTO_BED_LEVELING_FEATURE)
MagoKimbra's avatar
MagoKimbra committed
84

MagoKimbra's avatar
MagoKimbra committed
85 86
  #include "vector_3.h"

MagoKimbra's avatar
MagoKimbra committed
87 88 89 90 91 92 93 94 95 96 97 98
  // Transform required to compensate for bed level
  extern matrix_3x3 plan_bed_level_matrix;

  /**
   * Get the position applying the bed level matrix
   */
  vector_3 plan_get_position();

  /**
   * Add a new linear movement to the buffer. x, y, z are the signed, absolute target position in
   * millimeters. Feed rate specifies the (target) speed of the motion.
   */
MagoKimbra's avatar
MagoKimbra committed
99
  void plan_buffer_line(float x, float y, float z, const float& e, float feed_rate, const uint8_t extruder, const uint8_t driver);
MagoKimbra's avatar
MagoKimbra committed
100 101 102 103 104 105

  /**
   * Set the planner positions. Used for G92 instructions.
   * Multiplies by axis_steps_per_unit[] to set stepper positions.
   * Clears previous speed values.
   */
MagoKimbra's avatar
MagoKimbra committed
106
  void plan_set_position(float x, float y, float z, const float& e);
MagoKimbra's avatar
MagoKimbra committed
107 108

#else
MagoKimbra's avatar
MagoKimbra committed
109 110 111 112

  void plan_buffer_line(const float& x, const float& y, const float& z, const float& e, float feed_rate, const uint8_t extruder, const uint8_t driver);
  void plan_set_position(const float& x, const float& y, const float& z, const float& e);

MagoKimbra's avatar
MagoKimbra committed
113
#endif // AUTO_BED_LEVELING_FEATURE
MagoKimbra's avatar
MagoKimbra committed
114

MagoKimbra's avatar
MagoKimbra committed
115
void plan_set_e_position(const float& e);
MagoKimbra's avatar
MagoKimbra committed
116

MagoKimbra's avatar
MagoKimbra committed
117 118 119 120
//===========================================================================
//============================= public variables ============================
//===========================================================================

MagoKimbra's avatar
MagoKimbra committed
121
extern millis_t minsegmenttime;
MagoKimbra's avatar
MagoKimbra committed
122
extern float max_feedrate[3 + EXTRUDERS]; // Max speeds in mm per minute
MagoKimbra's avatar
MagoKimbra committed
123 124 125
extern float axis_steps_per_unit[3 + EXTRUDERS];
extern unsigned long max_acceleration_units_per_sq_second[3 + EXTRUDERS]; // Use M201 to override by software
extern float minimumfeedrate;
MagoKimbra's avatar
MagoKimbra committed
126 127 128 129
extern float acceleration;                    // Normal acceleration mm/s^2  DEFAULT ACCELERATION for all moves. M204 SXXXX
extern float retract_acceleration[EXTRUDERS]; // Retract acceleration mm/s^2 filament pull-back and push-forward while standing still in the other axis M204 TXXXX
extern float travel_acceleration;             // Travel acceleration mm/s^2  DEFAULT ACCELERATION for all NON printing moves. M204 MXXXX
extern float max_xy_jerk;                     // The largest speed change requiring no acceleration
MagoKimbra's avatar
MagoKimbra committed
130
extern float max_z_jerk;
MagoKimbra's avatar
MagoKimbra committed
131
extern float max_e_jerk[EXTRUDERS];
MagoKimbra's avatar
MagoKimbra committed
132 133 134
extern float mintravelfeedrate;
extern unsigned long axis_steps_per_sqr_second[3 + EXTRUDERS];

MagoKimbra's avatar
MagoKimbra committed
135
#if ENABLED(AUTOTEMP)
MagoKimbra's avatar
MagoKimbra committed
136 137 138 139 140 141 142 143
  extern bool autotemp_enabled;
  extern float autotemp_max;
  extern float autotemp_min;
  extern float autotemp_factor;
#endif

extern block_t block_buffer[BLOCK_BUFFER_SIZE];            // A ring buffer for motion instructions
extern volatile unsigned char block_buffer_head;           // Index of the next block to be pushed
MagoKimbra's avatar
MagoKimbra committed
144
extern volatile unsigned char block_buffer_tail;
MagoKimbra's avatar
MagoKimbra committed
145 146 147 148 149 150 151 152 153 154 155 156

// Returns true if the buffer has a queued block, false otherwise
FORCE_INLINE bool blocks_queued() { return (block_buffer_head != block_buffer_tail); }

// Called when the current block is no longer needed. Discards
// the block and makes the memory available for new blocks.
FORCE_INLINE void plan_discard_current_block() {
  if (blocks_queued())
    block_buffer_tail = BLOCK_MOD(block_buffer_tail + 1);
}

// Gets the current block. Returns NULL if buffer empty
MagoKimbra's avatar
MagoKimbra committed
157
FORCE_INLINE block_t* plan_get_current_block() {
MagoKimbra's avatar
MagoKimbra committed
158
  if (blocks_queued()) {
MagoKimbra's avatar
MagoKimbra committed
159
    block_t* block = &block_buffer[block_buffer_tail];
MagoKimbra's avatar
MagoKimbra committed
160 161 162 163 164 165 166 167 168
    block->busy = true;
    return block;
  }
  else
    return NULL;
}

void reset_acceleration_rates();

MagoKimbra's avatar
MagoKimbra committed
169
#endif // PLANNER_H