CFS and RFID

CFS Fluidd widget

The CFS is controlled through a custom Fluidd widget called Filament Box. It shows the CFS and filament-path state, lets you select a slot or unload filament, and stores the material details for each slot.

Open the widget settings with the cog to change runout swapping, unloading after a print, and RFID reading options. The Fluidd console is where the firmware reports CFS status, errors, and troubleshooting information.

Spoolman

You can optionally link a Spoolman spool to each CFS slot from Filament Box. Open a slot, choose Select spool, then save it. Its filament details and remaining weight are shown in Filament Box, and it becomes the active Spoolman spool when that slot is loaded.

RFID

If you do not plan to write your own RFID tags for your spools, you can ignore the rest of this section.

RFID fills Filament Box slot details automatically: material, color, brand, name, and remaining filament. The printer only reads tags. It does not write them.

There are two readers. Both update the same Filament Box card in Fluidd.

CFS slots

Open Filament Box → settings (the cog) for the two RFID options. Both are off by default.

• Read RFID on insertion — when a spool is inserted into the CFS, read its RFID tag once to populate its saved filament details. Filament must be unloaded.
• Read RFID after Klipper starts — when Klipper starts, read present spools that the CFS internally has no RFID data for. Consequently, a printer power cycle spins every occupied slot. Saved slot details (name, color, material) live in Klipper. RFID remaining % comes from the CFS RFID record and shows on the slot after a successful read. The only reason to enable this is RFID remaining %. Filament must be unloaded.

External reader

Tap a spool against the printer’s standalone reader. A successful scan beeps and fills the External slot on the Filament Box card.

The external reader does not show remaining filament.

Resolution

A tag identifies a spool in one of two ways. Pick one when you write it.

• Spoolman — put the Spoolman spool ID in reserve. Material, color, brand, and name come from Spoolman. filamentId and color on the tag are ignored.
• Catalog — put a material code in filamentId and #RRGGBB in color. Leave reserve as 000000. Brand, name, material, and flush temperature come from a mapping you saved, or else the Creality catalog. If the code is not in the catalog and has no mapping, the slot is left as-is.

If reserve is an integer greater than 1, the Spoolman path wins even if filamentId is also set. 000000 and 000001 are not spool IDs; stock Creality tags often have 1 in this field.

Tags are 40-character Creality records. Resolution uses filamentId, color, and reserve. See this tag writer for an example.

Spoolman IDs on RFID tags

Use this if you want the slot filled from Spoolman. Write the spool ID in reserve, zero-padded, greater than 1 (000091). The other fields are not used.

If Spoolman’s material is not already in the Filament Box catalog, it is added with a default flush temperature. The console tells you to set the real flush temperature in the slot UI.

Select spool on the Filament Box card assigns a spool to that slot without writing the tag. It does not change how a later RFID scan resolves.

A slot with a Spoolman spool shows remaining weight from Spoolman, not the RFID percentage.

Catalog

Use this if you are not using Spoolman, or you only want a material/color profile from the tag. Write filamentId and color (#RRGGBB). Leave reserve as 000000.

A 6-character filamentId whose last five characters match a catalog code still resolves (101001 → 01001).

This firmware uses the same material codes Creality uses:

If the code is not in that table, the slot is left as-is. The console prints something like:

Unknown RFID tag in T0: CODE=ZZ9999
Map it with: _BOX_RFID_MAP_SET CODE=ZZ9999 MATERIAL=PLA BRAND="Brand" NAME="Name" TARGET_TEMP=220

Edit the material, brand, name, and temperature, then run it. The mapping is saved and applied to the slot that just scanned. Later scans of that code reuse it. Color stays whatever is on the tag.

Remaining filament shown in box card