soeinova/Fantasi - 仓库详情

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它将多款流行的渗透测试与硬件黑客设备整合到同一固件下，提供统一的 CLI 和应用生态，简化了跨设备的开发与使用。

适合谁使用

Flipper Zero、Kiisu、Chameleon Ultra、Proxmark3 用户
固件开发者与嵌入式工程师
硬件黑客与渗透测试人员
希望为多种设备使用统一平台的创客

典型使用场景

在多个设备上使用同一固件以实现一致的行为
通过通用 API 在任何支持的硬件上开发并运行 ELF 应用
通过主机 CLI 或蓝牙管理文件、刷写固件以及控制设备
测试和比较不同平台的射频/无线电能力

项目优势

使用单一构建系统支持多种 MCU 架构（Cortex-M4、ARM7TDMI 等）
自动检测连接的设备进行刷写，无需手动选择目标
内置 LittleFS 文件系统和静态编译 ELF 应用加载器
包含支持 USB 串口和蓝牙连接的主机 CLI，并带有丰富的命令集

使用前须知

部分目标（Proxmark5、Kiisu Smol、Kode Dot）标注为“即将推出”，尚未可用
构建需要 arm-none-eabi-gcc 及外部库（libreadline、libsystemd），可能未预装
蓝牙配对需从设备 USB 日志中获取密码，增加了设置步骤

README 快速开始

Supported targets

Target	MCU	Flash tool
Flipper Zero	STM32WB55 (Cortex-M4)	`dfu-util` via ROM DFU
Kiisu	STM32WB55 (Cortex-M4)	`dfu-util` via ROM DFU
Chameleon Ultra	nRF52840 (Cortex-M4)	`nrfutil` DFU
Proxmark3	AT91SAM7S256/512 (ARM7TDMI)	`tools/pm3_flasher.py` (pyserial)
Proxmark5	AT32F435	Coming soon
Kiisu Smol	STM32WB55 (Cortex-M4)	Coming soon
Kode Dot	ESP32-S3	Coming soon

Build

make                        # build every firmware + the host CLI
make PLATFORM=flipper       # STM32WB55 (Cortex-M4)
make PLATFORM=kiisu         # STM32WB55 (Cortex-M4)
make PLATFORM=chameleon     # nRF52840  (Cortex-M4)
make PLATFORM=proxmark3     # AT91SAM7S (ARM7TDMI)
make cli                    # host CLI only (build/cli/fantasi)
make clean                  # remove all build artifacts (or PLATFORM= for one)
make help                   # list targets

A bare make builds all three firmwares and the host CLI; make clean wipes the build/ tree. Pass PLATFORM= to scope to a single firmware, or make cli to build only the host CLI.

The firmware builds need arm-none-eabi-gcc and git on PATH; TinyUSB and LittleFS are auto-cloned on demand (pinned to known-good tags). The host CLI is built with the system cc and needs libreadline (and libsystemd for BLE).

Artifacts land in build/:

Target	Output
flipper	`build/flipper/fantasi-flipper.{elf,bin}`
kiisu	`build/flipper/fantasi-kiisu.{elf,bin}`
chameleon	`build/chameleon/fantasi-chameleon.{elf,bin,hex}`
proxmark3	`build/proxmark3/fantasi-proxmark3.{elf,bin}`
host CLI	`build/cli/fantasi`

Flash

make flash                  # auto-detect the connected device + flash it
make PLATFORM= flash  # force a specific target

With no PLATFORM, make flash auto-detects the single connected board - by querying a running Fantasi's device id, or by spotting a board already sitting in its DFU mode. If more than one device is connected it refuses to flash rather than guess; pass PLATFORM= to disambiguate.

A successful flash is indicated by a solid blue LED.

If the device is already running Fantasi, the flasher (tools/flash.py) uploads changed resources via MSC, sends dfu over CDC serial, and flashes with the platform's tool. On first flash it falls back to a manual DF

项目描述

Fantasi firmware

Fantasi