Spoolman Idea 1: Add OpenSpool `spool_id` extension to enable Spoolman in AFC-Lite by paxx12 · Pull Request #285 · paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware

paxx12 · 2026-02-15T10:19:45Z

This PR adds Spoolman integration to AFC and extends the RFID filament protocol to support spool_id.

Workflow: This requires a specially programmed NFC tags to include spool_id.

Changes

RFID Protocol: Added spool_id field to filament protocol NDEF for tracking spools
AFC Integration: Enhanced AFC lane management with Spoolman API support for automatic spool tracking
Moonraker Proxy: Added Spoolman proxy configuration to Moonraker
Configuration: New AFC config with Spoolman-related macros and settings

RFID support

Spoolman support

github-actions · 2026-02-15T10:25:01Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 5b5d38e (merge of a4163ed into develop)
Duration: 4m 47s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-15T10:41:38Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 0609378 (merge of 3d7d56f into develop)
Duration: 5m 1s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-15T11:03:07Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 9ace5ff (merge of e83dcf3 into develop)
Duration: 4m 47s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-15T12:00:13Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 6bc1da9 (merge of 8f0fba6 into develop)
Duration: 4m 42s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-15T18:52:32Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 54eda98 (merge of 49b2d3c into develop)
Duration: 4m 46s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-16T11:25:56Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 20cfaf1 (merge of c2ed582 into develop)
Duration: 5m 34s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

github-actions · 2026-02-16T11:39:36Z

✅ Build Artifacts

Version: 1.1.1-paxx12-test-pr-285
Build: 5999e47 (merge of 37bbd20 into develop)
Duration: 4m 44s

Artifact	Size
`basic-build`	205.31 MB
`extended-build`	240.74 MB
`basic-devel-build`	205.72 MB
`extended-devel-build`	241.15 MB

View workflow run

matissrapsa · 2026-03-24T16:54:03Z

Hey @paxx12 any chanche this will be included in v1.2.0-paxx12-14

paxx12 · 2026-03-24T16:55:42Z

Unlikely, as this requires updates in various places, but after this, likely yes.

github-actions · 2026-03-30T09:06:14Z

✅ Build Artifacts

Version: 1.2.0-paxx12-test-pr-285
Build: c99487d (merge of f2f40b9 into develop)
Duration: 4m 24s

Artifact	Size
`extended-devel-build`	225.55 MB
`extended-build`	225.15 MB

View workflow run

github-actions · 2026-03-30T14:43:20Z

✅ Build Artifacts

Version: 1.2.0-paxx12-test-pr-285
Build: 90b9923 (merge of 7882a74 into develop)
Duration: 3m 54s

Artifact	Size
`extended-devel-build`	225.55 MB
`extended-build`	225.15 MB

View workflow run

github-actions · 2026-04-04T20:19:27Z

✅ Build Artifacts

Version: 1.2.0-paxx12-test-pr-285
Build: 96b634e (merge of 9e9771c into develop)
Duration: 3m 39s

Artifact	Size
`extended-devel-build`	225.48 MB
`extended-build`	225.08 MB

View workflow run

github-actions · 2026-04-04T20:26:00Z

✅ Build Artifacts

Version: 1.2.0-paxx12-test-pr-285
Build: 67b8d82 (merge of b6baaab into develop)
Duration: 3m 58s

Artifact	Size
`extended-devel-build`	225.48 MB
`extended-build`	225.08 MB

View workflow run

Add `spool_id` field to OpenSpool protocol for integration with spool management systems. The `spool_id` is stored in `print_task_config` and can be set via RFID tags or `SET_PRINT_FILAMENT_CONFIG` command.

This reverts commit f2f40b929c0bd9d16d74ff6400fe8030aafcca25.

github-actions · 2026-04-05T16:58:56Z

✅ Build Artifacts

Version: 1.2.0-paxx12-test-pr-285
Build: 5ed7bfe (merge of 7d13836 into develop)
Duration: 4m 6s

Artifact	Size
`extended-devel-build`	225.49 MB
`extended-build`	225.08 MB

