Tips, troubleshooting, and how to get in touch.
Power on the Seeed Studio XIAO ESP32-C3 with the PN532 module attached. Open the app and go to the Connect tab. The app will scan for Bluetooth devices advertising the Nordic UART Service. Tap your reader/writer to connect.
Place a QIDI Box filament tag on the PN532 reader/writer. Go to the Read tab and tap Read Tag. The app reads sector 1, block 0 and displays the material, color, and manufacturer.
Go to the Write tab, select a material and color from the picker, then tap Write to Tag. The data is written to block 4 of the MIFARE Classic 1K chip.
Watch the app read and write a QIDI Box filament tag using a Bluetooth-connected PN532 reader/writer.
Make sure Bluetooth is enabled in your iPhone’s Settings and that QBox NFC Tagger has permission to use Bluetooth. Go to Settings > Privacy & Security > Bluetooth and ensure the app is allowed.
Ensure your Seeed Studio XIAO ESP32-C3 is powered on and running the NFC bridge firmware. The device must be advertising the Nordic UART Service (NUS). Try moving your iPhone closer to the reader/writer.
Place the NFC tag directly on the PN532 reader/writer before tapping Read or Write. The reader/writer needs 1–2 seconds to detect the tag. Enable Continuous Mode to retry automatically until the tag is detected.
The app tries the QIDI authentication key first, then falls back to the default MIFARE key. If both fail, the tag may use a non-standard key that is not currently supported.
Enable the Continuous Read or Continuous Write toggle to keep retrying until a tag is successfully read or written. This is useful when positioning the tag on the reader/writer — the app automatically detects it when contact is made. Tap the button again to cancel. Both toggles remember their state between app launches.
Demo Mode simulates a connected NFC reader/writer so you can explore the app without hardware. Enable it on the Help tab. All operations return simulated data and an orange “DEMO MODE” banner appears at the top of the screen.
The fastest way to report a bug, request a feature, or ask a question is to open a GitHub issue.
Open a GitHub Issue