Documentation · v1

Firmware updates.

Flashing the latest DiscoX firmware takes about a minute. This page walks you through entering Firmware Update Mode and dropping a new .uf2 file onto the device.

On this page

Latest firmware01 Entering update mode02 Flashing the .uf203 Troubleshooting04 Changelog05
01 · Current release

Latest firmware

The DiscoX runs an open-source C++ firmware built on the SAP6 platform. New releases ship roughly monthly with bug fixes, calibration improvements, and the occasional new feature.

Download discox-v1.4.2.uf2 All releases on GitHub

v1.4.2 · released 2026-04-12 · sha256 9f3c…b21a

02 · Bootloader

Entering Firmware Update Mode

Firmware Update Mode (also called UF2 bootloader mode) is what makes the DiscoX appear on your computer as a USB drive named DISCOX. While in this mode the device is waiting for a new firmware file — drag one on, and it flashes itself.

● Bootloader

The device looks like a USB drive

When the DiscoX is in Firmware Update Mode, the screen shows a steady bootloader prompt and your computer mounts a removable drive called DISCOX.

Method A — From the menu (recommended)

If your DiscoX is already running working firmware, this is the easiest path. No buttons gymnastics required.

  1. Power the device on and wait for the home screen.
  2. Press Button 3 to open the menu.
  3. Scroll to Update / Settings and select with Button 3.
  4. Select Update Firmware.
  5. The device reboots and the screen shows the bootloader prompt.
  6. Plug in USB-C — a drive named DISCOX will appear on your computer.

Method B — Double-press reset (recovery)

Use this if the firmware is unresponsive, the menu won't open, or a previous flash was interrupted. The device's reset is reachable through the USB-C port without opening the case.

  1. Connect the DiscoX to your computer with a USB-C data cable.
  2. Quickly double-press the reset button on the mainboard (or, on assembled units, double-tap Button 4 within 0.5s while plugged in).
  3. The status LED settles to a steady amber/red glow — that's the bootloader signal.
  4. The screen shows DISCOX BOOTLOADER and the DISCOX drive mounts.
Tip · Use a data cable

A surprising number of USB-C cables are charge-only. If the device powers on but no drive appears, swap the cable before assuming anything is wrong.

How to tell you're in update mode

  • The screen shows DISCOX BOOTLOADER with a version line.
  • The status LED holds a steady colour (no breathing or pulsing).
  • A removable drive called DISCOX has mounted on your computer.
  • The laser is off and buttons no longer take readings.
03 · Drag & drop

Flashing the .uf2

With the device in Firmware Update Mode and the DISCOX drive mounted, you're ready to flash.

  1. Download the latest .uf2 file from the link above.
  2. Open the DISCOX drive in Finder, Explorer, or your file manager.
  3. Drag the .uf2 onto the drive (or copy & paste — either works).
  4. The drive will dismount on its own as flashing starts. Don't unplug.
  5. After 5–15 seconds the device reboots into normal firmware and the home screen returns.
  6. Open Menu → About to confirm the version number matches what you flashed.
Don't interrupt the flash

Once the drive disappears, the chip is rewriting its own firmware. Pulling the cable mid-flash can leave the device in a half-written state — recoverable via Method B above, but easier just to wait the few seconds it takes.

04 · If something's off

Troubleshooting

No drive

The DISCOX drive doesn't appear

Try a different USB-C cable — many are charge-only. If you're sure the cable is fine, use Method B (double-press reset) to force the bootloader.

Stuck

Device won't boot after flashing

Hold the power button for 10 seconds to fully power down, then plug back in and re-enter update mode via Method B. Re-flash the latest known-good .uf2.

Wrong file

Drive ejects with a FAIL.TXT

The bootloader rejected the file. Make sure you downloaded the .uf2 for DiscoX (not a generic SAP6 build) and that the file isn't corrupted — re-download and try again.

Settings

My config.json was wiped

Major firmware updates can reset the settings file to defaults. Your calibration is preserved separately. Re-edit config.json via Menu → Update / Settings → Edit Settings File.

05 · What's new

Changelog

v1.4.2 — 2026-04-12

  • Improved leg detection at near-vertical clinos.
  • BLE reconnection is faster after the phone wakes from sleep.
  • Fixed an edge case where Mag Field Check could overflow on >9 pairs.

v1.4.0 — 2026-03-04

  • New Mag Field Check mode — verify cal accuracy without re-running a full calibration.
  • Auto-shutdown timer is now configurable in 6 steps.
  • Disco mode adds a "wild" sub-mode triggered by shaking the device.

v1.3.5 — 2026-01-22

  • Battery monitor IC support — proportional battery bar replaces the 3-segment indicator.
  • Lowered laser-distance offset default to 0.162 for production runs after the v3 case.