Flipper Zero Unleashed Firmware GoodFAPs 测试用例全解析从外置应用安装到硬件外设验证【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware导读本篇指南以 Unleashed 固件仓库中的 GoodFAPs 测试用例 为骨架系统讲解Good FAP由第三方开发者贡献、托管在应用目录/商店中的 Flipper 应用程序在PicoPass、气象站、AWR 烧录器、视频游戏模块、信号发生器、NFC Magic、SPI 存储管理等典型场景下的完整验证流程。GoodFAPs 与内置bundled应用的最大区别在于它们不随固件编译进系统而是通过 companion 或 Web 平台从应用目录安装到 SD 卡后由固件的应用加载器loader动态装载执行。读完本文你将掌握从目录安装 → 启动/退出 → 卸载/更新 → 外设接线 → 功能验证这一整套 GoodFAPs 的实战测试方法论并能将测试步骤直接复用到你自研 FAP 的质量验证中。适用范围本文所有步骤与截图均基于当前仓库 unleashed-firmware 对应的固件版本与目录结构外设接线、模块固件等硬件操作以文档描述与仓库实现为准请在真实硬件上按顺序验证。1. 什么是 Good FAP它与内置应用有何区别GoodFAPs 测试用例的第三、四节明确说明了这一概念基础形态下设备中并没有这些应用它们需要从应用目录catalog安装来源可以是 companion 应用如手机端 Flipper 应用或 Web 平台版本。安装完成后应用会出现在与自身类型对应的子菜单中BT、Games、NFC、Tools 等并带有一个正常图标与应用目录中一致的名称。从仓库源码结构看这一目录安装 → 动态装载机制由 lib/flipper_application含 ELF 装载器、应用清单解析与 applications/services/loader 共同支撑FAP 文件以独立可执行文件形式存放于 SD 卡固件运行时按需装载这正是基础形态无应用、安装后即出现的原因。测试中应用关闭后 Flipper 继续正常工作这一预期结果也直接验证了 FAP 与系统之间的隔离性——应用崩溃不应拖垮整个固件。2. 从应用目录安装、更新与卸载Catalog 工作流测试这是 GoodFAPs 中最基础也最关键的测试场景覆盖应用生命周期的完整闭环连接将 Flipper 连接到 companion 或 Web 平台。预期结果Flipper 连接成功。安装从目录安装任意数量的应用。预期结果应用被成功安装并在列表中显示正常图标与目录中一致的名称。启动启动应用。预期结果应用成功启动并正常工作。退出退出应用。预期结果应用关闭Flipper 继续正常工作。更新对已安装应用执行更新。预期结果应用更新成功且运行正常。卸载通过 companion、Web 平台以及 Flipper 自带的文件浏览器SD 卡目录分别卸载多个应用。预期结果三种途径均能完成卸载。测试要点第 6 步刻意覆盖三种卸载入口因为 companion/Web 走的是 RPC/应用管理接口而文件浏览器卸载验证的是删除 FAP 文件即可移除应用的底层事实——应用的可见性直接取决于 SD 卡上是否存在对应.fap文件。3. PicoPassNFC 卡读取与字典攻击PicoPass 属于 NFC 类 GoodFAP测试路径为Applications → NFC → PicoPass完整步骤如下打开 PicoPass 应用。预期结果应用正常打开。点击Read card。预期结果卡片被成功读取。保存卡片。预期结果卡片保存成功。点击Elite Dictionary Attack。预期结果字典攻击开始执行。该测试覆盖了读取Read→ 保存Save→ 离线密钥攻击Elite Dictionary Attack的完整 NFC 应用闭环其中 Elite Dictionary Attack 与仓库 lib/nfc 中 NFC 轮询poller与协议栈protocols能力对应是验证应用对底层 NFC 库调用是否正确的关键环节。4. 气象站SubGHz 多频点接收、Hopping 与屏幕锁定气象站Weather Station属于 SubGHz 类 GoodFAP测试路径为Applications → SubGHz → Weather Station。该用例需要两台 Flipper配合完成模拟发射用第二台 Flipper 在不同频率上模拟任意气象站信号。接收读取在第一台上点击Read。预期结果成功读取气象站数据。启用 Hopping进入Config菜单并开启 Hopping跳频。预期结果跳频生效能在不同频率上读取到气象站。锁定屏幕进入Config菜单并锁定屏幕。预期结果屏幕锁定功能正常。查看 About退出读取菜单进入 About 菜单。预期结果About 菜单信息正确显示。Hopping 是 SubGHz 接收的重要特性与仓库 lib/subghz 中的接收机receiver、环境environment与协议注册表registry实现直接相关测试中不同频率都能读到验证的正是多频点扫描与协议解码的协同工作。同时屏幕锁定与 About 菜单覆盖了 FAP 对 GUI/输入系统的使用是否正常。5. AWRAVR烧录器ISP 接线、固件读写与 avrdude 联调AWR Flasher 是我们Unleashed 团队贡献的应用的典型例子——文档特别指出这类应用的安装方式与目录中其他应用相同区别在于它们是项目方自己维护的。测试分为接线 → Dump → Flash → ISP → avrdude五步。5.1 按引脚图连接 AVR 单片机信号Flipper 引脚MISOPA6MOSIPA7SCKPB3RESETPB2GNDGNDVCC3V35.2 功能测试Dump AVR并保存转储。预期结果(1) Dump 过程中芯片型号被正确识别(2) 转储数据保存成功。Flash AVR烧录芯片。预期结果(1) Flash 芯片被正确检测(2) 出现固件选择菜单(3) 固件烧录成功。启动 ISP programmer。预期结果ISP 编程器正确识别芯片。5.3 用 avrdude 交叉验证文档给出了一条可在 PC 端执行的 avrdude 命令用于读取熔丝位fuse与锁定位lock作为验证avrdude.exe -p m2560 -c stk500v1 -P COM7 -U lock:r:lock.hex:r -U hfuse:r:hfuse.hex:r -U lfuse:r:lfuse.hex:r -U efuse:r:efuse.hex:r-p m2560目标芯片型号需按实际替换例如m328pATmega328P-c stk500v1编程器协议对应 AVR ISP/STK500 v1 接口-P COM7PC 上的串口端口号需替换为实际端口四个-U分别把lock锁定位、hfuse高熔丝位、lfuse低熔丝位、efuse扩展熔丝位以 hex 格式读回并保存为文件。预期结果avrdude 正常执行完毕。该命令用 PC 端标准工具对 Flipper 上 AWR 烧录器读出的熔丝/锁定位做独立校验避免仅依赖单一工具导致的误判。6. 视频游戏模块Video Game Module接入、显示镜像与固件刷新6.1 模块接入与显示验证将模块排针comb插入 Flipper。预期结果(1) 出现初始化提示信息(2) 状态栏出现模块图标。将已连接显示器的 HDMI 线插入模块。预期结果Flipper 的画面开始镜像到显示器上。第二步的状态栏模块图标可在仓库 applications/services/gui/gui.h 中看到对应支撑GUI 层定义了GuiLayerStatusBarLeft/GuiLayerStatusBarRight两个状态栏图层模块类应用通过向状态栏注册 viewport 即可显示图标。下载并运行游戏Air Arkanoid。预期结果加速度计accelerometer控制正常。6.2 模块固件刷新VGM tool插入模块确认初始化提示与状态栏图标同 6.1。从目录安装VGM tool应用并启动。预期结果如果设备已连接显示器屏幕镜像将停止因为进入刷机模式。点击Install official firmware。预期结果(1) 弹出对话框(2) 确认后开始安装(3) 安装完成后出现成功窗口并伴随提示音。将模块固件文件复制到 SD 卡。在 VGM tool 中选择installation from file选中 SD 卡上的固件文件。预期结果固件安装成功。从 Flipper 上断开 VGM用针按下模块Boot按钮并连接 PC 的 USB 线。预期结果PC 上打开文件管理器窗口模块以 U 盘模式出现。将固件文件拷贝到设备。预期结果拷贝完成后窗口关闭固件刷新开始。测试要点6.2 覆盖了应用内在线刷机official firmware与本地文件刷机from file两条固件刷新路径以及进入 Bootloader/U 盘模式的兜底方案是模块类外设验证的完整闭环。7. Tools 类 GoodFAPClock 与 NFC/RFID 检测器7.1 Clock路径Apps → Tools → Clock。预期结果时钟全屏激活并持续运行时间格式由 Flipper 的设置决定。这一点在仓库源码中可以得到印证clock_app.c 中通过locale_get_time_format()/locale_get_date_format()读取系统语言环境设置并按LocaleTimeFormat24h、LocaleDateFormatYMD/MDY等枚举值渲染时间与日期。也就是说Clock 应用本身不写死格式而是跟随 locale 服务 的全局配置。7.2 NFC/RFID Detector路径Apps → Tools → NFC/Rfid Detector。点击About。预期结果打开包含应用信息的标签页。点击Detect Field Type。预期结果应用工作区打开屏幕空白等待检测。将 Flipper 靠近任意读卡器甚至两个并排的读卡器。预期结果Flipper 能同时识别 NFC 与 RFID若附近有两个读卡器两种类型的卡片都会显示。该用例验证的是应用对 NFC 场field与低频 RFID 场的同时感知能力对应 lib/nfc 与 lib/lfrfid 两套射频协议的并行检测逻辑。8. 信号发生器Signal GeneratorPWM 与时钟输出验证路径为Apps → Tools → Signal Generator按文档步骤执行启动PWM Generator。预期结果应用正常启动。在不同输出引脚和不同频率上测试。预期结果PWM 信号按指定参数在指定引脚上生成。运行Clock Generator在不同频率和分频系数divider下测试。预期结果时钟信号按指定参数在指定引脚上生成。测试要点PWM 与 Clock 两类信号都要覆盖参数频率/分频→ 引脚的组合验证确保应用对 GPIO 定时器资源的配置、启停与释放正确不会出现信号串扰或引脚冲突。9. NFC Magic魔改卡检测、Gen1a 写入与擦除路径Applications → NFC → NFC Magic。NFC Magic 面向魔改卡如 Gen1a 类型的读写操作测试分为四步打开应用。预期结果应用正常打开。点击Check Magic Tag并贴近所需类型的卡片。预期结果卡片被成功识别。点击Write Gen1a从已保存的卡片列表中选择目标卡。预期结果弹出操作有风险的确认提示确认后数据被写入卡片。点击Wipe。预期结果卡片数据被清除。第 3 步的风险提示属于安全 UX 设计写 Gen1a 属于破坏性操作应用必须在执行前二次确认。该测试同时也验证了从保存列表选择数据源 → 写入目标卡的数据链路是否完整。10. SPI Mem ManagerSPI 存储芯片的读、写、擦除按应用内给出的引脚图连接芯片并启动应用。预期结果应用正常启动。Read chip。预期结果数据被成功读取。Write写入之前读取的数据。预期结果数据写入成功。Erase擦除芯片数据。预期结果芯片被清空。该用例构成读回 → 写回 → 擦除的完整数据完整性验证先用读操作获取基线数据再写回同一份数据最后擦除从而验证 SPI 读写路径的正确性。11. 测试用例设计思路总结与复用建议纵观 10 组 GoodFAPs 用例可以归纳出这套测试文档的通用设计模式直接可复用于你自研 FAP 的测试入口可达性每组用例的第一步都是进入指定菜单路径Applications → XX → YY验证应用在目录/菜单中的注册与装载是否正常。功能闭环每个功能点都有明确的操作步骤 预期结果二元结构例如 PicoPass 的读→存→攻击、SPI 的读→写→擦除。边界与恢复关注退出后系统是否继续正常工作、破坏性操作前是否有风险提示等验证应用与固件的隔离性。双工具/双通道交叉验证AWR 用例用 PC 端 avrdude 校验烧录结果、VGM 用例同时覆盖应用内刷机与本地文件刷机避免单一路径误判。硬件接线前置涉及外设的用例AWR 引脚表、模块排针都把接线/连接步骤前置并给出明确预期保证硬件就绪后才开始功能验证。将上述模式与本文前面各节的预期结果清单结合即可把 GoodFAPs 的验证方法完整迁移到你的下一个 FAP 应用上。12. 关联资料本文主依据GoodFAPs 测试用例测试相关文档应用开发调试指南、通用测试用例、NFC 测试用例、SubGHz 测试用例相关源码动态装载机制lib/flipper_application、applications/services/loader状态栏图标图层applications/services/gui/gui.h时钟格式跟随 localeapplications/main/clock_app/clock_app.c、applications/services/localeNFC 与低频射频协议栈lib/nfc、lib/lfrfidSubGHz 接收与协议注册lib/subghz【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考