better documentation
This commit is contained in:
parent
34fd59c370
commit
3b718b816c
@ -335,21 +335,44 @@ const bool Z_MAX_ENDSTOP_INVERTING = true; // set to true to invert the logic of
|
|||||||
|
|
||||||
#ifdef ENABLE_AUTO_BED_LEVELING
|
#ifdef ENABLE_AUTO_BED_LEVELING
|
||||||
|
|
||||||
// Enable auto bed leveling at any 3 points that aren't colinear
|
// There are 3 different ways to pick the X and Y locations to probe:
|
||||||
#define AUTO_BED_LEVELING_ANY_POINTS
|
// 1. Basic 3-point probe at left-back, left-front, and right-front corners of a rectangle
|
||||||
|
// 2. Probe all points of a 2D lattice, defined by a rectangle and ACCURATE_BED_LEVELING_POINTS
|
||||||
|
// 3. 3-point probe at 3 arbitrary points that don't form a line.
|
||||||
|
|
||||||
|
// To enable mode 1:
|
||||||
|
// - #define ENABLE_AUTO_BED_LEVELING
|
||||||
|
// - Set the XXXX_PROBE_BED_POSITION values below
|
||||||
|
// - Don't define AUTO_BED_LEVELING_ANY_POINTS or ACCURATE_BED_LEVELING
|
||||||
|
|
||||||
|
// To enable mode 2:
|
||||||
|
// - #define ENABLE_AUTO_BED_LEVELING
|
||||||
|
// - Set the XXXX_PROBE_BED_POSITION values below
|
||||||
|
// - #define ACCURATE_BED_LEVELING
|
||||||
|
// - Set the ACCURATE_BED_LEVELING_POINTS to your desired density
|
||||||
|
|
||||||
|
// To enable mode 3:
|
||||||
|
// - #define ENABLE_AUTO_BED_LEVELING
|
||||||
|
// - #define AUTO_BED_LEVELING_ANY_POINTS
|
||||||
|
// - Set the ABL_PROBE_PT_XXXX values below
|
||||||
|
// - Comment out (undefine) ACCURATE_BED_LEVELING since that is incompatible
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
// Mode 3: Enable auto bed leveling at any 3 points that aren't colinear
|
||||||
|
// #define AUTO_BED_LEVELING_ANY_POINTS
|
||||||
#ifdef AUTO_BED_LEVELING_ANY_POINTS
|
#ifdef AUTO_BED_LEVELING_ANY_POINTS
|
||||||
#define ABL_PROBE_PT_1_X -11
|
#define ABL_PROBE_PT_1_X 15
|
||||||
#define ABL_PROBE_PT_1_Y -15
|
#define ABL_PROBE_PT_1_Y 15
|
||||||
#define ABL_PROBE_PT_2_X -11
|
#define ABL_PROBE_PT_2_X 25
|
||||||
#define ABL_PROBE_PT_2_Y 75
|
#define ABL_PROBE_PT_2_Y 75
|
||||||
#define ABL_PROBE_PT_3_X 121
|
#define ABL_PROBE_PT_3_X 125
|
||||||
#define ABL_PROBE_PT_3_Y -15
|
#define ABL_PROBE_PT_3_Y 25
|
||||||
|
|
||||||
|
|
||||||
#else // not AUTO_BED_LEVELING_ANY_POINTS
|
#else // not AUTO_BED_LEVELING_ANY_POINTS
|
||||||
|
|
||||||
// these are the positions on the bed to do the probing
|
// Modes 1 & 2:
|
||||||
|
// For mode 1, probing happens at left-back, left-front, and right-front corners
|
||||||
|
// For mode 2, probing happens at lattice points within this rectangle (see ACCURATE_BED_LEVELING_POINTS)
|
||||||
#define LEFT_PROBE_BED_POSITION 15
|
#define LEFT_PROBE_BED_POSITION 15
|
||||||
#define RIGHT_PROBE_BED_POSITION 170
|
#define RIGHT_PROBE_BED_POSITION 170
|
||||||
#define BACK_PROBE_BED_POSITION 180
|
#define BACK_PROBE_BED_POSITION 180
|
||||||
@ -398,8 +421,11 @@ const bool Z_MAX_ENDSTOP_INVERTING = true; // set to true to invert the logic of
|
|||||||
// with accurate bed leveling, the bed is sampled in a ACCURATE_BED_LEVELING_POINTSxACCURATE_BED_LEVELING_POINTS grid and least squares solution is calculated
|
// with accurate bed leveling, the bed is sampled in a ACCURATE_BED_LEVELING_POINTSxACCURATE_BED_LEVELING_POINTS grid and least squares solution is calculated
|
||||||
// Note: this feature occupies 10'206 byte
|
// Note: this feature occupies 10'206 byte
|
||||||
#define ACCURATE_BED_LEVELING
|
#define ACCURATE_BED_LEVELING
|
||||||
|
// Mode 2 only
|
||||||
#ifdef ACCURATE_BED_LEVELING
|
#ifdef ACCURATE_BED_LEVELING
|
||||||
|
#ifdef AUTO_BED_LEVELING_ANY_POINTS
|
||||||
|
#error AUTO_BED_LEVELING_ANY_POINTS is incompatible with ACCURATE_BED_LEVELING
|
||||||
|
#endif
|
||||||
// I wouldn't see a reason to go above 3 (=9 probing points on the bed)
|
// I wouldn't see a reason to go above 3 (=9 probing points on the bed)
|
||||||
#define ACCURATE_BED_LEVELING_POINTS 2
|
#define ACCURATE_BED_LEVELING_POINTS 2
|
||||||
#endif
|
#endif
|
||||||
|
@ -1433,7 +1433,7 @@ void process_commands()
|
|||||||
break;
|
break;
|
||||||
|
|
||||||
#ifdef ENABLE_AUTO_BED_LEVELING
|
#ifdef ENABLE_AUTO_BED_LEVELING
|
||||||
case 29: // G29 Detailed Z-Probe, probes the bed at 3 points.
|
case 29: // G29 Detailed Z-Probe, probes the bed at 3 or more points.
|
||||||
{
|
{
|
||||||
#if Z_MIN_PIN == -1
|
#if Z_MIN_PIN == -1
|
||||||
#error "You must have a Z_MIN endstop in order to enable Auto Bed Leveling feature!!! Z_MIN_PIN must point to a valid hardware pin."
|
#error "You must have a Z_MIN endstop in order to enable Auto Bed Leveling feature!!! Z_MIN_PIN must point to a valid hardware pin."
|
||||||
@ -1463,6 +1463,7 @@ void process_commands()
|
|||||||
|
|
||||||
feedrate = homing_feedrate[Z_AXIS];
|
feedrate = homing_feedrate[Z_AXIS];
|
||||||
#ifdef ACCURATE_BED_LEVELING
|
#ifdef ACCURATE_BED_LEVELING
|
||||||
|
// probe at the points of a lattice grid
|
||||||
|
|
||||||
int xGridSpacing = (RIGHT_PROBE_BED_POSITION - LEFT_PROBE_BED_POSITION) / (ACCURATE_BED_LEVELING_POINTS-1);
|
int xGridSpacing = (RIGHT_PROBE_BED_POSITION - LEFT_PROBE_BED_POSITION) / (ACCURATE_BED_LEVELING_POINTS-1);
|
||||||
int yGridSpacing = (BACK_PROBE_BED_POSITION - FRONT_PROBE_BED_POSITION) / (ACCURATE_BED_LEVELING_POINTS-1);
|
int yGridSpacing = (BACK_PROBE_BED_POSITION - FRONT_PROBE_BED_POSITION) / (ACCURATE_BED_LEVELING_POINTS-1);
|
||||||
@ -1545,6 +1546,7 @@ void process_commands()
|
|||||||
|
|
||||||
|
|
||||||
#ifdef AUTO_BED_LEVELING_ANY_POINTS
|
#ifdef AUTO_BED_LEVELING_ANY_POINTS
|
||||||
|
// Probe at 3 arbitrary points
|
||||||
// probe 1
|
// probe 1
|
||||||
float z_at_pt_1 = probe_pt(ABL_PROBE_PT_1_X, ABL_PROBE_PT_1_Y, Z_RAISE_BEFORE_PROBING);
|
float z_at_pt_1 = probe_pt(ABL_PROBE_PT_1_X, ABL_PROBE_PT_1_Y, Z_RAISE_BEFORE_PROBING);
|
||||||
|
|
||||||
@ -1558,14 +1560,14 @@ void process_commands()
|
|||||||
|
|
||||||
set_bed_level_equation_any_pts(z_at_pt_1, z_at_pt_2, z_at_pt_3);
|
set_bed_level_equation_any_pts(z_at_pt_1, z_at_pt_2, z_at_pt_3);
|
||||||
#else // not AUTO_BED_LEVELING_ANY_POINTS
|
#else // not AUTO_BED_LEVELING_ANY_POINTS
|
||||||
|
// probe at 3 corners of a rectangle
|
||||||
// prob 1
|
// probe 1
|
||||||
float z_at_xLeft_yBack = probe_pt(LEFT_PROBE_BED_POSITION, BACK_PROBE_BED_POSITION, Z_RAISE_BEFORE_PROBING);
|
float z_at_xLeft_yBack = probe_pt(LEFT_PROBE_BED_POSITION, BACK_PROBE_BED_POSITION, Z_RAISE_BEFORE_PROBING);
|
||||||
|
|
||||||
// prob 2
|
// probe 2
|
||||||
float z_at_xLeft_yFront = probe_pt(LEFT_PROBE_BED_POSITION, FRONT_PROBE_BED_POSITION, current_position[Z_AXIS] + Z_RAISE_BETWEEN_PROBINGS);
|
float z_at_xLeft_yFront = probe_pt(LEFT_PROBE_BED_POSITION, FRONT_PROBE_BED_POSITION, current_position[Z_AXIS] + Z_RAISE_BETWEEN_PROBINGS);
|
||||||
|
|
||||||
// prob 3
|
// probe 3
|
||||||
float z_at_xRight_yFront = probe_pt(RIGHT_PROBE_BED_POSITION, FRONT_PROBE_BED_POSITION, current_position[Z_AXIS] + Z_RAISE_BETWEEN_PROBINGS);
|
float z_at_xRight_yFront = probe_pt(RIGHT_PROBE_BED_POSITION, FRONT_PROBE_BED_POSITION, current_position[Z_AXIS] + Z_RAISE_BETWEEN_PROBINGS);
|
||||||
|
|
||||||
clean_up_after_endstop_move();
|
clean_up_after_endstop_move();
|
||||||
|
Loading…
Reference in New Issue
Block a user