Device Management
RunBridge Firmware Updates
Firmware updates are not available for public download. They are provided by support as needed on an individual basis.
How to get an update
If you need a firmware update (for example to address a compatibility issue), contact support@runbridge.dev. Support will provide the appropriate firmware file and instructions when an update is warranted for your situation.
If support sends you a firmware file
When support provides a .UF2 file, install it as follows:
- Plug in RunBridge.
- Double-tap Reset quickly (toothpick or small object) to enter update mode.
-
- A USB drive will appear (e.g. RUNBRIDGE, XIAO-SENSE). Open it and drag the .UF2 file onto the drive (replace if asked).
Troubleshooting
- Drive not showing? Try a different USB cable or adjust your double-tap speed.
- Replacing file? Yes, it is safe to overwrite the existing CURRENT.UF2.
- Device stuck in DFU? If the LED stays pulsing, simply drag the CURRENT.UF2 file onto the drive again to restore it.
Developer Tools (Hex Converter)
Tool: Hex to UF2 Converter
Developer Utility: Convert raw Arduino .hex exports to release-ready .uf2 files.
Version History
Current Version: 3.2.1
📦 Version 3.2.1 – Spirit fix, logging, distance (February 2026)
Improves compatibility with Spirit and similar treadmills; better logging and distance sync.
✨ Highlights
- Spirit treadmill compatibility fix (CCCD write behavior)
- Larger log files and archive for support diagnostics
- Odometer interpolation so watch distance tracks treadmill display more closely
📦 Version 3.1.3 – Initial Public Release (January 2026)
First stable release for public distribution.
✨ Features
- FTMS treadmill bridge for Garmin watches
- Real-time heart rate relay from watch to treadmill
- Automatic session summary logging
- Distance banking for mid-session odometer resets
- Early odometer capture for reliable session summaries
🔧 Technical Details
- Bluetooth Low Energy (BLE) dual-mode operation
- Built-in serial logging for debugging
- Web-based firmware updater support
When to Update: Your RunBridge comes with firmware pre-installed. Firmware updates are provided by support as needed on an individual basis—contact support@runbridge.dev if you need an update.