My Marlin configs for Fabrikator Mini and CTC i3 Pro B
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

ultralcd_impl_HD44780.h 49KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534
  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. #ifndef ULTRALCD_IMPL_HD44780_H
  23. #define ULTRALCD_IMPL_HD44780_H
  24. /**
  25. * Implementation of the LCD display routines for a Hitachi HD44780 display.
  26. * These are the most common LCD character displays.
  27. */
  28. #include "utility.h"
  29. #include "duration_t.h"
  30. #if ENABLED(AUTO_BED_LEVELING_UBL)
  31. #include "ubl.h"
  32. #if ENABLED(ULTIPANEL)
  33. #define ULTRA_X_PIXELS_PER_CHAR 5
  34. #define ULTRA_Y_PIXELS_PER_CHAR 8
  35. #define ULTRA_COLUMNS_FOR_MESH_MAP 7
  36. #define ULTRA_ROWS_FOR_MESH_MAP 4
  37. #define N_USER_CHARS 8
  38. #define TOP_LEFT _BV(0)
  39. #define TOP_RIGHT _BV(1)
  40. #define LOWER_LEFT _BV(2)
  41. #define LOWER_RIGHT _BV(3)
  42. #endif
  43. #endif
  44. extern volatile uint8_t buttons; //an extended version of the last checked buttons in a bit array.
  45. ////////////////////////////////////
  46. // Setup button and encode mappings for each panel (into 'buttons' variable
  47. //
  48. // This is just to map common functions (across different panels) onto the same
  49. // macro name. The mapping is independent of whether the button is directly connected or
  50. // via a shift/i2c register.
  51. #if ENABLED(ULTIPANEL)
  52. //
  53. // Setup other button mappings of each panel
  54. //
  55. #if ENABLED(LCD_I2C_VIKI)
  56. #define B_I2C_BTN_OFFSET 3 // (the first three bit positions reserved for EN_A, EN_B, EN_C)
  57. // button and encoder bit positions within 'buttons'
  58. #define B_LE (BUTTON_LEFT<<B_I2C_BTN_OFFSET) // The remaining normalized buttons are all read via I2C
  59. #define B_UP (BUTTON_UP<<B_I2C_BTN_OFFSET)
  60. #define B_MI (BUTTON_SELECT<<B_I2C_BTN_OFFSET)
  61. #define B_DW (BUTTON_DOWN<<B_I2C_BTN_OFFSET)
  62. #define B_RI (BUTTON_RIGHT<<B_I2C_BTN_OFFSET)
  63. #if BUTTON_EXISTS(ENC)
  64. // the pause/stop/restart button is connected to BTN_ENC when used
  65. #define B_ST (EN_C) // Map the pause/stop/resume button into its normalized functional name
  66. #undef LCD_CLICKED
  67. #define LCD_CLICKED (buttons&(B_MI|B_RI|B_ST)) // pause/stop button also acts as click until we implement proper pause/stop.
  68. #else
  69. #undef LCD_CLICKED
  70. #define LCD_CLICKED (buttons&(B_MI|B_RI))
  71. #endif
  72. // I2C buttons take too long to read inside an interrupt context and so we read them during lcd_update
  73. #define LCD_HAS_SLOW_BUTTONS
  74. #elif ENABLED(LCD_I2C_PANELOLU2)
  75. #if !BUTTON_EXISTS(ENC) // Use I2C if not directly connected to a pin
  76. #define B_I2C_BTN_OFFSET 3 // (the first three bit positions reserved for EN_A, EN_B, EN_C)
  77. #define B_MI (PANELOLU2_ENCODER_C<<B_I2C_BTN_OFFSET) // requires LiquidTWI2 library v1.2.3 or later
  78. #undef LCD_CLICKED
  79. #define LCD_CLICKED (buttons & B_MI)
  80. // I2C buttons take too long to read inside an interrupt context and so we read them during lcd_update
  81. #define LCD_HAS_SLOW_BUTTONS
  82. #endif
  83. #elif DISABLED(NEWPANEL) // old style ULTIPANEL
  84. // Shift register bits correspond to buttons:
  85. #define BL_LE 7 // Left
  86. #define BL_UP 6 // Up
  87. #define BL_MI 5 // Middle
  88. #define BL_DW 4 // Down
  89. #define BL_RI 3 // Right
  90. #define BL_ST 2 // Red Button
  91. #define B_LE (_BV(BL_LE))
  92. #define B_UP (_BV(BL_UP))
  93. #define B_MI (_BV(BL_MI))
  94. #define B_DW (_BV(BL_DW))
  95. #define B_RI (_BV(BL_RI))
  96. #define B_ST (_BV(BL_ST))
  97. #define LCD_CLICKED ((buttons & B_MI) || (buttons & B_ST))
  98. #endif
  99. #endif // ULTIPANEL
  100. ////////////////////////////////////
  101. // Create LCD class instance and chipset-specific information
  102. #if ENABLED(LCD_I2C_TYPE_PCF8575)
  103. // note: these are register mapped pins on the PCF8575 controller not Arduino pins
  104. #define LCD_I2C_PIN_BL 3
  105. #define LCD_I2C_PIN_EN 2
  106. #define LCD_I2C_PIN_RW 1
  107. #define LCD_I2C_PIN_RS 0
  108. #define LCD_I2C_PIN_D4 4
  109. #define LCD_I2C_PIN_D5 5
  110. #define LCD_I2C_PIN_D6 6
  111. #define LCD_I2C_PIN_D7 7
  112. #include <Wire.h>
  113. #include <LCD.h>
  114. #include <LiquidCrystal_I2C.h>
  115. #define LCD_CLASS LiquidCrystal_I2C
  116. LCD_CLASS lcd(LCD_I2C_ADDRESS, LCD_I2C_PIN_EN, LCD_I2C_PIN_RW, LCD_I2C_PIN_RS, LCD_I2C_PIN_D4, LCD_I2C_PIN_D5, LCD_I2C_PIN_D6, LCD_I2C_PIN_D7);
  117. #elif ENABLED(LCD_I2C_TYPE_MCP23017)
  118. //for the LED indicators (which maybe mapped to different things in lcd_implementation_update_indicators())
  119. #define LED_A 0x04 //100
  120. #define LED_B 0x02 //010
  121. #define LED_C 0x01 //001
  122. #define LCD_HAS_STATUS_INDICATORS
  123. #include <Wire.h>
  124. #include <LiquidTWI2.h>
  125. #define LCD_CLASS LiquidTWI2
  126. #if ENABLED(DETECT_DEVICE)
  127. LCD_CLASS lcd(LCD_I2C_ADDRESS, 1);
  128. #else
  129. LCD_CLASS lcd(LCD_I2C_ADDRESS);
  130. #endif
  131. #elif ENABLED(LCD_I2C_TYPE_MCP23008)
  132. #include <Wire.h>
  133. #include <LiquidTWI2.h>
  134. #define LCD_CLASS LiquidTWI2
  135. #if ENABLED(DETECT_DEVICE)
  136. LCD_CLASS lcd(LCD_I2C_ADDRESS, 1);
  137. #else
  138. LCD_CLASS lcd(LCD_I2C_ADDRESS);
  139. #endif
  140. #elif ENABLED(LCD_I2C_TYPE_PCA8574)
  141. #include <LiquidCrystal_I2C.h>
  142. #define LCD_CLASS LiquidCrystal_I2C
  143. LCD_CLASS lcd(LCD_I2C_ADDRESS, LCD_WIDTH, LCD_HEIGHT);
  144. // 2 wire Non-latching LCD SR from:
  145. // https://bitbucket.org/fmalpartida/new-liquidcrystal/wiki/schematics#!shiftregister-connection
  146. #elif ENABLED(SR_LCD_2W_NL)
  147. extern "C" void __cxa_pure_virtual() { while (1); }
  148. #include <LCD.h>
  149. #include <LiquidCrystal_SR.h>
  150. #define LCD_CLASS LiquidCrystal_SR
  151. #if PIN_EXISTS(SR_STROBE)
  152. LCD_CLASS lcd(SR_DATA_PIN, SR_CLK_PIN, SR_STROBE_PIN);
  153. #else
  154. LCD_CLASS lcd(SR_DATA_PIN, SR_CLK_PIN);
  155. #endif
  156. #elif ENABLED(LCM1602)
  157. #include <Wire.h>
  158. #include <LCD.h>
  159. #include <LiquidCrystal_I2C.h>
  160. #define LCD_CLASS LiquidCrystal_I2C
  161. LCD_CLASS lcd(0x27, 2, 1, 0, 4, 5, 6, 7, 3, POSITIVE);
  162. #else
  163. // Standard directly connected LCD implementations
  164. #include <LiquidCrystal.h>
  165. #define LCD_CLASS LiquidCrystal
  166. LCD_CLASS lcd(LCD_PINS_RS, LCD_PINS_ENABLE, LCD_PINS_D4, LCD_PINS_D5, LCD_PINS_D6, LCD_PINS_D7); //RS,Enable,D4,D5,D6,D7
  167. #endif
  168. #include "utf_mapper.h"
  169. #if ENABLED(LCD_PROGRESS_BAR)
  170. static millis_t progress_bar_ms = 0; // Start millis of the current progress bar cycle
  171. #if PROGRESS_MSG_EXPIRE > 0
  172. static millis_t expire_status_ms = 0; // millis at which to expire the status message
  173. #endif
  174. #define LCD_STR_PROGRESS "\x03\x04\x05"
  175. #endif
  176. #if ENABLED(LCD_HAS_STATUS_INDICATORS)
  177. static void lcd_implementation_update_indicators();
  178. #endif
  179. static void createChar_P(const char c, const byte * const ptr) {
  180. byte temp[8];
  181. for (uint8_t i = 0; i < 8; i++)
  182. temp[i] = pgm_read_byte(&ptr[i]);
  183. lcd.createChar(c, temp);
  184. }
  185. static void lcd_set_custom_characters(
  186. #if ENABLED(LCD_PROGRESS_BAR)
  187. const bool info_screen_charset = true
  188. #endif
  189. ) {
  190. const static PROGMEM byte bedTemp[8] = {
  191. B00000,
  192. B11111,
  193. B10101,
  194. B10001,
  195. B10101,
  196. B11111,
  197. B00000,
  198. B00000
  199. };
  200. const static PROGMEM byte degree[8] = {
  201. B01100,
  202. B10010,
  203. B10010,
  204. B01100,
  205. B00000,
  206. B00000,
  207. B00000,
  208. B00000
  209. };
  210. const static PROGMEM byte thermometer[8] = {
  211. B00100,
  212. B01010,
  213. B01010,
  214. B01010,
  215. B01010,
  216. B10001,
  217. B10001,
  218. B01110
  219. };
  220. const static PROGMEM byte uplevel[8] = {
  221. B00100,
  222. B01110,
  223. B11111,
  224. B00100,
  225. B11100,
  226. B00000,
  227. B00000,
  228. B00000
  229. };
  230. const static PROGMEM byte feedrate[8] = {
  231. B11100,
  232. B10000,
  233. B11000,
  234. B10111,
  235. B00101,
  236. B00110,
  237. B00101,
  238. B00000
  239. };
  240. const static PROGMEM byte clock[8] = {
  241. B00000,
  242. B01110,
  243. B10011,
  244. B10101,
  245. B10001,
  246. B01110,
  247. B00000,
  248. B00000
  249. };
  250. #if ENABLED(SDSUPPORT)
  251. const static PROGMEM byte refresh[8] = {
  252. B00000,
  253. B00110,
  254. B11001,
  255. B11000,
  256. B00011,
  257. B10011,
  258. B01100,
  259. B00000,
  260. };
  261. const static PROGMEM byte folder[8] = {
  262. B00000,
  263. B11100,
  264. B11111,
  265. B10001,
  266. B10001,
  267. B11111,
  268. B00000,
  269. B00000
  270. };
  271. #if ENABLED(LCD_PROGRESS_BAR)
  272. const static PROGMEM byte progress[3][8] = { {
  273. B00000,
  274. B10000,
  275. B10000,
  276. B10000,
  277. B10000,
  278. B10000,
  279. B10000,
  280. B00000
  281. }, {
  282. B00000,
  283. B10100,
  284. B10100,
  285. B10100,
  286. B10100,
  287. B10100,
  288. B10100,
  289. B00000
  290. }, {
  291. B00000,
  292. B10101,
  293. B10101,
  294. B10101,
  295. B10101,
  296. B10101,
  297. B10101,
  298. B00000
  299. } };
  300. #endif
  301. #endif
  302. createChar_P(LCD_BEDTEMP_CHAR, bedTemp);
  303. createChar_P(LCD_DEGREE_CHAR, degree);
  304. createChar_P(LCD_STR_THERMOMETER[0], thermometer);
  305. createChar_P(LCD_FEEDRATE_CHAR, feedrate);
  306. createChar_P(LCD_CLOCK_CHAR, clock);
  307. #if ENABLED(SDSUPPORT)
  308. #if ENABLED(LCD_PROGRESS_BAR)
  309. static bool char_mode = false;
  310. if (info_screen_charset != char_mode) {
  311. char_mode = info_screen_charset;
  312. if (info_screen_charset) { // Progress bar characters for info screen
  313. for (int16_t i = 3; i--;) createChar_P(LCD_STR_PROGRESS[i], progress[i]);
  314. }
  315. else { // Custom characters for submenus
  316. createChar_P(LCD_UPLEVEL_CHAR, uplevel);
  317. createChar_P(LCD_STR_REFRESH[0], refresh);
  318. createChar_P(LCD_STR_FOLDER[0], folder);
  319. }
  320. }
  321. #else
  322. createChar_P(LCD_UPLEVEL_CHAR, uplevel);
  323. createChar_P(LCD_STR_REFRESH[0], refresh);
  324. createChar_P(LCD_STR_FOLDER[0], folder);
  325. #endif
  326. #else
  327. createChar_P(LCD_UPLEVEL_CHAR, uplevel);
  328. #endif
  329. }
  330. static void lcd_implementation_init(
  331. #if ENABLED(LCD_PROGRESS_BAR)
  332. const bool info_screen_charset = true
  333. #endif
  334. ) {
  335. #if ENABLED(LCD_I2C_TYPE_PCF8575)
  336. lcd.begin(LCD_WIDTH, LCD_HEIGHT);
  337. #ifdef LCD_I2C_PIN_BL
  338. lcd.setBacklightPin(LCD_I2C_PIN_BL, POSITIVE);
  339. lcd.setBacklight(HIGH);
  340. #endif
  341. #elif ENABLED(LCD_I2C_TYPE_MCP23017)
  342. lcd.setMCPType(LTI_TYPE_MCP23017);
  343. lcd.begin(LCD_WIDTH, LCD_HEIGHT);
  344. lcd_implementation_update_indicators();
  345. #elif ENABLED(LCD_I2C_TYPE_MCP23008)
  346. lcd.setMCPType(LTI_TYPE_MCP23008);
  347. lcd.begin(LCD_WIDTH, LCD_HEIGHT);
  348. #elif ENABLED(LCD_I2C_TYPE_PCA8574)
  349. lcd.init();
  350. lcd.backlight();
  351. #else
  352. lcd.begin(LCD_WIDTH, LCD_HEIGHT);
  353. #endif
  354. lcd_set_custom_characters(
  355. #if ENABLED(LCD_PROGRESS_BAR)
  356. info_screen_charset
  357. #endif
  358. );
  359. lcd.clear();
  360. }
  361. void lcd_implementation_clear() { lcd.clear(); }
  362. void lcd_print(const char c) { charset_mapper(c); }
  363. void lcd_print(const char *str) { while (*str) lcd.print(*str++); }
  364. void lcd_printPGM(const char *str) { while (const char c = pgm_read_byte(str)) lcd.print(c), ++str; }
  365. void lcd_print_utf(const char *str, uint8_t n=LCD_WIDTH) {
  366. char c;
  367. while (n && (c = *str)) n -= charset_mapper(c), ++str;
  368. }
  369. void lcd_printPGM_utf(const char *str, uint8_t n=LCD_WIDTH) {
  370. char c;
  371. while (n && (c = pgm_read_byte(str))) n -= charset_mapper(c), ++str;
  372. }
  373. #if ENABLED(SHOW_BOOTSCREEN)
  374. void lcd_erase_line(const int16_t line) {
  375. lcd.setCursor(0, line);
  376. for (uint8_t i = LCD_WIDTH + 1; --i;)
  377. lcd.write(' ');
  378. }
  379. // Scroll the PSTR 'text' in a 'len' wide field for 'time' milliseconds at position col,line
  380. void lcd_scroll(const int16_t col, const int16_t line, const char* const text, const int16_t len, const int16_t time) {
  381. char tmp[LCD_WIDTH + 1] = {0};
  382. int16_t n = max(lcd_strlen_P(text) - len, 0);
  383. for (int16_t i = 0; i <= n; i++) {
  384. strncpy_P(tmp, text + i, min(len, LCD_WIDTH));
  385. lcd.setCursor(col, line);
  386. lcd_print(tmp);
  387. delay(time / max(n, 1));
  388. }
  389. }
  390. static void logo_lines(const char* const extra) {
  391. int16_t indent = (LCD_WIDTH - 8 - lcd_strlen_P(extra)) / 2;
  392. lcd.setCursor(indent, 0); lcd.print('\x00'); lcd_printPGM(PSTR( "------" )); lcd.write('\x01');
  393. lcd.setCursor(indent, 1); lcd_printPGM(PSTR("|Marlin|")); lcd_printPGM(extra);
  394. lcd.setCursor(indent, 2); lcd.write('\x02'); lcd_printPGM(PSTR( "------" )); lcd.write('\x03');
  395. }
  396. void lcd_bootscreen() {
  397. const static PROGMEM byte corner[4][8] = { {
  398. B00000,
  399. B00000,
  400. B00000,
  401. B00000,
  402. B00001,
  403. B00010,
  404. B00100,
  405. B00100
  406. }, {
  407. B00000,
  408. B00000,
  409. B00000,
  410. B11100,
  411. B11100,
  412. B01100,
  413. B00100,
  414. B00100
  415. }, {
  416. B00100,
  417. B00010,
  418. B00001,
  419. B00000,
  420. B00000,
  421. B00000,
  422. B00000,
  423. B00000
  424. }, {
  425. B00100,
  426. B01000,
  427. B10000,
  428. B00000,
  429. B00000,
  430. B00000,
  431. B00000,
  432. B00000
  433. } };
  434. for (uint8_t i = 0; i < 4; i++)
  435. createChar_P(i, corner[i]);
  436. lcd.clear();
  437. #define LCD_EXTRA_SPACE (LCD_WIDTH-8)
  438. #define CENTER_OR_SCROLL(STRING,DELAY) \
  439. lcd_erase_line(3); \
  440. if (strlen(STRING) <= LCD_WIDTH) { \
  441. lcd.setCursor((LCD_WIDTH - lcd_strlen_P(PSTR(STRING))) / 2, 3); \
  442. lcd_printPGM(PSTR(STRING)); \
  443. safe_delay(DELAY); \
  444. } \
  445. else { \
  446. lcd_scroll(0, 3, PSTR(STRING), LCD_WIDTH, DELAY); \
  447. }
  448. #ifdef STRING_SPLASH_LINE1
  449. //
  450. // Show the Marlin logo with splash line 1
  451. //
  452. if (LCD_EXTRA_SPACE >= strlen(STRING_SPLASH_LINE1) + 1) {
  453. //
  454. // Show the Marlin logo, splash line1, and splash line 2
  455. //
  456. logo_lines(PSTR(" " STRING_SPLASH_LINE1));
  457. #ifdef STRING_SPLASH_LINE2
  458. CENTER_OR_SCROLL(STRING_SPLASH_LINE2, 2000);
  459. #else
  460. safe_delay(2000);
  461. #endif
  462. }
  463. else {
  464. //
  465. // Show the Marlin logo with splash line 1
  466. // After a delay show splash line 2, if it exists
  467. //
  468. #ifdef STRING_SPLASH_LINE2
  469. #define _SPLASH_WAIT_1 1500
  470. #else
  471. #define _SPLASH_WAIT_1 2000
  472. #endif
  473. logo_lines(PSTR(""));
  474. CENTER_OR_SCROLL(STRING_SPLASH_LINE1, _SPLASH_WAIT_1);
  475. #ifdef STRING_SPLASH_LINE2
  476. CENTER_OR_SCROLL(STRING_SPLASH_LINE2, 1500);
  477. #endif
  478. }
  479. #elif defined(STRING_SPLASH_LINE2)
  480. //
  481. // Show splash line 2 only, alongside the logo if possible
  482. //
  483. if (LCD_EXTRA_SPACE >= strlen(STRING_SPLASH_LINE2) + 1) {
  484. logo_lines(PSTR(" " STRING_SPLASH_LINE2));
  485. safe_delay(2000);
  486. }
  487. else {
  488. logo_lines(PSTR(""));
  489. CENTER_OR_SCROLL(STRING_SPLASH_LINE2, 2000);
  490. }
  491. #else
  492. //
  493. // Show only the Marlin logo
  494. //
  495. logo_lines(PSTR(""));
  496. safe_delay(2000);
  497. #endif
  498. lcd.clear();
  499. safe_delay(100);
  500. lcd_set_custom_characters(
  501. #if ENABLED(LCD_PROGRESS_BAR)
  502. false
  503. #endif
  504. );
  505. }
  506. #endif // SHOW_BOOTSCREEN
  507. void lcd_kill_screen() {
  508. lcd.setCursor(0, 0);
  509. lcd_print_utf(lcd_status_message);
  510. #if LCD_HEIGHT < 4
  511. lcd.setCursor(0, 2);
  512. #else
  513. lcd.setCursor(0, 2);
  514. lcd_printPGM(PSTR(MSG_HALTED));
  515. lcd.setCursor(0, 3);
  516. #endif
  517. lcd_printPGM(PSTR(MSG_PLEASE_RESET));
  518. }
  519. FORCE_INLINE void _draw_axis_label(const AxisEnum axis, const char* const pstr, const bool blink) {
  520. if (blink)
  521. lcd_printPGM(pstr);
  522. else {
  523. if (!axis_homed[axis])
  524. lcd.write('?');
  525. else {
  526. #if DISABLED(HOME_AFTER_DEACTIVATE) && DISABLED(DISABLE_REDUCED_ACCURACY_WARNING)
  527. if (!axis_known_position[axis])
  528. lcd.write(' ');
  529. else
  530. #endif
  531. lcd_printPGM(pstr);
  532. }
  533. }
  534. }
  535. FORCE_INLINE void _draw_heater_status(const int8_t heater, const char prefix, const bool blink) {
  536. const bool isBed = heater < 0;
  537. const float t1 = (isBed ? thermalManager.degBed() : thermalManager.degHotend(heater)),
  538. t2 = (isBed ? thermalManager.degTargetBed() : thermalManager.degTargetHotend(heater));
  539. if (prefix >= 0) lcd.print(prefix);
  540. lcd.print(itostr3(t1 + 0.5));
  541. lcd.write('/');
  542. #if HEATER_IDLE_HANDLER
  543. const bool is_idle = (!isBed ? thermalManager.is_heater_idle(heater) :
  544. #if HAS_TEMP_BED
  545. thermalManager.is_bed_idle()
  546. #else
  547. false
  548. #endif
  549. );
  550. if (!blink && is_idle) {
  551. lcd.write(' ');
  552. if (t2 >= 10) lcd.write(' ');
  553. if (t2 >= 100) lcd.write(' ');
  554. }
  555. else
  556. #endif
  557. lcd.print(itostr3left(t2 + 0.5));
  558. if (prefix >= 0) {
  559. lcd.print((char)LCD_DEGREE_CHAR);
  560. lcd.write(' ');
  561. if (t2 < 10) lcd.write(' ');
  562. }
  563. }
  564. #if ENABLED(LCD_PROGRESS_BAR)
  565. inline void lcd_draw_progress_bar(const uint8_t percent) {
  566. const int16_t tix = (int16_t)(percent * (LCD_WIDTH) * 3) / 100,
  567. cel = tix / 3,
  568. rem = tix % 3;
  569. uint8_t i = LCD_WIDTH;
  570. char msg[LCD_WIDTH + 1], b = ' ';
  571. msg[LCD_WIDTH] = '\0';
  572. while (i--) {
  573. if (i == cel - 1)
  574. b = LCD_STR_PROGRESS[2];
  575. else if (i == cel && rem != 0)
  576. b = LCD_STR_PROGRESS[rem - 1];
  577. msg[i] = b;
  578. }
  579. lcd.print(msg);
  580. }
  581. #endif // LCD_PROGRESS_BAR
  582. /**
  583. Possible status screens:
  584. 16x2 |000/000 B000/000|
  585. |0123456789012345|
  586. 16x4 |000/000 B000/000|
  587. |SD100% Z 000.00|
  588. |F100% T--:--|
  589. |0123456789012345|
  590. 20x2 |T000/000D B000/000D |
  591. |01234567890123456789|
  592. 20x4 |T000/000D B000/000D |
  593. |X 000 Y 000 Z 000.00|
  594. |F100% SD100% T--:--|
  595. |01234567890123456789|
  596. 20x4 |T000/000D B000/000D |
  597. |T000/000D Z 000.00|
  598. |F100% SD100% T--:--|
  599. |01234567890123456789|
  600. */
  601. static void lcd_implementation_status_screen() {
  602. const bool blink = lcd_blink();
  603. //
  604. // Line 1
  605. //
  606. lcd.setCursor(0, 0);
  607. #if LCD_WIDTH < 20
  608. //
  609. // Hotend 0 Temperature
  610. //
  611. _draw_heater_status(0, -1, blink);
  612. //
  613. // Hotend 1 or Bed Temperature
  614. //
  615. #if HOTENDS > 1 || TEMP_SENSOR_BED != 0
  616. lcd.setCursor(8, 0);
  617. #if HOTENDS > 1
  618. lcd.print((char)LCD_STR_THERMOMETER[0]);
  619. _draw_heater_status(1, -1, blink);
  620. #else
  621. lcd.print((char)LCD_BEDTEMP_CHAR);
  622. _draw_heater_status(-1, -1, blink);
  623. #endif
  624. #endif // HOTENDS > 1 || TEMP_SENSOR_BED != 0
  625. #else // LCD_WIDTH >= 20
  626. //
  627. // Hotend 0 Temperature
  628. //
  629. _draw_heater_status(0, LCD_STR_THERMOMETER[0], blink);
  630. //
  631. // Hotend 1 or Bed Temperature
  632. //
  633. #if HOTENDS > 1 || TEMP_SENSOR_BED != 0
  634. lcd.setCursor(10, 0);
  635. #if HOTENDS > 1
  636. _draw_heater_status(1, LCD_STR_THERMOMETER[0], blink);
  637. #else
  638. _draw_heater_status(-1, LCD_BEDTEMP_CHAR, blink);
  639. #endif
  640. #endif // HOTENDS > 1 || TEMP_SENSOR_BED != 0
  641. #endif // LCD_WIDTH >= 20
  642. //
  643. // Line 2
  644. //
  645. #if LCD_HEIGHT > 2
  646. #if LCD_WIDTH < 20
  647. #if ENABLED(SDSUPPORT)
  648. lcd.setCursor(0, 2);
  649. lcd_printPGM(PSTR("SD"));
  650. if (IS_SD_PRINTING)
  651. lcd.print(itostr3(card.percentDone()));
  652. else
  653. lcd_printPGM(PSTR("---"));
  654. lcd.write('%');
  655. #endif // SDSUPPORT
  656. #else // LCD_WIDTH >= 20
  657. lcd.setCursor(0, 1);
  658. #if HOTENDS > 1 && TEMP_SENSOR_BED != 0
  659. // If we both have a 2nd extruder and a heated bed,
  660. // show the heated bed temp on the left,
  661. // since the first line is filled with extruder temps
  662. _draw_heater_status(-1, LCD_BEDTEMP_CHAR, blink);
  663. #else
  664. // Before homing the axis letters are blinking 'X' <-> '?'.
  665. // When axis is homed but axis_known_position is false the axis letters are blinking 'X' <-> ' '.
  666. // When everything is ok you see a constant 'X'.
  667. _draw_axis_label(X_AXIS, PSTR(MSG_X), blink);
  668. lcd.print(ftostr4sign(current_position[X_AXIS]));
  669. lcd.write(' ');
  670. _draw_axis_label(Y_AXIS, PSTR(MSG_Y), blink);
  671. lcd.print(ftostr4sign(current_position[Y_AXIS]));
  672. #endif // HOTENDS > 1 || TEMP_SENSOR_BED != 0
  673. #endif // LCD_WIDTH >= 20
  674. lcd.setCursor(LCD_WIDTH - 8, 1);
  675. _draw_axis_label(Z_AXIS, PSTR(MSG_Z), blink);
  676. lcd.print(ftostr52sp(FIXFLOAT(current_position[Z_AXIS])));
  677. #if HAS_LEVELING
  678. lcd.write(planner.leveling_active || blink ? '_' : ' ');
  679. #endif
  680. #endif // LCD_HEIGHT > 2
  681. //
  682. // Line 3
  683. //
  684. #if LCD_HEIGHT > 3
  685. lcd.setCursor(0, 2);
  686. lcd.print((char)LCD_FEEDRATE_CHAR);
  687. lcd.print(itostr3(feedrate_percentage));
  688. lcd.write('%');
  689. #if LCD_WIDTH >= 20 && ENABLED(SDSUPPORT)
  690. lcd.setCursor(7, 2);
  691. lcd_printPGM(PSTR("SD"));
  692. if (IS_SD_PRINTING)
  693. lcd.print(itostr3(card.percentDone()));
  694. else
  695. lcd_printPGM(PSTR("---"));
  696. lcd.write('%');
  697. #endif // LCD_WIDTH >= 20 && SDSUPPORT
  698. char buffer[10];
  699. duration_t elapsed = print_job_timer.duration();
  700. uint8_t len = elapsed.toDigital(buffer);
  701. lcd.setCursor(LCD_WIDTH - len - 1, 2);
  702. lcd.print((char)LCD_CLOCK_CHAR);
  703. lcd_print(buffer);
  704. #endif // LCD_HEIGHT > 3
  705. //
  706. // Last Line
  707. // Status Message (which may be a Progress Bar or Filament display)
  708. //
  709. lcd.setCursor(0, LCD_HEIGHT - 1);
  710. #if ENABLED(LCD_PROGRESS_BAR)
  711. // Draw the progress bar if the message has shown long enough
  712. // or if there is no message set.
  713. #if DISABLED(LCD_SET_PROGRESS_MANUALLY)
  714. const uint8_t progress_bar_percent = card.percentDone();
  715. #endif
  716. if (progress_bar_percent > 2 && (ELAPSED(millis(), progress_bar_ms + PROGRESS_BAR_MSG_TIME) || !lcd_status_message[0]))
  717. return lcd_draw_progress_bar(progress_bar_percent);
  718. #elif ENABLED(FILAMENT_LCD_DISPLAY) && ENABLED(SDSUPPORT)
  719. // Show Filament Diameter and Volumetric Multiplier %
  720. // After allowing lcd_status_message to show for 5 seconds
  721. if (ELAPSED(millis(), previous_lcd_status_ms + 5000UL)) {
  722. lcd_printPGM(PSTR("Dia "));
  723. lcd.print(ftostr12ns(filament_width_meas));
  724. lcd_printPGM(PSTR(" V"));
  725. lcd.print(itostr3(100.0 * volumetric_multiplier[FILAMENT_SENSOR_EXTRUDER_NUM]));
  726. lcd.write('%');
  727. return;
  728. }
  729. #endif // FILAMENT_LCD_DISPLAY && SDSUPPORT
  730. #if ENABLED(STATUS_MESSAGE_SCROLLING)
  731. static bool last_blink = false;
  732. const uint8_t slen = lcd_strlen(lcd_status_message);
  733. const char *stat = lcd_status_message + status_scroll_pos;
  734. if (slen <= LCD_WIDTH)
  735. lcd_print_utf(stat); // The string isn't scrolling
  736. else {
  737. if (status_scroll_pos <= slen - LCD_WIDTH)
  738. lcd_print_utf(stat); // The string fills the screen
  739. else {
  740. uint8_t chars = LCD_WIDTH;
  741. if (status_scroll_pos < slen) { // First string still visible
  742. lcd_print_utf(stat); // The string leaves space
  743. chars -= slen - status_scroll_pos; // Amount of space left
  744. }
  745. lcd.write('.'); // Always at 1+ spaces left, draw a dot
  746. if (--chars) {
  747. if (status_scroll_pos < slen + 1) // Draw a second dot if there's space
  748. --chars, lcd.write('.');
  749. if (chars) lcd_print_utf(lcd_status_message, chars); // Print a second copy of the message
  750. }
  751. }
  752. if (last_blink != blink) {
  753. last_blink = blink;
  754. // Skip any non-printing bytes
  755. if (status_scroll_pos < slen) while (!PRINTABLE(lcd_status_message[status_scroll_pos])) status_scroll_pos++;
  756. if (++status_scroll_pos >= slen + 2) status_scroll_pos = 0;
  757. }
  758. }
  759. #else
  760. lcd_print_utf(lcd_status_message);
  761. #endif
  762. }
  763. #if ENABLED(ULTIPANEL)
  764. #if ENABLED(ADVANCED_PAUSE_FEATURE)
  765. static void lcd_implementation_hotend_status(const uint8_t row) {
  766. if (row < LCD_HEIGHT) {
  767. lcd.setCursor(LCD_WIDTH - 9, row);
  768. _draw_heater_status(active_extruder, LCD_STR_THERMOMETER[0], lcd_blink());
  769. }
  770. }
  771. #endif // ADVANCED_PAUSE_FEATURE
  772. static void lcd_implementation_drawmenu_static(const uint8_t row, const char* pstr, const bool center=true, const bool invert=false, const char *valstr=NULL) {
  773. UNUSED(invert);
  774. char c;
  775. int8_t n = LCD_WIDTH;
  776. lcd.setCursor(0, row);
  777. if (center && !valstr) {
  778. int8_t pad = (LCD_WIDTH - lcd_strlen_P(pstr)) / 2;
  779. while (--pad >= 0) { lcd.write(' '); n--; }
  780. }
  781. while (n > 0 && (c = pgm_read_byte(pstr))) {
  782. n -= charset_mapper(c);
  783. pstr++;
  784. }
  785. if (valstr) while (n > 0 && (c = *valstr)) {
  786. n -= charset_mapper(c);
  787. valstr++;
  788. }
  789. while (n-- > 0) lcd.write(' ');
  790. }
  791. static void lcd_implementation_drawmenu_generic(const bool sel, const uint8_t row, const char* pstr, const char pre_char, const char post_char) {
  792. char c;
  793. uint8_t n = LCD_WIDTH - 2;
  794. lcd.setCursor(0, row);
  795. lcd.print(sel ? pre_char : ' ');
  796. while ((c = pgm_read_byte(pstr)) && n > 0) {
  797. n -= charset_mapper(c);
  798. pstr++;
  799. }
  800. while (n--) lcd.write(' ');
  801. lcd.print(post_char);
  802. }
  803. static void lcd_implementation_drawmenu_setting_edit_generic(const bool sel, const uint8_t row, const char* pstr, const char pre_char, const char* const data) {
  804. char c;
  805. uint8_t n = LCD_WIDTH - 2 - lcd_strlen(data);
  806. lcd.setCursor(0, row);
  807. lcd.print(sel ? pre_char : ' ');
  808. while ((c = pgm_read_byte(pstr)) && n > 0) {
  809. n -= charset_mapper(c);
  810. pstr++;
  811. }
  812. lcd.write(':');
  813. while (n--) lcd.write(' ');
  814. lcd_print(data);
  815. }
  816. static void lcd_implementation_drawmenu_setting_edit_generic_P(const bool sel, const uint8_t row, const char* pstr, const char pre_char, const char* const data) {
  817. char c;
  818. uint8_t n = LCD_WIDTH - 2 - lcd_strlen_P(data);
  819. lcd.setCursor(0, row);
  820. lcd.print(sel ? pre_char : ' ');
  821. while ((c = pgm_read_byte(pstr)) && n > 0) {
  822. n -= charset_mapper(c);
  823. pstr++;
  824. }
  825. lcd.write(':');
  826. while (n--) lcd.write(' ');
  827. lcd_printPGM(data);
  828. }
  829. #define DRAWMENU_SETTING_EDIT_GENERIC(_src) lcd_implementation_drawmenu_setting_edit_generic(sel, row, pstr, '>', _src)
  830. #define DRAW_BOOL_SETTING(sel, row, pstr, data) lcd_implementation_drawmenu_setting_edit_generic_P(sel, row, pstr, '>', (*(data))?PSTR(MSG_ON):PSTR(MSG_OFF))
  831. void lcd_implementation_drawedit(const char* pstr, const char* const value=NULL) {
  832. lcd.setCursor(1, 1);
  833. lcd_printPGM(pstr);
  834. if (value != NULL) {
  835. lcd.write(':');
  836. const uint8_t valrow = (lcd_strlen_P(pstr) + 1 + lcd_strlen(value) + 1) > (LCD_WIDTH - 2) ? 2 : 1; // Value on the next row if it won't fit
  837. lcd.setCursor((LCD_WIDTH - 1) - (lcd_strlen(value) + 1), valrow); // Right-justified, padded by spaces
  838. lcd.write(' '); // overwrite char if value gets shorter
  839. lcd_print(value);
  840. }
  841. }
  842. #if ENABLED(SDSUPPORT)
  843. static void lcd_implementation_drawmenu_sd(const bool sel, const uint8_t row, const char* const pstr, const char* filename, char* const longFilename, const uint8_t concat, const char post_char) {
  844. UNUSED(pstr);
  845. lcd.setCursor(0, row);
  846. lcd.print(sel ? '>' : ' ');
  847. uint8_t n = LCD_WIDTH - concat;
  848. const char *outstr = longFilename[0] ? longFilename : filename;
  849. if (longFilename[0]) {
  850. #if ENABLED(SCROLL_LONG_FILENAMES)
  851. if (sel) {
  852. uint8_t name_hash = row;
  853. for (uint8_t l = FILENAME_LENGTH; l--;)
  854. name_hash = ((name_hash << 1) | (name_hash >> 7)) ^ filename[l]; // rotate, xor
  855. if (filename_scroll_hash != name_hash) { // If the hash changed...
  856. filename_scroll_hash = name_hash; // Save the new hash
  857. filename_scroll_max = max(0, lcd_strlen(longFilename) - n); // Update the scroll limit
  858. filename_scroll_pos = 0; // Reset scroll to the start
  859. lcd_status_update_delay = 8; // Don't scroll right away
  860. }
  861. outstr += filename_scroll_pos;
  862. }
  863. #else
  864. longFilename[n] = '\0'; // cutoff at screen edge
  865. #endif
  866. }
  867. char c;
  868. while (n && (c = *outstr)) {
  869. n -= charset_mapper(c);
  870. ++outstr;
  871. }
  872. while (n) { --n; lcd.write(' '); }
  873. lcd.print(post_char);
  874. }
  875. static void lcd_implementation_drawmenu_sdfile(const bool sel, const uint8_t row, const char* pstr, const char* filename, char* const longFilename) {
  876. lcd_implementation_drawmenu_sd(sel, row, pstr, filename, longFilename, 2, ' ');
  877. }
  878. static void lcd_implementation_drawmenu_sddirectory(const bool sel, const uint8_t row, const char* pstr, const char* filename, char* const longFilename) {
  879. lcd_implementation_drawmenu_sd(sel, row, pstr, filename, longFilename, 2, LCD_STR_FOLDER[0]);
  880. }
  881. #endif // SDSUPPORT
  882. #define lcd_implementation_drawmenu_back(sel, row, pstr, dummy) lcd_implementation_drawmenu_generic(sel, row, pstr, LCD_UPLEVEL_CHAR, LCD_UPLEVEL_CHAR)
  883. #define lcd_implementation_drawmenu_submenu(sel, row, pstr, data) lcd_implementation_drawmenu_generic(sel, row, pstr, '>', LCD_STR_ARROW_RIGHT[0])
  884. #define lcd_implementation_drawmenu_gcode(sel, row, pstr, gcode) lcd_implementation_drawmenu_generic(sel, row, pstr, '>', ' ')
  885. #define lcd_implementation_drawmenu_function(sel, row, pstr, data) lcd_implementation_drawmenu_generic(sel, row, pstr, '>', ' ')
  886. #if ENABLED(LCD_HAS_SLOW_BUTTONS)
  887. extern millis_t next_button_update_ms;
  888. static uint8_t lcd_implementation_read_slow_buttons() {
  889. #if ENABLED(LCD_I2C_TYPE_MCP23017)
  890. // Reading these buttons this is likely to be too slow to call inside interrupt context
  891. // so they are called during normal lcd_update
  892. uint8_t slow_bits = lcd.readButtons() << B_I2C_BTN_OFFSET;
  893. #if ENABLED(LCD_I2C_VIKI)
  894. if ((slow_bits & (B_MI | B_RI)) && PENDING(millis(), next_button_update_ms)) // LCD clicked
  895. slow_bits &= ~(B_MI | B_RI); // Disable LCD clicked buttons if screen is updated
  896. #endif // LCD_I2C_VIKI
  897. return slow_bits;
  898. #endif // LCD_I2C_TYPE_MCP23017
  899. }
  900. #endif // LCD_HAS_SLOW_BUTTONS
  901. #if ENABLED(LCD_HAS_STATUS_INDICATORS)
  902. static void lcd_implementation_update_indicators() {
  903. // Set the LEDS - referred to as backlights by the LiquidTWI2 library
  904. static uint8_t ledsprev = 0;
  905. uint8_t leds = 0;
  906. if (thermalManager.degTargetBed() > 0) leds |= LED_A;
  907. if (thermalManager.degTargetHotend(0) > 0) leds |= LED_B;
  908. #if FAN_COUNT > 0
  909. if (0
  910. #if HAS_FAN0
  911. || fanSpeeds[0]
  912. #endif
  913. #if HAS_FAN1
  914. || fanSpeeds[1]
  915. #endif
  916. #if HAS_FAN2
  917. || fanSpeeds[2]
  918. #endif
  919. ) leds |= LED_C;
  920. #endif // FAN_COUNT > 0
  921. #if HOTENDS > 1
  922. if (thermalManager.degTargetHotend(1) > 0) leds |= LED_C;
  923. #endif
  924. if (leds != ledsprev) {
  925. lcd.setBacklight(leds);
  926. ledsprev = leds;
  927. }
  928. }
  929. #endif // LCD_HAS_STATUS_INDICATORS
  930. #if ENABLED(AUTO_BED_LEVELING_UBL)
  931. /**
  932. Possible map screens:
  933. 16x2 |X000.00 Y000.00|
  934. |(00,00) Z00.000|
  935. 20x2 | X:000.00 Y:000.00 |
  936. | (00,00) Z:00.000 |
  937. 16x4 |+-------+(00,00)|
  938. || |X000.00|
  939. || |Y000.00|
  940. |+-------+Z00.000|
  941. 20x4 | +-------+ (00,00) |
  942. | | | X:000.00|
  943. | | | Y:000.00|
  944. | +-------+ Z:00.000|
  945. */
  946. typedef struct {
  947. uint8_t custom_char_bits[ULTRA_Y_PIXELS_PER_CHAR];
  948. } custom_char;
  949. typedef struct {
  950. uint8_t column, row;
  951. uint8_t y_pixel_offset, x_pixel_offset;
  952. uint8_t x_pixel_mask;
  953. } coordinate;
  954. void add_edges_to_custom_char(custom_char * const custom, coordinate * const ul, coordinate * const lr, coordinate * const brc, const uint8_t cell_location);
  955. FORCE_INLINE static void clear_custom_char(custom_char * const cc) { ZERO(cc->custom_char_bits); }
  956. /*
  957. // This debug routine should be deleted by anybody that sees it. It doesn't belong here
  958. // But I'm leaving it for now until we know the 20x4 Radar Map is working right.
  959. // We may need it again if any funny lines show up on the mesh points.
  960. void dump_custom_char(char *title, custom_char *c) {
  961. SERIAL_PROTOCOLLN(title);
  962. for (uint8_t j = 0; j < 8; j++) {
  963. for (uint8_t i = 7; i >= 0; i--)
  964. SERIAL_PROTOCOLCHAR(TEST(c->custom_char_bits[j], i) ? '1' : '0');
  965. SERIAL_EOL();
  966. }
  967. SERIAL_EOL();
  968. }
  969. //*/
  970. coordinate pixel_location(int16_t x, int16_t y) {
  971. coordinate ret_val;
  972. int16_t xp, yp, r, c;
  973. x++; y++; // +1 because lines on the left and top
  974. c = x / (ULTRA_X_PIXELS_PER_CHAR);
  975. r = y / (ULTRA_Y_PIXELS_PER_CHAR);
  976. ret_val.column = c;
  977. ret_val.row = r;
  978. xp = x - c * (ULTRA_X_PIXELS_PER_CHAR); // get the pixel offsets into the character cell
  979. xp = ULTRA_X_PIXELS_PER_CHAR - 1 - xp; // column within relevant character cell (0 on the right)
  980. yp = y - r * (ULTRA_Y_PIXELS_PER_CHAR);
  981. ret_val.x_pixel_mask = _BV(xp);
  982. ret_val.x_pixel_offset = xp;
  983. ret_val.y_pixel_offset = yp;
  984. return ret_val;
  985. }
  986. inline coordinate pixel_location(const uint8_t x, const uint8_t y) { return pixel_location((int16_t)x, (int16_t)y); }
  987. void lcd_implementation_ubl_plot(const uint8_t x, const uint8_t inverted_y) {
  988. #if LCD_WIDTH >= 20
  989. #define _LCD_W_POS 12
  990. #define _PLOT_X 1
  991. #define _MAP_X 3
  992. #define _LABEL(C,X,Y) lcd.setCursor(X, Y); lcd.print(C)
  993. #define _XLABEL(X,Y) _LABEL("X:",X,Y)
  994. #define _YLABEL(X,Y) _LABEL("Y:",X,Y)
  995. #define _ZLABEL(X,Y) _LABEL("Z:",X,Y)
  996. #else
  997. #define _LCD_W_POS 8
  998. #define _PLOT_X 0
  999. #define _MAP_X 1
  1000. #define _LABEL(X,Y,C) lcd.setCursor(X, Y); lcd.write(C)
  1001. #define _XLABEL(X,Y) _LABEL('X',X,Y)
  1002. #define _YLABEL(X,Y) _LABEL('Y',X,Y)
  1003. #define _ZLABEL(X,Y) _LABEL('Z',X,Y)
  1004. #endif
  1005. #if LCD_HEIGHT <= 3 // 16x2 or 20x2 display
  1006. /**
  1007. * Show X and Y positions
  1008. */
  1009. _XLABEL(_PLOT_X, 0);
  1010. lcd.print(ftostr32(LOGICAL_X_POSITION(pgm_read_float(&ubl._mesh_index_to_xpos[x]))));
  1011. _YLABEL(_LCD_W_POS, 0);
  1012. lcd.print(ftostr32(LOGICAL_Y_POSITION(pgm_read_float(&ubl._mesh_index_to_ypos[inverted_y]))));
  1013. lcd.setCursor(_PLOT_X, 0);
  1014. #else // 16x4 or 20x4 display
  1015. coordinate upper_left, lower_right, bottom_right_corner;
  1016. custom_char new_char;
  1017. uint8_t i, j, k, l, m, n, n_rows, n_cols, y,
  1018. bottom_line, right_edge,
  1019. x_map_pixels, y_map_pixels,
  1020. pixels_per_x_mesh_pnt, pixels_per_y_mesh_pnt,
  1021. suppress_x_offset = 0, suppress_y_offset = 0;
  1022. y = GRID_MAX_POINTS_Y - inverted_y - 1;
  1023. upper_left.column = 0;
  1024. upper_left.row = 0;
  1025. lower_right.column = 0;
  1026. lower_right.row = 0;
  1027. lcd_implementation_clear();
  1028. x_map_pixels = (ULTRA_X_PIXELS_PER_CHAR) * (ULTRA_COLUMNS_FOR_MESH_MAP) - 2; // minus 2 because we are drawing a box around the map
  1029. y_map_pixels = (ULTRA_Y_PIXELS_PER_CHAR) * (ULTRA_ROWS_FOR_MESH_MAP) - 2;
  1030. pixels_per_x_mesh_pnt = x_map_pixels / (GRID_MAX_POINTS_X);
  1031. pixels_per_y_mesh_pnt = y_map_pixels / (GRID_MAX_POINTS_Y);
  1032. if (pixels_per_x_mesh_pnt >= ULTRA_X_PIXELS_PER_CHAR) { // There are only 2 custom characters available, so the X
  1033. pixels_per_x_mesh_pnt = ULTRA_X_PIXELS_PER_CHAR; // size of the mesh point needs to fit within them independent
  1034. suppress_x_offset = 1; // of where the starting pixel is located.
  1035. }
  1036. if (pixels_per_y_mesh_pnt >= ULTRA_Y_PIXELS_PER_CHAR) { // There are only 2 custom characters available, so the Y
  1037. pixels_per_y_mesh_pnt = ULTRA_Y_PIXELS_PER_CHAR; // size of the mesh point needs to fit within them independent
  1038. suppress_y_offset = 1; // of where the starting pixel is located.
  1039. }
  1040. x_map_pixels = pixels_per_x_mesh_pnt * (GRID_MAX_POINTS_X); // now we have the right number of pixels to make both
  1041. y_map_pixels = pixels_per_y_mesh_pnt * (GRID_MAX_POINTS_Y); // directions fit nicely
  1042. right_edge = pixels_per_x_mesh_pnt * (GRID_MAX_POINTS_X) + 1; // find location of right edge within the character cell
  1043. bottom_line= pixels_per_y_mesh_pnt * (GRID_MAX_POINTS_Y) + 1; // find location of bottome line within the character cell
  1044. n_rows = bottom_line / (ULTRA_Y_PIXELS_PER_CHAR) + 1;
  1045. n_cols = right_edge / (ULTRA_X_PIXELS_PER_CHAR) + 1;
  1046. for (i = 0; i < n_cols; i++) {
  1047. lcd.setCursor(i, 0);
  1048. lcd.print((char)0x00); // top line of the box
  1049. lcd.setCursor(i, n_rows - 1);
  1050. lcd.write(0x01); // bottom line of the box
  1051. }
  1052. for (j = 0; j < n_rows; j++) {
  1053. lcd.setCursor(0, j);
  1054. lcd.write(0x02); // Left edge of the box
  1055. lcd.setCursor(n_cols - 1, j);
  1056. lcd.write(0x03); // right edge of the box
  1057. }
  1058. /**
  1059. * If the entire 4th row is not in use, do not put vertical bars all the way down to the bottom of the display
  1060. */
  1061. k = pixels_per_y_mesh_pnt * (GRID_MAX_POINTS_Y) + 2;
  1062. l = (ULTRA_Y_PIXELS_PER_CHAR) * n_rows;
  1063. if (l > k && l - k >= (ULTRA_Y_PIXELS_PER_CHAR) / 2) {
  1064. lcd.setCursor(0, n_rows - 1); // left edge of the box
  1065. lcd.write(' ');
  1066. lcd.setCursor(n_cols - 1, n_rows - 1); // right edge of the box
  1067. lcd.write(' ');
  1068. }
  1069. clear_custom_char(&new_char);
  1070. new_char.custom_char_bits[0] = 0B11111U; // char #0 is used for the top line of the box
  1071. lcd.createChar(0, (uint8_t*)&new_char);
  1072. clear_custom_char(&new_char);
  1073. k = (GRID_MAX_POINTS_Y) * pixels_per_y_mesh_pnt + 1; // row of pixels for the bottom box line
  1074. l = k % (ULTRA_Y_PIXELS_PER_CHAR); // row within relevant character cell
  1075. new_char.custom_char_bits[l] = 0B11111U; // char #1 is used for the bottom line of the box
  1076. lcd.createChar(1, (uint8_t*)&new_char);
  1077. clear_custom_char(&new_char);
  1078. for (j = 0; j < ULTRA_Y_PIXELS_PER_CHAR; j++)
  1079. new_char.custom_char_bits[j] = 0B10000U; // char #2 is used for the left edge of the box
  1080. lcd.createChar(2, (uint8_t*)&new_char);
  1081. clear_custom_char(&new_char);
  1082. m = (GRID_MAX_POINTS_X) * pixels_per_x_mesh_pnt + 1; // Column of pixels for the right box line
  1083. n = m % (ULTRA_X_PIXELS_PER_CHAR); // Column within relevant character cell
  1084. i = ULTRA_X_PIXELS_PER_CHAR - 1 - n; // Column within relevant character cell (0 on the right)
  1085. for (j = 0; j < ULTRA_Y_PIXELS_PER_CHAR; j++)
  1086. new_char.custom_char_bits[j] = (uint8_t)_BV(i); // Char #3 is used for the right edge of the box
  1087. lcd.createChar(3, (uint8_t*)&new_char);
  1088. i = x * pixels_per_x_mesh_pnt - suppress_x_offset;
  1089. j = y * pixels_per_y_mesh_pnt - suppress_y_offset;
  1090. upper_left = pixel_location(i, j);
  1091. k = (x + 1) * pixels_per_x_mesh_pnt - 1 - suppress_x_offset;
  1092. l = (y + 1) * pixels_per_y_mesh_pnt - 1 - suppress_y_offset;
  1093. lower_right = pixel_location(k, l);
  1094. bottom_right_corner = pixel_location(x_map_pixels, y_map_pixels);
  1095. /**
  1096. * First, handle the simple case where everything is within a single character cell.
  1097. * If part of the Mesh Plot is outside of this character cell, we will follow up
  1098. * and deal with that next.
  1099. */
  1100. //dump_custom_char("at entry:", &new_char);
  1101. clear_custom_char(&new_char);
  1102. const uint8_t ypix = min(upper_left.y_pixel_offset + pixels_per_y_mesh_pnt, ULTRA_Y_PIXELS_PER_CHAR);
  1103. for (j = upper_left.y_pixel_offset; j < ypix; j++) {
  1104. i = upper_left.x_pixel_mask;
  1105. for (k = 0; k < pixels_per_x_mesh_pnt; k++) {
  1106. new_char.custom_char_bits[j] |= i;
  1107. i >>= 1;
  1108. }
  1109. }
  1110. //dump_custom_char("after loops:", &new_char);
  1111. add_edges_to_custom_char(&new_char, &upper_left, &lower_right, &bottom_right_corner, TOP_LEFT);
  1112. //dump_custom_char("after add edges", &new_char);
  1113. lcd.createChar(4, (uint8_t*)&new_char);
  1114. lcd.setCursor(upper_left.column, upper_left.row);
  1115. lcd.write(0x04);
  1116. //dump_custom_char("after lcd update:", &new_char);
  1117. /**
  1118. * Next, check for two side by side character cells being used to display the Mesh Point
  1119. * If found... do the right hand character cell next.
  1120. */
  1121. if (upper_left.column == lower_right.column - 1) {
  1122. l = upper_left.x_pixel_offset;
  1123. clear_custom_char(&new_char);
  1124. for (j = upper_left.y_pixel_offset; j < ypix; j++) {
  1125. i = _BV(ULTRA_X_PIXELS_PER_CHAR - 1); // Fill in the left side of the right character cell
  1126. for (k = 0; k < pixels_per_x_mesh_pnt - 1 - l; k++) {
  1127. new_char.custom_char_bits[j] |= i;
  1128. i >>= 1;
  1129. }
  1130. }
  1131. add_edges_to_custom_char(&new_char, &upper_left, &lower_right, &bottom_right_corner, TOP_RIGHT);
  1132. lcd.createChar(5, (uint8_t *) &new_char);
  1133. lcd.setCursor(lower_right.column, upper_left.row);
  1134. lcd.write(0x05);
  1135. }
  1136. /**
  1137. * Next, check for two character cells stacked on top of each other being used to display the Mesh Point
  1138. */
  1139. if (upper_left.row == lower_right.row - 1) {
  1140. l = ULTRA_Y_PIXELS_PER_CHAR - upper_left.y_pixel_offset; // Number of pixel rows in top character cell
  1141. k = pixels_per_y_mesh_pnt - l; // Number of pixel rows in bottom character cell
  1142. clear_custom_char(&new_char);
  1143. for (j = 0; j < k; j++) {
  1144. i = upper_left.x_pixel_mask;
  1145. for (m = 0; m < pixels_per_x_mesh_pnt; m++) { // Fill in the top side of the bottom character cell
  1146. new_char.custom_char_bits[j] |= i;
  1147. if (!(i >>= 1)) break;
  1148. }
  1149. }
  1150. add_edges_to_custom_char(&new_char, &upper_left, &lower_right, &bottom_right_corner, LOWER_LEFT);
  1151. lcd.createChar(6, (uint8_t *) &new_char);
  1152. lcd.setCursor(upper_left.column, lower_right.row);
  1153. lcd.write(0x06);
  1154. }
  1155. /**
  1156. * Next, check for four character cells being used to display the Mesh Point. If that is
  1157. * what is here, we work to fill in the character cell that is down one and to the right one
  1158. * from the upper_left character cell.
  1159. */
  1160. if (upper_left.column == lower_right.column - 1 && upper_left.row == lower_right.row - 1) {
  1161. l = ULTRA_Y_PIXELS_PER_CHAR - upper_left.y_pixel_offset; // Number of pixel rows in top character cell
  1162. k = pixels_per_y_mesh_pnt - l; // Number of pixel rows in bottom character cell
  1163. clear_custom_char(&new_char);
  1164. for (j = 0; j < k; j++) {
  1165. l = upper_left.x_pixel_offset;
  1166. i = _BV(ULTRA_X_PIXELS_PER_CHAR - 1); // Fill in the left side of the right character cell
  1167. for (m = 0; m < pixels_per_x_mesh_pnt - 1 - l; m++) { // Fill in the top side of the bottom character cell
  1168. new_char.custom_char_bits[j] |= i;
  1169. i >>= 1;
  1170. }
  1171. }
  1172. add_edges_to_custom_char(&new_char, &upper_left, &lower_right, &bottom_right_corner, LOWER_RIGHT);
  1173. lcd.createChar(7, (uint8_t*)&new_char);
  1174. lcd.setCursor(lower_right.column, lower_right.row);
  1175. lcd.write(0x07);
  1176. }
  1177. #endif
  1178. /**
  1179. * Print plot position
  1180. */
  1181. lcd.setCursor(_LCD_W_POS, 0);
  1182. lcd.write('(');
  1183. lcd.print(x);
  1184. lcd.write(',');
  1185. lcd.print(inverted_y);
  1186. lcd.write(')');
  1187. #if LCD_HEIGHT <= 3 // 16x2 or 20x2 display
  1188. /**
  1189. * Print Z values
  1190. */
  1191. _ZLABEL(_LCD_W_POS, 1);
  1192. if (!isnan(ubl.z_values[x][inverted_y]))
  1193. lcd.print(ftostr43sign(ubl.z_values[x][inverted_y]));
  1194. else
  1195. lcd_printPGM(PSTR(" -----"));
  1196. #else // 16x4 or 20x4 display
  1197. /**
  1198. * Show all values at right of screen
  1199. */
  1200. _XLABEL(_LCD_W_POS, 1);
  1201. lcd.print(ftostr32(LOGICAL_X_POSITION(pgm_read_float(&ubl._mesh_index_to_xpos[x]))));
  1202. _YLABEL(_LCD_W_POS, 2);
  1203. lcd.print(ftostr32(LOGICAL_Y_POSITION(pgm_read_float(&ubl._mesh_index_to_ypos[inverted_y]))));
  1204. /**
  1205. * Show the location value
  1206. */
  1207. _ZLABEL(_LCD_W_POS, 3);
  1208. if (!isnan(ubl.z_values[x][inverted_y]))
  1209. lcd.print(ftostr43sign(ubl.z_values[x][inverted_y]));
  1210. else
  1211. lcd_printPGM(PSTR(" -----"));
  1212. #endif // LCD_HEIGHT > 3
  1213. }
  1214. void add_edges_to_custom_char(custom_char * const custom, coordinate * const ul, coordinate * const lr, coordinate * const brc, uint8_t cell_location) {
  1215. uint8_t i, k;
  1216. int16_t n_rows = lr->row - ul->row + 1,
  1217. n_cols = lr->column - ul->column + 1;
  1218. /**
  1219. * Check if Top line of box needs to be filled in
  1220. */
  1221. if (ul->row == 0 && ((cell_location & TOP_LEFT) || (cell_location & TOP_RIGHT))) { // Only fill in the top line for the top character cells
  1222. if (n_cols == 1) {
  1223. if (ul->column != brc->column)
  1224. custom->custom_char_bits[0] = 0xFF; // Single column in middle
  1225. else
  1226. for (i = brc->x_pixel_offset; i < ULTRA_X_PIXELS_PER_CHAR; i++) // Single column on right side
  1227. SBI(custom->custom_char_bits[0], i);
  1228. }
  1229. else if ((cell_location & TOP_LEFT) || lr->column != brc->column) // Multiple column in the middle or with right cell in middle
  1230. custom->custom_char_bits[0] = 0xFF;
  1231. else
  1232. for (i = brc->x_pixel_offset; i < ULTRA_X_PIXELS_PER_CHAR; i++)
  1233. SBI(custom->custom_char_bits[0], i);
  1234. }
  1235. /**
  1236. * Check if left line of box needs to be filled in
  1237. */
  1238. if ((cell_location & TOP_LEFT) || (cell_location & LOWER_LEFT)) {
  1239. if (ul->column == 0) { // Left column of characters on LCD Display
  1240. k = ul->row == brc->row ? brc->y_pixel_offset : ULTRA_Y_PIXELS_PER_CHAR; // If it isn't the last row... do the full character cell
  1241. for (i = 0; i < k; i++)
  1242. SBI(custom->custom_char_bits[i], ULTRA_X_PIXELS_PER_CHAR - 1);
  1243. }
  1244. }
  1245. /**
  1246. * Check if bottom line of box needs to be filled in
  1247. */
  1248. // Single row of mesh plot cells
  1249. if (n_rows == 1 /* && (cell_location == TOP_LEFT || cell_location == TOP_RIGHT) */ && ul->row == brc->row) {
  1250. if (n_cols == 1) // Single row, single column case
  1251. k = ul->column == brc->column ? brc->x_pixel_mask : 0x01;
  1252. else if (cell_location & TOP_RIGHT) // Single row, multiple column case
  1253. k = lr->column == brc->column ? brc->x_pixel_mask : 0x01;
  1254. else // Single row, left of multiple columns
  1255. k = 0x01;
  1256. while (k < _BV(ULTRA_X_PIXELS_PER_CHAR)) {
  1257. custom->custom_char_bits[brc->y_pixel_offset] |= k;
  1258. k <<= 1;
  1259. }
  1260. }
  1261. // Double row of characters on LCD Display
  1262. // And this is a bottom custom character
  1263. if (n_rows == 2 && (cell_location == LOWER_LEFT || cell_location == LOWER_RIGHT) && lr->row == brc->row) {
  1264. if (n_cols == 1) // Double row, single column case
  1265. k = ul->column == brc->column ? brc->x_pixel_mask : 0x01;
  1266. else if (cell_location & LOWER_RIGHT) // Double row, multiple column case
  1267. k = lr->column == brc->column ? brc->x_pixel_mask : 0x01;
  1268. else // Double row, left of multiple columns
  1269. k = 0x01;
  1270. while (k < _BV(ULTRA_X_PIXELS_PER_CHAR)) {
  1271. custom->custom_char_bits[brc->y_pixel_offset] |= k;
  1272. k <<= 1;
  1273. }
  1274. }
  1275. /**
  1276. * Check if right line of box needs to be filled in
  1277. */
  1278. // Nothing to do if the lower right part of the mesh pnt isn't in the same column as the box line
  1279. if (lr->column == brc->column) {
  1280. // This mesh point is in the same character cell as the right box line
  1281. if (ul->column == brc->column || (cell_location & TOP_RIGHT) || (cell_location & LOWER_RIGHT)) {
  1282. // If not the last row... do the full character cell
  1283. k = ul->row == brc->row ? brc->y_pixel_offset : ULTRA_Y_PIXELS_PER_CHAR;
  1284. for (i = 0; i < k; i++) custom->custom_char_bits[i] |= brc->x_pixel_mask;
  1285. }
  1286. }
  1287. }
  1288. #endif // AUTO_BED_LEVELING_UBL
  1289. #endif // ULTIPANEL
  1290. #endif // ULTRALCD_IMPL_HD44780_H