Action Commands

Action commands are a feature defined for the GCODE based RepRap communication protocol. To quote from the GCODE node of the RepRap wiki:

The RepRap machine may also send lines that look like this:

// This is some debugging or other information on a line on its own. It may be sent at any time.

Such lines will always be preceded by //.

On the latest version of Pronterface and […] OctoPrint a special comment of the form:

// action:command

is allowed to be sent from the firmware[. T]he command can currently be pause, resume or disconnect which will execute those commands on the host. As this is also a comment other hosts will just ignored these commands.

OctoPrint out of the box supports handling of the above mentioned commands:

cancel
When this command is received from the printer, OctoPrint will cancel a current print job like if the “Cancel” button had been clicked.
pause
When this command is received from the printer, OctoPrint will pause a current print job just like if the “Pause” button had been clicked.
paused
When this command is received from the printer, OctoPrint will pause a current print job but without triggering any GCODE scripts or sending SD print control commands to the printer. This might be interesting for firmware that wants to signal to OctoPrint that a print should be paused but without any control interference from OctoPrint, e.g. in case of a filament change fully managed by the firmware.
resume
When this command is received from the printer, OctoPrint will resume a current print job just like if the “Resume” button had been clicked.
resumed
When this command is received from the printer, OctoPrint will resume a current print job but without triggering any GCODE scripts or sending SD print control commands to the printer. This might be interesting for firmware that wants to signal to OctoPrint that a print should be resumed but without any control interference from OctoPrint, e.g. in case of a filament change fully managed by the firmware.
disconnect
When this command is received from the printer, OctoPrint will immediately disconnect from it.

If the bundled Action Command Prompt Support Plugin is enabled (which should be the case by default), OctoPrint will also interactive dialog creation through its supported commands.

Support for additional commands may be added by plugins by implementing a handler for the octoprint.comm.protocol.action hook.