Skip to content

bobberdolle1/openflash

OpenFlash
╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║   ██████╗ ██████╗ ███████╗███╗   ██╗███████╗██╗      █████╗ ███████╗██╗  ██╗ ║
║  ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██╔════╝██║  ██║ ║
║  ██║   ██║██████╔╝█████╗  ██╔██╗ ██║█████╗  ██║     ███████║███████╗███████║ ║
║  ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██╔══╝  ██║     ██╔══██║╚════██║██╔══██║ ║
║  ╚██████╔╝██║     ███████╗██║ ╚████║██║     ███████╗██║  ██║███████║██║  ██║ ║
║   ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚═╝     ╚══════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝ ║
║                                                                              ║
║                    $4 → Professional Flash Programmer                        ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

[ English · Русский ]


License: MIT Rust Platforms Chips



🇬🇧 ENGLISH


💀 What is OpenFlash?

The Problem:

Commercial flash programmers = $200-2000
Look like they escaped from 2003
Closed source, paid updates, Windows XP vibes

The Solution:

OpenFlash = $4 microcontroller + jumper wires
Modern cross-platform app
Open source, free forever, AI-powered
     ┌─────────────┐
     │  DEAD       │
     │  ROUTER     │
     │  ┌───────┐  │
     │  │ NAND  │◄─┼──── What's inside?
     │  └───────┘  │
     └─────────────┘
           │
           ▼
     ┌─────────────┐
     │  OpenFlash  │
     │  ═══════════│
     │  SECRETS    │
     │  REVEALED   │
     └─────────────┘

🎯 Why OpenFlash?

┌────────────────────────────────────────────────────────────────────────────────┐
│                                                                                │
│   COMMERCIAL PROGRAMMER              vs              OPENFLASH                 │
│   ══════════════════════                            ══════════                 │
│                                                                                │
│   💰 $200 - $2000                                   💰 $4 - $30                │
│   🖥️  Windows XP era UI                             🖥️  Modern React + Tauri   │
│   📦 Pay for chip database                          📦 230+ chips FREE         │
│   🔄 Pay for updates                                🔄 Free forever            │
│   🤖 No AI                                          🤖 AI-powered analysis     │
│   🔒 Closed source                                  🔓 MIT License             │
│   📅 Looks like 2003                                📅 Looks like 2025         │
│                                                                                │
└────────────────────────────────────────────────────────────────────────────────┘

🔌 Platforms

⚡ MICROCONTROLLERS
Platform Price Speed Best For Special
🍓 Raspberry Pi Pico ~$4 ██░░░ Beginners PIO magic
🍓 Raspberry Pi Pico 2 ~$5 ███░░ Enthusiasts NV-DDR support
🖤 STM32F4 Black Pill ~$5 ███░░ Best value 168MHz Cortex-M4
Teensy 4.0 / 4.1 ~$20-30 █████ Speed demons USB HS 480Mbps!
🔵 Arduino GIGA R1 ~$60 ████░ Enterprise WiFi + Hardware ECC
📶 ESP32 ~$4 ██░░░ Wireless WiFi operation
💙 STM32F1 Blue Pill ~$2 █░░░░ Ultra budget Cheapest option
🖥️ SINGLE BOARD COMPUTERS
Platform Price Speed Best For Special
🥧 Raspberry Pi 4/5 ~$35-75 ████░ Headless server Native GPIO
🍊 Orange Pi ~$15-50 ███░░ Budget SBC Allwinner/Rockchip
🍌 Banana Pi ~$15-35 ███░░ RISC-V fans SpacemiT K1 RISC-V!

💾 Supported Chips

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│  PARALLEL NAND ████████████████████████████████████████████████████  60+     │
│  Samsung • Micron • SK Hynix • Kioxia • Macronix • Winbond                   │
│                                                                              │
│  SPI NOR ████████████████████████████████████████████████████████████  75+   │
│  Winbond • GigaDevice • Macronix • Micron • ISSI • XMC • EON                 │
│                                                                              │
│  SPI NAND ██████████████████████████████████████████████████████  55+        │
│  GigaDevice • Winbond • Micron • Macronix • Kioxia • XTX • Foresee           │
│                                                                              │
│  eMMC ████████████████████████████████████████  40+                          │
│  Samsung • Micron • SK Hynix • SanDisk • Kingston                            │
│                                                                              │
│  UFS ██████████  10+  (detection)                                            │
│                                                                              │
│  ═══════════════════════════════════════════════════════════════════════     │
│  TOTAL: 230+ CHIPS                                                           │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

