docs: document remote method calls

This updates the "PANELDUE_BEEP" gcode macro to use the "paneldue_beep" remote method.  Also included is documentation on the "set_device_power" method added to the power plugin.

Signed-off-by:  Eric Callahan <arksine.code@gmail.com>
This commit is contained in:
Arksine 2020-11-01 14:54:07 -05:00
parent 59d27e6829
commit e5f3aeca78
1 changed files with 31 additions and 7 deletions

View File

@ -240,17 +240,14 @@ in the PanelDue's "macro" menu.
Note that buzzing the piezo requires the following gcode_macro in `printer.cfg`: Note that buzzing the piezo requires the following gcode_macro in `printer.cfg`:
``` ```
[gcode_macro PANELDUE_BEEP] [gcode_macro PANELDUE_BEEP]
variable_sequence: 0
variable_frequency: 0
variable_duration: 0
# Beep frequency # Beep frequency
default_parameter_FREQUENCY: 300 default_parameter_FREQUENCY: 300
# Beep duration in seconds # Beep duration in seconds
default_parameter_DURATION: 1. default_parameter_DURATION: 1.
gcode: gcode:
SET_GCODE_VARIABLE MACRO=PANELDUE_BEEP VARIABLE=frequency VALUE={FREQUENCY|int} {action_call_remote_method("paneldue_beep",
SET_GCODE_VARIABLE MACRO=PANELDUE_BEEP VARIABLE=duration VALUE={DURATION|float} frequency=FREQUENCY|int,
SET_GCODE_VARIABLE MACRO=PANELDUE_BEEP VARIABLE=sequence VALUE={printer["gcode_macro PANELDUE_BEEP"].sequence|int + 1} duration=DURATION|float)}
``` ```
#### Power Control Plugin #### Power Control Plugin
@ -282,5 +279,32 @@ that you listed under devices.
Each device can have a Friendly Name, pin, and activehigh set. Pin is the only Each device can have a Friendly Name, pin, and activehigh set. Pin is the only
required option. For devices that should be active when the signal is 0 or low, required option. For devices that should be active when the signal is 0 or low,
set {dev}_activehigh to False, otherwise don't put the option in the set {dev}_active_low to False, otherwise don't put the option in the
configuration. configuration.
It is possible to toggle device power from the Klippy host, this can be done
with a gcode_macro, such as:
```
[gcode_macro POWER_OFF_PRINTER]
gcode:
{action_call_remote_method("set_device_power",
device="printer",
state="off")}
```
The `POWER_OFF_PRINTER` gcode can be run to turn off the "printer" device.
This could be used in conjunction with Klipper's idle timeout to turn the
printer off when idle with a configuration similar to that of below:
```
[delayed_gcode delayed_printer_off]
initial_duration: 0.
gcode:
{% if printer.idle_timeout.state == "Idle" %}
POWER_OFF_PRINTER
{% endif %}
[idle_timeout]
gcode:
TURN_OFF_MOTORS
TURN_OFF_HEATERS
UPDATE_DELAYED_GCODE ID=delayed_printer_off DURATION=60
```