Skip to main content

Troubleshooting

Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.

Connection and upload​

The board does not show up as a port

Some USB cables only carry power. Try a cable you know transfers data, and plug it straight into the computer rather than through a hub. The RP2040 handles USB itself, so the board needs no separate USB-to-serial driver.

The upload fails or cannot connect

Check that Tools → Board and Tools → Port match this board. Close anything else that has the port open (Serial Monitor, Thonny or another terminal), because only one program can use it at a time.

If the board has stopped responding, it may not answer the upload's reset request. Unplug it, hold the BOOT button down while you plug it back in, and upload again. This starts the RP2040's USB bootloader, which takes the upload.

The port changes or disappears after an upload

A board with native USB restarts its USB connection after every upload or reset, and the port can come back under a different name. Select the port again in Tools → Port before opening Serial Monitor.

Serial output​

Serial Monitor shows random characters

The baud rate in Serial Monitor does not match the one in the sketch. Set the dropdown in the corner of Serial Monitor to the value in Serial.begin(), which is 115200 for the Quick Start example.

Serial Monitor stays empty

Press the board's RESET button with Serial Monitor open: the sketch may have printed before the monitor connected.

Power and voltage​

The board resets on its own, often when Wi-Fi starts

The supply cannot keep up with the current peaks, and the chip restarts when the voltage dips. Use a USB port on the computer itself or a powered hub, a shorter cable, or a charged battery.

A connected sensor or module does not work

The GPIO pins use 3.3 V logic. A 5 V signal on a GPIO pin can damage the board, so connect 5 V parts through a level shifter, and power each part from the voltage its own documentation asks for.

Nothing lights up, or the board gets warm

Unplug it straight away and disconnect everything wired to it. Look for a short between power and ground, then reconnect one part at a time. If a battery is connected, check its wiring before you plug it in again: battery plugs from different makers are not all wired the same way. See Power supply.

Board-specific issues​

Windows does not detect the board

The Windows Store version of the Arduino IDE has trouble detecting RP2040 boards. Install the Arduino IDE from arduino.cc instead, using the plain Windows installer or the Windows ZIP, and allow it to install any device drivers it suggests.

On Linux, the upload ends with “No drive to deploy”

An Arduino IDE installed through Flatpak (which many Linux app stores use) has restricted access to your computer, so uploads can fail with:

Scanning for RP2040 devices
...
No drive to deploy.

Install the Arduino IDE another way, or allow it access with this command and then restart the IDE:

flatpak override --user --filesystem=host:ro cc.arduino.IDE2

Still blocked?​