✨ Features

🔧 Core Operations

READ     ████████████████████  ✓
WRITE    ████████████████████  ✓
ERASE    ████████████████████  ✓
VERIFY   ████████████████████  ✓
CLONE    ████████████████████  ✓

🛡️ Error Correction

Hamming    ✓  1-bit correction
BCH-4      ✓  4-bit correction
BCH-8      ✓  8-bit correction
BCH-16     ✓  16-bit correction
BCH-24     ✓  24-bit correction

🤖 AI Analysis

🔍 Pattern Detection
   Encrypted │ Compressed │ Executable

📁 Filesystem Detection
   SquashFS │ UBIFS │ JFFS2 │ ext4 │ FAT

�  Key Search
   AES-128/192/256 keys in dumps

📊 Wear Analysis
   Remaining chip life estimation

🗺️ Memory Map
   Visual partition layout

🚀 Advanced Features

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│  v1.x  ✅ Foundation                                                        │
│        NAND • SPI • eMMC • AI analysis • Python API • CLI                   │
│                                                                             │
│  v2.x  ✅ Scale                                                             │
│        11 platforms • REST API • Device farm • Production line              │
│        Logic analyzer • JTAG/SWD • OpenFlash PCB                            │
│                                                                             │
│  v3.0  ✅ Cloud  ◄─── YOU ARE HERE                                          │
│        ☁️  Sync dumps across devices                                         │
│        👥 Team collaboration                                                 │
│        🌍 Community chip database                                            │
│        🔄 AI model updates OTA                                               │
│        🏢 Enterprise support                                                 │
│                                                                             │
│  v3.x  🔜 Coming                                                            │
│        FPGA support • Forensics tools • More chips                          │
│                                                                             │
│  v4.0  🔮 Future                                                            │
│        WebAssembly • Distributed dumping • Real-time collab                 │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

🏎️ Speed Comparison

                           1GB DUMP TIME
                           ═════════════

Teensy 4.1 (USB HS)    ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  3-5 min
Arduino GIGA           ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ~10 min
Raspberry Pi 4         ██████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ~12 min
STM32F4                ████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░  ~25 min
RP2350                 ████████████████████████░░░░░░░░░░░░░░░░░░░░░░  ~30 min
RP2040                 ████████████████████████████████████░░░░░░░░░░  ~45 min
ESP32                  ██████████████████████████████████████░░░░░░░░  ~50 min

🛠️ Quick Start

1️⃣ Try Without Hardware

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   Open App  →  Click "Mock"  →  Scan  →  Connect  →  Dump      │
│                                                                 │
│   Explore all features with simulated data!                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2️⃣ Minimal Hardware

TOTAL COST: ~$6

┌──────────────────────┐     ┌──────────────────────┐
│  Raspberry Pi Pico   │     │  Jumper Wires        │
│  ~$4                 │  +  │  ~$2                 │
└──────────────────────┘     └──────────────────────┘

3️⃣ Wiring (SPI Flash)

        PICO                          FLASH CHIP
    ┌──────────┐                    ┌──────────────┐
    │          │                    │              │
    │     GP16 ├────────────────────┤ DO (MISO)    │
    │     GP17 ├────────────────────┤ CS#          │
    │     GP18 ├────────────────────┤ CLK          │
    │     GP19 ├────────────────────┤ DI (MOSI)    │
    │      3V3 ├────────────────────┤ VCC          │
    │      GND ├────────────────────┤ GND          │
    │          │                    │              │
    └──────────┘                    └──────────────┘

4️⃣ Read!

Open App  →  Scan  →  Connect  →  Detect Chip  →  Dump  →  🎉

💻 Automation

Python API

import openflash

# Connect
device = openflash.connect()
chip = device.detect()

# Read
dump = device.read_full()
dump.save("firmware.bin")

# Analyze
analysis = openflash.ai.analyze(dump)
print(f"Quality: {analysis.quality_score:.0%}")
print(f"Filesystem: {analysis.filesystem}")

