536 lines
16 KiB
C++
536 lines
16 KiB
C++
/**
|
|
* Marlin 3D Printer Firmware
|
|
* Copyright (C) 2019 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 <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
#pragma once
|
|
|
|
#include "../inc/MarlinConfig.h"
|
|
|
|
#if HAS_BUZZER
|
|
#include "../libs/buzzer.h"
|
|
#endif
|
|
|
|
#define HAS_ENCODER_ACTION (HAS_LCD_MENU || ENABLED(ULTIPANEL_FEEDMULTIPLY))
|
|
|
|
#if HAS_SPI_LCD
|
|
|
|
#include "../Marlin.h"
|
|
|
|
#if ENABLED(ADVANCED_PAUSE_FEATURE)
|
|
#include "../feature/pause.h"
|
|
#include "../module/motion.h" // for active_extruder
|
|
#endif
|
|
|
|
enum LCDViewAction : uint8_t {
|
|
LCDVIEW_NONE,
|
|
LCDVIEW_REDRAW_NOW,
|
|
LCDVIEW_CALL_REDRAW_NEXT,
|
|
LCDVIEW_CLEAR_CALL_REDRAW,
|
|
LCDVIEW_CALL_NO_REDRAW
|
|
};
|
|
|
|
#if HAS_ADC_BUTTONS
|
|
uint8_t get_ADC_keyValue();
|
|
#endif
|
|
|
|
#if HAS_GRAPHICAL_LCD
|
|
#define SETCURSOR(col, row) lcd_moveto(col * (MENU_FONT_WIDTH), (row + 1) * (MENU_FONT_HEIGHT))
|
|
#define SETCURSOR_RJ(len, row) lcd_moveto(LCD_PIXEL_WIDTH - len * (MENU_FONT_WIDTH), (row + 1) * (MENU_FONT_HEIGHT))
|
|
#define LCDPRINT(p) u8g.print(p)
|
|
#define LCDWRITE(c) u8g.print(c)
|
|
#else
|
|
#define SETCURSOR(col, row) lcd_moveto(col, row)
|
|
#define SETCURSOR_RJ(len, row) lcd_moveto(LCD_WIDTH - len, row)
|
|
#define LCDPRINT(p) lcd_put_u8str(p)
|
|
#define LCDWRITE(c) lcd_put_wchar(c)
|
|
#endif
|
|
|
|
#define LCD_UPDATE_INTERVAL 100
|
|
|
|
#if HAS_LCD_MENU
|
|
|
|
#if ENABLED(SDSUPPORT)
|
|
#include "../sd/cardreader.h"
|
|
#endif
|
|
|
|
typedef void (*screenFunc_t)();
|
|
typedef void (*menuAction_t)();
|
|
|
|
// Manual Movement
|
|
constexpr float manual_feedrate_mm_m[XYZE] = MANUAL_FEEDRATE;
|
|
extern float move_menu_scale;
|
|
|
|
#if ENABLED(ADVANCED_PAUSE_FEATURE)
|
|
void lcd_advanced_pause_show_message(const AdvancedPauseMessage message,
|
|
const AdvancedPauseMode mode=ADVANCED_PAUSE_MODE_SAME,
|
|
const uint8_t extruder=active_extruder);
|
|
#endif
|
|
|
|
#if ENABLED(AUTO_BED_LEVELING_UBL)
|
|
void lcd_mesh_edit_setup(const float &initial);
|
|
float lcd_mesh_edit();
|
|
#endif
|
|
|
|
#endif // HAS_LCD_MENU
|
|
|
|
#endif
|
|
|
|
// REPRAPWORLD_KEYPAD (and ADC_KEYPAD)
|
|
#if ENABLED(REPRAPWORLD_KEYPAD)
|
|
#define BTN_OFFSET 0 // Bit offset into buttons for shift register values
|
|
|
|
#define BLEN_KEYPAD_F3 0
|
|
#define BLEN_KEYPAD_F2 1
|
|
#define BLEN_KEYPAD_F1 2
|
|
#define BLEN_KEYPAD_DOWN 3
|
|
#define BLEN_KEYPAD_RIGHT 4
|
|
#define BLEN_KEYPAD_MIDDLE 5
|
|
#define BLEN_KEYPAD_UP 6
|
|
#define BLEN_KEYPAD_LEFT 7
|
|
|
|
#define EN_KEYPAD_F1 _BV(BTN_OFFSET + BLEN_KEYPAD_F1)
|
|
#define EN_KEYPAD_F2 _BV(BTN_OFFSET + BLEN_KEYPAD_F2)
|
|
#define EN_KEYPAD_F3 _BV(BTN_OFFSET + BLEN_KEYPAD_F3)
|
|
#define EN_KEYPAD_DOWN _BV(BTN_OFFSET + BLEN_KEYPAD_DOWN)
|
|
#define EN_KEYPAD_RIGHT _BV(BTN_OFFSET + BLEN_KEYPAD_RIGHT)
|
|
#define EN_KEYPAD_MIDDLE _BV(BTN_OFFSET + BLEN_KEYPAD_MIDDLE)
|
|
#define EN_KEYPAD_UP _BV(BTN_OFFSET + BLEN_KEYPAD_UP)
|
|
#define EN_KEYPAD_LEFT _BV(BTN_OFFSET + BLEN_KEYPAD_LEFT)
|
|
|
|
#define RRK(B) (keypad_buttons & (B))
|
|
|
|
#ifdef EN_C
|
|
#define BUTTON_CLICK() ((buttons & EN_C) || RRK(EN_KEYPAD_MIDDLE))
|
|
#else
|
|
#define BUTTON_CLICK() RRK(EN_KEYPAD_MIDDLE)
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#if HAS_DIGITAL_BUTTONS
|
|
|
|
// Wheel spin pins where BA is 00, 10, 11, 01 (1 bit always changes)
|
|
#define BLEN_A 0
|
|
#define BLEN_B 1
|
|
|
|
#define EN_A _BV(BLEN_A)
|
|
#define EN_B _BV(BLEN_B)
|
|
|
|
#define BUTTON_EXISTS(BN) (defined(BTN_## BN) && BTN_## BN >= 0)
|
|
#define BUTTON_PRESSED(BN) !READ(BTN_## BN)
|
|
|
|
#if BUTTON_EXISTS(ENC)
|
|
#define BLEN_C 2
|
|
#define EN_C _BV(BLEN_C)
|
|
#endif
|
|
|
|
#if ENABLED(LCD_I2C_VIKI)
|
|
|
|
#define B_I2C_BTN_OFFSET 3 // (the first three bit positions reserved for EN_A, EN_B, EN_C)
|
|
|
|
// button and encoder bit positions within 'buttons'
|
|
#define B_LE (BUTTON_LEFT << B_I2C_BTN_OFFSET) // The remaining normalized buttons are all read via I2C
|
|
#define B_UP (BUTTON_UP << B_I2C_BTN_OFFSET)
|
|
#define B_MI (BUTTON_SELECT << B_I2C_BTN_OFFSET)
|
|
#define B_DW (BUTTON_DOWN << B_I2C_BTN_OFFSET)
|
|
#define B_RI (BUTTON_RIGHT << B_I2C_BTN_OFFSET)
|
|
|
|
#if BUTTON_EXISTS(ENC) // The pause/stop/restart button is connected to BTN_ENC when used
|
|
#define B_ST (EN_C) // Map the pause/stop/resume button into its normalized functional name
|
|
#define BUTTON_CLICK() (buttons & (B_MI|B_RI|B_ST)) // Pause/stop also acts as click until a proper pause/stop is implemented.
|
|
#else
|
|
#define BUTTON_CLICK() (buttons & (B_MI|B_RI))
|
|
#endif
|
|
|
|
// I2C buttons take too long to read inside an interrupt context and so we read them during lcd_update
|
|
|
|
#elif ENABLED(LCD_I2C_PANELOLU2)
|
|
|
|
#if !BUTTON_EXISTS(ENC) // Use I2C if not directly connected to a pin
|
|
|
|
#define B_I2C_BTN_OFFSET 3 // (the first three bit positions reserved for EN_A, EN_B, EN_C)
|
|
|
|
#define B_MI (PANELOLU2_ENCODER_C << B_I2C_BTN_OFFSET) // requires LiquidTWI2 library v1.2.3 or later
|
|
|
|
#define BUTTON_CLICK() (buttons & B_MI)
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#define BUTTON_EXISTS(BN) false
|
|
|
|
// Shift register bits correspond to buttons:
|
|
#define BL_LE 7 // Left
|
|
#define BL_UP 6 // Up
|
|
#define BL_MI 5 // Middle
|
|
#define BL_DW 4 // Down
|
|
#define BL_RI 3 // Right
|
|
#define BL_ST 2 // Red Button
|
|
#define B_LE (_BV(BL_LE))
|
|
#define B_UP (_BV(BL_UP))
|
|
#define B_MI (_BV(BL_MI))
|
|
#define B_DW (_BV(BL_DW))
|
|
#define B_RI (_BV(BL_RI))
|
|
#define B_ST (_BV(BL_ST))
|
|
|
|
#ifndef BUTTON_CLICK
|
|
#define BUTTON_CLICK() (buttons & (B_MI|B_ST))
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#if BUTTON_EXISTS(BACK)
|
|
#define BLEN_D 3
|
|
#define EN_D _BV(BLEN_D)
|
|
#define LCD_BACK_CLICKED() (buttons & EN_D)
|
|
#else
|
|
#define LCD_BACK_CLICKED() false
|
|
#endif
|
|
|
|
#ifndef BUTTON_CLICK
|
|
#ifdef EN_C
|
|
#define BUTTON_CLICK() (buttons & EN_C)
|
|
#else
|
|
#define BUTTON_CLICK() false
|
|
#endif
|
|
#endif
|
|
|
|
#if HAS_GRAPHICAL_LCD
|
|
enum MarlinFont : uint8_t {
|
|
FONT_STATUSMENU = 1,
|
|
FONT_EDIT,
|
|
FONT_MENU
|
|
};
|
|
#else
|
|
enum HD44780CharSet : uint8_t {
|
|
CHARSET_MENU,
|
|
CHARSET_INFO,
|
|
CHARSET_BOOT
|
|
};
|
|
#endif
|
|
|
|
////////////////////////////////////////////
|
|
//////////// MarlinUI Singleton ////////////
|
|
////////////////////////////////////////////
|
|
|
|
class MarlinUI {
|
|
public:
|
|
|
|
MarlinUI() {
|
|
#if HAS_LCD_MENU
|
|
currentScreen = status_screen;
|
|
#endif
|
|
}
|
|
|
|
static inline void buzz(const long duration, const uint16_t freq) {
|
|
#if ENABLED(LCD_USE_I2C_BUZZER)
|
|
lcd.buzz(duration, freq);
|
|
#elif PIN_EXISTS(BEEPER)
|
|
buzzer.tone(duration, freq);
|
|
#else
|
|
UNUSED(duration); UNUSED(freq);
|
|
#endif
|
|
}
|
|
|
|
// LCD implementations
|
|
static void clear_lcd();
|
|
static void init_lcd();
|
|
|
|
#if HAS_SPI_LCD || ENABLED(MALYAN_LCD) || ENABLED(EXTENSIBLE_UI)
|
|
static void init();
|
|
static void update();
|
|
static void set_alert_status_P(PGM_P message);
|
|
#else // NO LCD
|
|
static inline void init() {}
|
|
static inline void update() {}
|
|
static inline void set_alert_status_P(PGM_P message) { UNUSED(message); }
|
|
#endif
|
|
|
|
#if HAS_SPI_LCD || ENABLED(EXTENSIBLE_UI)
|
|
|
|
static char status_message[];
|
|
static bool has_status();
|
|
|
|
|
|
static uint8_t status_message_level; // Higher levels block lower levels
|
|
static inline void reset_alert_level() { status_message_level = 0; }
|
|
|
|
#if HAS_PRINT_PROGRESS
|
|
#if ENABLED(LCD_SET_PROGRESS_MANUALLY)
|
|
static uint8_t progress_bar_percent;
|
|
static void set_progress(const uint8_t progress) { progress_bar_percent = MIN(progress, 100); }
|
|
#endif
|
|
static uint8_t get_progress();
|
|
#else
|
|
static constexpr uint8_t get_progress() { return 0; }
|
|
#endif
|
|
|
|
#if HAS_SPI_LCD
|
|
|
|
static bool detected();
|
|
|
|
static LCDViewAction lcdDrawUpdate;
|
|
static inline bool should_draw() { return bool(lcdDrawUpdate); }
|
|
static inline void refresh(const LCDViewAction type) { lcdDrawUpdate = type; }
|
|
static inline void refresh() { refresh(LCDVIEW_CLEAR_CALL_REDRAW); }
|
|
|
|
#if ENABLED(SHOW_BOOTSCREEN)
|
|
static void show_bootscreen();
|
|
#endif
|
|
|
|
#if HAS_GRAPHICAL_LCD
|
|
|
|
static bool drawing_screen, first_page;
|
|
|
|
static void set_font(const MarlinFont font_nr);
|
|
|
|
#else
|
|
|
|
static constexpr bool drawing_screen = false, first_page = true;
|
|
|
|
static void set_custom_characters(const HD44780CharSet screen_charset=CHARSET_INFO);
|
|
|
|
#if ENABLED(LCD_PROGRESS_BAR)
|
|
static millis_t progress_bar_ms; // Start time for the current progress bar cycle
|
|
static void draw_progress_bar(const uint8_t percent);
|
|
#if PROGRESS_MSG_EXPIRE > 0
|
|
static millis_t MarlinUI::expire_status_ms; // = 0
|
|
static inline void reset_progress_bar_timeout() { expire_status_ms = 0; }
|
|
#endif
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#if ENABLED(STATUS_MESSAGE_SCROLLING)
|
|
static uint8_t status_scroll_offset;
|
|
#endif
|
|
static uint8_t lcd_status_update_delay;
|
|
|
|
#if HAS_LCD_CONTRAST
|
|
static int16_t contrast;
|
|
static void set_contrast(const int16_t value);
|
|
static inline void refresh_contrast() { set_contrast(contrast); }
|
|
#endif
|
|
|
|
#if ENABLED(FILAMENT_LCD_DISPLAY) && ENABLED(SDSUPPORT)
|
|
static millis_t next_filament_display;
|
|
#endif
|
|
|
|
static void quick_feedback(const bool clear_buttons=true);
|
|
static void completion_feedback(const bool good=true);
|
|
|
|
#if DISABLED(LIGHTWEIGHT_UI)
|
|
static void draw_status_message(const bool blink);
|
|
#endif
|
|
|
|
#if ENABLED(ADVANCED_PAUSE_FEATURE)
|
|
static void draw_hotend_status(const uint8_t row, const uint8_t extruder);
|
|
#endif
|
|
|
|
static void status_screen();
|
|
|
|
#else
|
|
static void refresh() {}
|
|
#endif
|
|
|
|
static bool get_blink();
|
|
static void kill_screen(PGM_P const lcd_msg);
|
|
static void draw_kill_screen();
|
|
static void set_status(const char* const message, const bool persist=false);
|
|
static void set_status_P(PGM_P const message, const int8_t level=0);
|
|
static void status_printf_P(const uint8_t level, PGM_P const fmt, ...);
|
|
static void reset_status();
|
|
|
|
#else // MALYAN_LCD or NO LCD
|
|
|
|
static inline void refresh() {}
|
|
static inline void set_status(const char* const message, const bool persist=false) { UNUSED(message); UNUSED(persist); }
|
|
static inline void set_status_P(PGM_P const message, const int8_t level=0) { UNUSED(message); UNUSED(level); }
|
|
static inline void status_printf_P(const uint8_t level, PGM_P const fmt, ...) { UNUSED(level); UNUSED(fmt); }
|
|
static inline void reset_status() {}
|
|
static inline void reset_alert_level() {}
|
|
static constexpr bool has_status() { return false; }
|
|
|
|
#endif
|
|
|
|
#if HAS_LCD_MENU
|
|
|
|
#if ENABLED(ENCODER_RATE_MULTIPLIER)
|
|
static bool encoderRateMultiplierEnabled;
|
|
static millis_t lastEncoderMovementMillis;
|
|
static void enable_encoder_multiplier(const bool onoff);
|
|
#endif
|
|
|
|
#if ENABLED(SDSUPPORT)
|
|
#if ENABLED(SCROLL_LONG_FILENAMES)
|
|
static uint8_t filename_scroll_pos, filename_scroll_max;
|
|
#endif
|
|
static const char * scrolled_filename(CardReader &theCard, const uint8_t maxlen, uint8_t hash, const bool doScroll);
|
|
#endif
|
|
|
|
#if IS_KINEMATIC
|
|
static bool processing_manual_move;
|
|
#else
|
|
static constexpr bool processing_manual_move = false;
|
|
#endif
|
|
|
|
#if E_MANUAL > 1
|
|
static int8_t manual_move_e_index;
|
|
#else
|
|
static constexpr int8_t manual_move_e_index = 0;
|
|
#endif
|
|
|
|
static int16_t preheat_hotend_temp[2], preheat_bed_temp[2];
|
|
static uint8_t preheat_fan_speed[2];
|
|
|
|
static void manage_manual_move();
|
|
|
|
static bool lcd_clicked;
|
|
static bool use_click();
|
|
|
|
static void synchronize(PGM_P const msg=NULL);
|
|
|
|
static screenFunc_t currentScreen;
|
|
static void goto_screen(const screenFunc_t screen, const uint32_t encoder=0);
|
|
static void save_previous_screen();
|
|
static void goto_previous_screen();
|
|
static void return_to_status();
|
|
static inline bool on_status_screen() { return currentScreen == status_screen; }
|
|
static inline void run_current_screen() { (*currentScreen)(); }
|
|
|
|
#if ENABLED(LIGHTWEIGHT_UI)
|
|
static void lcd_in_status(const bool inStatus);
|
|
#endif
|
|
|
|
static inline void defer_status_screen(const bool defer) {
|
|
#if LCD_TIMEOUT_TO_STATUS
|
|
defer_return_to_status = defer;
|
|
#else
|
|
UNUSED(defer);
|
|
#endif
|
|
}
|
|
|
|
static inline void goto_previous_screen_no_defer() {
|
|
defer_status_screen(false);
|
|
goto_previous_screen();
|
|
}
|
|
|
|
#if ENABLED(SD_REPRINT_LAST_SELECTED_FILE)
|
|
static void reselect_last_file();
|
|
#endif
|
|
|
|
#if ENABLED(G26_MESH_VALIDATION)
|
|
static inline void chirp() { buzz(LCD_FEEDBACK_FREQUENCY_DURATION_MS, LCD_FEEDBACK_FREQUENCY_HZ); }
|
|
#endif
|
|
|
|
#if ENABLED(AUTO_BED_LEVELING_UBL)
|
|
static void ubl_plot(const uint8_t x, const uint8_t inverted_y);
|
|
#endif
|
|
|
|
#elif HAS_SPI_LCD
|
|
|
|
static constexpr bool lcd_clicked = false;
|
|
static constexpr bool on_status_screen() { return true; }
|
|
static inline void run_current_screen() { status_screen(); }
|
|
|
|
#endif
|
|
|
|
#if ENABLED(LCD_BED_LEVELING) && (ENABLED(PROBE_MANUALLY) || ENABLED(MESH_BED_LEVELING))
|
|
static bool wait_for_bl_move;
|
|
#else
|
|
static constexpr bool wait_for_bl_move = false;
|
|
#endif
|
|
|
|
#if HAS_LCD_MENU && (ENABLED(AUTO_BED_LEVELING_UBL) || ENABLED(G26_MESH_VALIDATION))
|
|
static bool external_control;
|
|
FORCE_INLINE static void capture() { external_control = true; }
|
|
FORCE_INLINE static void release() { external_control = false; }
|
|
#else
|
|
static constexpr bool external_control = false;
|
|
#endif
|
|
|
|
#if HAS_ENCODER_ACTION
|
|
|
|
static volatile uint8_t buttons;
|
|
#if ENABLED(REPRAPWORLD_KEYPAD)
|
|
static volatile uint8_t keypad_buttons;
|
|
static bool handle_keypad();
|
|
#endif
|
|
#if HAS_SLOW_BUTTONS
|
|
static volatile uint8_t slow_buttons;
|
|
static uint8_t read_slow_buttons();
|
|
#endif
|
|
static void update_buttons();
|
|
static inline bool button_pressed() { return BUTTON_CLICK(); }
|
|
#if ENABLED(AUTO_BED_LEVELING_UBL) || ENABLED(G26_MESH_VALIDATION)
|
|
static void wait_for_release();
|
|
#endif
|
|
|
|
static uint32_t encoderPosition;
|
|
|
|
#if ENABLED(REVERSE_ENCODER_DIRECTION)
|
|
#define ENCODERBASE -1
|
|
#else
|
|
#define ENCODERBASE +1
|
|
#endif
|
|
#if ENABLED(REVERSE_MENU_DIRECTION)
|
|
static int8_t encoderDirection;
|
|
static inline void encoder_direction_normal() { encoderDirection = +(ENCODERBASE); }
|
|
static inline void encoder_direction_menus() { encoderDirection = -(ENCODERBASE); }
|
|
#else
|
|
static constexpr int8_t encoderDirection = ENCODERBASE;
|
|
static inline void encoder_direction_normal() {}
|
|
static inline void encoder_direction_menus() {}
|
|
#endif
|
|
|
|
#else
|
|
|
|
static inline void update_buttons() {}
|
|
|
|
#endif
|
|
|
|
private:
|
|
|
|
static void _synchronize();
|
|
|
|
#if HAS_SPI_LCD || ENABLED(EXTENSIBLE_UI)
|
|
static void finishstatus(const bool persist);
|
|
#endif
|
|
|
|
#if HAS_SPI_LCD
|
|
#if HAS_LCD_MENU
|
|
#if LCD_TIMEOUT_TO_STATUS
|
|
static bool defer_return_to_status;
|
|
#else
|
|
static constexpr bool defer_return_to_status = false;
|
|
#endif
|
|
#endif
|
|
static void draw_status_screen();
|
|
#endif
|
|
};
|
|
|
|
extern MarlinUI ui;
|
|
|
|
#define LCD_MESSAGEPGM(x) ui.set_status_P(PSTR(x))
|
|
#define LCD_ALERTMESSAGEPGM(x) ui.set_alert_status_P(PSTR(x))
|