First start
The Wi-Fi module can only work in one of the Wi-Fi modes at a time. If it does not connect to a known network, you can enable Access Point mode by performing a factory reset.The Wi-Fi Debugger Module is used for debugging the Flipper Zero's firmware. To begin working with the Wi-Fi Debugger Module you'll need to install building and debugging tools on your PC, for example GDB, GCC etc. After that you can build the device's firmware, connect your device to your computer using one of the methods below and run GDB.
For the debugger to work correctly, the firmware version on the device and in the files used by the debugger should be the same. If you plan on debugging your custom firmware, you'll need to install the tools needed to build it. This option is recommended for those who don't have any experience with debugging. If you already have debug tools installed, you can get the needed debugger files from our server.
In this example Ubuntu 22.04 :linux: is used.
Commands prefixed with # should be run as root, while the ones prefixed with $ can be run as your user.
Install build-essential and make:
Install arm-none-eabi-gcc 10.3.
Install Python 2.7.
Install the libncurses5 package
For the debugger to work using USB you'll need to set up Udev deivce access rules. To do this, create the rule file:
Reload Udev rules:
If you plan on debugging the official firmware and don't want to install the build tools, you can download all the needed files from our update server. Among them you'll find binary firmware files and an elf-file used by the debugger. Download the files:
Where *** — is the required firmware version.
Place them into you local firmware repository folder/flipperzero-firmware/dist/f7.
Clone the repository to your computer and build the Flipper Zero firmware:
Before launching GDB, you need to choose one of the two connection methods:

Connect the module to your computer with a USB cable.
When you connect the module to your computer, two Serial ports will be detected in the system:
- The first port that appears is used for communicating with the GDB server
- The second port that appears is used for UART
Run ls /dev/ttyACM* in terminal to watch device list:
Port /dev/ttyACM0 is used to connect to the GDB server.
Open the terminal and run the command according to your connection method:
$ ./fbt blackmagic
$ ./fbt blackmagic
You can learn more on working with GDB on the Working with GDB page.
The Wi-Fi module can only work in one of the Wi-Fi modes at a time. If it does not connect to a known network, you can enable Access Point mode by performing a factory reset.
To reset the Wi-Fi Debugger Module settings:
- Power the module via a USB cable or by connecting it to the Flipper Zero's GPIO
- Press and hold the Boot button until the LED changes its color to red.
After resetting the Wi-Fi settings, the module will switch to Access Point mode and will be available by the standard network name and IP address.