一、项目概述

OLED-Flipper 是一套面向硬件爱好者的开源自制复刻方案，基于 STM32WB55CGU6 主控硬件，移植 Flipper OS 系统，使用市面通用 SH1106 / SSD1306 I2C OLED 显示屏替代原厂专用屏幕，低成本搭建一台兼容原版 Flipper Zero 核心功能的便携式射频测试终端。项目完整开放定制固件、硬件接线定义、电路原理图、编译与烧录流程，仅用于无线电技术、硬件安全领域学习研究。

二、硬件架构

本项目以 WeAct STM32WB55 开发板作为核心载体，通过 I2C、SPI、GPIO 总线外接各类外设，总线资源采用复用设计，精简硬件布线：

1. 主控单元：STM32WB55，内置 BLE 蓝牙，支持 2.4GHz 通信，作为整机调度核心；

2. 显示单元：通用 128×64 I2C OLED（SH1106/SSD1306）；

3. 无线射频模块

   • CC1101：Sub-GHz 射频收发，覆盖 300–915MHz，实现无线信号录制、解调与重放；

   • ST25R3916：13.56MHz NFC，支持 MIFARE、EM 系列卡片读写模拟；

   • 自制模拟电路：125kHz LF-RFID 低频载波发射与检波解调，兼容 EM4100、T5577 等低频 ID 卡；

   • IR 红外收发：实现各类红外遥控器信号学习与模拟；

4. 外设扩展

   • MCP23017 IO 扩展芯片：统一管理实体按键、RGB 指示灯、震动马达；

   • SD 卡模块：文件存储、固件资源存放；

   • INA219/INA226：电池电压监测，搭载硬件电路实现过流、欠压保护；

   • 无源蜂鸣器：音频提示与告警。

三、功能实现

固件深度适配硬件，原生运行 Flipper OS，原版绝大多数功能均可正常编译运行： ✅ Sub-GHz 无线信号接收、录制、重放； ✅ NFC 13.56MHz 标签读写、卡片模拟； ✅ 125kHz 低频 RFID 卡读取与模拟； ✅ 红外遥控信号学习、发射； ✅ SD 卡文件管理、固件升级； ✅ 电池电量实时监控、硬件故障告警； ✅ BLE 蓝牙基础交互； ✅ GPIO 硬件调试拓展能力。

硬件限制说明：项目采用 I2C 总线复用外设资源，接线必须严格遵循引脚定义；125kHz 低频 RFID 依赖自制模拟解调电路，无法直接使用成品模块。

四、构建与烧录要点

1. 源码编译：依托 Flipper Build Tool 编译适配 OLED 硬件的定制固件；

2. OTP 一次性配置：首次刷机前需要写入 OTP 配置信息，OTP 仅可写入一次，写入后无法擦除修改，配置错误将永久影响设备运行；

3. 固件烧录

   • DFU 模式：USB 直连刷机，适合首次初始化设备；

   • ST-Link + STM32CubeProgrammer：离线烧录方案； ⚠️ 禁止直接执行整片全芯片擦除，该操作会清除校准与 OTP 数据，造成设备永久异常。

五、适用场景与免责声明

项目定位为教育学习用途，供无线电爱好者、硬件安全学习者进行技术研究、竞赛实验。 ⚠️ 重要提醒：

1. 作者不对焊接、刷机操作造成的硬件损坏承担任何责任，所有操作风险由使用者自行承担；

2. 射频设备使用、卡片信号模拟必须严格遵守国家法律法规；

3. 严禁未经授权复制他人门禁、车钥匙、无线遥控信号，严禁用于入侵、盗窃等违法行为，违规使用将承担相应法律责任。

六、License

GNU GENERAL PUBLIC LICENSE

七、项目地址

https://github.com/artema0g/oled_flipper