Install Firmware and Customize Settings
GP2040-CE is an open source gamepad firmware that's compatible with RetroPie, Mac/PC/Linux, PlayStation 3/4/5, Nintendo Switch/Switch 2, Xbox 360/One/Series, mini consoles, and others. It runs on a number of microcontrollers which use Raspberry Pi RP2040/RP2305 chips, such as The QT Py, Pico, KB2040 Kee Boar, and more.
First you'll flash the QT Py RP2040 with the drag-and-drop .uf2 file and then customize settings within a web editor.
Download Firmware
There isn't an official build for the QT Py RP2040 yes, but you can use this pre-release version by clicking the GP2040-CE_0.7.12_AdafruitQTPyRP2040.uf2 file.
This will save a file named GP2040-CE_0.7.12_AdafruitQTPyRP2040.uf2 to your download location.
Firmware Installation
This page gives detailed instructions on installation, but the basic steps are:
- Plug the QT Py RP2040 into your computer with a known good data and power USB cable
- While holding the
BOOTSELbutton down, press and release theRESETbutton this puts the board into BOOTSEL/USB drive mode - A new removable drive named
RPI-RP2will appear on your computer - Drag-and-drop the GP2040-CE_0.7.12_AdafruitQTPyRP2040.uf2 (or later) firmware .uf2 file onto the
RPI-RP2drive and wait for it to copy the file and reboot itself
Button Test
This is a great time to test the controller to make sure basic button presses are working.
Plug the QT Py RP2040 into your computer with a known good USB-C data and power cable. Head to this gamepad tester in your browser to see the button presses.
You can now use a jumper wire to short any mapped GPIO pin to ground -- those button presses will register on the controller tester.
Page last edited May 20, 2026
Text editor powered by tinymce.
