Skip to main content

E2 — RFID_SPI_CREATE_FAILED

Hardware version

This error only occurs on v3 hardware.

The SPI peripheral for the RFID reader could not be created.

What happens​

rfid_task exits immediately. RFID scanning is unavailable for this session — the device will not scan any competitor cards until it is rebooted. All other functionality (Wi-Fi, display, Stackmat) continues normally.

Possible causes​

  • The SPI peripheral configuration failed at driver level, which should not happen on unmodified firmware.
  • Flash or firmware corruption produced invalid peripheral parameters.

How to fix​

  1. Reboot the device — A fresh boot re-runs rfid_task from scratch.
  2. Reflash the firmware — Flash the latest firmware using espflash to rule out a corrupted build.
  3. Contact support — If this error appears consistently on stock firmware, open an issue on GitHub.