Firmware updates add games and fix link bugs. Install the launcher’s version from the browser, install your own .uf2, or copy a file onto the board by hand.

The easiest way to update is through the launcher:

  1. Go to launcher.gblink.io in Chrome or Edge.
  2. Click Connect and select the adapter.
  3. Read the Firmware line in Device Health.
  4. If the panel says Update available, click Update firmware and wait until it finishes.
  5. If the page asks you to reconnect, click Connect again and check that Firmware shows the new version.

You do not download a file. The launcher writes the firmware in the browser. Firefox can show the version, but it cannot do this one-click write. Use the manual steps below.

Custom UF2

Use this when you have your own .uf2, such as a build from Building from Source, instead of a version the launcher already lists.

  1. Open launcher.gblink.io in Chrome or Edge and click Connect.
  2. In Device Health, open Version to install.
  3. Choose Select custom firmware (uf2). A file picker opens.
  4. Pick your .uf2. The heading changes to Install custom firmware: and shows the file name. The button changes to Install custom firmware.
  5. Click Install custom firmware and wait until it finishes.
  6. If the page asks you to reconnect, click Connect again and check Firmware.

Canceling the file picker returns the panel to the bundled version. If the page cannot read the file, pick another .uf2.

Firefox can select the file the same way, but it cannot write it in one click. After the file is chosen, open Flash manually instead, download it, and follow the manual steps below.

Manual update

Use this if you are on Firefox, or if the one-click update stops.

  1. Download gblink.uf2 from the latest release on GitHub, or use Download firmware (.uf2) on the launcher.
  2. Unplug the adapter.
  3. Hold the BOOTSEL button on the board.
  4. While holding BOOTSEL, plug the adapter into USB.
  5. Release BOOTSEL. A drive named RPI-RP2 appears.
  6. Copy the .uf2 file onto that drive.
  7. The drive disappears and the adapter reboots on the new firmware.
Cased GB-Link USB V2 with the left button circled
On a cased GB-Link USB V2, BOOTSEL is the circled button on the left. The opening on the right is labeled RUN. On a bare Pico, BOOTSEL is the single button next to the USB port.

After updating

  • Click Connect again.
  • Check that Firmware in Device Health matches the version you just installed.
  • If a game still fails, unplug the adapter, plug it back in, and connect again.

Troubleshooting

IssueFix
Update stallsUnplug, hold BOOTSEL, reconnect, and try manual flash
Wrong version shownRefresh the page; reset the adapter
Device not recognized after flashTry a different USB port or cable

For technical build instructions, see Building from Source.