//menu.cpp #include "menu.h" #include #include #include #include #include "lcd.h" #include "Configuration.h" #include "Marlin.h" #include "cmdqueue.h" #include "ultralcd.h" #include "language.h" #include "static_assert.h" #include "sound.h" extern int32_t lcd_encoder; #define MENU_DEPTH_MAX 7 static menu_record_t menu_stack[MENU_DEPTH_MAX]; uint8_t menu_data[MENU_DATA_SIZE]; #ifndef __AVR__ #error "menu_data is non-portable to non 8bit processor" #endif uint8_t menu_depth = 0; uint8_t menu_block_entering_on_serious_errors = SERIOUS_ERR_NONE; uint8_t menu_line = 0; uint8_t menu_item = 0; uint8_t menu_row = 0; uint8_t menu_top = 0; uint8_t menu_clicked = 0; uint8_t menu_leaving = 0; menu_func_t menu_menu = 0; static_assert(sizeof(menu_data)>= sizeof(menu_data_edit_t),"menu_data_edit_t doesn't fit into menu_data"); void menu_data_reset(void) { // Resets the global shared C union. // This ensures, that the menu entered will find out, that it shall initialize itself. memset(&menu_data, 0, sizeof(menu_data)); } void menu_goto(menu_func_t menu, const uint32_t encoder, const bool feedback, bool reset_menu_state) { CRITICAL_SECTION_START; if (menu_menu != menu) { menu_menu = menu; lcd_encoder = encoder; menu_top = 0; //reset menu view. Needed if menu_back() is called from deep inside a menu, such as Support CRITICAL_SECTION_END; if (reset_menu_state) menu_data_reset(); if (feedback) lcd_quick_feedback(); } else CRITICAL_SECTION_END; } void menu_start(void) { if (lcd_encoder > 0x8000) lcd_encoder = 0; if (lcd_encoder < 0) { lcd_encoder = 0; Sound_MakeSound(e_SOUND_TYPE_BlindAlert); } if (lcd_encoder < menu_top) menu_top = lcd_encoder; menu_line = menu_top; menu_clicked = LCD_CLICKED; } void menu_end(void) { if (lcd_encoder >= menu_item) { lcd_encoder = menu_item - 1; Sound_MakeSound(e_SOUND_TYPE_BlindAlert); } if (((uint8_t)lcd_encoder) >= menu_top + LCD_HEIGHT) { menu_top = lcd_encoder - LCD_HEIGHT + 1; lcd_draw_update = 1; menu_line = menu_top - 1; menu_row = -1; } } void menu_back(uint8_t nLevel) { menu_depth = ((menu_depth > nLevel) ? (menu_depth - nLevel) : 0); menu_goto(menu_stack[menu_depth].menu, menu_stack[menu_depth].position, true, true); } void menu_back(void) { menu_back(1); } void menu_back_no_reset(void) { if (menu_depth > 0) { menu_depth--; menu_goto(menu_stack[menu_depth].menu, menu_stack[menu_depth].position, true, false); } } void menu_back_if_clicked(void) { if (lcd_clicked()) menu_back(); } void menu_back_if_clicked_fb(void) { if (lcd_clicked()) { lcd_quick_feedback(); menu_back(); } } void menu_submenu(menu_func_t submenu) { if (menu_depth < MENU_DEPTH_MAX) { menu_stack[menu_depth].menu = menu_menu; menu_stack[menu_depth++].position = lcd_encoder; menu_goto(submenu, 0, true, true); } } void menu_submenu_no_reset(menu_func_t submenu) { if (menu_depth < MENU_DEPTH_MAX) { menu_stack[menu_depth].menu = menu_menu; menu_stack[menu_depth++].position = lcd_encoder; menu_goto(submenu, 0, true, false); } } uint8_t menu_item_ret(void) { lcd_beeper_quick_feedback(); lcd_draw_update = 2; lcd_button_pressed = false; return 1; } /* int menu_draw_item_printf_P(char type_char, const char* format, ...) { va_list args; va_start(args, format); int ret = 0; lcd_set_cursor(0, menu_row); if (lcd_encoder == menu_item) lcd_print('>'); else lcd_print(' '); int cnt = vfprintf_P(lcdout, format, args); for (int i = cnt; i < 18; i++) lcd_print(' '); lcd_print(type_char); va_end(args); return ret; } */ static char menu_selection_mark(){ return (lcd_encoder == menu_item)?'>':' '; } static void menu_draw_item_puts_P(char type_char, const char* str) { lcd_set_cursor(0, menu_row); lcd_printf_P(PSTR("%c%-18.18S%c"), menu_selection_mark(), str, type_char); } static void menu_draw_toggle_puts_P(const char* str, const char* toggle, const uint8_t settings) { //settings: //xxxxxcba //a = selection mark. If it's set(1), then '>' will be used as the first character on the line. Else leave blank //b = toggle string is from progmem //c = do not set cursor at all. Must be handled externally. char lineStr[LCD_WIDTH + 1]; const char eol = (toggle == NULL)?LCD_STR_ARROW_RIGHT[0]:' '; if (toggle == NULL) toggle = _T(MSG_NA); sprintf_P(lineStr, PSTR("%c%-18.18S"), (settings & 0x01)?'>':' ', str); sprintf_P(lineStr + LCD_WIDTH - ((settings & 0x02)?strlen_P(toggle):strlen(toggle)) - 3, (settings & 0x02)?PSTR("[%S]%c"):PSTR("[%s]%c"), toggle, eol); if (!(settings & 0x04)) lcd_set_cursor(0, menu_row); fputs(lineStr, lcdout); } //! @brief Format sheet name //! //! @param[in] sheet_E Sheet in EEPROM //! @param[out] buffer for formatted output void menu_format_sheet_E(const Sheet &sheet_E, SheetFormatBuffer &buffer) { uint_least8_t index = sprintf_P(buffer.c, PSTR("%.10S "), _T(MSG_SHEET)); eeprom_read_block(&(buffer.c[index]), sheet_E.name, 7); //index += 7; buffer.c[index + 7] = '\0'; } //! @brief Format sheet name in select menu //! //! @param[in] sheet_E Sheet in EEPROM //! @param[out] buffer for formatted output void menu_format_sheet_select_E(const Sheet &sheet_E, SheetFormatBuffer &buffer) { uint_least8_t index = sprintf_P(buffer.c,PSTR("%-9.9S["), _T(MSG_SHEET)); eeprom_read_block(&(buffer.c[index]), sheet_E.name, sizeof(sheet_E.name)/sizeof(sheet_E.name[0])); for (const uint_least8_t start = index; static_cast(index - start) < sizeof(sheet_E.name)/sizeof(sheet_E.name[0]); ++index) { if (buffer.c[index] == '\0') break; } buffer.c[index] = ']'; buffer.c[index + 1] = '\0'; } static void menu_draw_item_select_sheet_E(char type_char, const Sheet &sheet) { lcd_set_cursor(0, menu_row); SheetFormatBuffer buffer; menu_format_sheet_select_E(sheet, buffer); lcd_printf_P(PSTR("%c%-18.18s%c"), menu_selection_mark(), buffer.c, type_char); } static void menu_draw_item_puts_E(char type_char, const Sheet &sheet) { lcd_set_cursor(0, menu_row); SheetFormatBuffer buffer; menu_format_sheet_E(sheet, buffer); lcd_printf_P(PSTR("%c%-18.18s%c"), menu_selection_mark(), buffer.c, type_char); } static void menu_draw_item_puts_P(char type_char, const char* str, char num) { lcd_set_cursor(0, menu_row); lcd_printf_P(PSTR("%c%-.16S "), menu_selection_mark(), str); lcd_putc(num); lcd_putc_at(19, menu_row, type_char); } /* int menu_draw_item_puts_P_int16(char type_char, const char* str, int16_t val, ) { lcd_set_cursor(0, menu_row); int cnt = lcd_printf_P(PSTR("%c%-18S%c"), (lcd_encoder == menu_item)?'>':' ', str, type_char); return cnt; } */ void menu_item_dummy(void) { menu_item++; } uint8_t menu_item_text_P(const char* str) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(' ', str); if (menu_clicked && (lcd_encoder == menu_item)) return menu_item_ret(); } menu_item++; return 0; } uint8_t menu_item_submenu_P(const char* str, menu_func_t submenu) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(LCD_STR_ARROW_RIGHT[0], str); if (menu_clicked && (lcd_encoder == menu_item)) { menu_submenu(submenu); return menu_item_ret(); } } menu_item++; return 0; } uint8_t menu_item_submenu_E(const Sheet &sheet, menu_func_t submenu) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_E(LCD_STR_ARROW_RIGHT[0], sheet); if (menu_clicked && (lcd_encoder == menu_item)) { menu_submenu(submenu); return menu_item_ret(); } } menu_item++; return 0; } uint8_t __attribute__((noinline)) menu_item_function_E(const Sheet &sheet, menu_func_t func) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_select_sheet_E(' ', sheet); if (menu_clicked && (lcd_encoder == menu_item)) { menu_clicked = false; lcd_consume_click(); lcd_update_enabled = 0; if (func) func(); lcd_update_enabled = 1; return menu_item_ret(); } } menu_item++; return 0; } uint8_t menu_item_back_P(const char* str) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(LCD_STR_UPLEVEL[0], str); if (menu_clicked && (lcd_encoder == menu_item)) { menu_back(); return menu_item_ret(); } } menu_item++; return 0; } bool __attribute__((noinline)) menu_item_leave(){ return ((menu_item == menu_line) && menu_clicked && (lcd_encoder == menu_item)) || menu_leaving; } uint8_t menu_item_function_P(const char* str, menu_func_t func) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(' ', str); if (menu_clicked && (lcd_encoder == menu_item)) { menu_clicked = false; lcd_consume_click(); lcd_update_enabled = 0; if (func) func(); lcd_update_enabled = 1; return menu_item_ret(); } } menu_item++; return 0; } //! @brief Menu item function taking single parameter //! //! Ideal for numbered lists calling functions with number parameter. //! @param str Item caption //! @param number aditional character to be added after str, e.g. number //! @param func pointer to function taking uint8_t with no return value //! @param fn_par value to be passed to function //! @retval 0 //! @retval 1 Item was clicked uint8_t menu_item_function_P(const char* str, char number, void (*func)(uint8_t), uint8_t fn_par) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(' ', str, number); if (menu_clicked && (lcd_encoder == menu_item)) { menu_clicked = false; lcd_consume_click(); lcd_update_enabled = 0; if (func) func(fn_par); lcd_update_enabled = 1; return menu_item_ret(); } } menu_item++; return 0; } uint8_t menu_item_toggle_P(const char* str, const char* toggle, menu_func_t func, const uint8_t settings) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_toggle_puts_P(str, toggle, settings | (menu_selection_mark()=='>')); if (menu_clicked && (lcd_encoder == menu_item)) { if (toggle == NULL) // print N/A warning message { menu_submenu(func); return menu_item_ret(); } else // do the actual toggling { menu_clicked = false; lcd_consume_click(); lcd_update_enabled = 0; if (func) func(); lcd_update_enabled = 1; return menu_item_ret(); } } } menu_item++; return 0; } uint8_t menu_item_gcode_P(const char* str, const char* str_gcode) { if (menu_item == menu_line) { if (lcd_draw_update) menu_draw_item_puts_P(' ', str); if (menu_clicked && (lcd_encoder == menu_item)) { if (str_gcode) enquecommand_P(str_gcode); return menu_item_ret(); } } menu_item++; return 0; } const char menu_fmt_int3[] PROGMEM = "%c%.15S:%s%3d"; const char menu_fmt_float31[] PROGMEM = "%-12.12S%+8.1f"; const char menu_fmt_float13[] PROGMEM = "%c%-13.13S%+5.3f"; template static void menu_draw_P(char chr, const char* str, int16_t val); template<> void menu_draw_P(char chr, const char* str, int16_t val) { int text_len = strlen_P(str); if (text_len > 15) text_len = 15; char spaces[LCD_WIDTH + 1] = {0}; memset(spaces,' ', LCD_WIDTH); if (val <= -100) spaces[15 - text_len - 1] = 0; else spaces[15 - text_len] = 0; lcd_printf_P(menu_fmt_int3, chr, str, spaces, val); } template<> void menu_draw_P(char chr, const char* str, int16_t val) { menu_data_edit_t* _md = (menu_data_edit_t*)&(menu_data[0]); float factor = 1.0f + static_cast(val) / 1000.0f; if (val <= _md->minEditValue) { menu_draw_toggle_puts_P(str, _T(MSG_OFF), 0x04 | 0x02 | (chr=='>')); } else { lcd_printf_P(menu_fmt_float13, chr, str, factor); } } //! @brief Draw up to 10 chars of text and a float number in format from +0.0 to +12345.0. The increased range is necessary //! for displaying large values of extruder positions, which caused text overflow in the previous implementation. //! //! @param str string label to print //! @param val value to print aligned to the right side of the display //! //! Implementation comments: //! The text needs to come with a colon ":", this function does not append it anymore. //! That resulted in a much shorter implementation (234628B -> 234476B) //! There are similar functions around which may be shortened in a similar way void menu_draw_float31(const char* str, float val) { lcd_printf_P(menu_fmt_float31, str, val); } //! @brief Draw up to 14 chars of text and a float number in format +1.234 //! //! @param str string label to print //! @param val value to print aligned to the right side of the display //! //! Implementation comments: //! This function uses similar optimization principles as menu_draw_float31 //! (i.e. str must include a ':' at its end) //! FLASH usage dropped 234476B -> 234392B //! Moreover, this function gets inlined in the final code, so removing it doesn't really help ;) void menu_draw_float13(const char* str, float val) { lcd_printf_P(menu_fmt_float13, ' ', str, val); } template static void _menu_edit_P(void) { menu_data_edit_t* _md = (menu_data_edit_t*)&(menu_data[0]); if (lcd_draw_update) { if (lcd_encoder < _md->minEditValue) lcd_encoder = _md->minEditValue; if (lcd_encoder > _md->maxEditValue) lcd_encoder = _md->maxEditValue; lcd_set_cursor(0, 1); menu_draw_P(' ', _md->editLabel, (int)lcd_encoder); } if (LCD_CLICKED) { *((T)(_md->editValue)) = lcd_encoder; menu_back_no_reset(); } } template uint8_t menu_item_edit_P(const char* str, T pval, int16_t min_val, int16_t max_val) { menu_data_edit_t* _md = (menu_data_edit_t*)&(menu_data[0]); if (menu_item == menu_line) { if (lcd_draw_update) { lcd_set_cursor(0, menu_row); menu_draw_P(menu_selection_mark(), str, *pval); } if (menu_clicked && (lcd_encoder == menu_item)) { menu_submenu_no_reset(_menu_edit_P); _md->editLabel = str; _md->editValue = pval; _md->minEditValue = min_val; _md->maxEditValue = max_val; lcd_encoder = *pval; return menu_item_ret(); } } menu_item++; return 0; } template uint8_t menu_item_edit_P(const char* str, int16_t *pval, int16_t min_val, int16_t max_val); template uint8_t menu_item_edit_P(const char* str, uint8_t *pval, int16_t min_val, int16_t max_val); #undef _menu_data