GP2040-CE Upgrade Instructions
This article is intended to provide a step-by-step guide to updating your GP2040-powered SGF product, such as BRIDGET, FAUST, and EDDIE. It does not cover every possible scenario, only the most common. If further assistance is needed, please contact us at firstname.lastname@example.org
Round 1 - Preparation
Head to the GP2040-CE downloads page and scroll to the latest "regular" release. You don't want anything that has "-RC" or "Beta" or anything like that in the name.
Under the correct release page, click the arrow next to "Assets" to expand the list of files if they're not already visible.
First, download the flash_nuke.uf2 file. This can erase the entire PCB if something goes wrong -- it's not usually needed, but good to have on hand. This file is the same for every piece of hardware.
Next, download the correct firmware for your product.
BRIDGET - GP2040-CE_(release)_SGFBridget.uf2
FAUST - GP2040-CE_(release)_SGFFaust.uf2
EDDIE - GP2040-CE_(release)_RP2040AdvancedBreakoutBoardUSBPassthrough.uf2
Remember where these files are downloaded, as you'll need them soon.
Round 2 - Back That Thing Up
Unplug your controller if it's plugged in. While holding the START (S2) button, plug it into a computer and keep holding the button for about 5 seconds after plugging it in, then release the button.
Next, open a web browser on the computer and navigate to http://192.168.7.1/ -- this is the web configurator for GP2040-CE.
Inside the web configurator, click Configuration, then Data Backup and Restoration. Once inside this page, under the backup section, make sure all options are selected and click Save to save a backup of your current configuration. You shouldn't need this, but it's handy to have just in case.
Round 3 - Upgrayedd
While still in the web configurator page, click the big REBOOT button, then select USB (BOOTSEL). This will automatically reboot your controller into BOOTSEL mode, where it will show up on the computer as a removable media device (like a USB flash storage drive) called RPI-RP2.
IF AND ONLY IF RECOMMENDED BY THE GP2040-CE RELEASE NOTES OR SGF:
At this point, you may drop the flash_nuke.uf2 file into the main folder of the RPI-RP2 drive. DO NOT UNPLUG THE CONTROLLER. After a few seconds, it will reboot again and show up as a drive with the same name. This is normal and means that it has been erased successfully.
Finally, drop the correct .uf2 file for the release you downloaded into the RPI-RP2 drive. This will automatically reboot your controller and the drive will not show back up. You can now visit https://gamepad-tester.com/ and press some buttons on the controller to verify that it's working.
Bonus Round - Restoring
If you erased before or otherwise lost your configuration, re-enter the web configurator by using the same steps from above. Navigate back to the Data Backup and Restoration page, under the Restoration section, make sure all of the checkboxes are selected, then restore using the file you backed up earlier. Reboot when done.