src/modules/tools/zprobe/ZProbe.cpp

   1 /*
   2       This file is part of Smoothie (http://smoothieware.org/). The motion control part is heavily based on Grbl (https://github.com/simen/grbl).
   3       Smoothie 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.
   4       Smoothie 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.
   5       You should have received a copy of the GNU General Public License along with Smoothie. If not, see <http://www.gnu.org/licenses/>.
   6 */
   7
   8 #include "ZProbe.h"
   9
  10 #include "Kernel.h"
  11 #include "BaseSolution.h"
  12 #include "Config.h"
  13 #include "Robot.h"
  14 #include "StepperMotor.h"
  15 #include "StreamOutputPool.h"
  16 #include "Gcode.h"
  17 #include "Conveyor.h"
  18 #include "Stepper.h"
  19 #include "checksumm.h"
  20 #include "ConfigValue.h"
  21 #include "SlowTicker.h"
  22 #include "Planner.h"
  23 #include "SerialMessage.h"
  24 #include "PublicDataRequest.h"
  25 #include "EndstopsPublicAccess.h"
  26 #include "PublicData.h"
  27 #include "LevelingStrategy.h"
  28 #include "StepTicker.h"
  29
  30 // strategies we know about
  31 #include "DeltaCalibrationStrategy.h"
  32 #include "ThreePointStrategy.h"
  33 #include "ZGridStrategy.h"
  34
  35 #define enable_checksum          CHECKSUM("enable")
  36 #define probe_pin_checksum       CHECKSUM("probe_pin")
  37 #define debounce_count_checksum  CHECKSUM("debounce_count")
  38 #define slow_feedrate_checksum   CHECKSUM("slow_feedrate")
  39 #define fast_feedrate_checksum   CHECKSUM("fast_feedrate")
  40 #define return_feedrate_checksum CHECKSUM("return_feedrate")
  41 #define probe_height_checksum    CHECKSUM("probe_height")
  42 #define gamma_max_checksum       CHECKSUM("gamma_max")
  43
  44 // from endstop section
  45 #define delta_homing_checksum    CHECKSUM("delta_homing")
  46
  47 #define X_AXIS 0
  48 #define Y_AXIS 1
  49 #define Z_AXIS 2
  50
  51 #define STEPPER THEKERNEL->robot->actuators
  52 #define STEPS_PER_MM(a) (STEPPER[a]->get_steps_per_mm())
  53 #define Z_STEPS_PER_MM STEPS_PER_MM(Z_AXIS)
  54
  55 #define abs(a) ((a<0) ? -a : a)
  56
  57 void ZProbe::on_module_loaded()
  58 {
  59     // if the module is disabled -> do nothing
  60     if(!THEKERNEL->config->value( zprobe_checksum, enable_checksum )->by_default(false)->as_bool()) {
  61         // as this module is not needed free up the resource
  62         delete this;
  63         return;
  64     }
  65     this->running = false;
  66
  67     // load settings
  68     this->on_config_reload(this);
  69     // register event-handlers
  70     register_for_event(ON_GCODE_RECEIVED);
  71
  72     THEKERNEL->step_ticker->register_acceleration_tick_handler([this](){acceleration_tick(); });
  73 }
  74
  75 void ZProbe::on_config_reload(void *argument)
  76 {
  77     this->pin.from_string( THEKERNEL->config->value(zprobe_checksum, probe_pin_checksum)->by_default("nc" )->as_string())->as_input();
  78     this->debounce_count = THEKERNEL->config->value(zprobe_checksum, debounce_count_checksum)->by_default(0  )->as_number();
  79
  80     // get strategies to load
  81     vector<uint16_t> modules;
  82     THEKERNEL->config->get_module_list( &modules, leveling_strategy_checksum);
  83     for( auto cs : modules ){
  84         if( THEKERNEL->config->value(leveling_strategy_checksum, cs, enable_checksum )->as_bool() ){
  85             bool found= false;
  86             // check with each known strategy and load it if it matches
  87             switch(cs) {
  88                 case delta_calibration_strategy_checksum:
  89                     this->strategies.push_back(new DeltaCalibrationStrategy(this));
  90                     found= true;
  91                     break;
  92
  93                 case three_point_leveling_strategy_checksum:
  94                     // NOTE this strategy is mutually exclusive with the delta calibration strategy
  95                     this->strategies.push_back(new ThreePointStrategy(this));
  96                     found= true;
  97                     break;
  98
  99                 case ZGrid_leveling_checksum:
 100                      this->strategies.push_back(new ZGridStrategy(this));
 101                      found= true;
 102                      break;
 103
 104                 // add other strategies here
 105                 //case zheight_map_strategy:
 106                 //     this->strategies.push_back(new ZHeightMapStrategy(this));
 107                 //     found= true;
 108                 //     break;
 109             }
 110             if(found) this->strategies.back()->handleConfig();
 111         }
 112     }
 113
 114     // need to know if we need to use delta kinematics for homing
 115     this->is_delta = THEKERNEL->config->value(delta_homing_checksum)->by_default(false)->as_bool();
 116
 117     // default for backwards compatibility add DeltaCalibrationStrategy if a delta
 118     // will be deprecated
 119     if(this->strategies.empty()) {
 120         if(this->is_delta) {
 121             this->strategies.push_back(new DeltaCalibrationStrategy(this));
 122             this->strategies.back()->handleConfig();
 123         }
 124     }
 125
 126     this->probe_height  = THEKERNEL->config->value(zprobe_checksum, probe_height_checksum)->by_default(5.0F)->as_number();
 127     this->slow_feedrate = THEKERNEL->config->value(zprobe_checksum, slow_feedrate_checksum)->by_default(5)->as_number(); // feedrate in mm/sec
 128     this->fast_feedrate = THEKERNEL->config->value(zprobe_checksum, fast_feedrate_checksum)->by_default(100)->as_number(); // feedrate in mm/sec
 129     this->return_feedrate = THEKERNEL->config->value(zprobe_checksum, return_feedrate_checksum)->by_default(0)->as_number(); // feedrate in mm/sec
 130     this->max_z         = THEKERNEL->config->value(gamma_max_checksum)->by_default(500)->as_number(); // maximum zprobe distance
 131 }
 132
 133 bool ZProbe::wait_for_probe(int& steps)
 134 {
 135     unsigned int debounce = 0;
 136     while(true) {
 137         THEKERNEL->call_event(ON_IDLE);
 138         if(THEKERNEL->is_halted()){
 139             // aborted by kill
 140             return false;
 141         }
 142
 143         // if no stepper is moving, moves are finished and there was no touch
 144         if( !STEPPER[Z_AXIS]->is_moving() && (!is_delta || (!STEPPER[Y_AXIS]->is_moving() && !STEPPER[Z_AXIS]->is_moving())) ) {
 145             return false;
 146         }
 147
 148         // if the touchprobe is active...
 149         if( this->pin.get() ) {
 150             //...increase debounce counter...
 151             if( debounce < debounce_count) {
 152                 // ...but only if the counter hasn't reached the max. value
 153                 debounce++;
 154             } else {
 155                 // ...otherwise stop the steppers, return its remaining steps
 156                 if(STEPPER[Z_AXIS]->is_moving()){
 157                     steps= STEPPER[Z_AXIS]->get_stepped();
 158                     STEPPER[Z_AXIS]->move(0, 0);
 159                 }
 160                 if(is_delta) {
 161                     for( int i = X_AXIS; i <= Y_AXIS; i++ ) {
 162                         if ( STEPPER[i]->is_moving() ) {
 163                             STEPPER[i]->move(0, 0);
 164                         }
 165                     }
 166                 }
 167                 return true;
 168             }
 169         } else {
 170             // The probe was not hit yet, reset debounce counter
 171             debounce = 0;
 172         }
 173     }
 174 }
 175
 176 // single probe with custom feedrate
 177 // returns boolean value indicating if probe was triggered
 178 bool ZProbe::run_probe_feed(int& steps, float feedrate)
 179 {
 180     // not a block move so disable the last tick setting
 181     for ( int c = X_AXIS; c <= Z_AXIS; c++ ) {
 182         STEPPER[c]->set_moved_last_block(false);
 183     }
 184
 185     // Enable the motors
 186     THEKERNEL->stepper->turn_enable_pins_on();
 187     this->current_feedrate = feedrate * Z_STEPS_PER_MM; // steps/sec
 188     float maxz= this->max_z*2;
 189
 190     // move Z down
 191     STEPPER[Z_AXIS]->move(true, maxz * Z_STEPS_PER_MM, 0); // always probes down, no more than 2*maxz
 192     if(this->is_delta) {
 193         // for delta need to move all three actuators
 194         STEPPER[X_AXIS]->move(true, maxz * STEPS_PER_MM(X_AXIS), 0);
 195         STEPPER[Y_AXIS]->move(true, maxz * STEPS_PER_MM(Y_AXIS), 0);
 196     }
 197
 198     // start acceleration processing
 199     this->running = true;
 200
 201     bool r = wait_for_probe(steps);
 202     this->running = false;
 203     STEPPER[X_AXIS]->move(0, 0);
 204     STEPPER[Y_AXIS]->move(0, 0);
 205     STEPPER[Z_AXIS]->move(0, 0);
 206     return r;
 207 }
 208
 209 // single probe with either fast or slow feedrate
 210 // returns boolean value indicating if probe was triggered
 211 bool ZProbe::run_probe(int& steps, bool fast)
 212 {
 213     float feedrate = (fast ? this->fast_feedrate : this->slow_feedrate);
 214     return run_probe_feed(steps, feedrate);
 215
 216 }
 217
 218 bool ZProbe::return_probe(int steps)
 219 {
 220     // move probe back to where it was
 221
 222     float fr;
 223     if(this->return_feedrate != 0) { // use return_feedrate if set
 224         fr = this->return_feedrate;
 225     } else {
 226         fr = this->slow_feedrate*2; // nominally twice slow feedrate
 227         if(fr > this->fast_feedrate) fr = this->fast_feedrate; // unless that is greater than fast feedrate
 228     }
 229
 230     this->current_feedrate = fr * Z_STEPS_PER_MM; // feedrate in steps/sec
 231     bool dir= steps < 0;
 232     steps= abs(steps);
 233
 234     STEPPER[Z_AXIS]->move(dir, steps, 0);
 235     if(this->is_delta) {
 236         STEPPER[X_AXIS]->move(dir, steps, 0);
 237         STEPPER[Y_AXIS]->move(dir, steps, 0);
 238     }
 239
 240     this->running = true;
 241     while(STEPPER[Z_AXIS]->is_moving() || (is_delta && (STEPPER[X_AXIS]->is_moving() || STEPPER[Y_AXIS]->is_moving())) ) {
 242         // wait for it to complete
 243         THEKERNEL->call_event(ON_IDLE);
 244          if(THEKERNEL->is_halted()){
 245             // aborted by kill
 246             break;
 247         }
 248     }
 249
 250     this->running = false;
 251     STEPPER[X_AXIS]->move(0, 0);
 252     STEPPER[Y_AXIS]->move(0, 0);
 253     STEPPER[Z_AXIS]->move(0, 0);
 254
 255     return true;
 256 }
 257
 258 bool ZProbe::doProbeAt(int &steps, float x, float y)
 259 {
 260     int s;
 261     // move to xy
 262     coordinated_move(x, y, NAN, getFastFeedrate());
 263     if(!run_probe(s)) return false;
 264
 265     // return to original Z
 266     return_probe(s);
 267     steps = s;
 268
 269     return true;
 270 }
 271
 272 float ZProbe::probeDistance(float x, float y)
 273 {
 274     int s;
 275     if(!doProbeAt(s, x, y)) return NAN;
 276     return zsteps_to_mm(s);
 277 }
 278
 279 void ZProbe::on_gcode_received(void *argument)
 280 {
 281     Gcode *gcode = static_cast<Gcode *>(argument);
 282
 283     if( gcode->has_g && gcode->g >= 29 && gcode->g <= 32) {
 284         // make sure the probe is defined and not already triggered before moving motors
 285        if(!this->pin.connected()) {
 286             gcode->stream->printf("ZProbe not connected.\n");
 287             return;
 288         }
 289         if(this->pin.get()) {
 290             gcode->stream->printf("ZProbe triggered before move, aborting command.\n");
 291             return;
 292         }
 293
 294         if( gcode->g == 30 ) { // simple Z probe
 295             // first wait for an empty queue i.e. no moves left
 296             THEKERNEL->conveyor->wait_for_empty_queue();
 297
 298             int steps;
 299             bool probe_result;
 300             if(gcode->has_letter('F')) {
 301                 probe_result = run_probe_feed(steps, gcode->get_value('F') / 60);
 302             } else {
 303                 probe_result = run_probe(steps);
 304             }
 305
 306             if(probe_result) {
 307                 gcode->stream->printf("Z:%1.4f C:%d\n", steps / Z_STEPS_PER_MM, steps);
 308                 // move back to where it started, unless a Z is specified
 309                 if(gcode->has_letter('Z')) {
 310                     // set Z to the specified value, and leave probe where it is
 311                     THEKERNEL->robot->reset_axis_position(gcode->get_value('Z'), Z_AXIS);
 312                 } else {
 313                     return_probe(steps);
 314                 }
 315             } else {
 316                 gcode->stream->printf("ZProbe not triggered\n");
 317             }
 318
 319         } else {
 320             if(gcode->subcode == 0) {
 321                 // find the first strategy to handle the gcode
 322                 for(auto s : strategies){
 323                     if(s->handleGcode(gcode)) {
 324                         return;
 325                     }
 326                 }
 327                 gcode->stream->printf("No strategy found to handle G%d\n", gcode->g);
 328
 329             }else{
 330                 // subcode selects which strategy to send the code to
 331                 // they are loaded in the order they are defined in config, 1 being the first, 2 being the second and so on.
 332                 int i= gcode->subcode-1;
 333                 if(gcode->subcode < strategies.size()) {
 334                     if(!strategies[i]->handleGcode(gcode)){
 335                         gcode->stream->printf("strategy #%d did not handle G%d\n", i+1, gcode->g);
 336                     }
 337                     return;
 338
 339                 }else{
 340                     gcode->stream->printf("strategy #%d is not loaded\n", i+1);
 341                 }
 342             }
 343         }
 344
 345     } else if(gcode->has_m) {
 346         // M code processing here
 347         int c;
 348         switch (gcode->m) {
 349             case 119:
 350                 c = this->pin.get();
 351                 gcode->stream->printf(" Probe: %d", c);
 352                 gcode->add_nl = true;
 353                 break;
 354
 355             case 670:
 356                 if (gcode->has_letter('S')) this->slow_feedrate = gcode->get_value('S');
 357                 if (gcode->has_letter('K')) this->fast_feedrate = gcode->get_value('K');
 358                 if (gcode->has_letter('R')) this->return_feedrate = gcode->get_value('R');
 359                 if (gcode->has_letter('Z')) this->max_z = gcode->get_value('Z');
 360                 if (gcode->has_letter('H')) this->probe_height = gcode->get_value('H');
 361                 break;
 362
 363             case 500: // save settings
 364             case 503: // print settings
 365                 gcode->stream->printf(";Probe feedrates Slow/fast(K)/Return (mm/sec) max_z (mm) height (mm):\nM670 S%1.2f K%1.2f R%1.2f Z%1.2f H%1.2f\n",
 366                     this->slow_feedrate, this->fast_feedrate, this->return_feedrate, this->max_z, this->probe_height);
 367
 368                 // fall through is intended so leveling strategies can handle m-codes too
 369
 370             default:
 371                 for(auto s : strategies){
 372                     if(s->handleGcode(gcode)) {
 373                         return;
 374                     }
 375                 }
 376         }
 377     }
 378 }
 379
 380 // Called periodically to change the speed to match acceleration
 381 void ZProbe::acceleration_tick(void)
 382 {
 383     if(!this->running) return; // nothing to do
 384     if(STEPPER[Z_AXIS]->is_moving()) accelerate(Z_AXIS);
 385
 386     if(is_delta) {
 387          // deltas needs to move all actuators
 388         for ( int c = X_AXIS; c <= Y_AXIS; c++ ) {
 389             if( !STEPPER[c]->is_moving() ) continue;
 390             accelerate(c);
 391         }
 392     }
 393
 394     return;
 395 }
 396
 397 void ZProbe::accelerate(int c)
 398 {   uint32_t current_rate = STEPPER[c]->get_steps_per_second();
 399     uint32_t target_rate = floorf(this->current_feedrate);
 400
 401     // Z may have a different acceleration to X and Y
 402     float acc= (c==Z_AXIS) ? THEKERNEL->planner->get_z_acceleration() : THEKERNEL->planner->get_acceleration();
 403     if( current_rate < target_rate ) {
 404         uint32_t rate_increase = floorf((acc / THEKERNEL->acceleration_ticks_per_second) * STEPS_PER_MM(c));
 405         current_rate = min( target_rate, current_rate + rate_increase );
 406     }
 407     if( current_rate > target_rate ) {
 408         current_rate = target_rate;
 409     }
 410
 411     // steps per second
 412     STEPPER[c]->set_speed(current_rate);
 413 }
 414
 415 // issue a coordinated move directly to robot, and return when done
 416 // Only move the coordinates that are passed in as not nan
 417 void ZProbe::coordinated_move(float x, float y, float z, float feedrate, bool relative)
 418 {
 419     char buf[32];
 420     char cmd[64];
 421
 422     if(relative) strcpy(cmd, "G91 G0 ");
 423     else strcpy(cmd, "G0 ");
 424
 425     if(!isnan(x)) {
 426         int n = snprintf(buf, sizeof(buf), " X%1.3f", x);
 427         strncat(cmd, buf, n);
 428     }
 429     if(!isnan(y)) {
 430         int n = snprintf(buf, sizeof(buf), " Y%1.3f", y);
 431         strncat(cmd, buf, n);
 432     }
 433     if(!isnan(z)) {
 434         int n = snprintf(buf, sizeof(buf), " Z%1.3f", z);
 435         strncat(cmd, buf, n);
 436     }
 437
 438     // use specified feedrate (mm/sec)
 439     int n = snprintf(buf, sizeof(buf), " F%1.1f", feedrate * 60); // feed rate is converted to mm/min
 440     strncat(cmd, buf, n);
 441     if(relative) strcat(cmd, " G90");
 442
 443     //THEKERNEL->streams->printf("DEBUG: move: %s\n", cmd);
 444
 445     // send as a command line as may have multiple G codes in it
 446     struct SerialMessage message;
 447     message.message = cmd;
 448     message.stream = &(StreamOutput::NullStream);
 449     THEKERNEL->call_event(ON_CONSOLE_LINE_RECEIVED, &message );
 450     THEKERNEL->conveyor->wait_for_empty_queue();
 451 }
 452
 453 // issue home command
 454 void ZProbe::home()
 455 {
 456     Gcode gc("G28", &(StreamOutput::NullStream));
 457     THEKERNEL->call_event(ON_GCODE_RECEIVED, &gc);
 458 }
 459
 460 float ZProbe::zsteps_to_mm(float steps)
 461 {
 462     return steps / Z_STEPS_PER_MM;
 463 }