3diy
/
moonraker
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: update documenation for "power on queued" changes 

Signed-off-by:  Eric Callahan <arksine.code@gmail.com>
This commit is contained in:
Eric Callahan 2022-02-23 09:13:54 -05:00
parent 7ab1dda772
commit 8ff54e2372
3 changed files with 33 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -43,7 +43,7 @@ to see if any action is necessary on their part. The date of the most
recent change is included. recent change is included.
Users:\ Users:\
[user_changes.md](https://moonraker.readthedocs.io/en/latest/user_changes/) - December 24th 2021 [user_changes.md](https://moonraker.readthedocs.io/en/latest/user_changes/) - Febuary 22nd 2022
Developers:\ Developers:\
[api_changes.md](https://moonraker.readthedocs.io/en/latest/api_changes/) - March 15th 2021 [api_changes.md](https://moonraker.readthedocs.io/en/latest/api_changes/) - March 15th 2021

43
docs/configuration.md
View File

@ -358,11 +358,11 @@ off_when_shutdown: False
off_when_shutdown_delay: 0 off_when_shutdown_delay: 0
# If "off_when_shutdown" is set, this option specifies the amount of time # If "off_when_shutdown" is set, this option specifies the amount of time
# (in seconds) to wait before turning the device off. Default is 0 seconds. # (in seconds) to wait before turning the device off. Default is 0 seconds.
on_when_upload_queued: False on_when_job_queued: False
# If set to True the device will power on if the file manager # If set to True the device will power on if a job is queued while the
# queues an upload while the device is off. This allows for an automated # device is off. This allows for an automated "upload, power on, and
# "upload, power on, and print" approach directly from the slicer, see # print" approach directly from the slicer, see the configuration example
# the configuration example below for details. The default is False. # below for details. The default is False.
locked_while_printing: False locked_while_printing: False
# If True, locks the device so that the power cannot be changed while the # If True, locks the device so that the power cannot be changed while the
# printer is printing. This is useful to avert an accidental shutdown to # printer is printing. This is useful to avert an accidental shutdown to
@ -968,9 +968,11 @@ gcode:
#### Power on G-Code Uploads #### Power on G-Code Uploads
The following is an example configuration that would fully automate To power on a device after an upload, `queue_gcode_uploads: True` must
the process of powering on a printer and loading a print from a be set in the `[file_manager]`, `load_on_startup: True` must be set in
Slicer upload with the "start" flag enabled. `[job_queue]` and `one_when_job_queued: True` must be set in `[power dev_name]`,
where "dev_name" the the name of your power device. For example:
```ini ```ini
# moonraker.conf # moonraker.conf
@ -980,8 +982,8 @@ Slicer upload with the "start" flag enabled.
[file_manager] [file_manager]
queue_gcode_uploads: True queue_gcode_uploads: True
# Set the config_path and log_path options to the correct locations # Set the config_path and log_path options to the correct locations
config_path: #config_path:
log_path: #log_path:
# Configure the Job Queue to start a queued print when Klipper reports as # Configure the Job Queue to start a queued print when Klipper reports as
# ready. # ready.
@ -990,14 +992,14 @@ load_on_startup: True
# Configure the job_transition_delay and job_transition_gcode options # Configure the job_transition_delay and job_transition_gcode options
# if desired. Note that they do no apply to prints loaded on startup. # if desired. Note that they do no apply to prints loaded on startup.
# Configure the "power" device to turn on when uploads are queued. # Configure the "power" device to turn on when jobs are queued.
[power printer] [power printer]
type: gpio on_when_job_queued: True
pin: gpio26 # configure the type and any type specific options. This example
initial_state: off # uses a gpio
# Power the printer on when the file manager queues an upload #type: gpio
on_when_upload_queued: True #pin: gpio26
bound_service: klipper #initial_state: off
``` ```
With the above configuration options set, an upload with the "start" With the above configuration options set, an upload with the "start"
@ -1105,8 +1107,11 @@ info_tags:
This second example is for "applications". These may be git repositories This second example is for "applications". These may be git repositories
or zipped distributions. or zipped distributions.
Note that git repos must have at least one tag for Moonraker !!! Note
to identify its version. Git repos must have at least one tag for Moonraker to identify its
version. The tag may be lightweight or annotated. The tag must be in
semantic version format, `vX.Y.Z`, where X, Y, and Z are all unsigned
integer values. For example, a repos first tag might be `v0.0.1`.
```ini ```ini
# moonraker.conf # moonraker.conf

8
docs/user_changes.md
View File

@ -2,6 +2,14 @@
This file will track changes that require user intervention, This file will track changes that require user intervention,
such as a configuration change or a reinstallation. such as a configuration change or a reinstallation.
### Feburary 22nd 2022
- The `on_when_upload_queued` option for [power] devices has been
deprecated in favor of `on_when_job_queued`. As the new option
name implies, this option will power on the device when any new
job is queued, not only when its sourced from an upload. The
`on_when_upload_queued` option will be treated as an alias to
`on_when_job_queued` until its removal.
### February 16th 2022 ### February 16th 2022
- Webcam settings can now be defined in the `moonraker.conf` file, under - Webcam settings can now be defined in the `moonraker.conf` file, under
the `[octoprint_compat]` section. The default values are being used as the `[octoprint_compat]` section. The default values are being used as