RunBridge Firmware Updates

RunBridge uses a Seeed XIAO nRF52840 module. Updating firmware means copying a single .uf2 file to the board’s UF2 bootloader drive (it is not a normal USB stick).

Before you start

• You have the .uf2 file from support (download or email attachment).
• Use a USB cable that supports data (many are charge-only) and a reliable adapter if your computer needs one; avoid flaky hubs if you can.
• To check the firmware version afterward, use Chrome or Edge on a desktop with the Extractor page (see below).

Reset button (all computers)

Double-tap Reset means press the small Reset button twice quickly (about as fast as a double-click). Use something gentle that won’t scratch the board—a toothpick, plastic pick, or similar. If you are too slow, the board just reboots normally; try again with two quicker taps.

Windows

1. Save the .uf2 file somewhere easy to find, such as Downloads or your Desktop. If you downloaded it from email and Windows “blocked” it: right-click the file → Properties → check Unblock (if shown) → OK.
2. Plug RunBridge into the PC. Open File Explorer (folder icon on the taskbar). Select This PC in the left sidebar so you can see drives.
3. Double-tap Reset on RunBridge (see photo above). Within a few seconds, a new removable drive should appear. Its name can vary. Common examples include RUNBRIDGE or XIAO-SENSE, but use whichever new small drive appears right after the double-tap.
4. Open that drive. Drag your .uf2 file into the window, or copy and paste it there. The drive contains a file named CURRENT.UF2. When Windows asks to replace that file, choose Replace—replacing CURRENT.UF2 with the firmware support sent you is normal, expected, and safe.
5. Wait a moment. The drive may vanish while Windows still shows a copy dialog—see the yellow note above. If the drive disappears and RunBridge reconnects, the update probably succeeded even if Windows reported an error.
6. After a short wait, the RGB LED should show a brief boot color cycle when the firmware starts. After that, the LED may be off until normal device activity begins (examples in LED States).
7. If you never see that boot color cycle after USB power, unplug RunBridge, wait a few seconds, and plug it back in, then watch the LED again (this is more common on Mac but helps on Windows too).

macOS

1. Save the .uf2 file to Downloads or Desktop.
2. Plug RunBridge into your Mac. If macOS shows a prompt to allow or trust a new USB accessory, choose Allow (wording varies by macOS version). If you tapped Don’t Allow by mistake, open System Settings → General or Privacy & Security and look for USB or accessory settings to approve the device, or unplug and plug in again and allow when prompted.
3. Open Finder. In the sidebar under Locations, watch for your Mac and any removable volumes.
4. Double-tap Reset on RunBridge. Within a few seconds, a new volume should appear. Its name can vary. Common examples include RUNBRIDGE or XIAO-SENSE, but use whichever new volume appears right after the double-tap. If macOS asks again to allow a USB accessory, Allow—the bootloader looks like a different device to the system.
5. Drag your .uf2 file onto that volume, or open the volume and copy the file inside. You may see a Finder message that the copy could not be completed; if the volume disappears and the device reconnects, the flash may still have succeeded (see the yellow note above).
6. After updating, the RGB LED should show a brief boot color cycle when the firmware starts. After that, the LED may be off until normal device activity begins (examples in LED States).
7. If you never see that boot color cycle, or you are unsure the update finished, unplug RunBridge, wait a few seconds, and plug it back in—macOS often needs this clean USB cycle—then check the LED again.