# OpenFlash Wiki

**[🇬🇧 English version](Home.md)**

---

<div align="center">

```
     ██████╗ ██████╗ ███████╗███╗   ██╗███████╗██╗      █████╗ ███████╗██╗  ██╗
    ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██╔════╝██║  ██║
    ██║   ██║██████╔╝█████╗  ██╔██╗ ██║█████╗  ██║     ███████║███████╗███████║
    ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██╔══╝  ██║     ██╔══██║╚════██║██╔══██║
    ╚██████╔╝██║     ███████╗██║ ╚████║██║     ███████╗██║  ██║███████║██║  ██║
     ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚═╝     ╚══════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
```

**Железо за $4. Софт бесплатно. Читай любую флеш-память.**

</div>

---

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

| Раздел | Описание |
|--------|----------|
| **[🆕 Гайд для новичков](Beginners-Guide-RU.md)** | Никогда не работал с флешером? Начни здесь! |
| [Быстрый старт](Getting-Started-RU.md) | Установка и первые шаги |
| [Подключение железа](Hardware-Setup-RU.md) | Схемы подключения для всех платформ |
| [Поддерживаемые чипы](Supported-Chips-RU.md) | 230+ поддерживаемых чипов |
| [Решение проблем](Troubleshooting-RU.md) | Частые проблемы и решения |
| [FAQ](FAQ-RU.md) | Часто задаваемые вопросы |

---

## 🤔 Что такое OpenFlash?

OpenFlash читает данные из чипов флеш-памяти — хранилища внутри роутеров, IoT устройств, игровых консолей, SSD и вообще любой электроники.

**Коммерческие программаторы стоят $200-2000.** OpenFlash использует микроконтроллер за $4.

