From a7f7622f9fede91af990a7ec4ba85aee1abe3b09 Mon Sep 17 00:00:00 2001
From: Mathis Mensing <github@matmen.dev>
Date: Sat, 3 Feb 2024 21:11:30 +0100
Subject: [PATCH] feat(spoolman): multi-tool support (#1324)

Signed-off-by: Mathis Mensing <github@matmen.dev>
Co-authored-by: Pedro Lamas <pedrolamas@gmail.com>
---
 docs/assets/images/spoolman-multitool.png     | Bin 0 -> 34219 bytes
 docs/features/spoolman.md                     |  43 +++++++
 .../widgets/spoolman/SpoolSelectionDialog.vue |  43 ++++++-
 .../widgets/spoolman/SpoolmanCard.vue         | 109 +++++++++++++++++-
 .../widgets/toolhead/ToolChangeCommands.vue   |  24 +++-
 src/locales/de.yaml                           |   5 +-
 src/locales/en.yaml                           |   5 +-
 src/scss/misc.scss                            |   9 ++
 src/store/spoolman/actions.ts                 |   1 -
 src/store/spoolman/getters.ts                 |   6 +-
 src/store/spoolman/state.ts                   |   3 +-
 src/store/spoolman/types.ts                   |  10 ++
 12 files changed, 237 insertions(+), 21 deletions(-)
 create mode 100644 docs/assets/images/spoolman-multitool.png

diff --git a/docs/assets/images/spoolman-multitool.png b/docs/assets/images/spoolman-multitool.png
new file mode 100644
index 0000000000000000000000000000000000000000..ac85254f6bd1739fef5a73a5f8153aa8fba3fada
GIT binary patch
literal 34219
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
NV(+Ad3Iuh({C^879t8jZ

literal 0
HcmV?d00001

diff --git a/docs/features/spoolman.md b/docs/features/spoolman.md
index e8627dd741..7c0e3b948b 100644
--- a/docs/features/spoolman.md
+++ b/docs/features/spoolman.md
@@ -42,3 +42,46 @@ When starting a print or changing spools, Fluidd will automatically perform thes
 1) a spool is selected  
 2) the selected spool has enough filament left on it to finish the print job  
 3) the selected spool's filament type matches the one selected in the slicer  
+
+### Toolchanger Support
+Fluidd supports selecting spools for individual toolchange macros.
+For toolchange macros to show up in the "Change Spool" dropdown, simply add a `spool_id`
+variable to your toolchange `gcode_macro`s with a default value of `None`.
+You will also need to call the [`SET_ACTIVE_SPOOL`](https://moonraker.readthedocs.io/en/latest/configuration#setting-the-active-spool-from-klipper)
+macro in an appropriate place in your toolchange macro.
+
+```yaml
+[gcode_macro T0]
+variable_spool_id: None
+gcode:
+  ...
+  SET_ACTIVE_SPOOL ID={ printer['gcode_macro T0'].spool_id }
+  ...
+```
+
+![screenshot](/assets/images/spoolman-multitool.png)
+
+#### Remembering associated spools across restarts
+By default, Klipper does not keep track of Gcode macro variables across restarts.
+If Fluidd detects a [`[save_variables]`](https://www.klipper3d.org/Config_Reference.html#save_variables)
+section in your configuration, it will automatically emit a `SAVE_VARIABLE` command
+on spool selection, saving the selected spool to the `<MACRO_NAME>__SPOOL_ID` variable.
+
+You can use the following macro to restore the previous selection after a restart:
+{% raw %}
+```sh
+[delayed_gcode RESTORE_SELECTED_SPOOLS]
+initial_duration: 0.1
+gcode:
+  {% set svv = printer.save_variables.variables %}
+  {% for object in printer %}
+    {% if object.startswith('gcode_macro ') and printer[object].spool_id is defined %}
+      {% set macro = object.replace('gcode_macro ', '') %}
+      {% set var = (macro + '__SPOOL_ID')|lower %}
+      {% if svv[var] is defined %}
+        SET_GCODE_VARIABLE MACRO={macro} VARIABLE=spool_id VALUE={svv[var]}
+      {% endif %}
+    {% endif %}
+  {% endfor %}
+```
+{% endraw %}
diff --git a/src/components/widgets/spoolman/SpoolSelectionDialog.vue b/src/components/widgets/spoolman/SpoolSelectionDialog.vue
index 1f857c42dd..7b58c58104 100644
--- a/src/components/widgets/spoolman/SpoolSelectionDialog.vue
+++ b/src/components/widgets/spoolman/SpoolSelectionDialog.vue
@@ -6,7 +6,7 @@
     title-shadow
   >
     <template #title>
-      <span class="focus--text">{{ $t('app.spoolman.title.spool_selection') }}</span>
+      <span class="focus--text">$tc('app.spoolman.title.spool_selection', targetMacro ? 2 : 1, { macro: targetMacro })</span>
 
       <v-spacer />
 
@@ -122,8 +122,8 @@
               <div class="d-flex">
                 <v-icon
                   :color="`#${item.filament.color_hex ?? ($vuetify.theme.dark ? 'fff' : '000')}`"
-                  x-large
-                  class="mr-4 flex-column"
+                  size="42px"
+                  class="mr-4 flex-column spool-icon"
                 >
                   {{ item.id === selectedSpool ? '$markedCircle' : '$filament' }}
                 </v-icon>
@@ -182,7 +182,7 @@
         <v-icon class="mr-2">
           {{ filename ? '$printer' : '$send' }}
         </v-icon>
-        {{ filename ? $t('app.general.btn.print') : $t('app.spoolman.btn.select') }}
+        {{ filename ? $t('app.general.btn.print') : $tc('app.spoolman.btn.select', targetMacro ? 2 : 1, { macro: targetMacro }) }}
       </app-btn>
     </template>
 
@@ -198,7 +198,7 @@
 import { Component, Mixins, Watch } from 'vue-property-decorator'
 import StateMixin from '@/mixins/state'
 import { SocketActions } from '@/api/socketActions'
-import type { Spool } from '@/store/spoolman/types'
+import type { MacroWithSpoolId, Spool } from '@/store/spoolman/types'
 import BrowserMixin from '@/mixins/browser'
 import QRReader from '@/components/widgets/spoolman/QRReader.vue'
 import type { CameraConfig } from '@/store/cameras/types'
@@ -224,6 +224,10 @@ export default class SpoolSelectionDialog extends Mixins(StateMixin, BrowserMixi
   onOpen () {
     if (this.open) {
       this.selectedSpoolId = this.$store.state.spoolman.activeSpool ?? null
+      if (this.targetMacro) {
+        const macro: MacroWithSpoolId | undefined = this.$store.getters['macros/getMacroByName'](this.targetMacro.toLowerCase())
+        this.selectedSpoolId = macro?.variables.spool_id ?? null
+      }
 
       if (this.currentFileName) {
         // prefetch file metadata
@@ -327,6 +331,10 @@ export default class SpoolSelectionDialog extends Mixins(StateMixin, BrowserMixi
     return this.$store.getters['files/getFile'](filepath ? `gcodes/${filepath}` : 'gcodes', filename)
   }
 
+  get targetMacro (): string | undefined {
+    return this.$store.state.spoolman.dialog.targetMacro
+  }
+
   get cameras () {
     const cameras = this.$store.getters['cameras/getEnabledCameras']
       .filter((camera: CameraConfig) => camera.service !== 'iframe')
@@ -444,6 +452,30 @@ export default class SpoolSelectionDialog extends Mixins(StateMixin, BrowserMixi
       }
     }
 
+    if (this.targetMacro) {
+      // set spool_id via SET_GCODE_VARIABLE
+      const commands = [
+        `SET_GCODE_VARIABLE MACRO=${this.targetMacro} VARIABLE=spool_id VALUE=${this.selectedSpool ?? 'None'}`
+      ]
+
+      const supportsSaveVariables = this.$store.getters['printer/getPrinterConfig']('save_variables')
+      if (supportsSaveVariables) {
+        // persist selected spool across restarts
+        commands.push(`SAVE_VARIABLE VARIABLE=${this.targetMacro.toUpperCase()}__SPOOL_ID VALUE=${this.selectedSpool ?? 'None'}`)
+      }
+
+      await SocketActions.printerGcodeScript(commands.join('\n'))
+
+      const macro: MacroWithSpoolId | undefined = this.$store.getters['macros/getMacroByName'](this.targetMacro.toLowerCase())
+      if (macro?.variables.active) {
+        // selected tool is active, update active spool
+        await SocketActions.serverSpoolmanPostSpoolId(this.selectedSpool ?? undefined)
+      }
+
+      this.open = false
+      return
+    }
+
     await SocketActions.serverSpoolmanPostSpoolId(this.selectedSpool ?? undefined)
     if (this.filename) {
       await SocketActions.printerPrintStart(this.filename)
@@ -452,6 +484,7 @@ export default class SpoolSelectionDialog extends Mixins(StateMixin, BrowserMixi
         this.$router.push({ path: '/' })
       }
     }
+
     this.open = false
   }
 
diff --git a/src/components/widgets/spoolman/SpoolmanCard.vue b/src/components/widgets/spoolman/SpoolmanCard.vue
index fbeba57a47..fc1b394dc1 100644
--- a/src/components/widgets/spoolman/SpoolmanCard.vue
+++ b/src/components/widgets/spoolman/SpoolmanCard.vue
@@ -7,13 +7,87 @@
   >
     <template #menu>
       <app-btn
+        v-if="!targetableMacros.length"
         small
         class="ms-1 my-1"
         :disabled="!isConnected"
-        @click="handleSelectSpool"
+        @click="() => handleSelectSpool()"
       >
         {{ $t('app.spoolman.label.change_spool') }}
       </app-btn>
+
+      <v-menu
+        v-else
+        bottom
+        left
+        offset-y
+        transition="slide-y-transition"
+        min-width="150"
+      >
+        <template #activator="{ on, attrs, value }">
+          <app-btn
+            v-bind="attrs"
+            small
+            class="ms-1 my-1"
+            :disabled="!isConnected"
+            v-on="on"
+          >
+            {{ $t('app.spoolman.label.change_spool') }}
+            <v-icon
+              small
+              class="ml-1"
+              :class="{ 'rotate-180': value }"
+            >
+              $chevronDown
+            </v-icon>
+          </app-btn>
+        </template>
+        <v-list dense>
+          <v-list-item @click="() => handleSelectSpool()">
+            <v-list-item-content>
+              <v-list-item-title>
+                {{ $t('app.spoolman.label.active_spool') }}
+              </v-list-item-title>
+            </v-list-item-content>
+
+            <v-list-item-icon
+              v-if="activeSpool"
+            >
+              <v-icon
+                :color="getSpoolColor(activeSpool)"
+                class="spool-icon"
+              >
+                $filament
+              </v-icon>
+            </v-list-item-icon>
+          </v-list-item>
+
+          <template v-for="macro of targetableMacros">
+            <v-list-item
+              :key="macro.name"
+              :class="{primary: macro.variables?.active}"
+              @click="() => handleSelectSpool(macro)"
+            >
+              <v-list-item-content>
+                <v-list-item-title>
+                  {{ macro.name }}
+                </v-list-item-title>
+              </v-list-item-content>
+
+              <v-list-item-icon
+                v-if="macro.variables.spool_id"
+              >
+                <v-icon
+                  :color="getSpoolColor(getSpoolById(macro.variables.spool_id))"
+                  class="spool-icon"
+                >
+                  $filament
+                </v-icon>
+              </v-list-item-icon>
+            </v-list-item>
+          </template>
+        </v-list>
+      </v-menu>
     </template>
 
     <v-progress-linear
@@ -107,8 +181,9 @@
         >
           <v-icon
             v-if="activeSpool"
-            :color="activeSpool.filament.color_hex ? `#${activeSpool.filament.color_hex}` : undefined"
+            :color="getSpoolColor(activeSpool)"
             size="110px"
+            class="spool-icon"
           >
             $filament
           </v-icon>
@@ -134,8 +209,9 @@
 <script lang="ts">
 import { Component, Mixins } from 'vue-property-decorator'
 import StateMixin from '@/mixins/state'
-import type { Spool } from '@/store/spoolman/types'
+import type { MacroWithSpoolId, Spool } from '@/store/spoolman/types'
 import StatusLabel from '@/components/widgets/status/StatusLabel.vue'
+import type { Macro } from '@/store/macros/types'
 
 @Component({
   components: { StatusLabel }
@@ -143,8 +219,11 @@ import StatusLabel from '@/components/widgets/status/StatusLabel.vue'
 export default class SpoolmanCard extends Mixins(StateMixin) {
   labelWidth = '86px'
 
-  handleSelectSpool () {
-    this.$store.commit('spoolman/setDialogState', { show: true })
+  handleSelectSpool (targetMacro?: Macro) {
+    this.$store.commit('spoolman/setDialogState', {
+      show: true,
+      targetMacro: targetMacro?.name
+    })
   }
 
   get activeSpool (): Spool | null {
@@ -155,5 +234,25 @@ export default class SpoolmanCard extends Mixins(StateMixin) {
   get isConnected (): boolean {
     return this.$store.getters['spoolman/getConnected']
   }
+
+  get targetableMacros (): MacroWithSpoolId[] {
+    const macros = this.$store.getters['macros/getMacros'] as Macro[]
+
+    return macros
+      .filter((macro): macro is MacroWithSpoolId => macro.variables != null && 'spool_id' in macro.variables)
+      .map(macro => ({
+        ...macro,
+        name: macro.name.toUpperCase()
+      }))
+      .sort((a, b) => a.name.localeCompare(b.name))
+  }
+
+  getSpoolById (id: number): Spool | undefined {
+    return this.$store.getters['spoolman/getSpoolById'](id)
+  }
+
+  getSpoolColor (spool?: Spool) {
+    return `#${spool?.filament.color_hex ?? (this.$vuetify.theme.dark ? 'fff' : '000')}`
+  }
 }
 </script>
diff --git a/src/components/widgets/toolhead/ToolChangeCommands.vue b/src/components/widgets/toolhead/ToolChangeCommands.vue
index 748b3b3668..48175394c3 100644
--- a/src/components/widgets/toolhead/ToolChangeCommands.vue
+++ b/src/components/widgets/toolhead/ToolChangeCommands.vue
@@ -22,8 +22,15 @@
               v-on="on"
               @click="sendGcode(macro.name)"
             >
+              <v-icon
+                v-if="macro.spoolId && getSpoolById(macro.spoolId)"
+                class="mr-1 spool-icon"
+                :color="getSpoolColor(getSpoolById(macro.spoolId))"
+              >
+                $filament
+              </v-icon>
               <span
-                v-if="macro.color"
+                v-else-if="macro.color"
                 class="extruder-color mr-1"
                 :class="{
                   active: macro.active
@@ -47,12 +54,14 @@ import { Component, Mixins } from 'vue-property-decorator'
 import StateMixin from '@/mixins/state'
 import type { GcodeCommands } from '@/store/printer/types'
 import type { TranslateResult } from 'vue-i18n'
+import type { Spool } from '@/store/spoolman/types'
 
 type ToolChangeCommand = {
   name: string,
   description: string | TranslateResult,
   color?: string,
-  active?: boolean
+  active?: boolean,
+  spoolId?: number
 }
 
 @Component({})
@@ -78,7 +87,8 @@ export default class ToolChangeCommands extends Mixins(StateMixin) {
           name: command,
           description,
           color: macro?.variables?.color ? `#${macro.variables.color}` : undefined,
-          active: macro?.variables?.active ?? false
+          active: macro?.variables?.active ?? false,
+          spoolId: macro?.variables?.spool_id
         } satisfies ToolChangeCommand
       })
       .sort((a, b) => {
@@ -88,6 +98,14 @@ export default class ToolChangeCommands extends Mixins(StateMixin) {
         return numberA - numberB
       })
   }
+
+  getSpoolById (id: number): Spool | undefined {
+    return this.$store.getters['spoolman/getSpoolById'](id)
+  }
+
+  getSpoolColor (spool: Spool | undefined) {
+    return `#${spool?.filament.color_hex ?? (this.$vuetify.theme.dark ? 'fff' : '000')}`
+  }
 }
 </script>
 
diff --git a/src/locales/de.yaml b/src/locales/de.yaml
index 1c04b6a225..de3a97ae60 100644
--- a/src/locales/de.yaml
+++ b/src/locales/de.yaml
@@ -841,12 +841,13 @@ app:
     btn:
       manage_spools: Spulen verwalten
       scan_code: Code scannen
-      select: Auswählen
+      select: 'Auswählen | Für {macro} auswählen'
     title:
-      spool_selection: Spulenauswahl
+      spool_selection: 'Spulenauswahl | Spulenauswahl für {macro}'
       scan_spool: Spule scannen
       spoolman: Spoolman
     label:
+      active_spool: Aktive Spule
       change_spool: Spule wechseln
       comment: Kommentar
       device_camera: Gerät
diff --git a/src/locales/en.yaml b/src/locales/en.yaml
index 1a6f8fb5c9..e89f3f24b0 100644
--- a/src/locales/en.yaml
+++ b/src/locales/en.yaml
@@ -813,12 +813,13 @@ app:
     btn:
       manage_spools: Manage Spools
       scan_code: Scan Code
-      select: Select
+      select: 'Select | Select for {macro}'
     title:
       spoolman: Spoolman
-      spool_selection: Spool Selection
+      spool_selection: 'Spool Selection | Spool Selection for macro {macro}'
       scan_spool: Scan Spool
     label:
+      active_spool: Active Spool
       change_spool: Change Spool
       comment: Comment
       device_camera: Device
diff --git a/src/scss/misc.scss b/src/scss/misc.scss
index 7045e5b9cf..a095ef501e 100644
--- a/src/scss/misc.scss
+++ b/src/scss/misc.scss
@@ -63,3 +63,12 @@ input[type=number] {
 .constrained-width.quad {
   max-width: map-get($container-max-widths, 'xl') * 2;
 }
+
+.spool-icon {
+  stroke: rgba(0,0,0, 0.25);
+  stroke-width: .025rem;
+}
+
+.theme--dark .spool-icon {
+  stroke: rgba(0,0,0, 0.5);
+}
diff --git a/src/store/spoolman/actions.ts b/src/store/spoolman/actions.ts
index 1545f46181..470a736403 100644
--- a/src/store/spoolman/actions.ts
+++ b/src/store/spoolman/actions.ts
@@ -158,7 +158,6 @@ export const actions: ActionTree<SpoolmanState, RootState> = {
           return
         }
 
-        consola.debug(`${logPrefix} received spoolman message:`, data)
         switch (data.resource) {
           case 'spool':
             dispatch('onSpoolChange', data)
diff --git a/src/store/spoolman/getters.ts b/src/store/spoolman/getters.ts
index 6f8edbb764..511823380f 100644
--- a/src/store/spoolman/getters.ts
+++ b/src/store/spoolman/getters.ts
@@ -1,5 +1,5 @@
 import type { GetterTree } from 'vuex'
-import type { SpoolmanState } from './types'
+import type { Spool, SpoolmanState } from './types'
 import type { RootState } from '../types'
 
 export const getters: GetterTree<SpoolmanState, RootState> = {
@@ -15,6 +15,10 @@ export const getters: GetterTree<SpoolmanState, RootState> = {
     return state.availableSpools
   },
 
+  getSpoolById: (state) => {
+    return (id: number) => state.availableSpools.find((spool: Spool) => spool.id === id)
+  },
+
   getConnected: (state) => {
     return state.connected
   },
diff --git a/src/store/spoolman/state.ts b/src/store/spoolman/state.ts
index 24733d8c4c..586ab06b45 100644
--- a/src/store/spoolman/state.ts
+++ b/src/store/spoolman/state.ts
@@ -6,8 +6,7 @@ export const defaultState = (): SpoolmanState => {
     activeSpool: undefined,
     connected: false,
     dialog: {
-      show: false,
-      filename: ''
+      show: false
     }
   }
 }
diff --git a/src/store/spoolman/types.ts b/src/store/spoolman/types.ts
index 19441e131c..4b5c1ecda5 100644
--- a/src/store/spoolman/types.ts
+++ b/src/store/spoolman/types.ts
@@ -1,3 +1,5 @@
+import type { Macro } from '@/store/macros/types'
+
 export interface Vendor {
   id: number;
   registered: Date;
@@ -52,6 +54,7 @@ export interface SpoolmanState {
 export interface SpoolSelectionDialogState {
   show: boolean;
   filename?: string;
+  targetMacro?: string;
 }
 
 export interface WebsocketBasePayload {
@@ -75,3 +78,10 @@ export interface WebsocketVendorPayload extends WebsocketBasePayload {
   resource: 'vendor';
   payload: Vendor;
 }
+
+export interface MacroWithSpoolId extends Macro {
+  variables: {
+    spool_id: number | null;
+    [key: string]: unknown;
+  }
+}