spooly.eu/docs/home-assistant/actions

Aktionen

Alle 9 Aktionen brauchen das Recht zu ändern. Fehlt es, kommt eine Meldung, und Home Assistant bietet die erneute Anmeldung an. Nach jeder Aktion ruft die Integration sofort neu ab.

Als Text öffnen

Auf dieser Seite

Die Spule wählst du über ihr Gerät, Slot und Wartungsaufgabe über ihren Sensor. Im Aktionen-Editor wählst du aus einer Liste, in YAML steht die ID des Geräts. Beispiele

`spooly.set_weight`

In der Oberfläche: Gewicht setzen

Setzt das Restgewicht. Gib genau eines der beiden Gewichte an.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste.
`grams`	Zahl, optional	Filament ohne Spule, 0 bis 20.000 g
`gross_grams`	Zahl, optional	Spule auf der Waage, 0 bis 40.000 g. Braucht eine bekannte Tara.

YAML

action: spooly.set_weight
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  gross_grams: 742

`spooly.refill`

In der Oberfläche: Nachfüllen

Addiert Gramm zum Restgewicht.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste.
`grams`	Zahl	1 bis 20.000 g

YAML

action: spooly.refill
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  grams: 250

`spooly.assign_slot`

In der Oberfläche: Slot zuordnen

Legt eine Spule in einen Slot. Geht nur mit aktivem Slot-Autopilot.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste.
`slot`	Entität	Der Sensor des Slots
`confirm_color`	Ja/Nein, optional	Auch zuordnen, wenn der Drucker eine andere Farbe meldet. Standard aus.

YAML

action: spooly.assign_slot
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  slot: sensor.x1_carbon_von_tobi_1_2
  confirm_color: false

`spooly.clear_slot`

In der Oberfläche: Slot leeren

Nimmt die Spule aus einem Slot, sie bleibt in Spooly. Geht nur mit aktivem Slot-Autopilot.

Feld	Typ	Bedeutung
`slot`	Entität	Der Sensor des Slots

YAML

action: spooly.clear_slot
data:
  slot: sensor.x1_carbon_von_tobi_1_2

`spooly.move`

In der Oberfläche: Umlagern

Legt eine Spule in einen Lagerort, auf Wunsch auf einen Platz. Ohne Platz liegt sie im Ort ohne Platz.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste.
`location`	Text	Name des Lagerorts mit Pfad, wie ihn `GET /locations` liefert, oder seine Kennung. Für einen Platz hängst du ihn an wie in Spooly: „Werkstatt · Trockenbox · Platz 1“. So kannst du auch das Attribut `location` einer Spule übernehmen. Heißen zwei Lagerorte gleich, nimm die Kennung aus `location_id`, auch mit „· Platz 1“ dahinter.

YAML

action: spooly.move
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  location: "Schrank 01 · Fach vorne"

`spooly.archive`

In der Oberfläche: Archivieren

Archiviert eine Spule. Sie verlässt den aktiven Bestand und wird nicht gelöscht.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste.

YAML

action: spooly.archive
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8

Holt eine archivierte Spule zurück in den aktiven Bestand. Das geht nur, solange das Gerät der Spule in Home Assistant noch existiert. Hast du es nach dem Archivieren gelöscht (wie die Datenaktualisierung empfiehlt), holst du die Spule in der App zurück.

Feld	Typ	Bedeutung
`device_id`	Gerät	Das Gerät der archivierten Spule

YAML

action: spooly.restore
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8

`spooly.complete_maintenance`

In der Oberfläche: Wartung erledigt

Meldet eine Wartungsaufgabe als erledigt.

Feld	Typ	Bedeutung
`task`	Entität	Der Sensor der Aufgabe
`action`	Auswahl, optional	`replace` getauscht, `clean` gereinigt oder `check` geprüft. Ohne Angabe nimmt Spooly die übliche Tätigkeit der Aufgabe.
`notes`	Text, optional	Freitext, Spooly speichert ihn beim Eintrag

YAML

action: spooly.complete_maintenance
data:
  task: sensor.x1_carbon_von_tobi_nozzle_0_4_mm
  action: replace
  notes: Neue Düse 0,4 mm

`spooly.snooze_maintenance`

In der Oberfläche: Wartung zurückstellen

Stellt eine Wartungsaufgabe zurück.

Feld	Typ	Bedeutung
`task`	Entität	Der Sensor der Aufgabe
`days`	Auswahl	7, 14 oder 30
`reason`	Text, optional	Freitext, Spooly speichert ihn

YAML

action: spooly.snooze_maintenance
data:
  task: sensor.x1_carbon_von_tobi_nozzle_0_4_mm
  days: 14
  reason: Teil ist bestellt