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.

Installing tools to build the firmware

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.

Linux :linux:
macOS :mac:

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:

# apt install build-essential make libpython2.7-dev

Install arm-none-eabi-gcc 10.3.

# toolchain="gcc-arm-none-eabi-10.3-2021.10" # toolchain_package="$toolchain-$(uname -m)-linux" # wget -P /opt "https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/$toolchain_package.tar.bz2" # tar xjf /opt/$toolchain_package.tar.bz2 -C /opt # rm /opt/$toolchain_package.tar.bz2 # for file in /opt/$toolchain/bin/* ; do ln -s "${file}" "/usr/bin/$(basename ${file})" ; done

Install Python 2.7.

$ sudo apt install libpython2.7-dev

Install the libncurses5 package

$ sudo apt-get install libncurses5

For the debugger to work using USB you'll need to set up Udev deivce access rules. To do this, create the rule file:

SUBSYSTEMS=="usb", ATTRS{idVendor}=="1d50", ATTRS{idProduct}=="6018", GROUP="plugdev", MODE="0666" SUBSYSTEMS=="usb", ATTRS{idVendor}=="303a", ATTRS{idProduct}=="40??", GROUP="plugdev", MODE="0666"

Reload Udev rules:

# udevadm control --reload-rules && udevadm trigger

Pre-made debugger files

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:

flipper-z-f7-firmware-***.elf flipper-z-f7-full-***.bin flipper-z-f7-full-***.dfu flipper-z-f7-full-***.json

Where *** — is the required firmware version.

Place them into you local firmware repository folder/flipperzero-firmware/dist/f7.

Building the firmware

Clone the repository to your computer and build the Flipper Zero firmware:

$ git clone https://github.com/flipperdevices/flipperzero-firmware.git $ cd flipperzero-firmware $ ./fbt

Connecting to the PC

Before launching GDB, you need to choose one of the two connection methods:

USB connection :usb:
Wi-Fi connection :wifi:
Document image

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
Linux :linux:
macOS :mac:

Run ls /dev/ttyACM* in terminal to watch device list:

$ ls /dev/ttyACM* /dev/ttyACM0  /dev/ttyACM1

Port /dev/ttyACM0 is used to connect to the GDB server.

Launching the debugger

Open the terminal and run the command according to your connection method:

via Wi-Fi

$ ./fbt blackmagic

via USB

$ ./fbt blackmagic

You can learn more on working with GDB on the Working with GDB page.

Factory reset

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:

  1. Power the module via a USB cable or by connecting it to the Flipper Zero's GPIO
  2. 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.

Updated 03 Aug 2022
Did this page help you?