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:
- start
When this command is received from the printer, a job is currently selected and not active, OctoPrint will start it just like if the “Start”/”Restart” button had been clicked.
New in version 1.5.0.
- cancel
When this command is received from the printer, OctoPrint will cancel a current print job just 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.
- sd_inserted
When this command is received from the printer, OctoPrint will assume an SD card is present in the printer, set the corresponding internal state flags and send a file list request. This command is only recognized if SD support is enabled in OctoPrint.
New in version 1.6.0.
- sd_ejected
When this command is received from the printer, OctoPrint will assume the SD card has been removed from the printer and clear the corresponding internal state flags. This command is only recognized if SD support is enabled in OctoPrint.
New in version 1.6.0.
- sd_updated
When this command is received from the printer, OctoPrint will assume something on the SD card in the printer has changed and trigger a file list request. This command is only recognized if SD support is enabled in OctoPrint.
New in version 1.6.0.
- shutdown
When this command is received from the printer, support for it is enabled in its settings and a working system shutdown command is configured, OctoPrint will immediately shutdown the system. This command is not enabled by default due to the high risk of seeing it abused by malicious firmware or manipulated GCODE, but can be enabled in the OctoPrint settings via Serial Connection > Firmware & Protocol > Action Commands if so desired by the user.
New in version 1.8.0.
If the bundled Action Command Prompt Support Plugin is enabled (which should be the case by default), OctoPrint will also support 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.