aboutsummaryrefslogtreecommitdiffstats
path: root/docs/Config_Reference.md
diff options
context:
space:
mode:
authorDmitry Butyugin <dmbutyugin@google.com>2025-05-23 01:44:47 +0200
committerKevinOConnor <kevin@koconnor.net>2025-06-04 13:40:58 -0400
commit4d4b9684a53fa7e776914b222cdab21f870dad76 (patch)
tree1293fe6e5bbc52d01d502cdbfff625a5821e0e7d /docs/Config_Reference.md
parent14cbb8dd2db14a473fe0a01c626d9bbecc420144 (diff)
downloadkutter-4d4b9684a53fa7e776914b222cdab21f870dad76.tar.gz
kutter-4d4b9684a53fa7e776914b222cdab21f870dad76.tar.xz
kutter-4d4b9684a53fa7e776914b222cdab21f870dad76.zip
input_shaper: Track kinematics updates by dual_carriage
Signed-off-by: Dmitry Butyugin <dmbutyugin@google.com>
Diffstat (limited to 'docs/Config_Reference.md')
-rw-r--r--docs/Config_Reference.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/Config_Reference.md b/docs/Config_Reference.md
index 9dbcae06..d9125d47 100644
--- a/docs/Config_Reference.md
+++ b/docs/Config_Reference.md
@@ -2482,6 +2482,27 @@ carriages: u-y
...
```
+`[dual_carriage]` requires special configuration for the input shaper.
+In general, it is necessary to run input shaper calibration twice -
+for the `dual_carriage` and its `primary_carriage` for the axis they
+share. Then the input shaper can be configured as follows, assuming the
+example above:
+```
+[input_shaper]
+# Intentionally empty
+
+[delayed_gcode init_shaper]
+initial_duration: 0.1
+gcode:
+ SET_DUAL_CARRIAGE CARRIAGE=u
+ SET_INPUT_SHAPER SHAPER_TYPE_X=<dual_carriage_x_shaper> SHAPER_FREQ_X=<dual_carriage_x_freq> SHAPER_TYPE_Y=<y_shaper> SHAPER_FREQ_Y=<y_freq>
+ SET_DUAL_CARRIAGE CARRIAGE=x
+ SET_INPUT_SHAPER SHAPER_TYPE_X=<primary_carriage_x_shaper> SHAPER_FREQ_X=<primary_carriage_x_freq> SHAPER_TYPE_Y=<y_shaper> SHAPER_FREQ_Y=<y_freq>
+```
+Note that `SHAPER_TYPE_Y` and `SHAPER_FREQ_Y` must be the same in both
+commands in this case, since the same motors drive Y axis when either
+of the `x` and `u` carriages are active.
+
It is worth noting that `generic_cartesian` kinematic can support two
dual carriages for X and Y axes. For reference, see for instance a
[sample](../config/sample-corexyuv.cfg) of CoreXYUV configuration.