/** * Marlin 3D Printer Firmware * Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin] * * Based on Sprinter and grbl. * Copyright (C) 2011 Camiel Gubbels / Erik van der Zalm * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * */ #include "../../inc/MarlinConfigPre.h" #if HAS_LCD_MENU #include "menu.h" #include "../ultralcd.h" #include "../../module/planner.h" #include "../../module/motion.h" #include "../../gcode/queue.h" #include "../../sd/cardreader.h" #if ENABLED(EEPROM_SETTINGS) #include "../../module/configuration_store.h" #endif #if WATCH_HOTENDS || WATCH_THE_BED #include "../../module/temperature.h" #endif #if ENABLED(BABYSTEP_ZPROBE_OFFSET) #include "../../module/probe.h" #endif #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT) || ENABLED(AUTO_BED_LEVELING_UBL) #include "../../feature/bedlevel/bedlevel.h" #endif //////////////////////////////////////////// ///////////// Global Variables ///////////// //////////////////////////////////////////// // Menu Navigation int8_t encoderTopLine; typedef struct { screenFunc_t menu_function; uint32_t encoder_position; } menuPosition; menuPosition screen_history[6]; uint8_t screen_history_depth = 0; bool screen_changed, defer_return_to_status; // Value Editing PGM_P editLabel; void *editValue; int32_t minEditValue, maxEditValue; screenFunc_t callbackFunc; bool liveEdit; // Prevent recursion into screen handlers bool no_reentry = false; //////////////////////////////////////////// //////// Menu Navigation & History ///////// //////////////////////////////////////////// void lcd_return_to_status() { lcd_goto_screen(lcd_status_screen); } void lcd_save_previous_screen() { if (screen_history_depth < COUNT(screen_history)) { screen_history[screen_history_depth].menu_function = currentScreen; screen_history[screen_history_depth].encoder_position = encoderPosition; ++screen_history_depth; } } void lcd_goto_previous_menu() { if (screen_history_depth > 0) { --screen_history_depth; lcd_goto_screen( screen_history[screen_history_depth].menu_function, screen_history[screen_history_depth].encoder_position ); } else lcd_return_to_status(); } void lcd_goto_previous_menu_no_defer() { defer_return_to_status = false; lcd_goto_previous_menu(); } //////////////////////////////////////////// /////////// Common Menu Actions //////////// //////////////////////////////////////////// void menu_item_gcode::action(PGM_P pgcode) { enqueue_and_echo_commands_P(pgcode); } //////////////////////////////////////////// /////////// Menu Editing Actions /////////// //////////////////////////////////////////// /** * Functions for editing single values * * The "DEFINE_MENU_EDIT_ITEM" macro generates the functions needed to edit a numerical value. * * The prerequisite is that in the header the type was already declared: * * DECLARE_MENU_EDIT_TYPE(int16_t, int3, itostr3, 1) * * For example, DEFINE_MENU_EDIT_ITEM(int3) expands into these functions: * * bool menu_item_int3::_edit(); * void menu_item_int3::edit(); // edit int16_t (interactively) * void menu_item_int3::action_setting_edit(PGM_P const pstr, int16_t * const ptr, const int16_t minValue, const int16_t maxValue, const screenFunc_t callback = null, const bool live = false); * * You can then use one of the menu macros to present the edit interface: * MENU_ITEM_EDIT(int3, MSG_SPEED, &feedrate_percentage, 10, 999) * * This expands into a more primitive menu item: * MENU_ITEM_VARIANT(int3, _setting_edit, MSG_SPEED, PSTR(MSG_SPEED), &feedrate_percentage, 10, 999) * * ...which calls: * menu_item_int3::action_setting_edit(PSTR(MSG_SPEED), &feedrate_percentage, 10, 999) */ void menu_item_invariants::edit(strfunc_t strfunc, loadfunc_t loadfunc) { ENCODER_DIRECTION_NORMAL(); if ((int32_t)encoderPosition < 0) encoderPosition = 0; if ((int32_t)encoderPosition > maxEditValue) encoderPosition = maxEditValue; if (lcdDrawUpdate) lcd_implementation_drawedit(editLabel, strfunc(encoderPosition + minEditValue)); if (lcd_clicked || (liveEdit && lcdDrawUpdate)) { if (editValue != NULL) loadfunc(editValue, encoderPosition + minEditValue); if (callbackFunc && (liveEdit || lcd_clicked)) (*callbackFunc)(); if (lcd_clicked) lcd_goto_previous_menu(); lcd_clicked = false; } } void menu_item_invariants::init(PGM_P const el, void * const ev, const int32_t minv, const int32_t maxv, const uint32_t ep, const screenFunc_t cs, const screenFunc_t cb, const bool le) { lcd_save_previous_screen(); lcd_refresh(); editLabel = el; editValue = ev; minEditValue = minv; maxEditValue = maxv; encoderPosition = ep; currentScreen = cs; callbackFunc = cb; liveEdit = le; } #define DEFINE_MENU_EDIT_ITEM(NAME) template class menu_item_template; DEFINE_MENU_EDIT_ITEM(int3); DEFINE_MENU_EDIT_ITEM(int4); DEFINE_MENU_EDIT_ITEM(int8); DEFINE_MENU_EDIT_ITEM(float3); DEFINE_MENU_EDIT_ITEM(float52); DEFINE_MENU_EDIT_ITEM(float43); DEFINE_MENU_EDIT_ITEM(float5); DEFINE_MENU_EDIT_ITEM(float51); DEFINE_MENU_EDIT_ITEM(float52sign); DEFINE_MENU_EDIT_ITEM(float62); DEFINE_MENU_EDIT_ITEM(long5); void menu_item_bool::action_setting_edit(PGM_P pstr, bool *ptr, screenFunc_t callback) { UNUSED(pstr); *ptr ^= true; lcd_refresh(); if (callback) (*callback)(); } //////////////////////////////////////////// ///////////////// Menu Tree //////////////// //////////////////////////////////////////// #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT) float lcd_z_fade_height; void _lcd_set_z_fade_height() { set_z_fade_height(lcd_z_fade_height); } #endif bool printer_busy() { return planner.movesplanned() || IS_SD_PRINTING(); } /** * General function to go directly to a screen */ void lcd_goto_screen(screenFunc_t screen, const uint32_t encoder/*=0*/) { if (currentScreen != screen) { #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT) // Shadow for editing the fade height lcd_z_fade_height = planner.z_fade_height; #endif #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING) && ENABLED(BABYSTEPPING) static millis_t doubleclick_expire_ms = 0; // Going to menu_main from status screen? Remember first click time. // Going back to status screen within a very short time? Go to Z babystepping. if (screen == menu_main) { if (currentScreen == lcd_status_screen) doubleclick_expire_ms = millis() + DOUBLECLICK_MAX_INTERVAL; } else if (screen == lcd_status_screen && currentScreen == menu_main && PENDING(millis(), doubleclick_expire_ms)) { if (printer_busy()) { screen = #if ENABLED(BABYSTEP_ZPROBE_OFFSET) lcd_babystep_zoffset #else lcd_babystep_z #endif ; } #if ENABLED(MOVE_Z_WHEN_IDLE) else { move_menu_scale = MOVE_Z_IDLE_MULTIPLICATOR; screen = lcd_move_z; } #endif } #endif currentScreen = screen; encoderPosition = encoder; if (screen == lcd_status_screen) { defer_return_to_status = false; #if ENABLED(AUTO_BED_LEVELING_UBL) ubl.lcd_map_control = false; #endif screen_history_depth = 0; } lcd_implementation_clear(); // Re-initialize custom characters that may be re-used #if HAS_CHARACTER_LCD #if ENABLED(AUTO_BED_LEVELING_UBL) if (!ubl.lcd_map_control) #endif LCD_SET_CHARSET(screen == lcd_status_screen ? CHARSET_INFO : CHARSET_MENU); #endif lcdDrawUpdate = LCDVIEW_CALL_REDRAW_NEXT; screen_changed = true; #if HAS_GRAPHICAL_LCD drawing_screen = false; #endif } } //////////////////////////////////////////// ///////////// Manual Movement ////////////// //////////////////////////////////////////// // // Display the synchronize screen until moves are // finished, and don't return to the caller until // done. ** This blocks the command queue! ** // static PGM_P sync_message; void _lcd_synchronize() { if (lcdDrawUpdate) lcd_implementation_drawmenu_static(LCD_HEIGHT >= 4 ? 1 : 0, sync_message); if (no_reentry) return; // Make this the current handler till all moves are done no_reentry = true; const screenFunc_t old_screen = currentScreen; lcd_goto_screen(_lcd_synchronize); planner.synchronize(); // idle() is called until moves complete no_reentry = false; lcd_goto_screen(old_screen); } // Display the synchronize screen with a custom message // ** This blocks the command queue! ** void lcd_synchronize(PGM_P const msg/*=NULL*/) { static const char moving[] PROGMEM = MSG_MOVING; sync_message = msg ? msg : moving; _lcd_synchronize(); } /** * Scrolling for menus and other line-based screens * * encoderLine is the position based on the encoder * encoderTopLine is the top menu line to display * _lcdLineNr is the index of the LCD line (e.g., 0-3) * _menuLineNr is the menu item to draw and process * _thisItemNr is the index of each MENU_ITEM or STATIC_ITEM * screen_items is the total number of items in the menu (after one call) */ int8_t encoderLine, screen_items; void scroll_screen(const uint8_t limit, const bool is_menu) { ENCODER_DIRECTION_MENUS(); ENCODER_RATE_MULTIPLY(false); if (encoderPosition > 0x8000) encoderPosition = 0; if (first_page) { encoderLine = encoderPosition / (ENCODER_STEPS_PER_MENU_ITEM); screen_changed = false; } if (screen_items > 0 && encoderLine >= screen_items - limit) { encoderLine = MAX(0, screen_items - limit); encoderPosition = encoderLine * (ENCODER_STEPS_PER_MENU_ITEM); } if (is_menu) { NOMORE(encoderTopLine, encoderLine); if (encoderLine >= encoderTopLine + LCD_HEIGHT) encoderTopLine = encoderLine - LCD_HEIGHT + 1; } else encoderTopLine = encoderLine; } void lcd_completion_feedback(const bool good/*=true*/) { if (good) { lcd_buzz(100, 659); lcd_buzz(100, 698); } else lcd_buzz(20, 440); } #if HAS_LINE_TO_Z void line_to_z(const float &z) { current_position[Z_AXIS] = z; planner.buffer_line(current_position, MMM_TO_MMS(manual_feedrate_mm_m[Z_AXIS]), active_extruder); } #endif #if ENABLED(BABYSTEP_ZPROBE_OFFSET) void lcd_babystep_zoffset() { if (use_click()) { return lcd_goto_previous_menu_no_defer(); } defer_return_to_status = true; #if ENABLED(BABYSTEP_HOTEND_Z_OFFSET) const bool do_probe = (active_extruder == 0); #else constexpr bool do_probe = true; #endif ENCODER_DIRECTION_NORMAL(); if (encoderPosition) { const int16_t babystep_increment = (int32_t)encoderPosition * (BABYSTEP_MULTIPLICATOR); encoderPosition = 0; const float diff = planner.steps_to_mm[Z_AXIS] * babystep_increment, new_probe_offset = zprobe_zoffset + diff, new_offs = #if ENABLED(BABYSTEP_HOTEND_Z_OFFSET) do_probe ? new_probe_offset : hotend_offset[Z_AXIS][active_extruder] - diff #else new_probe_offset #endif ; if (WITHIN(new_offs, Z_PROBE_OFFSET_RANGE_MIN, Z_PROBE_OFFSET_RANGE_MAX)) { thermalManager.babystep_axis(Z_AXIS, babystep_increment); if (do_probe) zprobe_zoffset = new_offs; #if ENABLED(BABYSTEP_HOTEND_Z_OFFSET) else hotend_offset[Z_AXIS][active_extruder] = new_offs; #endif lcdDrawUpdate = LCDVIEW_CALL_REDRAW_NEXT; } } if (lcdDrawUpdate) { #if ENABLED(BABYSTEP_HOTEND_Z_OFFSET) if (!do_probe) lcd_implementation_drawedit(PSTR(MSG_IDEX_Z_OFFSET), ftostr43sign(hotend_offset[Z_AXIS][active_extruder])); else #endif lcd_implementation_drawedit(PSTR(MSG_ZPROBE_ZOFFSET), ftostr43sign(zprobe_zoffset)); #if ENABLED(BABYSTEP_ZPROBE_GFX_OVERLAY) if (do_probe) _lcd_zoffset_overlay_gfx(zprobe_zoffset); #endif } } #endif // BABYSTEP_ZPROBE_OFFSET /** * Watch temperature callbacks */ #if HAS_TEMP_HOTEND #if WATCH_HOTENDS #define _WATCH_FUNC(N) thermalManager.start_watching_heater(N) #else #define _WATCH_FUNC(N) NOOP #endif void watch_temp_callback_E0() { _WATCH_FUNC(0); } #if HOTENDS > 1 void watch_temp_callback_E1() { _WATCH_FUNC(1); } #if HOTENDS > 2 void watch_temp_callback_E2() { _WATCH_FUNC(2); } #if HOTENDS > 3 void watch_temp_callback_E3() { _WATCH_FUNC(3); } #if HOTENDS > 4 void watch_temp_callback_E4() { _WATCH_FUNC(4); } #if HOTENDS > 5 void watch_temp_callback_E5() { _WATCH_FUNC(5); } #endif // HOTENDS > 5 #endif // HOTENDS > 4 #endif // HOTENDS > 3 #endif // HOTENDS > 2 #endif // HOTENDS > 1 #endif // HAS_TEMP_HOTEND void watch_temp_callback_bed() { #if WATCH_THE_BED thermalManager.start_watching_bed(); #endif } #if ENABLED(AUTO_BED_LEVELING_UBL) || ENABLED(PID_AUTOTUNE_MENU) || ENABLED(ADVANCED_PAUSE_FEATURE) void lcd_enqueue_command(const char * const cmd) { no_reentry = true; enqueue_and_echo_command_now(cmd); no_reentry = false; } void lcd_enqueue_commands_P(PGM_P const cmd) { no_reentry = true; enqueue_and_echo_commands_now_P(cmd); no_reentry = false; } #endif #if ENABLED(EEPROM_SETTINGS) void lcd_store_settings() { lcd_completion_feedback(settings.save()); } void lcd_load_settings() { lcd_completion_feedback(settings.load()); } #endif void _lcd_draw_homing() { constexpr uint8_t line = (LCD_HEIGHT - 1) / 2; if (lcdDrawUpdate) lcd_implementation_drawmenu_static(line, PSTR(MSG_LEVEL_BED_HOMING)); lcdDrawUpdate = LCDVIEW_CALL_NO_REDRAW; } #if ENABLED(LCD_BED_LEVELING) || (HAS_LEVELING && DISABLED(SLIM_LCD_MENUS)) #include "../../feature/bedlevel/bedlevel.h" void _lcd_toggle_bed_leveling() { set_bed_leveling_enabled(!planner.leveling_active); } #endif #endif // HAS_LCD_MENU