unleashed-firmware/documentation/devboard/Get started with the Dev Board.md
Ruslan Nadyrshin 960e0bf545
Small fixes in the wifi devboard docs (#3953)
* Small fixes in the wifi devboard docs

- Several broken numbered lists fixed
- Added a skipped link to the uFBT
- The Devboard naming fixed
2024-10-16 18:38:53 +04:00

3.8 KiB

Get started with the Devboard

\image html https://cdn.flipperzero.one/Flipper_Zero_WiFi_developer_board_box_CDN.jpg width=700

Before you start using your Devboard, you need to prepare your Flipper Zero and Devboard for debugging. In this guide, we'll walk you through all the necessary steps and provide links to explore the Devboard's capabilities further.


Step 1. Enable Debug Mode on your Flipper Zero

Since the main purpose of the Developer board is to debug applications on Flipper Zero, you first need to enable Debug Mode. To do so, go to Settings → System and set Debug to ON.

\image html https://cdn.flipperzero.one/Flipper_Zero_enamble_debug_CDN.jpg width=700

Note

Debug Mode needs to be re-enabled after each update of Flipper Zero's firmware.

Debug Mode allows you to debug your apps for Flipper Zero, as well as access debugging options in apps via the user interface and CLI. To learn more about Flipper Zero CLI, visit Command-line interface in Flipper Docs.

\image html https://cdn.flipperzero.one/Flipper_Zero_Command_Line_Interface_CDN.jpg width=700


Step 2. Update firmware on the Developer Board

The Developer Board comes with stock firmware that may not include all the latest features and bug fixes. To ensure optimal performance, please update your board's firmware using the instructions in Firmware update on Devboard.


Step 3. Plug the Devboard into Flipper Zero

Once your Developer Board firmware is up to date, you can proceed to plug it into your Flipper Zero. Two important things to keep in mind:

  1. Power off your Flipper Zero before plugging in the Developer Board.

    If you skip this step, you may corrupt the data stored on the microSD card. Connecting external modules with a large capacitive load may affect the microSD card's power supply since both the microSD card and external module are powered from the same 3.3 V power source inside Flipper Zero.

  2. Make sure the Developer Board is inserted all the way in.

    If your Flipper Zero isn't in a silicone case, insert the module all the way in so there is no gap between your Flipper Zero and the Devboard. You may need to apply more force to insert it completely. After that, press and hold the BACK button to power on your Flipper Zero.

    \image html https://cdn.flipperzero.one/Flipper_Zero_external_module_without_case_CDN.jpg width=700

    If your Flipper Zero is in a silicone case, insert the module all the way in so there is no gap in the middle between the silicone case and the module. After that, press and hold the BACK button to power on your Flipper Zero.

    \image html https://cdn.flipperzero.one/Flipper_Zero_external_module_with_case_CDN.jpg width=700


Step 4. Connect to a computer

Now, you can connect the Developer Board to your computer via USB or Wi-Fi, depending on your needs. We described both methods in separate documents:

  • Via USB cable for debugging in DAP Link or Black Magic mode, and reading logs.
  • Via Wi-Fi for debugging in Black Magic mode.

Next steps

You are ready to debug now! To further explore what you can do with the Devboard, check out these pages:

These guides should help you get started with your Devboard. If you have any questions or you want to share your experience, don't hesitate to join our community on Reddit and Discord, where we have a dedicated #wifi-devboard channel.