CLI

# Scan for devices
openflash scan

# Read chip
openflash read -o dump.bin

# AI analysis
openflash analyze dump.bin

# Write with verification
openflash write -i firmware.bin --verify

# Batch processing
openflash batch jobs.toml

🏗️ Build from Source

# Prerequisites: Rust 1.70+, Node 18+

git clone https://github.com/openflash/openflash.git
cd openflash/openflash

# ┌─────────────────────────────────────────────────────────────┐
# │  GUI (Tauri + React)                                        │
# └─────────────────────────────────────────────────────────────┘
cd gui && npm i && cargo tauri dev

# ┌─────────────────────────────────────────────────────────────┐
# │  CLI                                                        │
# └─────────────────────────────────────────────────────────────┘
cargo build -p openflash-cli --release

# ┌─────────────────────────────────────────────────────────────┐
# │  Firmware (pick your platform)                              │
# └─────────────────────────────────────────────────────────────┘

# RP2040 (Raspberry Pi Pico)
cd firmware/rp2040
rustup target add thumbv6m-none-eabi
cargo build --release --target thumbv6m-none-eabi

# RP2350 (Raspberry Pi Pico 2)
cd firmware/rp2350
rustup target add thumbv8m.main-none-eabihf
cargo build --release --target thumbv8m.main-none-eabihf

# Teensy 4.x (USB High Speed!)
cd firmware/teensy4
rustup target add thumbv7em-none-eabihf
cargo build --release --target thumbv7em-none-eabihf

📚 Documentation

📖 Wiki — Full documentation
🆕 Beginner's Guide — Never used a programmer?
🔌 Hardware Setup — Wiring diagrams
📋 Supported Chips — 230+ chips
🔧 Troubleshooting — When things break
FAQ — Common questions



🇷🇺 РУССКИЙ


💀 Что такое OpenFlash?

Проблема:

Профессиональные программаторы = $200-2000
Выглядят как из 2003 года
Закрытый код, платные обновления, Windows XP вайбы

Решение:

OpenFlash = микроконтроллер за $4 + провода
Современное кроссплатформенное приложение
Open source, бесплатно навсегда, с AI
     ┌─────────────┐
     │  МЁРТВЫЙ    │
     │  РОУТЕР     │
     │  ┌───────┐  │
     │  │ NAND  │◄─┼──── Что внутри?
     │  └───────┘  │
     └─────────────┘
           │
           ▼
     ┌─────────────┐
     │  OpenFlash  │
     │  ═══════════│
     │  СЕКРЕТЫ    │
     │  РАСКРЫТЫ   │
     └─────────────┘

🎯 Почему OpenFlash?

┌────────────────────────────────────────────────────────────────────────────────┐
│                                                                                │
│   КОММЕРЧЕСКИЙ ПРОГРАММАТОР          vs              OPENFLASH                 │
│   ══════════════════════════                        ══════════                 │
│                                                                                │
│   💰 $200 - $2000                                   💰 $4 - $30                │
│   🖥️  Интерфейс эпохи Windows XP                    🖥️  Современный React+Tauri│
│   📦 База чипов за деньги                           📦 230+ чипов БЕСПЛАТНО    │
│   🔄 Обновления за деньги                           🔄 Бесплатно навсегда      │
│   🤖 Без AI                                         🤖 AI-анализ встроен       │
│   🔒 Закрытый код                                   🔓 MIT лицензия            │
│   📅 Выглядит как 2003                              📅 Выглядит как 2025       │
│                                                                                │
└────────────────────────────────────────────────────────────────────────────────┘

🔌 Платформы

