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
Writing data to T5577 cards
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)
Apps
HID controllers
Flipper Mobile App
Reporting Mobile App bugs
qFlipper
Troubleshooting drivers on Windows
Development
Hardware
Blueprints
Docs powered by
Archbee
Development
...
Hardware
Wi-Fi Developer Board

Get started with the Dev Board

The Wi-Fi Developer Board serves as a tool to debug the Flipper Zero firmware. To debug the firmware, the initial step involves compiling the firmware from its source code. This process enables the debugging functionality within the firmware and generates all the necessary files required for debugging purposes.

<div class="info flipper-callout">
    <div class="callout-header"></div>
    Building and debugging the Flipper Zero firmware is fully supported on MacOS and Linux. Support for Windows is in beta test.
</div>



Updating the firmware of your Developer Board

Update the firmware of your Developer Board before using it. For more information, visit Firmware update on Developer Board.



Installing Git

You’ll need Git installed on your computer to clone the firmware repository. If you don’t have Git, install it by doing the following:

%mac%MacOS

On MacOS, install the Xcode Command Line Tools package, which includes Git as one of the pre-installed command-line utilities, by running in the Terminal the following command:

xcode-select --install

%linux%Linux

On Linux, you can install Git using your package manager. For example, on Ubuntu, run in the Terminal the following command:

sudo apt install git

For other distributions, refer to your package manager documentation.



Building the firmware

First, clone the firmware repository:

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

Then, run the Flipper Build Tool (FBT) to build the firmware:

./fbt


Connecting the Developer Board

The Developer Board can work in the Wired mode and two Wireless modes: Wi-Fi access point (AP) mode and Wi-Fi client (STA) mode. The Wired mode is the simplest to set up, but requires a USB Type-C cable. The Wireless modes are more complex to set up, but they allow you to debug your Flipper Zero wirelessly.

<div class="info flipper-callout">
    <div class="callout-header"></div>
    Use the following credentials when connecting to the Developer Board in <span style="white-space: nowrap;"><b>Wi-Fi access point</b></span> mode:
    <br>
    <br>
    Name: <b>blackmagic</b>
    <br>
    Password: <b>iamwitcher</b>
</div>

%usb%Wired
%wifi%Wireless
The Developer Board in Wired mode
The Developer Board in Wired mode


To connect the Developer Board in Wired mode, do the following:

1

Cold-plug the Developer Board by turning off your Flipper Zero and connecting the Developer Board, and then turning it back on.

2

On your computer, open the Terminal and run the following:

%mac%MacOS

ls /dev/cu.*

%linux%Linux

ls /dev/tty*

Note the list of devices.

3

Connect the Developer Board to your computer via a USB-C cable.

4

Rerun the command. Two new devices have to appear: this is the Developer Board.

<div class="info flipper-callout">
    <div class="callout-header"></div>
   If the Developer Board doesn’t appear in the list of devices, try using a different cable, USB port, or computer.
</div>

<div class="info flipper-callout">
    <div class="callout-header"></div>
Flipper Zero logs can only be viewed when the Developer Board is connected via USB. The option to view logs over Wi-Fi will be added in future updates. For more information, visit <a href="https://docs.flipperzero.one/development/hardware/wifi-debugger-module/reading-logs" onclick="next.router.push('https://docs.flipperzero.one/development/hardware/wifi-debugger-module/reading-logs')"><u>Reading logs via the Dev Board</u>.
</div>


Wi-Fi access point (AP) mode

The Developer Board in Wi-Fi access point mode
The Developer Board in Wi-Fi access point mode


Out of the box, the Developer Board is configured to work as a Wi-Fi access point. This means it will create its own Wi-Fi network to which you can connect. If your Developer Board doesn’t create a Wi-Fi network, it is probably configured to work in Wi-Fi client mode. To reset your Developer Board back to Wi-Fi access point mode, press and hold the BOOT button for 10 seconds, then wait for the module to reboot.

You can reconfigure the Developer Board mode by pressing and holding the BOOT button
You can reconfigure the Developer Board mode by pressing and holding the BOOT button


To connect the Developer Board in Wi-Fi access point mode, do the following:

1

Cold-plug the Developer Board by turning off your Flipper Zero and connecting the Developer Board, and then turning it back on.

2

Open Wi-Fi settings on your client device (phone, laptop, or other).

3

Connect to the network: Name: blackmagic Password: iamwitcher

4

To configure the Developer Board, open a browser and go to http://192.168.4.1.

Wi-Fi client (STA) mode

The Developer Board in Wi-Fi client mode
The Developer Board in Wi-Fi client mode


To connect the Developer Board in Wi-Fi client mode, you need to configure it to connect to your Wi-Fi network by doing the following:

1

Cold-plug the Developer Board by turning off your Flipper Zero and connecting the Developer Board, and then turning it back on.

2

Connect to the Developer Board in Wi-Fi access point mode.

3

In a browser, go to the configuration page on http://192.168.4.1.

4

Select the STA mode and enter your network’s SSID (name) and password. For convenience, you can click the + button to see the list of nearby networks.

5

Save the configuration and reboot the Developer Board.

In the Wi-Fi tab, you can set the Developer Board mode
In the Wi-Fi tab, you can set the Developer Board mode


After rebooting, the Developer Board connects to your Wi-Fi network. You can connect to the device using the mDNS name blackmagic.local or the IP address it got from your router (you’ll have to figure this out yourself, every router is different).

After connecting to your debugger via http://blackmagic.local, you can find its IP address in the SYS tab. You can also change the debugger’s mode to AP or STA there.

In the SYS tab, you can view the IP address of your Developer Board
In the SYS tab, you can view the IP address of your Developer Board



Debugging the firmware

Open the Terminal in the flipperzero-firmware directory that you cloned earlier and run the following command:

./fbt devboard_flash

This will upload the firmware you’ve just built to your Flipper Zero via the Developer Board. After that, you can start debugging the firmware using the GDB debugger. We recommend using VSCode with the recommended extensions, and we have pre-made configurations for it.

To debug in VSCode, do the following:

1

In VSCode, open the flipperzero-firmware directory.

2

You should see a notification about recommended extensions. Install them. If there were no notifications, open the Extensions tab, enter @recommended in the search bar, and install the workspace recommendations.

3

In the Terminal, run the ./fbt vscode_dist command. This will generate the VSCode configuration files needed for debugging.

4

In VSCode, open the Run and Debug tab and select Attach FW (blackmagic) from the dropdown menu.

5

If needed, flash your Flipper Zero with the ./fbt flash_blackmagic command, then click the Play button in the debug sidebar to start the debugging session.

6

Note that starting a debug session halts the execution of the firmware, so you’ll need to click the Continue button on the toolbar at the top of your VSCode window to continue execution.

Click Continue in the toolbar to continue execution of the firmware
Click Continue in the toolbar to continue execution of the firmware


To learn about debugging, visit the following pages:

  • Debugging with GDB
  • Debugging in VS Code



Updated 11 Sep 2023
Did this page help you?
PREVIOUS
Wi-Fi Developer Board
NEXT
Firmware update on Developer Board
Docs powered by
Archbee
TABLE OF CONTENTS
Updating the firmware of your Developer Board
Installing Git
Building the firmware
Connecting the Developer Board
Wi-Fi access point (AP) mode
Wi-Fi client (STA) mode
Debugging the firmware
Docs powered by
Archbee

Community

Kickstarter Habr.com Discord Forum Blog

For developers

Documentation GitHub Design Guide

Distributors

Lab401 Joom How to buy Become a Partner

About

Contacts Jobs Compliance Company Abuse Report Privacy Policy

Copyright © 2023 Flipper Devices Inc.