View workflow run

paxx12 · 2026-05-10T07:12:57Z

Why `spool_id` (PR #285) was closed in favour of `card_uid` (PR #364)

Problem with the `spool_id` approach

PR #285 extends the RFID NDEF record with a spool_id field that maps directly
to a Spoolman spool. The mapping lives on the tag, which creates several issues:

The tag must be specially programmed with a spool_id - only works with
OpenSpool-compatible tooling (SpoolPainter, etc.).
Any tag not programmed this way is excluded - blank tags, manufacturer
tags, read-only or undecryptable tags cannot participate.
The tag is the source of truth, not Spoolman. This makes migration,
re-binding, and tag replacement unnecessarily painful.
Maintaining two parallel identification paths adds complexity and test surface
with limited benefit.

Why `card_uid` in Spoolman (PR #364) is correct

PR #364 flips the model: instead of storing the Spoolman spool ID on the tag,
it stores the tag's hardware CARD_UID in Spoolman's lot_nr field. The field is subject to be defined.

Spoolman becomes the single source of truth - not the tag.
Any NFC tag works - blank, pre-programmed, OpenSpool, read-only - as long
as the reader can obtain its UID. The tag does not need to be writable,
decryptable, or compliant with any particular NDEF schema.
First-time setup: assign a spool to a lane via Fluidd once, firmware
binds the CARD_UID into lot_nr. Every subsequent insertion is automatic.
Future-proof: the same lot_nr lookup can extend to barcodes, QR codes,
serial numbers, or any unique identifier - no firmware changes needed.
Mobile apps: can update Spoolman database already, since they already fetch available spools from Spoolman.
Mobile apps are not required: user might or might not use Mobile apps, since tag is never written by printer, the printer can create the mapping as well.

End-user experience

Both approaches produce the same outcome at print time: insert a spool, the
printer resolves it to a Spoolman entry and tracks usage automatically.
The difference is invisible during printing. The only practical change is the
one-time setup - a UI click instead of physical tag programming.

Migration from `spool_id` tags

Spools programmed with OpenSpool spool_id data continue to be read for
color/material metadata. The card_uid mapping in #364 uses the tag UID as the
key instead of spool_id. Re-binding is done through the normal UI flow
(one click per spool side), or via a planned mobile migration tool that reads
the UID and updates Spoolman's lot_nr in bulk.

Long story short

This follows the same pattern as explained in here: https://help.simplyprint.io/en/article/all-about-nfc-rfid-for-filament-spools-bambu-openprinttag-creality-qidi-anycubic-more-19luyni/#3-the-problem-that-this-solves

This was referenced Feb 15, 2026

Add Multi-tool support in Fluidd/Mainsail by emulating AFC #236

Closed

Spoolman Helper: a usage tracking module and integration for Spoolman, in U1 flavour #163

Closed

paxx12 added the proof-of-concept Label to indicate that this feature is proof of concept label Feb 15, 2026

paxx12 force-pushed the afc-spool_id-spoolman branch from a4163ed to 3d7d56f Compare February 15, 2026 10:36

paxx12 force-pushed the afc-spool_id-spoolman branch from 3d7d56f to e83dcf3 Compare February 15, 2026 10:57

paxx12 changed the title ~~Add AFC Spoolman Integration with spool_id Support~~ Add RFID support for spool_id parsing to enable Spoolman in AFC Feb 15, 2026

paxx12 changed the title ~~Add RFID support for spool_id parsing to enable Spoolman in AFC~~ Add OpenSpool spool_id extension to enable Spoolman in AFC Feb 15, 2026

paxx12 force-pushed the afc-spool_id-spoolman branch from e83dcf3 to 8f0fba6 Compare February 15, 2026 11:55

paxx12 force-pushed the afc-spool_id-spoolman branch from 49b2d3c to c2ed582 Compare February 16, 2026 11:19

paxx12 force-pushed the afc-spool_id-spoolman branch from c2ed582 to 37bbd20 Compare February 16, 2026 11:34

luksto mentioned this pull request Feb 28, 2026

Integration for spool_id patbearnl/Android-Openspool-Ntag-Writer-with-JSon-cvs-import-support-for-3DFP-and-Spoolman-import-supoort#1

Open

Fewiel mentioned this pull request Mar 13, 2026

Feature/spoolman filament tracking Fewiel/SpoolHero#4

Open

paxx12 force-pushed the afc-spool_id-spoolman branch from 37bbd20 to f2f40b9 Compare March 30, 2026 09:01

paxx12 force-pushed the develop branch 2 times, most recently from e374a6e to a5b2d91 Compare March 30, 2026 14:36

paxx12 force-pushed the afc-spool_id-spoolman branch from f2f40b9 to 7882a74 Compare March 30, 2026 14:38

paxx12 mentioned this pull request Mar 30, 2026

Spoolman Idea 2: Store RFID Tag ID in Spoolman database when selected via AFC-Lite #364

Open

paxx12 force-pushed the afc-spool_id-spoolman branch from 7882a74 to 9e9771c Compare April 4, 2026 20:15

paxx12 changed the title ~~Add OpenSpool spool_id extension to enable Spoolman in AFC~~ Spoolman Idea 1: Add OpenSpool spool_id extension to enable Spoolman in AFC Apr 4, 2026

paxx12 changed the title ~~Spoolman Idea 1: Add OpenSpool spool_id extension to enable Spoolman in AFC~~ Spoolman Idea 1: Add OpenSpool spool_id extension to enable Spoolman in AFC-Lite Apr 4, 2026

paxx12 added 10 commits April 5, 2026 18:54

Improve RFID timeouts to improve tags discovery

9c359dd

AFC properly advertises spoolman pressence

ec8973d

Make _get_state to return spool

7ba3378

Add spoolman_proxy to moonraker

ef56bfb

Add spool_id to print_task_config

e8eeb37

Add spoolman monitoring to afc.cfg

c03fd1a

Allow to SET_SPOOL_ID

3af2058

Add spool_id support to RFID filament protocol

0a5c228

Add `spool_id` field to OpenSpool protocol for integration with spool management systems. The `spool_id` is stored in `print_task_config` and can be set via RFID tags or `SET_PRINT_FILAMENT_CONFIG` command.

Revert "Add spool_id support to RFID filament protocol"

fd4a837

This reverts commit f2f40b929c0bd9d16d74ff6400fe8030aafcca25.

Normalize AFC spool_id to int

7d13836

paxx12 force-pushed the afc-spool_id-spoolman branch from b6baaab to 7d13836 Compare April 5, 2026 16:54

paxx12 closed this May 10, 2026

paxx12 mentioned this pull request May 10, 2026

Integrate Spoolman with the NFC filament detection #433

Closed

paxx12 deleted the afc-spool_id-spoolman branch May 10, 2026 07:13

Conversation

paxx12 commented Feb 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

RFID support

Spoolman support

Uh oh!

github-actions Bot commented Feb 15, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 15, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 15, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 15, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 15, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 16, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Feb 16, 2026

✅ Build Artifacts

Uh oh!

matissrapsa commented Mar 24, 2026

Uh oh!

paxx12 commented Mar 24, 2026

Uh oh!

github-actions Bot commented Mar 30, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Mar 30, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Apr 4, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Apr 4, 2026

✅ Build Artifacts

Uh oh!

github-actions Bot commented Apr 5, 2026

✅ Build Artifacts

Uh oh!

paxx12 commented May 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why spool_id (PR #285) was closed in favour of card_uid (PR #364)

Problem with the spool_id approach

Why card_uid in Spoolman (PR #364) is correct

End-user experience

Migration from spool_id tags

Long story short

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

paxx12 commented Feb 15, 2026 •

edited

Loading

paxx12 commented May 10, 2026 •

edited

Loading

Why `spool_id` (PR #285) was closed in favour of `card_uid` (PR #364)

Problem with the `spool_id` approach

Why `card_uid` in Spoolman (PR #364) is correct

Migration from `spool_id` tags