2024-10-16 17:38:53 +03:00
# Reading logs via the Devboard {#dev_board_reading_logs}
2024-03-06 09:25:21 +03:00
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.
> **NOTE:** 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.
2024-03-20 12:44:31 +03:00
***
2024-03-06 09:25:21 +03:00
## Setting the log level
2024-10-14 16:47:12 +03:00
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 ](https://docs.flipper.net/basics/settings#d5TAt ).
2024-03-06 09:25:21 +03:00
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_log_level.jpg "You can manually set the preferred log level" width=700
2024-03-06 09:25:21 +03:00
***
## 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:
2024-10-14 16:47:12 +03:00
### macOS
2024-03-06 09:25:21 +03:00
2024-10-14 16:47:12 +03:00
On macOS, you need to install the **minicom** communication program by doing the following:
2024-03-06 09:25:21 +03:00
2024-03-20 12:44:31 +03:00
1. [Install Homebrew ](https://brew.sh/ ) by running the following command in the Terminal:
2024-03-06 09:25:21 +03:00
2024-03-20 12:44:31 +03:00
```text
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
2024-03-06 09:25:21 +03:00
2. After installation of Homebrew, run the following command to install minicom:
2024-03-20 12:44:31 +03:00
```text
brew install minicom
```
2024-03-06 09:25:21 +03:00
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:
2024-03-20 12:44:31 +03:00
```text
ls /dev/cu.*
```
2024-03-06 09:25:21 +03:00
2024-03-20 12:44:31 +03:00
Note the list of devices.
2024-03-06 09:25:21 +03:00
2024-03-20 12:44:31 +03:00
3. Connect the developer board to your computer using a USB Type-C cable.
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_developer_board_wired.png width=700
2024-03-06 09:25:21 +03:00
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
2024-03-20 12:44:31 +03:00
```text
/dev/cu.usbmodemblackmagic1
```
```text
/dev/cu.usbmodemblackmagic3
```
2024-03-06 09:25:21 +03:00
Your Developer Board might have different names.
5. Run the following command:
2024-03-20 12:44:31 +03:00
```text
minicom -D /dev/< port > -b 230400
```
2024-03-06 09:25:21 +03:00
Where `<port>` is the name of your device with a bigger number.
Example:
2024-03-20 12:44:31 +03:00
```text
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
```
2024-03-06 09:25:21 +03:00
6. View logs of your Flipper Zero in the Terminal.
7. To quit, close the minicom window or quit via the minicom menu.
### Linux
On Linux, you need to install the **minicom** communication program. For example, on Ubuntu, run in the Terminal the following command:
```text
2024-03-20 12:44:31 +03:00
sudo apt install minicom
```
2024-03-06 09:25:21 +03:00
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:
2024-03-20 12:44:31 +03:00
```text
ls /dev/tty*
```
2024-03-06 09:25:21 +03:00
Note the list of devices.
3. Connect the developer board to your computer using a USB Type-C cable.
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_developer_board_wired.png width=700
2024-03-06 09:25:21 +03:00
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
2024-03-20 12:44:31 +03:00
```text
/dev/ttyACM0
```
```text
/dev/ttyACM1
```
2024-03-06 09:25:21 +03:00
Your Developer Board might have different names.
5. Run the following command:
```text
2024-03-20 12:44:31 +03:00
minicom -D /dev/< port > -b 230400
2024-03-06 09:25:21 +03:00
```
Where `<port>` is the name of your device with a bigger number.
Example:
```text
2024-03-20 12:44:31 +03:00
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
2024-03-06 09:25:21 +03:00
```
6. View logs of your Flipper Zero in the Terminal.
2024-03-20 12:44:31 +03:00
**NOTE:** If no logs are shown in the Terminal, try running the command from Step 5 with another device name.
2024-03-06 09:25:21 +03:00
7. To quit, close the minicom window or quit via the minicom menu.
### Windows
On Windows, do the following:
1. On your computer, [install the PuTTY application ](https://www.chiark.greenend.org.uk/\~sgtatham/putty/latest.html ).
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.
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_developer_board_wired.png width=700
2024-03-06 09:25:21 +03:00
2024-10-08 14:27:16 +03:00
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.
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_devboard_Device_Manager.png width=700
2024-03-06 09:25:21 +03:00
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** .
2024-10-14 16:47:12 +03:00
\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_devboard_PuTTy.jpg width=700
2024-03-06 09:25:21 +03:00
8. View logs of your Flipper Zero in the PuTTY terminal window.
9. To quit, close the PuTTY window.