Error Code: MCU_ERR_0078

title: "Fix RP2040 USB Device Controller Lockup (Silicon Erratum RP2040-E15)" slug: fix-rp2040-usb-device-controller-lockup-erratum-e15-pico-sdk metadescription: "RP2040 USB device controller hanging where SOFRD stops incrementing under high-speed USB hubs? Fix Silicon Erratum RP2040-E15 by updating to Pico SDK 1.5.1+." excerpt: "Does your RP2040 USB device freeze enumeration or stop incrementing SOFRD when connected through certain USB hubs? Learn how Silicon Erratum RP2040-E15 works and how to fix it." primarykeywords: - "rp2040 usb device controller lockup erratum e15" - "rp2040 erratum e15 usb phy hang" - "rp2040 sofrd register not incrementing usb" secondarykeywords: - "pico sdk 1.5.1 rp2040-e15 workaround tinyusb" - "raspberry pi pico usb hub enumeration freeze" - "rp2040 datasheet appendix b errata e15" - "tinyusb dcdrp2040 erratum e15" canonicalurl: "https://mentora.school/blog/fix-rp2040-usb-device-controller-lockup-erratum-e15-pico-sdk" author: "Mentora Hardware Troubleshooting Bench" date: "2026-10-24"

Article Publishing & SEO / AEO Metadata

Metadata Field

Specification

Article Title

Fix RP2040 USB Device Controller Lockup (Silicon Erratum RP2040-E15)

Target Slug

fix-rp2040-usb-device-controller-lockup-erratum-e15-pico-sdk

Canonical URL

https://mentora.school/blog/fix-rp2040-usb-device-controller-lockup-erratum-e15-pico-sdk

Meta Description (160 chars)

RP2040 USB device controller hanging where SOF_RD stops incrementing under high-speed USB hubs? Fix Silicon Erratum RP2040-E15 by updating to Pico SDK 1.5.1+.

Post Excerpt

Does your RP2040 USB device freeze enumeration or stop incrementing SOF_RD when connected through certain USB hubs? Learn how Silicon Erratum RP2040-E15 works and how to fix it.

Primary Keywords

rp2040 usb device controller lockup erratum e15, rp2040 erratum e15 usb phy hang, rp2040 sof_rd register not incrementing usb

Secondary Keywords

pico sdk 1.5.1 rp2040-e15 workaround tinyusb, raspberry pi pico usb hub enumeration freeze, rp2040 datasheet appendix b errata e15, tinyusb dcd_rp2040 erratum e15

Author & Date

Mentora Hardware Troubleshooting Bench | October 24, 2026

DELIVERABLE 1: The Mentora School Blog Post

Fix RP2040 USB Device Controller Lockup (Silicon Erratum RP2040-E15)

Quick Answer (AEO / 60-Second Summary)

Symptom: Your RP2040-based product (Raspberry Pi Pico or custom RP2040 PCB running USB CDC, HID, MIDI, or Audio via TinyUSB) works reliably on some computers, but intermittently locks up its USB interface when plugged into specific USB 2.0/3.0 hubs or host controllers. When locked up, the USBSOFRD register stops incrementing, all endpoint transfers halt, and only a USB reset or re-plug recovers the bus.

Root Cause (Official Silicon Erratum RP2040-E15): Documented in Appendix B of the official RP2040 Datasheet, Erratum RP2040-E15 is a hardware state-machine bug in the RP2040's internal Full-Speed USB 2.0 device controller:

If a specific sequence of packet transitions or a truncated packet/SE0 state occurs on the USB bus (frequently generated by High-Speed USB 2.0/3.0 hubs translating packets via Transaction Translators), the internal USB SIE (Serial Interface Engine) RX state machine deadlocks waiting for an end-of-packet that has already passed.

The Solution:

Upgrade to pico-sdk Version 1.5.1 or Newer (Includes TinyUSB 0.15.0+): Raspberry Pi engineers implemented a comprehensive software/hardware recovery workaround for RP2040-E15 in Pico SDK 1.5.1 (and modern arduino-pico / MicroPython v1.21+).

Verify PICORP2040USBDEVICEENUMERATIONFIX and RP2040-E15 Workarounds Are Linked: Recompile your UF2 binary against pico-sdk >= 1.5.1 (or 2.0.0+) so the updated TinyUSB dcdrp2040.c driver is baked into your firmware!

Technical Deep-Dive: Inside Silicon Erratum RP2040-E15 & RP2040-E5