```
┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   Твой компьютер         Микроконтроллер $4      Флеш-чип      │
│   ┌──────────┐           ┌──────────────┐        ┌─────────┐   │
│   │ OpenFlash│◄── USB ──►│ Raspberry Pi │◄─провода►│ NAND    │   │
│   │   App    │           │    Pico      │        │ память  │   │
│   └──────────┘           └──────────────┘        └─────────┘   │
│                                                                 │
│   Вся логика             Тупая труба            Твои секреты   │
│   (ECC, анализ, AI)      (просто GPIO)          живут тут      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## ⚡ Быстрый старт

### Нет железа? Попробуй прямо сейчас!

1. [Скачай OpenFlash](https://github.com/openflash/openflash/releases)
2. Нажми **Mock** → **Scan** → **Connect**
3. Нажми **Dump NAND**
4. Исследуй: Hex View, Bitmap, Analysis, AI

### Есть Raspberry Pi Pico?

1. Скачай прошивку: `openflash-rp2040.uf2`
2. Зажми BOOTSEL, воткни USB, скинь файл
3. Подключи к чипу ([схемы тут](Hardware-Setup-RU.md))
4. Открой приложение → Scan → Connect → Dump

---

## 🔧 Поддерживаемое железо

### Микроконтроллеры

| Платформа | Цена | Скорость | USB | Для кого |
|-----------|------|----------|-----|----------|
| **Raspberry Pi Pico** | ~$4 | ⭐⭐ | Full Speed | Новички |
| **Raspberry Pi Pico 2** | ~$5 | ⭐⭐⭐ | Full Speed | NV-DDR NAND |
| **STM32F4 Black Pill** | ~$5 | ⭐⭐⭐ | Full Speed | Лучшее соотношение цена/скорость |
| **Teensy 4.0/4.1** | ~$20-30 | ⭐⭐⭐⭐⭐ | **High Speed** | Для скорости ⚡ |
| **Arduino GIGA R1** | ~$60 | ⭐⭐⭐⭐ | High Speed | Enterprise + WiFi |
| **ESP32** | ~$4 | ⭐⭐ | UART/USB | Беспроводной |

### Одноплатники (SBC)

| Платформа | Цена | Скорость | Для кого |
|-----------|------|----------|----------|
| **Raspberry Pi 4/5** | ~$35-75 | ⭐⭐⭐⭐ | Headless сервер |
| **Orange Pi** | ~$15-50 | ⭐⭐⭐ | Бюджетный SBC |
| **Banana Pi** | ~$15-35 | ⭐⭐⭐ | RISC-V вариант 🍌 |

### Типы флеш-памяти

| Тип | Чипов | Интерфейс |
|-----|-------|-----------|
| Parallel NAND | 60+ | 8-бит шина, 14 проводов |
| SPI NAND | 55+ | 4 провода |
| SPI NOR | 75+ | 4 провода |
| eMMC | 40+ | 4 провода (SPI режим) |
| UFS | 10+ | Только детекция |

---

## 🎯 Применение

| Задача | Описание |
|--------|----------|
| **Извлечение прошивок** | Дамп прошивок из роутеров, камер, IoT устройств |
| **Восстановление данных** | Восстановление данных с повреждённых носителей |
| **Исследование безопасности** | Анализ прошивок на уязвимости |
| **Реверс-инжиниринг** | Понять как работает устройство |
| **Embedded разработка** | Отладка и тестирование флеш-операций |
| **Форензика** | Извлечение улик с устройств |
| **Обучение** | Изучить как работает флеш-память |

---

## 🧠 Ключевые возможности

### Чтение и запись
- Чтение любого поддерживаемого чипа
- Запись/программирование с верификацией
- Управление bad block'ами
- Отслеживание износа

### Анализ
- **AI-детекция паттернов** — находит зашифрованные, сжатые, исполняемые области
- **Детекция файловых систем** — SquashFS, UBIFS, JFFS2, ext4, FAT
- **ECC коррекция** — Hamming, BCH-4/8/16
- **Поиск ключей шифрования** — находит AES ключи в дампах
- **Анализ износа** — оценка оставшегося ресурса чипа

### Автоматизация
- **Python API** — `pip install pyopenflash`
- **CLI** — `openflash read -o dump.bin`
- **Batch обработка** — обработка нескольких чипов
- **REST API** — интеграция с твоими инструментами

### Облако (v3.0+)
- Синхронизация дампов между устройствами
- Командная работа
- Общая база чипов
- Обновления AI моделей

---

## 📊 Сравнение скорости

| Платформа | Время дампа 1GB | Скорость |
|-----------|-----------------|----------|
| Teensy 4.1 | **3-5 мин** | ~3-5 MB/s |
| Arduino GIGA | ~10 мин | ~1.5 MB/s |
| Raspberry Pi 4 | ~12 мин | ~1.3 MB/s |
| STM32F4 | ~25 мин | ~650 KB/s |
| RP2350 | ~30 мин | ~550 KB/s |
| RP2040 | ~45 мин | ~370 KB/s |
| ESP32 | ~50 мин | ~330 KB/s |

**Teensy 4.x использует USB High Speed (480 Mbit/s) — в 10-20 раз быстрее других MCU!**

---

## 🆘 Помощь

| Ресурс | Ссылка |
|--------|--------|
| 📖 Эта wiki | Ты здесь! |
| 💬 Обсуждения | [GitHub Discussions](https://github.com/openflash/openflash/discussions) |
| 🐛 Баг-репорты | [GitHub Issues](https://github.com/openflash/openflash/issues) |
| 📧 Email | support@openflash.io |

---

## 🤝 Участие в проекте

Мы рады вкладу в проект!

- **Тестируй чипы** — Сообщай о работающих/неработающих чипах
- **Исправляй баги** — Присылай pull request'ы
- **Улучшай документацию** — Помоги другим разобраться
- **Переводи** — Добавь свой язык

См. [CONTRIBUTING.md](https://github.com/openflash/openflash/blob/main/CONTRIBUTING.md)

---

<div align="center">

**OpenFlash v3.0** · MIT License · Сделано с ❤️ сообществом

</div>