website logo
HomeShopDocsBlogForum
⌘K
Flipper Zero Documentation
Basics
🐬First start
MicroSD card setup
Firmware update
Pet dolphin
Power
Reboot
Controls
Settings
Sub-GHz
Reading signals
Reading RAW signals
Adding new remotes
Supported Sub-GHz vendors
Frequencies
125 kHz RFID
Reading 125 kHz RFID cards
Adding 125 kHz cards manually
Animal microchips
NFC
Reading NFC cards
Recovering keys with MFKey32
Unlocking cards with passwords
Writing data to magic cards
Infrared
Reading infrared signals
Using universal remotes
GPIO & modules
iButton
Bad USB
U2F (Universal 2nd Factor)
Applications
HID controllers
Flipper Mobile App
Reporting Mobile App bugs
qFlipper
Troubleshoot drivers on Windows
Development
Firmware
Hardware
Blueprints
Docs powered by archbee 

Firmware recovery

Document image


Occasionally, your Flipper Zero may fail to update correctly, display images, or respond to button presses. These issues could be caused by corruption in the device's firmware. You can repair the corrupted firmware with the help of the qFlipper desktop application and the built-in USB Device Firmware Update (DFU) bootloader. The USB DFU bootloader allows you to update your Flipper Zero by bypassing the device's operating system, which minimizes the risk of errors during the update process.

But first, try doing the following:

  • Reboot your Flipper Zero by pressing and holding the %left%LEFT and %back%BACK buttons.
  • Charge your device with the provided USB Type-C cable for several minutes because your Flipper Zero might have the battery completely drained.

If you still have the problems mentioned above, proceed to the repair procedure.

<div class="warning flipper-callout">
    <div class="callout-header">Firmware repair erases all internal storage data</div>
    The dolphin's level, settings, and information about paired devices will be erased. <b>Data on the microSD card will be saved.</b>
</div>



Switching to Recovery mode

Before starting the repair procedure with qFlipper, you must switch your Flipper Zero to Recovery mode, which activates the built-in USB DFU bootloader. The process of switching your device to Recovery mode can vary depending on the state of the device.

If your device is operational but fails to update properly

Switch your Flipper Zero to Recovery mode by doing the following:

  1. Go to Main Menu -> Settings -> Power.
  2. Then go to Reboot -> Firmware upgrade.

    You will see the Recovery mode screen
    You will see the Recovery mode screen
    
  3. Connect your Flipper Zero to a computer via a USB cable. The computer should detect your Flipper Zero as a DFU device.

Alternatively, you can switch the device to Recovery mode by doing the following:

  1. Press and hold the %left%LEFT and %back%BACK buttons at the same time.
  2. Release the %back%BACK button, but keep pressing the %left%LEFT button until the blue LED lights up.
  3. Connect your Flipper Zero to a computer via a USB cable. The computer should detect your Flipper Zero as a DFU device.
<video
    autoplay muted loop playsinline style="width: 100%; margin: 0 !important;"
    src="https://cdn.flipperzero.one/Flipper_DFU_button_compressed.mp4"
></video>

<div class="info flipper-callout">
    <div class="callout-header"></div>
     To exit Recovery mode, press and hold the %left%<b>LEFT</b> and %back%<b>BACK</b> buttons.
</div>



If your device fails to display any images or respond to button presses

If your Flipper Zero is bricked, switch the device to Recovery mode via a hard reboot:

  1. Unplug the USB cable from your Flipper Zero if connected.
  2. Press and hold the %ok%OK and %back%BACK buttons for 30 seconds. It is normal if your Flipper Zero has no indications on the screen.
  3. Connect your Flipper Zero to a computer via a USB cable. The computer should detect your Flipper Zero as a DFU device.
<video
    autoplay muted loop playsinline style="width: 100%; margin: 0 !important;"
    src="https://cdn.flipperzero.one/flipper_recovery_dfu_mode_compressed.mp4"
></video>




Checking the connection

You can check if the device is connected to your computer as a DFU device by doing the following:

%windows%Windows
%mac%macOS
%linux%Linux
  1. Go to Device Manager.
  2. Find the DFU in FS Mode device.
Your Flipper Zero is successfully connected as a DFU device
Your Flipper Zero is successfully connected as a DFU device




<div class="info flipper-callout">
    <div class="callout-header"></div>
    The Flipper Zero DFU device doesn't come with a driver for Windows. The driver is automatically installed during the qFlipper application installation process.</b>
</div>

  1. Go to  -> About This Mac -> More info -> System Report.
  2. Then go to Hardware -> USB.
  3. Find the DFU in FS Mode device.
Your Flipper Zero is successfully connected as a DFU device
Your Flipper Zero is successfully connected as a DFU device




<div class="info flipper-callout">
    <div class="callout-header"></div>
    On macOS, the list of connected devices doesn't refresh automatically when connecting a new device. To update the list and view the newly connected device, press <b>Command+R</b>.
</div>




You can also check if your Flipper Zero is connected to your computer as a DFU device using the Terminal by running the system_profiler SPUSBDataType command:



You can check the connection via the Terminal
You can check the connection via the Terminal




  1. Run the Terminal and enter the lsusb command.
  2. Find the STMicroelectronics STM Device in DFU Mode.
You can check the connection via the Terminal
You can check the connection via the Terminal




If you have a system information tool installed on your computer:

  1. Go to USB Devices.
  2. Find the DFU in FS Mode device.
You can check the connection via systems information tools
You can check the connection via systems information tools




If your Flipper Zero isn't detected as a DFU device

  • Use a different USB cable.
  • If possible, connect your Flipper Zero directly to a USB port on your computer's motherboard, avoiding the use of an adapter or hub.
  • First, remove the microSD card from your Flipper Zero, charge the device for one hour, then attempt to connect it without the microSD card inserted.


Repairing the firmware via qFlipper

Once your Flipper Zero is connected to your computer as a DFU device, the qFlipper application automatically detects the device.

To repair the firmware:

  1. Run the qFlipper application on your computer.
  2. Connect your Flipper Zero to your computer as a DFU device.
  3. On your computer, click the Repair button. The qFlipper application will perform a complete installation of the firmware.
qFlipper automatically detects your Flipper Zero as a DFU device
qFlipper automatically detects your Flipper Zero as a DFU device


If qFlipper fails to repair the firmware

  • Reboot your device by pressing and holding the %left%LEFT and %back%BACK buttons with a USB cable disconnected, then repeat the repair procedure.
  • If qFlipper still fails to repair the firmware, make a hard reboot by pressing and holding the %back%BACK button for 30 seconds with a USB cable disconnected, then repeat the repair procedure.
  • Run the qFlipper application as an administrator.
  • If possible, connect your Flipper Zero directly to a USB port on your computer's motherboard, avoiding the use of an adapter or hub.



Updated 08 Jun 2023
Did this page help you?
Yes
No
PREVIOUS
Internal storage repair
NEXT
Pet dolphin
Docs powered by archbee 
TABLE OF CONTENTS
Switching to Recovery mode
If your device is operational but fails to update properly
If your device fails to display any images or respond to button presses
Checking the connection
If your Flipper Zero isn't detected as a DFU device
Repairing the firmware via qFlipper
If qFlipper fails to repair the firmware

Community

Kickstarter Habr.com Discord Forum Blog

For developers

Documentation GitHub Design Guide

Distributors

Lab401 Joom How to buy Become a Partner

About

Contacts Compliance Company Abuse Report Privacy Policy

Copyright © 2023 Flipper Devices Inc.