Flipper Zero固件开发板调试指南

Flipper Zero固件开发板调试指南

flipperzero-firmware Flipper Zero firmware source code 项目地址: https://gitcode.com/gh_mirrors/fl/flipperzero-firmware

概述

本文将详细介绍如何通过Wi-Fi开发板对Flipper Zero设备进行固件调试。开发板在此过程中充当调试探针，建立主机调试器与目标微控制器之间的桥梁。调试过程可以通过Wi-Fi或有线USB连接进行控制。

硬件连接原理

开发板与Flipper Zero之间通过SWD(Serial Wire Debug)接口进行通信，主要使用以下两个GPIO引脚：

• 引脚10 (SWCLK)：串行线时钟信号
• 引脚12 (SWDIO)：串行线调试数据输入/输出

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

准备工作

1. 环境搭建

首先需要安装Git工具来获取固件源代码。Git是版本控制工具，可以从其官方网站获取各平台安装包。

2. 获取并编译固件

1. 打开终端(Windows用户使用PowerShell)，进入工作目录
2. 克隆固件仓库：

   git clone --recursive 固件仓库地址
   cd flipperzero-firmware
   

3. 使用FBT(Flipper Build Tool)编译固件：

   ./fbt
   

调试流程详解

1. 烧录固件

在编译完成后，首先需要将固件烧录到设备：

./fbt flash

2. VS Code调试配置

推荐使用VS Code进行调试，步骤如下：

1. 在VS Code中打开固件项目目录
2. 安装推荐的扩展插件(通常会自动提示)
3. 生成VS Code调试配置文件：

   ./fbt vscode_dist
   

3. 选择调试器

在VS Code的"运行和调试"面板中，有两种调试器可选：

• Attach FW (blackmagic)：支持Wi-Fi和USB连接
• Attach FW (DAP)：仅支持USB连接

\image html https://cdn.flipperzero.one/Flipper_Zero_Wi-Fi_devboard_VS_Code.jpg width=900

4. 开始调试

1. 确保开发板处于正确的调试模式(可通过开发板网页界面查看)
2. 点击调试启动按钮(▶)
3. 调试开始后，固件执行会暂停，需要点击继续按钮(⏵)恢复执行

调试技巧

1. 断点设置：在关键代码行左侧点击设置断点
2. 变量监视：在调试过程中可以添加变量监视
3. 调用栈查看：调试暂停时可查看完整的调用栈
4. 内存查看：可以查看特定内存地址的内容

注意事项

1. 调试过程中固件执行会暂停，需要手动继续
2. 确保开发板调试模式与选择的调试器匹配
3. 首次调试可能需要较长时间建立连接
4. 复杂断点可能会影响实时性表现

通过以上步骤，开发者可以高效地进行Flipper Zero固件的调试工作，快速定位和解决问题。

flipperzero-firmware Flipper Zero firmware source code 项目地址: https://gitcode.com/gh_mirrors/fl/flipperzero-firmware