My Marlin configs for Fabrikator Mini and CTC i3 Pro B
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。

ubl_motion.cpp 31KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738
  1. /**
  2. * Marlin 3D Printer Firmware
  3. * Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
  4. *
  5. * Based on Sprinter and grbl.
  6. * Copyright (C) 2011 Camiel Gubbels / Erik van der Zalm
  7. *
  8. * This program is free software: you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation, either version 3 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  20. *
  21. */
  22. #include "MarlinConfig.h"
  23. #if ENABLED(AUTO_BED_LEVELING_UBL)
  24. #include "Marlin.h"
  25. #include "ubl.h"
  26. #include "planner.h"
  27. #include "stepper.h"
  28. #include <math.h>
  29. extern float destination[XYZE];
  30. #if AVR_AT90USB1286_FAMILY // Teensyduino & Printrboard IDE extensions have compile errors without this
  31. inline void set_current_to_destination() { COPY(current_position, destination); }
  32. #else
  33. extern void set_current_to_destination();
  34. #endif
  35. #if ENABLED(DELTA)
  36. extern float delta[ABC],
  37. endstop_adj[ABC];
  38. extern float delta_radius,
  39. delta_tower_angle_trim[2],
  40. delta_tower[ABC][2],
  41. delta_diagonal_rod,
  42. delta_calibration_radius,
  43. delta_diagonal_rod_2_tower[ABC],
  44. delta_segments_per_second,
  45. delta_clip_start_height;
  46. extern float delta_safe_distance_from_top();
  47. #endif
  48. static void debug_echo_axis(const AxisEnum axis) {
  49. if (current_position[axis] == destination[axis])
  50. SERIAL_ECHOPGM("-------------");
  51. else
  52. SERIAL_ECHO_F(destination[X_AXIS], 6);
  53. }
  54. void debug_current_and_destination(const char *title) {
  55. // if the title message starts with a '!' it is so important, we are going to
  56. // ignore the status of the g26_debug_flag
  57. if (*title != '!' && !ubl.g26_debug_flag) return;
  58. const float de = destination[E_AXIS] - current_position[E_AXIS];
  59. if (de == 0.0) return; // Printing moves only
  60. const float dx = destination[X_AXIS] - current_position[X_AXIS],
  61. dy = destination[Y_AXIS] - current_position[Y_AXIS],
  62. xy_dist = HYPOT(dx, dy);
  63. if (xy_dist == 0.0) return;
  64. SERIAL_ECHOPGM(" fpmm=");
  65. const float fpmm = de / xy_dist;
  66. SERIAL_ECHO_F(fpmm, 6);
  67. SERIAL_ECHOPGM(" current=( ");
  68. SERIAL_ECHO_F(current_position[X_AXIS], 6);
  69. SERIAL_ECHOPGM(", ");
  70. SERIAL_ECHO_F(current_position[Y_AXIS], 6);
  71. SERIAL_ECHOPGM(", ");
  72. SERIAL_ECHO_F(current_position[Z_AXIS], 6);
  73. SERIAL_ECHOPGM(", ");
  74. SERIAL_ECHO_F(current_position[E_AXIS], 6);
  75. SERIAL_ECHOPGM(" ) destination=( ");
  76. debug_echo_axis(X_AXIS);
  77. SERIAL_ECHOPGM(", ");
  78. debug_echo_axis(Y_AXIS);
  79. SERIAL_ECHOPGM(", ");
  80. debug_echo_axis(Z_AXIS);
  81. SERIAL_ECHOPGM(", ");
  82. debug_echo_axis(E_AXIS);
  83. SERIAL_ECHOPGM(" ) ");
  84. SERIAL_ECHO(title);
  85. SERIAL_EOL();
  86. }
  87. void unified_bed_leveling::line_to_destination_cartesian(const float &feed_rate, uint8_t extruder) {
  88. /**
  89. * Much of the nozzle movement will be within the same cell. So we will do as little computation
  90. * as possible to determine if this is the case. If this move is within the same cell, we will
  91. * just do the required Z-Height correction, call the Planner's buffer_line() routine, and leave
  92. */
  93. const float start[XYZE] = {
  94. current_position[X_AXIS],
  95. current_position[Y_AXIS],
  96. current_position[Z_AXIS],
  97. current_position[E_AXIS]
  98. },
  99. end[XYZE] = {
  100. destination[X_AXIS],
  101. destination[Y_AXIS],
  102. destination[Z_AXIS],
  103. destination[E_AXIS]
  104. };
  105. const int cell_start_xi = get_cell_index_x(RAW_X_POSITION(start[X_AXIS])),
  106. cell_start_yi = get_cell_index_y(RAW_Y_POSITION(start[Y_AXIS])),
  107. cell_dest_xi = get_cell_index_x(RAW_X_POSITION(end[X_AXIS])),
  108. cell_dest_yi = get_cell_index_y(RAW_Y_POSITION(end[Y_AXIS]));
  109. if (g26_debug_flag) {
  110. SERIAL_ECHOPAIR(" ubl.line_to_destination(xe=", end[X_AXIS]);
  111. SERIAL_ECHOPAIR(", ye=", end[Y_AXIS]);
  112. SERIAL_ECHOPAIR(", ze=", end[Z_AXIS]);
  113. SERIAL_ECHOPAIR(", ee=", end[E_AXIS]);
  114. SERIAL_CHAR(')');
  115. SERIAL_EOL();
  116. debug_current_and_destination(PSTR("Start of ubl.line_to_destination()"));
  117. }
  118. if (cell_start_xi == cell_dest_xi && cell_start_yi == cell_dest_yi) { // if the whole move is within the same cell,
  119. /**
  120. * we don't need to break up the move
  121. *
  122. * If we are moving off the print bed, we are going to allow the move at this level.
  123. * But we detect it and isolate it. For now, we just pass along the request.
  124. */
  125. if (!WITHIN(cell_dest_xi, 0, GRID_MAX_POINTS_X - 1) || !WITHIN(cell_dest_yi, 0, GRID_MAX_POINTS_Y - 1)) {
  126. // Note: There is no Z Correction in this case. We are off the grid and don't know what
  127. // a reasonable correction would be.
  128. planner._buffer_line(end[X_AXIS], end[Y_AXIS], end[Z_AXIS] + state.z_offset, end[E_AXIS], feed_rate, extruder);
  129. set_current_to_destination();
  130. if (g26_debug_flag)
  131. debug_current_and_destination(PSTR("out of bounds in ubl.line_to_destination()"));
  132. return;
  133. }
  134. FINAL_MOVE:
  135. /**
  136. * Optimize some floating point operations here. We could call float get_z_correction(float x0, float y0) to
  137. * generate the correction for us. But we can lighten the load on the CPU by doing a modified version of the function.
  138. * We are going to only calculate the amount we are from the first mesh line towards the second mesh line once.
  139. * We will use this fraction in both of the original two Z Height calculations for the bi-linear interpolation. And,
  140. * instead of doing a generic divide of the distance, we know the distance is MESH_X_DIST so we can use the preprocessor
  141. * to create a 1-over number for us. That will allow us to do a floating point multiply instead of a floating point divide.
  142. */
  143. const float xratio = (RAW_X_POSITION(end[X_AXIS]) - mesh_index_to_xpos(cell_dest_xi)) * (1.0 / (MESH_X_DIST));
  144. float z1 = z_values[cell_dest_xi ][cell_dest_yi ] + xratio *
  145. (z_values[cell_dest_xi + 1][cell_dest_yi ] - z_values[cell_dest_xi][cell_dest_yi ]),
  146. z2 = z_values[cell_dest_xi ][cell_dest_yi + 1] + xratio *
  147. (z_values[cell_dest_xi + 1][cell_dest_yi + 1] - z_values[cell_dest_xi][cell_dest_yi + 1]);
  148. if (cell_dest_xi >= GRID_MAX_POINTS_X - 1) z1 = z2 = 0.0;
  149. // we are done with the fractional X distance into the cell. Now with the two Z-Heights we have calculated, we
  150. // are going to apply the Y-Distance into the cell to interpolate the final Z correction.
  151. const float yratio = (RAW_Y_POSITION(end[Y_AXIS]) - mesh_index_to_ypos(cell_dest_yi)) * (1.0 / (MESH_Y_DIST));
  152. float z0 = cell_dest_yi < GRID_MAX_POINTS_Y - 1 ? (z1 + (z2 - z1) * yratio) * fade_scaling_factor_for_z(end[Z_AXIS]) : 0.0;
  153. /**
  154. * If part of the Mesh is undefined, it will show up as NAN
  155. * in z_values[][] and propagate through the
  156. * calculations. If our correction is NAN, we throw it out
  157. * because part of the Mesh is undefined and we don't have the
  158. * information we need to complete the height correction.
  159. */
  160. if (isnan(z0)) z0 = 0.0;
  161. planner._buffer_line(end[X_AXIS], end[Y_AXIS], end[Z_AXIS] + z0 + state.z_offset, end[E_AXIS], feed_rate, extruder);
  162. if (g26_debug_flag)
  163. debug_current_and_destination(PSTR("FINAL_MOVE in ubl.line_to_destination()"));
  164. set_current_to_destination();
  165. return;
  166. }
  167. /**
  168. * If we get here, we are processing a move that crosses at least one Mesh Line. We will check
  169. * for the simple case of just crossing X or just crossing Y Mesh Lines after we get all the details
  170. * of the move figured out. We can process the easy case of just crossing an X or Y Mesh Line with less
  171. * computation and in fact most lines are of this nature. We will check for that in the following
  172. * blocks of code:
  173. */
  174. const float dx = end[X_AXIS] - start[X_AXIS],
  175. dy = end[Y_AXIS] - start[Y_AXIS];
  176. const int left_flag = dx < 0.0 ? 1 : 0,
  177. down_flag = dy < 0.0 ? 1 : 0;
  178. const float adx = left_flag ? -dx : dx,
  179. ady = down_flag ? -dy : dy;
  180. const int dxi = cell_start_xi == cell_dest_xi ? 0 : left_flag ? -1 : 1,
  181. dyi = cell_start_yi == cell_dest_yi ? 0 : down_flag ? -1 : 1;
  182. /**
  183. * Compute the scaling factor for the extruder for each partial move.
  184. * We need to watch out for zero length moves because it will cause us to
  185. * have an infinate scaling factor. We are stuck doing a floating point
  186. * divide to get our scaling factor, but after that, we just multiply by this
  187. * number. We also pick our scaling factor based on whether the X or Y
  188. * component is larger. We use the biggest of the two to preserve precision.
  189. */
  190. const bool use_x_dist = adx > ady;
  191. float on_axis_distance = use_x_dist ? dx : dy,
  192. e_position = end[E_AXIS] - start[E_AXIS],
  193. z_position = end[Z_AXIS] - start[Z_AXIS];
  194. const float e_normalized_dist = e_position / on_axis_distance,
  195. z_normalized_dist = z_position / on_axis_distance;
  196. int current_xi = cell_start_xi,
  197. current_yi = cell_start_yi;
  198. const float m = dy / dx,
  199. c = start[Y_AXIS] - m * start[X_AXIS];
  200. const bool inf_normalized_flag = (isinf(e_normalized_dist) != 0),
  201. inf_m_flag = (isinf(m) != 0);
  202. /**
  203. * This block handles vertical lines. These are lines that stay within the same
  204. * X Cell column. They do not need to be perfectly vertical. They just can
  205. * not cross into another X Cell column.
  206. */
  207. if (dxi == 0) { // Check for a vertical line
  208. current_yi += down_flag; // Line is heading down, we just want to go to the bottom
  209. while (current_yi != cell_dest_yi + down_flag) {
  210. current_yi += dyi;
  211. const float next_mesh_line_y = LOGICAL_Y_POSITION(mesh_index_to_ypos(current_yi));
  212. /**
  213. * if the slope of the line is infinite, we won't do the calculations
  214. * else, we know the next X is the same so we can recover and continue!
  215. * Calculate X at the next Y mesh line
  216. */
  217. const float x = inf_m_flag ? start[X_AXIS] : (next_mesh_line_y - c) / m;
  218. float z0 = z_correction_for_x_on_horizontal_mesh_line(x, current_xi, current_yi);
  219. z0 *= fade_scaling_factor_for_z(end[Z_AXIS]);
  220. /**
  221. * If part of the Mesh is undefined, it will show up as NAN
  222. * in z_values[][] and propagate through the
  223. * calculations. If our correction is NAN, we throw it out
  224. * because part of the Mesh is undefined and we don't have the
  225. * information we need to complete the height correction.
  226. */
  227. if (isnan(z0)) z0 = 0.0;
  228. const float y = LOGICAL_Y_POSITION(mesh_index_to_ypos(current_yi));
  229. /**
  230. * Without this check, it is possible for the algorithm to generate a zero length move in the case
  231. * where the line is heading down and it is starting right on a Mesh Line boundary. For how often that
  232. * happens, it might be best to remove the check and always 'schedule' the move because
  233. * the planner._buffer_line() routine will filter it if that happens.
  234. */
  235. if (y != start[Y_AXIS]) {
  236. if (!inf_normalized_flag) {
  237. on_axis_distance = use_x_dist ? x - start[X_AXIS] : y - start[Y_AXIS];
  238. e_position = start[E_AXIS] + on_axis_distance * e_normalized_dist;
  239. z_position = start[Z_AXIS] + on_axis_distance * z_normalized_dist;
  240. }
  241. else {
  242. e_position = end[E_AXIS];
  243. z_position = end[Z_AXIS];
  244. }
  245. planner._buffer_line(x, y, z_position + z0 + state.z_offset, e_position, feed_rate, extruder);
  246. } //else printf("FIRST MOVE PRUNED ");
  247. }
  248. if (g26_debug_flag)
  249. debug_current_and_destination(PSTR("vertical move done in ubl.line_to_destination()"));
  250. //
  251. // Check if we are at the final destination. Usually, we won't be, but if it is on a Y Mesh Line, we are done.
  252. //
  253. if (current_position[X_AXIS] != end[X_AXIS] || current_position[Y_AXIS] != end[Y_AXIS])
  254. goto FINAL_MOVE;
  255. set_current_to_destination();
  256. return;
  257. }
  258. /**
  259. *
  260. * This block handles horizontal lines. These are lines that stay within the same
  261. * Y Cell row. They do not need to be perfectly horizontal. They just can
  262. * not cross into another Y Cell row.
  263. *
  264. */
  265. if (dyi == 0) { // Check for a horizontal line
  266. current_xi += left_flag; // Line is heading left, we just want to go to the left
  267. // edge of this cell for the first move.
  268. while (current_xi != cell_dest_xi + left_flag) {
  269. current_xi += dxi;
  270. const float next_mesh_line_x = LOGICAL_X_POSITION(mesh_index_to_xpos(current_xi)),
  271. y = m * next_mesh_line_x + c; // Calculate Y at the next X mesh line
  272. float z0 = z_correction_for_y_on_vertical_mesh_line(y, current_xi, current_yi);
  273. z0 *= fade_scaling_factor_for_z(end[Z_AXIS]);
  274. /**
  275. * If part of the Mesh is undefined, it will show up as NAN
  276. * in z_values[][] and propagate through the
  277. * calculations. If our correction is NAN, we throw it out
  278. * because part of the Mesh is undefined and we don't have the
  279. * information we need to complete the height correction.
  280. */
  281. if (isnan(z0)) z0 = 0.0;
  282. const float x = LOGICAL_X_POSITION(mesh_index_to_xpos(current_xi));
  283. /**
  284. * Without this check, it is possible for the algorithm to generate a zero length move in the case
  285. * where the line is heading left and it is starting right on a Mesh Line boundary. For how often
  286. * that happens, it might be best to remove the check and always 'schedule' the move because
  287. * the planner._buffer_line() routine will filter it if that happens.
  288. */
  289. if (x != start[X_AXIS]) {
  290. if (!inf_normalized_flag) {
  291. on_axis_distance = use_x_dist ? x - start[X_AXIS] : y - start[Y_AXIS];
  292. e_position = start[E_AXIS] + on_axis_distance * e_normalized_dist; // is based on X or Y because this is a horizontal move
  293. z_position = start[Z_AXIS] + on_axis_distance * z_normalized_dist;
  294. }
  295. else {
  296. e_position = end[E_AXIS];
  297. z_position = end[Z_AXIS];
  298. }
  299. planner._buffer_line(x, y, z_position + z0 + state.z_offset, e_position, feed_rate, extruder);
  300. } //else printf("FIRST MOVE PRUNED ");
  301. }
  302. if (g26_debug_flag)
  303. debug_current_and_destination(PSTR("horizontal move done in ubl.line_to_destination()"));
  304. if (current_position[X_AXIS] != end[X_AXIS] || current_position[Y_AXIS] != end[Y_AXIS])
  305. goto FINAL_MOVE;
  306. set_current_to_destination();
  307. return;
  308. }
  309. /**
  310. *
  311. * This block handles the generic case of a line crossing both X and Y Mesh lines.
  312. *
  313. */
  314. int xi_cnt = cell_start_xi - cell_dest_xi,
  315. yi_cnt = cell_start_yi - cell_dest_yi;
  316. if (xi_cnt < 0) xi_cnt = -xi_cnt;
  317. if (yi_cnt < 0) yi_cnt = -yi_cnt;
  318. current_xi += left_flag;
  319. current_yi += down_flag;
  320. while (xi_cnt > 0 || yi_cnt > 0) {
  321. const float next_mesh_line_x = LOGICAL_X_POSITION(mesh_index_to_xpos(current_xi + dxi)),
  322. next_mesh_line_y = LOGICAL_Y_POSITION(mesh_index_to_ypos(current_yi + dyi)),
  323. y = m * next_mesh_line_x + c, // Calculate Y at the next X mesh line
  324. x = (next_mesh_line_y - c) / m; // Calculate X at the next Y mesh line
  325. // (No need to worry about m being zero.
  326. // If that was the case, it was already detected
  327. // as a vertical line move above.)
  328. if (left_flag == (x > next_mesh_line_x)) { // Check if we hit the Y line first
  329. // Yes! Crossing a Y Mesh Line next
  330. float z0 = z_correction_for_x_on_horizontal_mesh_line(x, current_xi - left_flag, current_yi + dyi);
  331. z0 *= fade_scaling_factor_for_z(end[Z_AXIS]);
  332. /**
  333. * If part of the Mesh is undefined, it will show up as NAN
  334. * in z_values[][] and propagate through the
  335. * calculations. If our correction is NAN, we throw it out
  336. * because part of the Mesh is undefined and we don't have the
  337. * information we need to complete the height correction.
  338. */
  339. if (isnan(z0)) z0 = 0.0;
  340. if (!inf_normalized_flag) {
  341. on_axis_distance = use_x_dist ? x - start[X_AXIS] : next_mesh_line_y - start[Y_AXIS];
  342. e_position = start[E_AXIS] + on_axis_distance * e_normalized_dist;
  343. z_position = start[Z_AXIS] + on_axis_distance * z_normalized_dist;
  344. }
  345. else {
  346. e_position = end[E_AXIS];
  347. z_position = end[Z_AXIS];
  348. }
  349. planner._buffer_line(x, next_mesh_line_y, z_position + z0 + state.z_offset, e_position, feed_rate, extruder);
  350. current_yi += dyi;
  351. yi_cnt--;
  352. }
  353. else {
  354. // Yes! Crossing a X Mesh Line next
  355. float z0 = z_correction_for_y_on_vertical_mesh_line(y, current_xi + dxi, current_yi - down_flag);
  356. z0 *= fade_scaling_factor_for_z(end[Z_AXIS]);
  357. /**
  358. * If part of the Mesh is undefined, it will show up as NAN
  359. * in z_values[][] and propagate through the
  360. * calculations. If our correction is NAN, we throw it out
  361. * because part of the Mesh is undefined and we don't have the
  362. * information we need to complete the height correction.
  363. */
  364. if (isnan(z0)) z0 = 0.0;
  365. if (!inf_normalized_flag) {
  366. on_axis_distance = use_x_dist ? next_mesh_line_x - start[X_AXIS] : y - start[Y_AXIS];
  367. e_position = start[E_AXIS] + on_axis_distance * e_normalized_dist;
  368. z_position = start[Z_AXIS] + on_axis_distance * z_normalized_dist;
  369. }
  370. else {
  371. e_position = end[E_AXIS];
  372. z_position = end[Z_AXIS];
  373. }
  374. planner._buffer_line(next_mesh_line_x, y, z_position + z0 + state.z_offset, e_position, feed_rate, extruder);
  375. current_xi += dxi;
  376. xi_cnt--;
  377. }
  378. if (xi_cnt < 0 || yi_cnt < 0) break; // we've gone too far, so exit the loop and move on to FINAL_MOVE
  379. }
  380. if (g26_debug_flag)
  381. debug_current_and_destination(PSTR("generic move done in ubl.line_to_destination()"));
  382. if (current_position[X_AXIS] != end[X_AXIS] || current_position[Y_AXIS] != end[Y_AXIS])
  383. goto FINAL_MOVE;
  384. set_current_to_destination();
  385. }
  386. #if UBL_DELTA
  387. // macro to inline copy exactly 4 floats, don't rely on sizeof operator
  388. #define COPY_XYZE( target, source ) { \
  389. target[X_AXIS] = source[X_AXIS]; \
  390. target[Y_AXIS] = source[Y_AXIS]; \
  391. target[Z_AXIS] = source[Z_AXIS]; \
  392. target[E_AXIS] = source[E_AXIS]; \
  393. }
  394. #if IS_SCARA // scale the feed rate from mm/s to degrees/s
  395. static float scara_feed_factor, scara_oldA, scara_oldB;
  396. #endif
  397. // We don't want additional apply_leveling() performed by regular buffer_line or buffer_line_kinematic,
  398. // so we call _buffer_line directly here. Per-segmented leveling and kinematics performed first.
  399. inline void _O2 ubl_buffer_segment_raw( float rx, float ry, float rz, float le, float fr ) {
  400. #if ENABLED(DELTA) // apply delta inverse_kinematics
  401. const float delta_A = rz + SQRT( delta_diagonal_rod_2_tower[A_AXIS]
  402. - HYPOT2( delta_tower[A_AXIS][X_AXIS] - rx,
  403. delta_tower[A_AXIS][Y_AXIS] - ry ));
  404. const float delta_B = rz + SQRT( delta_diagonal_rod_2_tower[B_AXIS]
  405. - HYPOT2( delta_tower[B_AXIS][X_AXIS] - rx,
  406. delta_tower[B_AXIS][Y_AXIS] - ry ));
  407. const float delta_C = rz + SQRT( delta_diagonal_rod_2_tower[C_AXIS]
  408. - HYPOT2( delta_tower[C_AXIS][X_AXIS] - rx,
  409. delta_tower[C_AXIS][Y_AXIS] - ry ));
  410. planner._buffer_line(delta_A, delta_B, delta_C, le, fr, active_extruder);
  411. #elif IS_SCARA // apply scara inverse_kinematics (should be changed to save raw->logical->raw)
  412. const float lseg[XYZ] = { LOGICAL_X_POSITION(rx),
  413. LOGICAL_Y_POSITION(ry),
  414. LOGICAL_Z_POSITION(rz)
  415. };
  416. inverse_kinematics(lseg); // this writes delta[ABC] from lseg[XYZ]
  417. // should move the feedrate scaling to scara inverse_kinematics
  418. const float adiff = FABS(delta[A_AXIS] - scara_oldA),
  419. bdiff = FABS(delta[B_AXIS] - scara_oldB);
  420. scara_oldA = delta[A_AXIS];
  421. scara_oldB = delta[B_AXIS];
  422. float s_feedrate = max(adiff, bdiff) * scara_feed_factor;
  423. planner._buffer_line(delta[A_AXIS], delta[B_AXIS], delta[C_AXIS], le, s_feedrate, active_extruder);
  424. #else // CARTESIAN
  425. // Cartesian _buffer_line seems to take LOGICAL, not RAW coordinates
  426. const float lx = LOGICAL_X_POSITION(rx),
  427. ly = LOGICAL_Y_POSITION(ry),
  428. lz = LOGICAL_Z_POSITION(rz);
  429. planner._buffer_line(lx, ly, lz, le, fr, active_extruder);
  430. #endif
  431. }
  432. /**
  433. * Prepare a segmented linear move for DELTA/SCARA/CARTESIAN with UBL and FADE semantics.
  434. * This calls planner._buffer_line multiple times for small incremental moves.
  435. * Returns true if did NOT move, false if moved (requires current_position update).
  436. */
  437. bool _O2 unified_bed_leveling::prepare_segmented_line_to(const float ltarget[XYZE], const float &feedrate) {
  438. if (!position_is_reachable_xy(ltarget[X_AXIS], ltarget[Y_AXIS])) // fail if moving outside reachable boundary
  439. return true; // did not move, so current_position still accurate
  440. const float tot_dx = ltarget[X_AXIS] - current_position[X_AXIS],
  441. tot_dy = ltarget[Y_AXIS] - current_position[Y_AXIS],
  442. tot_dz = ltarget[Z_AXIS] - current_position[Z_AXIS],
  443. tot_de = ltarget[E_AXIS] - current_position[E_AXIS];
  444. const float cartesian_xy_mm = HYPOT(tot_dx, tot_dy); // total horizontal xy distance
  445. #if IS_KINEMATIC
  446. const float seconds = cartesian_xy_mm / feedrate; // seconds to move xy distance at requested rate
  447. uint16_t segments = lroundf(delta_segments_per_second * seconds), // preferred number of segments for distance @ feedrate
  448. seglimit = lroundf(cartesian_xy_mm * (1.0 / (DELTA_SEGMENT_MIN_LENGTH))); // number of segments at minimum segment length
  449. NOMORE(segments, seglimit); // limit to minimum segment length (fewer segments)
  450. #else
  451. uint16_t segments = lroundf(cartesian_xy_mm * (1.0 / (DELTA_SEGMENT_MIN_LENGTH))); // cartesian fixed segment length
  452. #endif
  453. NOLESS(segments, 1); // must have at least one segment
  454. const float inv_segments = 1.0 / segments; // divide once, multiply thereafter
  455. #if IS_SCARA // scale the feed rate from mm/s to degrees/s
  456. scara_feed_factor = cartesian_xy_mm * inv_segments * feedrate;
  457. scara_oldA = stepper.get_axis_position_degrees(A_AXIS);
  458. scara_oldB = stepper.get_axis_position_degrees(B_AXIS);
  459. #endif
  460. const float seg_dx = tot_dx * inv_segments,
  461. seg_dy = tot_dy * inv_segments,
  462. seg_dz = tot_dz * inv_segments,
  463. seg_de = tot_de * inv_segments;
  464. // Note that E segment distance could vary slightly as z mesh height
  465. // changes for each segment, but small enough to ignore.
  466. float seg_rx = RAW_X_POSITION(current_position[X_AXIS]),
  467. seg_ry = RAW_Y_POSITION(current_position[Y_AXIS]),
  468. seg_rz = RAW_Z_POSITION(current_position[Z_AXIS]),
  469. seg_le = current_position[E_AXIS];
  470. const bool above_fade_height = (
  471. #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT)
  472. planner.z_fade_height != 0 && planner.z_fade_height < RAW_Z_POSITION(ltarget[Z_AXIS])
  473. #else
  474. false
  475. #endif
  476. );
  477. // Only compute leveling per segment if ubl active and target below z_fade_height.
  478. if (!state.active || above_fade_height) { // no mesh leveling
  479. const float z_offset = state.active ? state.z_offset : 0.0;
  480. do {
  481. if (--segments) { // not the last segment
  482. seg_rx += seg_dx;
  483. seg_ry += seg_dy;
  484. seg_rz += seg_dz;
  485. seg_le += seg_de;
  486. } else { // last segment, use exact destination
  487. seg_rx = RAW_X_POSITION(ltarget[X_AXIS]);
  488. seg_ry = RAW_Y_POSITION(ltarget[Y_AXIS]);
  489. seg_rz = RAW_Z_POSITION(ltarget[Z_AXIS]);
  490. seg_le = ltarget[E_AXIS];
  491. }
  492. ubl_buffer_segment_raw( seg_rx, seg_ry, seg_rz + z_offset, seg_le, feedrate );
  493. } while (segments);
  494. return false; // moved but did not set_current_to_destination();
  495. }
  496. // Otherwise perform per-segment leveling
  497. #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT)
  498. const float fade_scaling_factor = fade_scaling_factor_for_z(ltarget[Z_AXIS]);
  499. #endif
  500. // increment to first segment destination
  501. seg_rx += seg_dx;
  502. seg_ry += seg_dy;
  503. seg_rz += seg_dz;
  504. seg_le += seg_de;
  505. for(;;) { // for each mesh cell encountered during the move
  506. // Compute mesh cell invariants that remain constant for all segments within cell.
  507. // Note for cell index, if point is outside the mesh grid (in MESH_INSET perimeter)
  508. // the bilinear interpolation from the adjacent cell within the mesh will still work.
  509. // Inner loop will exit each time (because out of cell bounds) but will come back
  510. // in top of loop and again re-find same adjacent cell and use it, just less efficient
  511. // for mesh inset area.
  512. int8_t cell_xi = (seg_rx - (UBL_MESH_MIN_X)) * (1.0 / (MESH_X_DIST)),
  513. cell_yi = (seg_ry - (UBL_MESH_MIN_Y)) * (1.0 / (MESH_X_DIST));
  514. cell_xi = constrain(cell_xi, 0, (GRID_MAX_POINTS_X) - 1);
  515. cell_yi = constrain(cell_yi, 0, (GRID_MAX_POINTS_Y) - 1);
  516. const float x0 = mesh_index_to_xpos(cell_xi), // 64 byte table lookup avoids mul+add
  517. y0 = mesh_index_to_ypos(cell_yi);
  518. float z_x0y0 = z_values[cell_xi ][cell_yi ], // z at lower left corner
  519. z_x1y0 = z_values[cell_xi+1][cell_yi ], // z at upper left corner
  520. z_x0y1 = z_values[cell_xi ][cell_yi+1], // z at lower right corner
  521. z_x1y1 = z_values[cell_xi+1][cell_yi+1]; // z at upper right corner
  522. if (isnan(z_x0y0)) z_x0y0 = 0; // ideally activating state.active (G29 A)
  523. if (isnan(z_x1y0)) z_x1y0 = 0; // should refuse if any invalid mesh points
  524. if (isnan(z_x0y1)) z_x0y1 = 0; // in order to avoid isnan tests per cell,
  525. if (isnan(z_x1y1)) z_x1y1 = 0; // thus guessing zero for undefined points
  526. float cx = seg_rx - x0, // cell-relative x and y
  527. cy = seg_ry - y0;
  528. const float z_xmy0 = (z_x1y0 - z_x0y0) * (1.0 / (MESH_X_DIST)), // z slope per x along y0 (lower left to lower right)
  529. z_xmy1 = (z_x1y1 - z_x0y1) * (1.0 / (MESH_X_DIST)); // z slope per x along y1 (upper left to upper right)
  530. float z_cxy0 = z_x0y0 + z_xmy0 * cx; // z height along y0 at cx (changes for each cx in cell)
  531. const float z_cxy1 = z_x0y1 + z_xmy1 * cx, // z height along y1 at cx
  532. z_cxyd = z_cxy1 - z_cxy0; // z height difference along cx from y0 to y1
  533. float z_cxym = z_cxyd * (1.0 / (MESH_Y_DIST)); // z slope per y along cx from y0 to y1 (changes for each cx in cell)
  534. // float z_cxcy = z_cxy0 + z_cxym * cy; // interpolated mesh z height along cx at cy (do inside the segment loop)
  535. // As subsequent segments step through this cell, the z_cxy0 intercept will change
  536. // and the z_cxym slope will change, both as a function of cx within the cell, and
  537. // each change by a constant for fixed segment lengths.
  538. const float z_sxy0 = z_xmy0 * seg_dx, // per-segment adjustment to z_cxy0
  539. z_sxym = (z_xmy1 - z_xmy0) * (1.0 / (MESH_Y_DIST)) * seg_dx; // per-segment adjustment to z_cxym
  540. for(;;) { // for all segments within this mesh cell
  541. float z_cxcy = z_cxy0 + z_cxym * cy; // interpolated mesh z height along cx at cy
  542. #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT)
  543. z_cxcy *= fade_scaling_factor; // apply fade factor to interpolated mesh height
  544. #endif
  545. z_cxcy += state.z_offset; // add fixed mesh offset from G29 Z
  546. if (--segments == 0) { // if this is last segment, use ltarget for exact
  547. seg_rx = RAW_X_POSITION(ltarget[X_AXIS]);
  548. seg_ry = RAW_Y_POSITION(ltarget[Y_AXIS]);
  549. seg_rz = RAW_Z_POSITION(ltarget[Z_AXIS]);
  550. seg_le = ltarget[E_AXIS];
  551. }
  552. ubl_buffer_segment_raw( seg_rx, seg_ry, seg_rz + z_cxcy, seg_le, feedrate );
  553. if (segments == 0 ) // done with last segment
  554. return false; // did not set_current_to_destination()
  555. seg_rx += seg_dx;
  556. seg_ry += seg_dy;
  557. seg_rz += seg_dz;
  558. seg_le += seg_de;
  559. cx += seg_dx;
  560. cy += seg_dy;
  561. if (!WITHIN(cx, 0, MESH_X_DIST) || !WITHIN(cy, 0, MESH_Y_DIST)) { // done within this cell, break to next
  562. break;
  563. }
  564. // Next segment still within same mesh cell, adjust the per-segment
  565. // slope and intercept to compute next z height.
  566. z_cxy0 += z_sxy0; // adjust z_cxy0 by per-segment z_sxy0
  567. z_cxym += z_sxym; // adjust z_cxym by per-segment z_sxym
  568. } // segment loop
  569. } // cell loop
  570. }
  571. #endif // UBL_DELTA
  572. #endif // AUTO_BED_LEVELING_UBL