paxx12 · kbaker827 · Mar 4, 2026 · Mar 3, 2026 · Mar 4, 2026
diff --git a/docs/firmware_config.md b/docs/firmware_config.md
@@ -51,7 +51,7 @@ Toggle settings directly from the web interface:
 | VPN Provider | None, Tailscale | Enable VPN remote access (Experimental) |
 | Cloud | None, OctoEverywhere | Enable Cloud-based remote access (Experimental) |
 | Tweaks | TMC AutoTune, TMC Reduced Current, Object Processing, AFC Stub | Experimental Klipper tweaks ([tweaks](tweaks.md)) |
-| RFID Detection System | External, Snapmaker | Set how filament is detected ([rfid_support](rfid_support.md)) |
+| RFID Detection System | External, Snapmaker, OpenRFID, OpenRFID (force generic vendor) | Set how filament is detected ([rfid_support](rfid_support.md)) |
 
 Changes are applied immediately and relevant services are restarted.
 
@@ -156,6 +156,10 @@ Note: Remote screen requires additional Moonraker configuration. See [Remote Scr
 **rfid** - Filament tag detection system
 - `snapmaker` (default) - Snapmaker's built-in RFID reader
 - `external` - Disable built-in readers (useful for external readers)
+- `openrfid` - Alternative detection with extended spool/tag support
+- `openrfid-generic` - Same as openrfid, labels all spool vendors as generic
+
+See [Alternative Filament Detection](rfid_support.md#alternative-detection-systems) for setup instructions.
 
 #### [remote_access]
 
@@ -204,7 +208,7 @@ usb: none
 rtsp: false
 
 [components]
-# Filament tag detection system: external, snapmaker
+# Filament tag detection system: external, snapmaker, openrfid, openrfid-generic
 rfid: snapmaker
 
 [remote_access]

diff --git a/docs/index.md b/docs/index.md
@@ -71,6 +71,7 @@ Heavily expanded firmware with extensive features and customization. Includes al
 - [Klipper Tweaks](tweaks.md) - Experimental [TMC driver optimizations](tweaks.md#tmc-autotune), [reduced current](tweaks.md#tmc-reduced-current), and [object processing for adaptive mesh](tweaks.md#object-processing-for-adaptive-mesh)
 - [AFC-Lite Stub](afc-lite.md) - Experimental AFC UI compatibility layer for Fluidd/Mainsail
 - [RFID Filament Tag Support](rfid_support.md) - NTAG213/215/216 support for OpenSpool format
+- [Alternative Filament Detection](rfid_support.md#alternative-detection-systems) - Alternative detection implementations with extended spool/tag support from Bambu, Creality, Anycubic, and others
 
 **Monitoring & Notifications:**
 

diff --git a/docs/rfid_support.md b/docs/rfid_support.md
@@ -120,6 +120,53 @@ Use the **NFC Tools** app (iOS/Android) to inspect tags:
 **Compatible tag types:** NTAG213/215/216, Mifare Classic 1K
 **Note:** ISO15693 tags (OpenPrintTag) are not supported
 
+## Alternative Detection Systems
+
+**Available in: Extended firmware only**
+
+The OpenRFID detection system is an alternative to Snapmaker's built-in filament tag detection, based on the [OpenRFID](https://github.com/suchmememanyskill/OpenRFID) project. It adds support for tagged spools from multiple manufacturers.
+
+To enable it, navigate to the [firmware-config](firmware_config.md) web interface, go to **Snapmaker Components > RFID Detection System**, and select **OpenRFID** or **OpenRFID (force generic vendor)**.
+
+- **OpenRFID** - Filament is identified by brand and type. Spools unrecognized by Snapmaker Orca are hidden in Snapmaker Orca.
+- **OpenRFID (force generic vendor)** - Same as OpenRFID, but spools are labeled as Generic so they always appear in Snapmaker Orca.
+- **External** - Disables the built-in readers entirely, useful for external readers such as [wasikuss/snapmaker-u1-remote-rfid-reader](https://github.com/wasikuss/snapmaker-u1-remote-rfid-reader).
+
+### Supported Tags
+
+| System | Enabled by default | Remarks |
+|--------|-------------------|---------|
+| Bambu | No | Requires additional configuration (see below) |
+| Creality | No | Requires additional configuration (see below) |
+| Anycubic | Yes | - |
+| Snapmaker | Yes | - |
+| Elegoo | No | Elegoo spools tagged with RFID work unreliably |
+| [OpenSpool](https://openspool.io/) | Yes | - |
+| TigerTag | Yes | Fully offline implementation |
+
+### Bambu / Creality Spool Configuration
+
+Bambu and Creality tagged spools require authentication keys. Edit the user configuration file to enable them:
+
+```
+/oem/printer_data/config/extended/openrfid_user.cfg
+```
+
+For **Bambu** spools:
+```ini
+[bambu_lab_tag_processor]
+key = <your 32 hex character key>
+```
+
+For **Creality** spools:
+```ini
+[creality_tag_processor]
+key = <your 32 hex character key>
+encryption_key = <your 32 hex character key>
+```
+
+After editing, restart the printer.
+
 ## Troubleshooting
 
 **Tag not detected:**

diff --git a/...e-extended/10-firmware-config/root/usr/local/share/firmware-config/extended/extended2.cfg b/...e-extended/10-firmware-config/root/usr/local/share/firmware-config/extended/extended2.cfg
@@ -17,7 +17,7 @@ usb: none
 rtsp: false
 
 [components]
-rfid: external, snapmaker
+rfid: external, snapmaker, openrfid, openrfid-generic
 
 [remote_access]
 # Enable SSH access: true, false

diff --git a/...firmware-extended/10-firmware-config/root/usr/local/share/firmware-config/html/index.html b/...firmware-extended/10-firmware-config/root/usr/local/share/firmware-config/html/index.html
@@ -40,7 +40,7 @@
         .row-desc { display: block; font-size: 12px; color: var(--muted); margin-top: 2px; }
         .row-help { font-size: 12px; color: var(--accent); margin-left: 6px; vertical-align: middle; }
         .row-help:hover { text-decoration: none; opacity: 0.8; }
-        .row select { align-self: flex-start; background: var(--card); border: 1px solid #555; border-radius: 6px; padding: 8px 12px; color: var(--text); font-size: 13px; cursor: pointer; min-width: 150px; }
+        .row select { align-self: flex-start; background: var(--card); border: 1px solid #555; border-radius: 6px; padding: 8px 12px; color: var(--text); font-size: 13px; cursor: pointer; min-width: 150px; max-width: 150px; }
         .row select:focus { outline: none; border-color: var(--accent); }
         .links-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; }
         .link-item { background: var(--item); padding: 12px 16px; border-radius: 6px; text-decoration: none; display: flex; align-items: center; gap: 10px; transition: background 0.2s; }

diff --git a/...-rfid-support/root/usr/local/share/firmware-config/functions/13_settings_rfid_reader.yaml b/...-rfid-support/root/usr/local/share/firmware-config/functions/13_settings_rfid_reader.yaml
@@ -4,7 +4,7 @@ settings:
     items:
       rfid:
         label: Filament Detection
-        help_url: https://snapmakeru1-extended-firmware.pages.dev/rfid_support#alternative-detection-system
+        help_url: https://snapmakeru1-extended-firmware.pages.dev/rfid_support#alternative-detection-systems
         description: Set how filament is detected.
         get_cmd:
           - /usr/local/bin/extended-config.py
@@ -21,6 +21,7 @@ settings:
               - -xc
               - |
                 /usr/local/bin/extended-config.py add /oem/printer_data/config/extended/extended2.cfg components rfid external
+                /etc/init.d/S99openrfid stop
                 /etc/init.d/S59rfid-support restart
                 /etc/init.d/S60klipper restart
           snapmaker:
@@ -30,6 +31,7 @@ settings:
               - -xc
               - |
                 /usr/local/bin/extended-config.py add /oem/printer_data/config/extended/extended2.cfg components rfid snapmaker
+                /etc/init.d/S99openrfid stop
                 /etc/init.d/S59rfid-support restart
                 /etc/init.d/S60klipper restart
         default: snapmaker
diff --git a/overlays/firmware-extended/31-openrfid/root/etc/init.d/S99openrfid b/overlays/firmware-extended/31-openrfid/root/etc/init.d/S99openrfid
@@ -0,0 +1,74 @@
+#!/bin/sh
+
+PIDFILE="/var/run/openrfid.pid"
+EXTENDED2_CFG="/oem/printer_data/config/extended/extended2.cfg"
+
+start() {
+    RFID=$(/usr/local/bin/extended-config.py get "$EXTENDED2_CFG" components rfid snapmaker 2>/dev/null)
+    DETECT_CONFIG=""
+    case "$RFID" in
+        openrfid)
+            DETECT_CONFIG=/usr/local/share/openrfid/extended/openrfid_u1_vendor.cfg
+            ;;
+
+        openrfid-generic)
+            DETECT_CONFIG=/usr/local/share/openrfid/extended/openrfid_u1_generic.cfg
+            ;;
+
+        *)
+            echo "Filament tag detection not set to openrfid or openrfid-generic, not starting."
+            return
+            ;;
+    esac
+
+    if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
+        echo "OpenRFID already running"
+        return 0
+    fi
+
+    ADDITIONAL_CONFIG=/oem/printer_data/config/extended/openrfid_user.cfg
+    if ! test -f "$ADDITIONAL_CONFIG"; then
+        ADDITIONAL_CONFIG=""
+    fi
+
+    printf "Starting OpenRFID: "
+    start-stop-daemon -S -b -m \
+        -p "$PIDFILE" \
+        -x /usr/bin/python3 -- /usr/local/bin/openrfid.py \
+        /tmp/openrfid.cfg \
+        /usr/local/share/openrfid/extended/openrfid_u1_base.cfg \
+        $DETECT_CONFIG \
+        $ADDITIONAL_CONFIG
+    echo "OK"
+}
+
+stop() {
+    printf "Stopping OpenRFID: "
+    if [ -f "$PIDFILE" ]; then
+        start-stop-daemon -K -p "$PIDFILE" -s TERM
+        rm -f "$PIDFILE"
+        echo "OK"
+    else
+        echo "not running"
+    fi
+}
+
+case "$1" in
+    start)
+        start
+        ;;
+    stop)
+        stop
+        ;;
+    restart|reload)
+        stop
+        sleep 1
+        start
+        ;;
+    *)
+        echo "Usage: $0 {start|stop|restart}"
+        exit 1
+        ;;
+esac
+
+exit $?
diff --git a/overlays/firmware-extended/31-openrfid/root/usr/local/bin/openrfid.py b/overlays/firmware-extended/31-openrfid/root/usr/local/bin/openrfid.py
@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+
+import configparser
+import logging
+import logging.handlers
+import os
+import re
+import runpy
+import sys
+
+
+_FM175XX_READER = "/home/lava/klipper/klippy/extras/fm175xx_reader.py"
+
+
+def _snapmaker_key():
+    try:
+        with open(_FM175XX_READER, "r") as f:
+            content = f.read()
+    except OSError as e:
+        print(f"Error: cannot read Klipper RFID driver at {_FM175XX_READER}: {e}", file=sys.stderr)
+        sys.exit(1)
+    m = re.search(r'FM175XX_M1_CARD_HKDF_SALT_KEY_B\s*=\s*b"([^"]+)"', content)
+    if m is None:
+        print(
+            f"Error: Snapmaker HKDF key not found in {_FM175XX_READER}. "
+            "The firmware driver may have changed.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    return m.group(1).encode().hex()
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(f"Usage: {sys.argv[0]} <target.cfg> [source.cfg ...]")
+        sys.exit(1)
+
+    target = sys.argv[1]
+    sources = sys.argv[2:]
+
+    config = configparser.RawConfigParser()
+    config.optionxform = str
+    config.read(sources)
+
+    if not config.has_section("snapmaker_tag_processor"):
+        config.add_section("snapmaker_tag_processor")
+    config.set("snapmaker_tag_processor", "key", _snapmaker_key())
+
+    with open(target, "w") as f:
+        config.write(f)
+
+    handler = logging.handlers.SysLogHandler(address="/dev/log")
+    logging.root.handlers = [handler]
+    logging.root.setLevel(logging.DEBUG)
+
+    sys.argv = [sys.argv[0], target]
+    sys.path.insert(0, "/usr/local/share/openrfid")
+    os.chdir("/usr/local/share/openrfid")
+    runpy.run_path("main.py", run_name="__main__")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/...nded/31-openrfid/root/usr/local/share/firmware-config/functions/15_settings_openrfid.yaml b/...nded/31-openrfid/root/usr/local/share/firmware-config/functions/15_settings_openrfid.yaml
@@ -0,0 +1,29 @@
+settings:
+  snapmaker_components:
+    items:
+      rfid:
+        options:
+          openrfid:
+            label: OpenRFID
+            confirm: Please read the relevant documentation for this feature. Bambu Lab and Creality spools are not enabled by default.
+            cmd:
+              - bash
+              - -xc
+              - |
+                /usr/local/bin/extended-config.py add /oem/printer_data/config/extended/extended2.cfg components rfid openrfid
+                cp -an /usr/local/share/openrfid/extended/openrfid_user.cfg /oem/printer_data/config/extended/openrfid_user.cfg
+                /etc/init.d/S59rfid-support restart
+                /etc/init.d/S99openrfid start
+                /etc/init.d/S60klipper restart
+          openrfid-generic:
+            label: OpenRFID (force generic vendor)
+            confirm: Please read the relevant documentation for this feature. Bambu Lab and Creality spools are not enabled by default.
+            cmd:
+              - bash
+              - -xc
+              - |
+                /usr/local/bin/extended-config.py add /oem/printer_data/config/extended/extended2.cfg components rfid openrfid-generic
+                cp -an /usr/local/share/openrfid/extended/openrfid_user.cfg /oem/printer_data/config/extended/openrfid_user.cfg
+                /etc/init.d/S59rfid-support restart
+                /etc/init.d/S99openrfid start
+                /etc/init.d/S60klipper restart
diff --git a/...firmware-extended/31-openrfid/root/usr/local/share/openrfid/extended/openrfid_u1_base.cfg b/...firmware-extended/31-openrfid/root/usr/local/share/openrfid/extended/openrfid_u1_base.cfg
@@ -0,0 +1,85 @@
+[output_pin upper_rfid_coils_enable_pin]
+gpio_device = 1
+line = 27
+
+[output_pin lower_rfid_coils_enable_pin]
+gpio_device = 1
+line = 24
+
+[output_pin rfid_reader_right_side_reset_pin]
+gpio_device = 1
+line = 25
+
+[output_pin rfid_reader_left_side_reset_pin]
+gpio_device = 1
+line = 28
+
+[software_spi rfid_reader_right_side_spi]
+bus = 2
+device = 0
+max_speed_hz = 500000
+mode = 0
+
+[software_spi rfid_reader_left_side_spi]
+bus = 2
+device = 1
+max_speed_hz = 500000
+mode = 0
+
+[fm175xx rfid_reader_right_side]
+enabled = false
+spi = rfid_reader_right_side_spi
+reset_pin = rfid_reader_right_side_reset_pin
+
+[fm175xx rfid_reader_left_side]
+enabled = false
+spi = rfid_reader_left_side_spi
+reset_pin = rfid_reader_left_side_reset_pin
+
+[gpio_enabled_rfid_reader slot_0_reader]
+slot = 0
+rfid_reader = rfid_reader_left_side
+gpio_pins_high = upper_rfid_coils_enable_pin
+gpio_pins_low = lower_rfid_coils_enable_pin
+
+[gpio_enabled_rfid_reader slot_1_reader]
+slot = 1
+rfid_reader = rfid_reader_left_side
+gpio_pins_high = lower_rfid_coils_enable_pin
+gpio_pins_low = upper_rfid_coils_enable_pin
+
+[gpio_enabled_rfid_reader slot_2_reader]
+slot = 2
+rfid_reader = rfid_reader_right_side
+gpio_pins_high = upper_rfid_coils_enable_pin
+gpio_pins_low = lower_rfid_coils_enable_pin
+
+[gpio_enabled_rfid_reader slot_3_reader]
+slot = 3
+rfid_reader = rfid_reader_right_side
+gpio_pins_high = lower_rfid_coils_enable_pin
+gpio_pins_low = upper_rfid_coils_enable_pin
+
+[anycubic_tag_processor]
+
+[openspool_tag_processor]
+
+[tigertag_tag_processor]
+
+[webhook_exporter error_exporter]
+method = POST
+event = tag_read_error
+url = http://localhost/printer/filament_detect/set
+body_json_template = {"channel":{{reader.slot}},"info":{}}
+
+[moonraker_on_property_change]
+moonraker_socket_path = /oem/printer_data/comms/moonraker.sock
+track_object = filament_detect
+track_field = state
+get_index_from_field = array
+act_on_value = 1
+
+[configuration]
+auto_read_mode = false
+retries = 20
+read_interval_seconds = 0.2