The RP2040 datasheet documents two distinct USB device silicon errata that affect field-deployed USB devices:

Silicon Erratum ID

Phase Affected

Hardware Mechanism

Patched in Pico SDK Version

RP2040-E5

Initial USB Enumeration (SE0 after Bus Reset)

USB PHY fails to exit reset cleanly on certain hubs unless GPIO15 bank pads are pulsed.

pico-sdk >= 1.1.0 (rp2040usbdeviceenumerationfix)

RP2040-E15

Active Runtime USB Traffic (SOF_RD freeze)

USB SIE RX state machine locks up when an IN endpoint and OUT/SOF packet collide or abort.

pico-sdk >= 1.5.1 (TinyUSB dcd_rp2040.c patch)

HOW THE PICO SDK 1.5.1+ WORKAROUND PREVENTS E15 LOCKUP: 1. Avoids concurrent endpoint buffer arming during critical SOF windows: • Synchronizes endpoint buffer control register writes (USB_DPSRAM) against the Start-Of-Frame (SOF) timer. 2. Recovers automatically if the SIE RX state machine stalls: • Detects missing SOF progression and toggles the internal transceiver state without dropping the host USB enumeration!

Step-by-Step: Updating Your Pico C SDK & TinyUSB Submodules

If your project is compiled against an older pico-sdk (such as 1.3.0, 1.4.0, or 1.5.0), update your SDK and TinyUSB submodule and perform a clean build:

1. Navigate to your pico-sdk directory:cd $PICOSDKPATH# 2. Fetch the latest SDK release (1.5.1+ or 2.0.0+):git fetch --tagsgit checkout 1.5.1 # Or latest 2.x release# 3. CRITICAL: Update the bundled TinyUSB submodule!git submodule update --init --recursive# 4. Rebuild your firmware from a clean build directory:cd /path/to/your/projectrm -rf build && mkdir build && cd buildcmake ..make -j4

Verify in your build output or CMakeCache.txt that PICORP2040USBDEVICEENUMERATIONFIX and PICORP2040USBDEVICEUFRAMEFIX are enabled (1 by default in pico-sdk >= 1.5.1).

For more bare-metal embedded tutorials, silicon errata analysis, and RP2040 firmware workflows, explore Mentora School.

DELIVERABLE 2: The Community Forum Reply Message

Target Thread: Raspberry Pi Forums: RP2040 USB device controller lockup; Erratum E15 seen in field

Recipient: Anonymous / Raspberry Pi Forums Community

What you are observing—where the USB device controller hangs in the field under specific high-speed USB hubs and the SOF_RD register stops incrementing—is the exact symptom of RP2040 Silicon Erratum RP2040-E15!

What Causes RP2040-E15

In the RP2040's internal Full-Speed USB SIE (Serial Interface Engine), if an endpoint buffer control register handoff coincides with a specific packet transition or Transaction Translator abort from a High-Speed USB 2.0/3.0 hub, the internal USB receiver state machine deadlocks and stops decoding subsequent SOF (Start-Of-Frame) tokens.

How to Fix It (Pico SDK 1.5.1+ & PICORP2040USBDEVICEUFRAME_FIX)

Raspberry Pi engineers added the official software/hardware workaround for RP2040-E15 in Pico SDK 1.5.1 (which enables PICORP2040USBDEVICEUFRAMEFIX=1 by default in dcdrp2040.c).

Update your pico-sdk to 1.5.1 (or 2.0.0+) AND update its tinyusb submodule: bash cd $PICOSDKPATH git fetch --tags && git checkout 1.5.1 git submodule update --init --recursive (Many developers git pull the main pico-sdk repo but forget git submodule update --init --recursive, which leaves lib/tinyusb stuck on the older unpatched dcd_rp2040.c driver!).

Important Note on RP2040-E15 Workaround Requirements: The PICORP2040USBDEVICEUFRAMEFIX workaround in dcdrp2040.c uses a PIO state machine / DMA timer synchronization mechanism to schedule unsafe IN endpoint transfers away from the end-of-microframe window. Make sure your application does not disable or starve the USB IRQ or claim all PIO instructions if the E15 workaround is active.

I wrote a full breakdown of RP2040-E15 and RP2040-E5 USB errata and submodule update verification on Mentora: https://mentora.school/blog/fix-rp2040-usb-device-controller-lockup-erratum-e15-pico-sdk