⚡ МИКРОКОНТРОЛЛЕРЫ
Платформа Цена Скорость Для кого Особенность
🍓 Raspberry Pi Pico ~$4 ██░░░ Новички PIO магия
🍓 Raspberry Pi Pico 2 ~$5 ███░░ Энтузиасты NV-DDR поддержка
🖤 STM32F4 Black Pill ~$5 ███░░ Лучшее соотношение 168MHz Cortex-M4
Teensy 4.0 / 4.1 ~$20-30 █████ Скорость важна USB HS 480Mbps!
🔵 Arduino GIGA R1 ~$60 ████░ Enterprise WiFi + Hardware ECC
📶 ESP32 ~$4 ██░░░ Беспроводная работа WiFi операции
💙 STM32F1 Blue Pill ~$2 █░░░░ Ультра-бюджет Самый дешёвый
🖥️ ОДНОПЛАТНЫЕ КОМПЬЮТЕРЫ
Платформа Цена Скорость Для кого Особенность
🥧 Raspberry Pi 4/5 ~$35-75 ████░ Headless сервер Native GPIO
🍊 Orange Pi ~$15-50 ███░░ Бюджетный SBC Allwinner/Rockchip
🍌 Banana Pi ~$15-35 ███░░ Фанаты RISC-V SpacemiT K1 RISC-V!

💾 Поддерживаемые чипы

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│  PARALLEL NAND ████████████████████████████████████████████████████  60+     │
│  Samsung • Micron • SK Hynix • Kioxia • Macronix • Winbond                   │
│                                                                              │
│  SPI NOR ████████████████████████████████████████████████████████████  75+   │
│  Winbond • GigaDevice • Macronix • Micron • ISSI • XMC • EON                 │
│                                                                              │
│  SPI NAND ██████████████████████████████████████████████████████  55+        │
│  GigaDevice • Winbond • Micron • Macronix • Kioxia • XTX • Foresee           │
│                                                                              │
│  eMMC ████████████████████████████████████████  40+                          │
│  Samsung • Micron • SK Hynix • SanDisk • Kingston                            │
│                                                                              │
│  UFS ██████████  10+  (детекция)                                             │
│                                                                              │
│  ═══════════════════════════════════════════════════════════════════════     │
│  ВСЕГО: 230+ ЧИПОВ                                                           │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

✨ Возможности

🔧 Базовые операции

ЧТЕНИЕ     ████████████████████  ✓
ЗАПИСЬ     ████████████████████  ✓
СТИРАНИЕ   ████████████████████  ✓
ПРОВЕРКА   ████████████████████  ✓
КЛОНИРОВАНИЕ ██████████████████  ✓

🛡️ Коррекция ошибок

Hamming    ✓  1-бит коррекция
BCH-4      ✓  4-бит коррекция
BCH-8      ✓  8-бит коррекция
BCH-16     ✓  16-бит коррекция
BCH-24     ✓  24-бит коррекция

🤖 AI-анализ

🔍 Детекция паттернов
   Шифрование │ Сжатие │ Исполняемый код

📁 Детекция файловых систем
   SquashFS │ UBIFS │ JFFS2 │ ext4 │ FAT

🔐 Поиск ключей
   AES-128/192/256 ключи в дампах

📊 Анализ износа
   Оценка оставшегося ресурса чипа

🗺️ Карта памяти
   Визуальная схема разделов

🚀 Продвинутые фичи

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│  v1.x  ✅ Фундамент                                                         │
│        NAND • SPI • eMMC • AI-анализ • Python API • CLI                     │
│                                                                             │
│  v2.x  ✅ Масштаб                                                           │
│        11 платформ • REST API • Device farm • Production line               │
│        Логический анализатор • JTAG/SWD • OpenFlash PCB                     │
│                                                                             │
│  v3.0  ✅ Облако  ◄─── ВЫ ЗДЕСЬ                                             │
│        ☁️  Синхронизация дампов между устройствами                           │
│        👥 Командная работа                                                   │
│        🌍 Краудсорсинг базы чипов                                            │
│        🔄 OTA обновления AI-моделей                                          │
│        🏢 Enterprise поддержка                                               │
│                                                                             │
│  v3.x  🔜 Скоро                                                             │
│        FPGA поддержка • Forensics инструменты • Больше чипов                │
│                                                                             │
│  v4.0  🔮 Будущее                                                           │
│        WebAssembly • Распределённый дампинг • Real-time коллаборация        │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

🏎️ Сравнение скорости

                           ВРЕМЯ ДАМПА 1GB
                           ═══════════════

Teensy 4.1 (USB HS)    ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  3-5 мин
Arduino GIGA           ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ~10 мин
Raspberry Pi 4         ██████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ~12 мин
STM32F4                ████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░  ~25 мин
RP2350                 ████████████████████████░░░░░░░░░░░░░░░░░░░░░░  ~30 мин
RP2040                 ████████████████████████████████████░░░░░░░░░░  ~45 мин
ESP32                  ██████████████████████████████████████░░░░░░░░  ~50 мин

