Updated documentation of events
parent
be99930021
commit
624630ac63
|
@ -0,0 +1,61 @@
|
||||||
|
TODO: Add to config documentation
|
||||||
|
|
||||||
|
There are two types of event handlers at the moment:
|
||||||
|
* ''systemCommandTrigger'': invokes an external command without waiting for the result
|
||||||
|
* ''gcodeCommandTrigger'': sends some gcode to the printer. Separate multiple commands with a comma
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
events:
|
||||||
|
systemCommandTrigger:
|
||||||
|
enabled: True
|
||||||
|
subscriptions:
|
||||||
|
- event: Disconnected
|
||||||
|
command: python ~/growl.py -t mygrowlserver -d "Lost connection to printer" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
||||||
|
- event: PrintStarted
|
||||||
|
command: python ~/growl.py -t mygrowlserver -d "Starting _FILE_" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
||||||
|
- event: PrintDone
|
||||||
|
command: python ~/growl.py -t mygrowlserver -d "Completed _FILE_" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
||||||
|
gcodeCommandTrigger:
|
||||||
|
enabled: True
|
||||||
|
subscriptions:
|
||||||
|
- event: Connected
|
||||||
|
command: M115,M17 printer connected!,G28
|
||||||
|
|
||||||
|
|
||||||
|
command values support the following dynamic tokens:
|
||||||
|
* ''%(data)s'': the data associated with the event (not all events have data, when they do, it's often a filename)
|
||||||
|
* ''%(filename)s'': filename of the current print (not always the same as _DATA_ filename)
|
||||||
|
* ''%(progress)s'': the progress of the print in percent
|
||||||
|
* ''%(zheight)s'': the current Z position of the head
|
||||||
|
* ''%(now)s'': the date and time of the event in ISO 8601
|
||||||
|
|
||||||
|
Available Events:
|
||||||
|
|
||||||
|
* ''Startup'': the server has started
|
||||||
|
* ''Connected'': the server has connected to the printer (data is port and baudrate)
|
||||||
|
* ''Disconnected'': the server has disconnected from the printer
|
||||||
|
* ''ClientOpen'': a client has connected to the web server
|
||||||
|
* ''ClientClosed'': a client has disconnected from the web server
|
||||||
|
* ''PowerOn'': the GCode has turned on the printer power via M80
|
||||||
|
* ''PowerOff'': the GCode has turned on the printer power via M81
|
||||||
|
* ''Upload'': a gcode file upload has been uploaded (data is filename)
|
||||||
|
* ''LoadStart'': a gcode file load has started (data is filename)
|
||||||
|
* ''LoadDone'': a gcode file load has finished (data is filename)
|
||||||
|
* ''PrintStarted'': a print has started
|
||||||
|
* ''PrintFailed'': a print failed
|
||||||
|
* ''PrintDone'': a print completed successfully
|
||||||
|
* ''Cancelled'': the print has been cancelled via the cancel button
|
||||||
|
* ''Home'': the head has gone home via G28
|
||||||
|
* ''ZChange'': the printer's Z-Height has changed (new layer)
|
||||||
|
* ''Paused'': the print has been paused
|
||||||
|
* ''Waiting'': the print is paused due to a gcode wait command
|
||||||
|
* ''Cooling'': the GCode has enabled the platform cooler via M245
|
||||||
|
* ''Alert'': the GCode has issued a user alert (beep) via M300
|
||||||
|
* ''Conveyor'': the GCode has enabled the conveyor belt via M240
|
||||||
|
* ''Eject'': the GCode has enabled the part ejector via M40
|
||||||
|
* ''CaptureStart'': a timelapse image is starting to be captured (data is image filename)
|
||||||
|
* ''CaptureDone'': a timelapse image has completed being captured (data is image filename)
|
||||||
|
* ''MovieDone'': the timelapse movie is completed (data is movie filename)
|
||||||
|
* ''EStop'': the GCode has issued a panic stop via M112
|
||||||
|
* ''Error'': an error has occurred (data is error string)
|
|
@ -1,63 +0,0 @@
|
||||||
Add to the "system:" section of config.yaml
|
|
||||||
|
|
||||||
There are two types of event handlers at the moment:
|
|
||||||
system: invokes an external command without waiting for the result
|
|
||||||
gcode: sends some gcode to the printer. Separate multiple commands with a comma
|
|
||||||
|
|
||||||
Example:
|
|
||||||
system:
|
|
||||||
events:
|
|
||||||
- event: Connected
|
|
||||||
type: gcode
|
|
||||||
command: M115,M17 printer connected!,G28
|
|
||||||
- event: Disconnected
|
|
||||||
type: system
|
|
||||||
command: python ~/growl.py -t mygrowlserver -d "Lost connection to printer" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
|
||||||
- event: PrintStarted
|
|
||||||
type: system
|
|
||||||
command: python ~/growl.py -t mygrowlserver -d "Starting _FILE_" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
|
||||||
- event: PrintDone
|
|
||||||
type: system
|
|
||||||
command: python ~/growl.py -t mygrowlserver -d "Completed _FILE_" -a OctoPrint -i http://rasppi:8080/Octoprint_logo.png
|
|
||||||
|
|
||||||
command values support the following dynamic tokens:
|
|
||||||
_DATA_ - the data associated with the event (not all events have data, when they do, it's often a filename)
|
|
||||||
_FILE_ - filename of the current print (not always the same as _DATA_ filename)
|
|
||||||
_LINE_ - the current GCode line
|
|
||||||
_PROGRESS_ - the percent complete
|
|
||||||
_ZHEIGHT_ - the current Z position of the head
|
|
||||||
_NOW_ - the date and time of the event
|
|
||||||
|
|
||||||
|
|
||||||
Available Events:
|
|
||||||
|
|
||||||
Startup -- the server has started
|
|
||||||
Connected -- the server has connected to the printer (data is port and baudrate)
|
|
||||||
Disconnected -- the server has disconnected from the printer
|
|
||||||
ClientOpen -- a client has connected to the web server
|
|
||||||
ClientClosed -- a client has disconnected from the web server
|
|
||||||
PowerOn -- the GCode has turned on the printer power via M80
|
|
||||||
PowerOff -- the GCode has turned on the printer power via M81
|
|
||||||
Upload -- a gcode file upload has been uploaded (data is filename)
|
|
||||||
LoadStart -- a gcode file load has started (data is filename)
|
|
||||||
LoadDone -- a gcode file load has finished (data is filename)
|
|
||||||
PrintStarted -- a print has started (data is filename)
|
|
||||||
PrintFailed -- a print failed (data is filename)
|
|
||||||
PrintDone -- a print completed successfully (data is filename)
|
|
||||||
Cancelled -- the print has been cancelled via the cancel button (data is filename)
|
|
||||||
Home -- the head has gone home via G28
|
|
||||||
ZChange -- the printer's Z-Height has changed (new layer)
|
|
||||||
Paused -- the print has been paused
|
|
||||||
Waiting -- the print is paused due to a gcode wait command
|
|
||||||
Cooling -- the GCode has enabled the platform cooler via M245
|
|
||||||
Alert -- the GCode has issued a user alert (beep) via M300
|
|
||||||
Conveyor -- the GCode has enabled the conveyor belt via M240
|
|
||||||
Eject -- the GCode has enabled the part ejector via M40
|
|
||||||
CaptureStart -- a timelapse image is starting to be captured (data is image filename)
|
|
||||||
CaptureDone -- a timelapse image has completed being captured (data is image filename)
|
|
||||||
MovieDone -- the timelapse movie is completed (data is movie filename)
|
|
||||||
EStop -- the GCode has issued a panic stop via M112
|
|
||||||
Error -- an error has occurred (data is error string)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue