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

Reading logs via the Dev Board

The Developer Board allows you to read Flipper Zero logs via UART. Unlike reading logs via the command-line interface (CLI), the Developer Board enables you to collect logs from the device directly to a serial console independently from the operating system of Flipper Zero. It allows you to see the device's logs when it's loading, updating, or crashing. It's useful for debugging and troubleshooting during software development.

<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.



Setting the log level

Depending on your needs, you can set the log level by going to Main Menu -> Settings -> Log Level. To learn more about logging levels, visit Settings.

You can manually set the preferred log level
You can manually set the preferred log level



Viewing Flipper Zero logs

Depending on your operating system, you need to install an additional application on your computer to read logs via the Developer Board:

%mac%MacOS
%linux%Linux
%windows%Windows

On MacOS, you need to install the minicom communication program by doing the following:

1

Install Homebrew by running in the Terminal the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

After installation of Homebrew, run the following command to install minicom:

brew install minicom

After installation of minicom on your macOS computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:

1

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

2

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

ls /dev/cu.*

Note the list of devices.

3

Connect the developer board to your computer using a USB Type-C cable.

Document image

4

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

/dev/cu.usbmodemblackmagic1 /dev/cu.usbmodemblackmagic3

Your Developer Board might have different names.

5

Run the following command:

minicom -D /dev/<port> -b 230400

Where <port> is the name of your device with a bigger number.

Example:

minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
6

View logs of your Flipper Zero in the Terminal.

7

To quit, close the minicom window or quit via the minicom menu.

On Linux, you need to install the minicom communication program. For example, on Ubuntu, run in the Terminal the following command:

sudo apt install minicom

After installation of minicom on your Linux computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:

1

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

2

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

ls /dev/tty*

Note the list of devices.

3

Connect the developer board to your computer using a USB Type-C cable.

Document image

4

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

/dev/ttyACM0  /dev/ttyACM1

Your Developer Board might have different names.

5

Run the following command:

minicom -D /dev/<port> -b 230400

Where <port> is the name of your device with a bigger number.

Example:

minicom -D /dev/ttyACM1 -b 230400
6

View logs of your Flipper Zero in the Terminal.

<div class="warning flipper-callout">
    <div class="callout-header"></div>
    If no logs are shown in the Terminal, try running the command from Step 5 with another device name.
</div>

7

To quit, close the minicom window or quit via the minicom menu.

On Windows, do the following:

1

On your computer, install the PuTTY application.

2

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

3

Connect the developer board to your computer using a USB Type-C cable.

Document image

4

Find the serial port that the developer board is connected to by going to Device Manager -> Ports (COM & LPT) and looking for a new port that appears when you connect the Wi-Fi developer board.

Document image

5

Run the PuTTY application and select Serial as the connection type.

6

Enter the port number you found in the previous step into the Serial line field.

7

Set the Speed parameter to 230400 and click Open.

Document image

8

View logs of your Flipper Zero in the PuTTY terminal window.

9

To quit, close the PuTTY window.





Updated 11 Sep 2023
Did this page help you?
PREVIOUS
Firmware update on Developer Board
NEXT
Wi-Fi Developer Board schematics
Docs powered by
Archbee
TABLE OF CONTENTS
Setting the log level
Viewing Flipper Zero logs
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.