🛠️ Быстрый старт

1️⃣ Попробуй без железа

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   Открой приложение → "Mock" → Scan → Connect → Dump           │
│                                                                 │
│   Изучи все функции на симулированных данных!                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2️⃣ Минимальное железо

ОБЩАЯ СТОИМОСТЬ: ~$6

┌──────────────────────┐     ┌──────────────────────┐
│  Raspberry Pi Pico   │     │  Провода-перемычки   │
│  ~$4                 │  +  │  ~$2                 │
└──────────────────────┘     └──────────────────────┘

3️⃣ Подключение (SPI Flash)

        PICO                          FLASH ЧИП
    ┌──────────┐                    ┌──────────────┐
    │          │                    │              │
    │     GP16 ├────────────────────┤ DO (MISO)    │
    │     GP17 ├────────────────────┤ CS#          │
    │     GP18 ├────────────────────┤ CLK          │
    │     GP19 ├────────────────────┤ DI (MOSI)    │
    │      3V3 ├────────────────────┤ VCC          │
    │      GND ├────────────────────┤ GND          │
    │          │                    │              │
    └──────────┘                    └──────────────┘

4️⃣ Читай!

Открой приложение → Scan → Connect → Detect Chip → Dump → 🎉

💻 Автоматизация

Python API

import openflash

# Подключение
device = openflash.connect()
chip = device.detect()

# Чтение
dump = device.read_full()
dump.save("firmware.bin")

# Анализ
analysis = openflash.ai.analyze(dump)
print(f"Качество: {analysis.quality_score:.0%}")
print(f"ФС: {analysis.filesystem}")

CLI

# Поиск устройств
openflash scan

# Чтение чипа
openflash read -o dump.bin

# AI-анализ
openflash analyze dump.bin

# Запись с проверкой
openflash write -i firmware.bin --verify

# Пакетная обработка
openflash batch jobs.toml

🏗️ Сборка из исходников

# Требования: Rust 1.70+, Node 18+

git clone https://github.com/openflash/openflash.git
cd openflash/openflash

# ┌─────────────────────────────────────────────────────────────┐
# │  GUI (Tauri + React)                                        │
# └─────────────────────────────────────────────────────────────┘
cd gui && npm i && cargo tauri dev

# ┌─────────────────────────────────────────────────────────────┐
# │  CLI                                                        │
# └─────────────────────────────────────────────────────────────┘
cargo build -p openflash-cli --release

# ┌─────────────────────────────────────────────────────────────┐
# │  Прошивка (выбери свою платформу)                           │
# └─────────────────────────────────────────────────────────────┘

# RP2040 (Raspberry Pi Pico)
cd firmware/rp2040
rustup target add thumbv6m-none-eabi
cargo build --release --target thumbv6m-none-eabi

# RP2350 (Raspberry Pi Pico 2)
cd firmware/rp2350
rustup target add thumbv8m.main-none-eabihf
cargo build --release --target thumbv8m.main-none-eabihf

# Teensy 4.x (USB High Speed!)
cd firmware/teensy4
rustup target add thumbv7em-none-eabihf
cargo build --release --target thumbv7em-none-eabihf

📚 Документация

📖 Wiki — Полная документация
🆕 Гайд для новичков — Никогда не пользовались программатором?
🔌 Настройка железа — Схемы подключения
📋 Поддерживаемые чипы — 230+ чипов
🔧 Решение проблем — Когда что-то сломалось
FAQ — Частые вопросы



╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║                         YOUR DATA WANTS TO BE FREE                           ║
║                         ─────────────────────────                            ║
║                         ТВОИ ДАННЫЕ ХОТЯТ СВОБОДЫ                            ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

⭐ Star · 🐛 Issues · 💬 Discussions


Made with Rust Made with React Made with Tauri


MIT License — Do whatever, don't sue us / Делай что хочешь, только не суди

About

OpenFlash is an open-source NAND/eMMC/NOR flash programmer that turns cheap microcontrollers ($4 Raspberry Pi Pico, STM32, ESP32) into full-featured flash memory readers/writers.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors