Skip to content

Revert Firmware Version

If a firmware update introduced unexpected behavior with your setup, you can roll back to the previous version that is still resident on your device—no download required, and it completes in seconds. This feature is sometimes referred to as Firmware Update Undo.

Availability

Firmware undo is available on Bond Bridge (BD-1000), Bond Bridge Pro (BD-1750), Firefly, and Smart by Bond1. It is not available on Mate or Sidekick, which use a different update mechanism.

Limitations

  • One step back only. The device stores one previous firmware image. Each update overwrites the oldest image, so only the version immediately before your last update is available.
  • Minimum version. The stored image must be v3.0 or later. Devices that shipped with older firmware won't show a revert option until they've been through at least two updates on v3+.
  • Settings are preserved, with a caveat. Your devices, rooms, and configuration survive a revert. However, if the newer firmware added settings for a new feature, the older firmware may discard those settings when it writes to the database. Upgrading again may not restore them—you may need to reconfigure that feature.

Note: firmware undo cannot restore the original factory image. To do that, see Rescue Reset.

How to Revert in the Bond Home App

Back Up First

We recommend backing up your device configuration from the device settings screen before reverting. While settings are preserved, a backup ensures you can recover if the older firmware has trouble with configuration written by the newer version.

  1. Open the Bond Home app and select your device
  2. Navigate to the Firmware Version screen
  3. Tap the overflow menu (three dots) in the top-right corner
  4. Select Revert Firmware Version
  5. Review the current and previous firmware versions in the confirmation dialog, then confirm
  6. The device will reboot automatically. A success banner will confirm: "Firmware successfully reverted."

If you don't see the Revert Firmware Version option, your device either hasn't been updated yet or the stored image is too old (pre-v3.0).

For Developers: Local API

How It Works

Bond devices store three firmware images in flash: the original factory image (never overwritten) and two update slots that alternate with each upgrade. When you update, the new image is written to the inactive slot while the old one stays intact. Reverting switches the boot partition back to that previous slot and reboots.

Checking Revert Availability

The undo_ver field on v2/sys/version indicates the stored previous firmware version, or null if no valid image is available.

GET http://<bond-ip>/v2/sys/version
→ { "fw_ver": "v4.3.0", "undo_ver": "v4.1.0", ... }

Triggering a Revert

PUT http://<bond-ip>/v2/sys/upgrade
{ "undo": 1, "reboot": 1 }

The undo field must not be combined with other upgrade fields (host, path, info, sig). Setting reboot to 1 triggers an automatic reboot after 3 seconds; omitting it switches the boot partition but waits for a manual reboot.

Monitoring Progress

Poll GET v2/sys/upgrade to monitor status:

  • progress: 999—auto-reboot in progress
  • progress: 1000—partition switched, awaiting manual reboot
  • error_msg—present if something went wrong

After the device reboots, confirm the revert succeeded by checking that fw_ver on v2/sys/version matches the expected previous version.

  1. Smart by Bond products include ceiling fans, heaters, and lighting controllers produced by our partners. ↩