diff options
| author | Jason S. McMullan <jason.mcmullan@gmail.com> | 2021-04-17 06:54:12 -0400 |
|---|---|---|
| committer | KevinOConnor <kevin@koconnor.net> | 2021-05-26 11:57:57 -0400 |
| commit | 913649de2e8057e849be2a54e08d34302ee37dad (patch) | |
| tree | b7461d6351d46c73a5ad10e3aa49e7b8ad8facae /docs | |
| parent | 4ea434796bb1f5bcc9d44bfcd0d9d66b8476faa9 (diff) | |
| download | kutter-913649de2e8057e849be2a54e08d34302ee37dad.tar.gz kutter-913649de2e8057e849be2a54e08d34302ee37dad.tar.xz kutter-913649de2e8057e849be2a54e08d34302ee37dad.zip | |
loop_sdcard: Add loopable SD card file sections
To support continuous belt printing, add nestable repeat
loop support via an `[sdcard_loop]` module.
Supported G-Code:
- SDCARD_LOOP_BEGIN COUNT=n ; Loop for N times, or infinitely if N is 0
- SDCARD_LOOP_END ; End of loop
- SDCARD_LOOP_DESIST ; Complete all loops without iterating
Marlin M808 compatibility example in `config/sample-macros.cfg`:
- M808 Ln ; Loop for N times, or infinitely if N is 0
- M808 ; End of loop
- M808 K ; Complete all loops without iterating
Added unit tests in test/klippy/sdcard_loop.test
See https://reprap.org/wiki/G-code#M808:_Set_or_Goto_Repeat_Marker
Signed-off-by: Jason S. McMullan <jason.mcmullan@gmail.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/Config_Reference.md | 14 | ||||
| -rw-r--r-- | docs/G-Codes.md | 7 |
2 files changed, 21 insertions, 0 deletions
diff --git a/docs/Config_Reference.md b/docs/Config_Reference.md index 30c2468a..812dd7a9 100644 --- a/docs/Config_Reference.md +++ b/docs/Config_Reference.md @@ -1312,6 +1312,20 @@ path: # be provided. ``` +## [sdcard_loop] + +Some printers with stage-clearing features, such as a part ejector or +a belt printer, can find use in looping sections of the sdcard file. +(For example, to print the same part over and over, or repeat the +a section of a part for a chain or other repeated pattern). + +See the `config/sample-macros.cfg` file for a Marlin compatible M808 +G-Code macro. + +``` +[sdcard_loop] +``` + ## [force_move] Support manually moving stepper motors for diagnostic purposes. Note, diff --git a/docs/G-Codes.md b/docs/G-Codes.md index 2f012bf5..cb84fa65 100644 --- a/docs/G-Codes.md +++ b/docs/G-Codes.md @@ -66,6 +66,13 @@ In addition, the following extended commands are availble when the - Load a file and start SD print: `SDCARD_PRINT_FILE FILENAME=<filename>` - Unload file and clear SD state: `SDCARD_RESET_FILE` +When the [sdcard_loop config section](Config_Reference.md#sdcard_loop) is +enabled, the following extended commands are available. +- Begin a looped section in the SD print: `SDCARD_LOOP_BEGIN COUNT=<count>` + - A count of 0 indicates that the section should be looped indefinately. +- End a looped section in the SD print: `SDCARD_LOOP_END` +- Complete existing loops without further iterations: `SDCARD_LOOP_DESIST` + ## G-Code arcs The following standard G-Code commands are available if a |