aboutsummaryrefslogtreecommitdiff
path: root/Marlin/src/feature/host_actions.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'Marlin/src/feature/host_actions.cpp')
-rw-r--r--Marlin/src/feature/host_actions.cpp202
1 files changed, 202 insertions, 0 deletions
diff --git a/Marlin/src/feature/host_actions.cpp b/Marlin/src/feature/host_actions.cpp
new file mode 100644
index 0000000..5ba3a3e
--- /dev/null
+++ b/Marlin/src/feature/host_actions.cpp
@@ -0,0 +1,202 @@
+/**
+ * Marlin 3D Printer Firmware
+ * Copyright (c) 2020 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 <https://www.gnu.org/licenses/>.
+ *
+ */
+
+#include "../inc/MarlinConfig.h"
+
+#if ENABLED(HOST_ACTION_COMMANDS)
+
+#include "host_actions.h"
+
+//#define DEBUG_HOST_ACTIONS
+
+#if ENABLED(ADVANCED_PAUSE_FEATURE)
+ #include "pause.h"
+ #include "../gcode/queue.h"
+#endif
+
+#if HAS_FILAMENT_SENSOR
+ #include "runout.h"
+#endif
+
+void host_action(PGM_P const pstr, const bool eol) {
+ PORT_REDIRECT(SERIAL_ALL);
+ SERIAL_ECHOPGM("//action:");
+ serialprintPGM(pstr);
+ if (eol) SERIAL_EOL();
+}
+
+#ifdef ACTION_ON_KILL
+ void host_action_kill() { host_action(PSTR(ACTION_ON_KILL)); }
+#endif
+#ifdef ACTION_ON_PAUSE
+ void host_action_pause(const bool eol/*=true*/) { host_action(PSTR(ACTION_ON_PAUSE), eol); }
+#endif
+#ifdef ACTION_ON_PAUSED
+ void host_action_paused(const bool eol/*=true*/) { host_action(PSTR(ACTION_ON_PAUSED), eol); }
+#endif
+#ifdef ACTION_ON_RESUME
+ void host_action_resume() { host_action(PSTR(ACTION_ON_RESUME)); }
+#endif
+#ifdef ACTION_ON_RESUMED
+ void host_action_resumed() { host_action(PSTR(ACTION_ON_RESUMED)); }
+#endif
+#ifdef ACTION_ON_CANCEL
+ void host_action_cancel() { host_action(PSTR(ACTION_ON_CANCEL)); }
+#endif
+#ifdef ACTION_ON_START
+ void host_action_start() { host_action(PSTR(ACTION_ON_START)); }
+#endif
+
+#if ENABLED(HOST_PROMPT_SUPPORT)
+
+ PGMSTR(CONTINUE_STR, "Continue");
+ PGMSTR(DISMISS_STR, "Dismiss");
+
+ #if HAS_RESUME_CONTINUE
+ extern bool wait_for_user;
+ #endif
+
+ PromptReason host_prompt_reason = PROMPT_NOT_DEFINED;
+
+ void host_action_notify(const char * const message) {
+ PORT_REDIRECT(SERIAL_ALL);
+ host_action(PSTR("notification "), false);
+ SERIAL_ECHOLN(message);
+ }
+
+ void host_action_notify_P(PGM_P const message) {
+ PORT_REDIRECT(SERIAL_ALL);
+ host_action(PSTR("notification "), false);
+ serialprintPGM(message);
+ SERIAL_EOL();
+ }
+
+ void host_action_prompt(PGM_P const ptype, const bool eol=true) {
+ PORT_REDIRECT(SERIAL_ALL);
+ host_action(PSTR("prompt_"), false);
+ serialprintPGM(ptype);
+ if (eol) SERIAL_EOL();
+ }
+
+ void host_action_prompt_plus(PGM_P const ptype, PGM_P const pstr, const char extra_char='\0') {
+ host_action_prompt(ptype, false);
+ PORT_REDIRECT(SERIAL_ALL);
+ SERIAL_CHAR(' ');
+ serialprintPGM(pstr);
+ if (extra_char != '\0') SERIAL_CHAR(extra_char);
+ SERIAL_EOL();
+ }
+ void host_action_prompt_begin(const PromptReason reason, PGM_P const pstr, const char extra_char/*='\0'*/) {
+ host_action_prompt_end();
+ host_prompt_reason = reason;
+ host_action_prompt_plus(PSTR("begin"), pstr, extra_char);
+ }
+ void host_action_prompt_button(PGM_P const pstr) { host_action_prompt_plus(PSTR("button"), pstr); }
+ void host_action_prompt_end() { host_action_prompt(PSTR("end")); }
+ void host_action_prompt_show() { host_action_prompt(PSTR("show")); }
+
+ void _host_prompt_show(PGM_P const btn1/*=nullptr*/, PGM_P const btn2/*=nullptr*/) {
+ if (btn1) host_action_prompt_button(btn1);
+ if (btn2) host_action_prompt_button(btn2);
+ host_action_prompt_show();
+ }
+ void host_prompt_do(const PromptReason reason, PGM_P const pstr, PGM_P const btn1/*=nullptr*/, PGM_P const btn2/*=nullptr*/) {
+ host_action_prompt_begin(reason, pstr);
+ _host_prompt_show(btn1, btn2);
+ }
+ void host_prompt_do(const PromptReason reason, PGM_P const pstr, const char extra_char, PGM_P const btn1/*=nullptr*/, PGM_P const btn2/*=nullptr*/) {
+ host_action_prompt_begin(reason, pstr, extra_char);
+ _host_prompt_show(btn1, btn2);
+ }
+
+ void filament_load_host_prompt() {
+ const bool disable_to_continue = TERN0(HAS_FILAMENT_SENSOR, runout.filament_ran_out);
+ host_prompt_do(PROMPT_FILAMENT_RUNOUT, PSTR("Paused"), PSTR("PurgeMore"),
+ disable_to_continue ? PSTR("DisableRunout") : CONTINUE_STR
+ );
+ }
+
+ //
+ // Handle responses from the host, such as:
+ // - Filament runout responses: Purge More, Continue
+ // - General "Continue" response
+ // - Resume Print response
+ // - Dismissal of info
+ //
+ void host_response_handler(const uint8_t response) {
+ #ifdef DEBUG_HOST_ACTIONS
+ static PGMSTR(m876_prefix, "M876 Handle Re");
+ serialprintPGM(m876_prefix); SERIAL_ECHOLNPAIR("ason: ", host_prompt_reason);
+ serialprintPGM(m876_prefix); SERIAL_ECHOLNPAIR("sponse: ", response);
+ #endif
+ PGM_P msg = PSTR("UNKNOWN STATE");
+ const PromptReason hpr = host_prompt_reason;
+ host_prompt_reason = PROMPT_NOT_DEFINED; // Reset now ahead of logic
+ switch (hpr) {
+ case PROMPT_FILAMENT_RUNOUT:
+ msg = PSTR("FILAMENT_RUNOUT");
+ switch (response) {
+
+ case 0: // "Purge More" button
+ #if BOTH(HAS_LCD_MENU, ADVANCED_PAUSE_FEATURE)
+ pause_menu_response = PAUSE_RESPONSE_EXTRUDE_MORE; // Simulate menu selection (menu exits, doesn't extrude more)
+ #endif
+ filament_load_host_prompt(); // Initiate another host prompt. (NOTE: The loop in load_filament may also do this!)
+ break;
+
+ case 1: // "Continue" / "Disable Runout" button
+ #if BOTH(HAS_LCD_MENU, ADVANCED_PAUSE_FEATURE)
+ pause_menu_response = PAUSE_RESPONSE_RESUME_PRINT; // Simulate menu selection
+ #endif
+ #if HAS_FILAMENT_SENSOR
+ if (runout.filament_ran_out) { // Disable a triggered sensor
+ runout.enabled = false;
+ runout.reset();
+ }
+ #endif
+ break;
+ }
+ break;
+ case PROMPT_USER_CONTINUE:
+ TERN_(HAS_RESUME_CONTINUE, wait_for_user = false);
+ msg = PSTR("FILAMENT_RUNOUT_CONTINUE");
+ break;
+ case PROMPT_PAUSE_RESUME:
+ msg = PSTR("LCD_PAUSE_RESUME");
+ #if ENABLED(ADVANCED_PAUSE_FEATURE)
+ extern const char M24_STR[];
+ queue.inject_P(M24_STR);
+ #endif
+ break;
+ case PROMPT_INFO:
+ msg = PSTR("GCODE_INFO");
+ break;
+ default: break;
+ }
+ SERIAL_ECHOPGM("M876 Responding PROMPT_");
+ serialprintPGM(msg);
+ SERIAL_EOL();
+ }
+
+#endif // HOST_PROMPT_SUPPORT
+
+#endif // HOST_ACTION_COMMANDS