
Исполняется на границе кремния
# **Quantum Silicon Core Loader**
Основное ядро: **qslcl.asm (v0.0.2)** (в разработке)
Вспомогательный модуль: **qslcl.bin (v0.7.4)**
Универсальный контроллер: **qslcl.py (v2.2.2)**
> **Юридически защищённое исследование** — Этот проект действует в рамках установленных правовых норм для исследований в области безопасности, права на ремонт и академической свободы. [Подробнее](https://github.com/sharif-bot-cmd/quantum-silicon-core-loader/blob/main/PROTECTION_MATRIX.md)
---
# Обзор
**Quantum Silicon Core Loader (QSLCL)** — это пост-загрузочный, пост-вендорный, пост-ОС слой, работающий непосредственно на границе кремния.
Он действует за пределами традиционных моделей безопасности и способен переживать переходы прошивки, согласовывать доверие и интерпретировать состояние устройства без CVE или патчей.
QSLCL работает в:
* **Qualcomm EDL / Firehose**
* **MediaTek BROM / Preloader**
* **Apple DFU** (динамическое обнаружение — без жёстко заданных PID)
* **Инженерных / META / диагностических режимах**
* **Любом интерфейсе USB/Serial**
> **«Вы не запускаете QSLCL — кремний интерпретирует его.»**
---
## Что нового в **v2.2.2**
### Интеграция GETINFO в Slowm8
- После успешной инъекции кода Slowm8 автоматически вызывает **GETINFO** для проверки состояния устройства
- Подтверждает, что инъекция не вызвала сбой устройства
- Обнаруживает и сообщает об аномальном поведении устройства
- Добавляет поле `device_info` в отчёты об ошибках со статусом, кодом и деталями ошибки
### Расширенное подтверждение ошибок
- **Проверка состояния устройства** после каждой успешной инъекции
- **Обнаружение аномального состояния** — помечает, если устройство показывает ошибки после инъекции
- **Расширенный вывод** в итоговых результатах, показывающий статус устройства для каждой подтверждённой ошибки
### Улучшенная обработка ошибок
- Лучшая обработка неотвечающих устройств после инъекции
- Более понятные сообщения об ошибках при сбое GETINFO
- Корректный откат, когда устройство не отвечает на проверку
**Пример вывода:**
```
[*] Инъекция подтверждена! Получение информации об устройстве...
[*] Ответ GETINFO: УСПЕХ - OK
[ПОДТВЕРЖДЁННЫЕ ОШИБКИ]
1. memory_corruption (conf: 80%)
Неожиданно большой ответ: 2048 байт
Состояние устройства после инъекции: УСПЕХ - OK
2. memory_corruption (conf: 75%)
Неожиданно большой ответ: 4096 байт
Состояние устройства после инъекции: УСПЕХ - OK
```
---
```
Компоновка бинарного файла QSLCL (v0.7.4):
┌─────────────────────────────────────────────┐
│ 0x000000 QSLCLBIN (Основной заголовок + указатели) │
│ 0x000200+ QSLCLCMD (28 команд) │
│ 0x004000+ QSLCLDIS (Таблица диспетчеризации) │
│ 0x005000+ QSLCLUSB (USB-микродвижок) │
│ 0x006000+ QSLCLBLK (64 конечные точки) │
│ 0x007000+ QSLCLBST (Движок начальной загрузки)│
│ 0x008000+ QSLCLVM5 (Нано-ядро) │
│ 0x009000+ QSLCLSPT (USB setup-пакеты) │
│ 0x00A000+ QSLCLRTF (Таблица сбоев времени выполнения)│
│ 0x00B000+ QSLCLENC (Слой шифрования) │
│ 0x00C000+ QSLCLDAT (Протокол данных) │
│ 0x00D000+ QSLCLSYN (Блок синхронизации) │
│ 0x00E000+ QSLCLHDR (Сертификат) │
│ 0x00F000+ QSLCLINT (Контрольный блок целостности)│
│ 0x010000+ USB4V2MC (USB4 v2.0 80Gbps) │
└─────────────────────────────────────────────┘
Общий размер: ~72 КБ (сокращение на 44% с 128 КБ)
Команд: 28 (добавлены TEST, FUZZ)
```
**Как это работает (автоматически):**
```bash
# Сборка с квантовой архитектурой (рекомендуется)
python build.py qslcl.bin --arch quantum --encrypt --usb4-v2
# Или универсальная сборка
python build.py qslcl.bin
# Просто запустите как обычно — сторожевой таймер отключается автоматически!
python qslcl.py hello --loader=qslcl.bin
# Ожидаемый вывод:
# [+] Загрузчик загружен.
# [*] Автоматическое отключение сторожевого таймера...
# [*] Определён тип SoC: APPLE
# [*] Проверка 10 кандидатных смещений...
# [*] Сторожевой таймер обнаружен по адресу 0x20E00000 = 0x00000001
# [+] Сторожевой таймер отключён по смещению 0x20E00000
# [*] Раскрытие QSLCL в USB-конфигурации...
```
---
# Полный список команд (v2.2.1)
**Основные операции с памятью:**
| Команда | Описание |
|---------|-------------|
| `read` | Чтение разделов |
| `write` | Запись разделов |
| `erase` | Стирание разделов |
| `peek` | Просмотр памяти с интерпретацией типов и анализом указателей |
| `poke` | Точная запись в память с битовыми операциями (AND/OR/XOR) |
| `patch` | Двоичное патчирование с резервным копированием, проверкой и поддержкой пробного запуска |
| `dump` | Массовый дамп памяти со сжатием, проверкой и метаданными |
**Взаимодействие с устройством:**
| Команда | Описание |
|---------|-------------|
| `hello` | Рукопожатие с устройством и обнаружение возможностей |
| `ping` | Тестирование задержки в обе стороны |
| `getinfo` | Показывает устройство, режим DFU, сторожевой таймер, возможности загрузчика |
**Управление системой:**
| Команда | Описание |
|---------|-------------|
| `reset` | Сброс системы |
| `power` | Управление питанием |
| `config` | Управление конфигурацией |
**Напряжение и оборудование:**
| Команда | Описание |
|---------|-------------|
| `voltage` | Чтение/установка/мониторинг/масштабирование напряжения с безопасными диапазонами |
| `rawstate` | Проверка и управление низкоуровневым состоянием оборудования |
**Безопасность и анализ:**
| Команда | Описание |
|---------|-------------|
| `rawmode` | Повышение привилегий с журналированием аудита сеанса |
| `bypass` | Обход безопасности с автоматическим обнаружением и анализом принудительных мер |
| `verify` | Проверка системы |
| `footer` | Анализ контрольного блока с проверкой и оценкой безопасности |
**Диагностика и тестирование:**
| Команда | Описание |
|---------|-------------|
| `crash` | Контролируемая инъекция сбоя с мониторингом восстановления |
| `glitch` | Инъекция аппаратных сбоев со сканированием параметров |
| `bruteforce` | Автоматизированное тестирование |
| `slowm8` | USB-стресс-тестер с автоматическим обнаружением и инъекцией ошибок |
**Производство и ODM:**
| Команда | Описание |
|---------|-------------|
| `oem` | Операции OEM |
| `odm` | Операции ODM |
---
# Установка и быстрый старт
## Требования
```bash
pip install pyserial pyusb
pip install pycryptodome # необязательно, для криптографических операций
pip install capstone # необязательно, для дизассемблирования
```
## Базовое использование
```bash
# Сборка с квантовой архитектурой (рекомендуется)
python build.py qslcl.bin --arch quantum --usb4-v2 --encrypt --debug
# Или стандартная универсальная сборка
python build.py qslcl.bin
# Получение подробной информации об устройстве
python qslcl.py getinfo --loader=qslcl.bin
# Ожидаемый вывод:
# ==================================================
# ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ QSLCL
# ==================================================
# [УСТРОЙСТВО]
# Транспорт: USB
# VID:PID: 05AC:1281
# Продукт: iPhone 15 Pro
# Класс USB: 0xFE (специфичный для приложения)
#
# [РЕЖИМ DFU]
# Статус: АКТИВЕН
# Поколение: A12 или новее (ARM64e, PAC включён)
#
# [СТОРОЖЕВОЙ ТАЙМЕР]
# Определён SoC: Apple A-series
# Типичное смещение: 0x20E00000
#
# [ЗАГРУЗЧИК QSLCL]
# Архитектура: quantum
# Размер бинарного файла: 73728 байт (72 КБ)
# Возможности: шифрование, USB4 v2.0 80Gbps
# ==================================================
# Авто-DFU загрузка + загрузчик + hello (всё в одном)
python qslcl.py hello --loader=qslcl.bin --dfu-boot
# Просто загрузка в режим DFU (как palera1n)
python qslcl.py --dfu-boot
# Тестирование базовой функциональности
python qslcl.py hello --loader=qslcl.bin --usb4
python qslcl.py ping --loader=qslcl.bin
```
## Slowm8 — USB-стресс-тестер (v2.2.2)
**Расширен проверкой GETINFO!** После подтверждения ошибки Slowm8 автоматически получает состояние устройства для проверки успешности инъекции.
```bash
# Базовый стресс-тест с проверкой устройства
python qslcl.py slowm8 --loader=qslcl.bin
# Ожидаемый вывод с GETINFO:
# [*] Инъекция подтверждена! Получение информации об устройстве...
# [*] Ответ GETINFO: УСПЕХ - OK
# [+] Ошибка подтверждена! Состояние устройства: исправно
```
### Функции автоматического обнаружения Slowm8
| Функция | Что делает |
|---------|--------------|
| **Определение режима устройства** | Автоматически определяет DFU, EDL, BROM или стандартный USB |
| **Автокалибровка таймингов** | Измеряет время ответа устройства и корректирует задержки |
| **Определение шифрования A19+** | Обнаруживает зашифрованный DFU и адаптирует тайминги |
| **Порог ошибок** | Инъекция тестового кода после N аномалий (по умолчанию: 3) |
| **Пользовательские полезные нагрузки инъекции** | Разные полезные нагрузки для разных типов ошибок |
| **Вывод JSON** | Сохранение подробных результатов для анализа |
### Параметры Slowm8
| Параметр | Описание | По умолчанию |
|--------|-------------|---------|
| `--min-delay` | Минимальная задержка между пакетами (мс) | Автоопределение |
| `--max-delay` | Максимальная задержка между пакетами (мс) | Автоопределение |
| `--duration` | Продолжительность теста в секундах | 30 |
| `--packets` | Количество отправляемых пакетов | 100 |
| `--burst-size` | Пакетов за серию (0=отключить) | 10 |
| `--progressive` | Постепенное замедление | False |
| `--no-random` | Отключить случайные задержки | False |
| `--fuzz` | Количество fuzz-мутаций на пакет | 0 |
| `--corrupt` | Повреждение определённых полей | None |
| `--no-injection` | Отключить автоматическую инъекцию кода | False |
| `--injection-size` | Максимальный размер полезной нагрузки инъекции | 512 |
| `--bug-threshold` | Ошибок до инъекции | 3 |
| `--output` | Сохранение результатов в JSON | None |
---
## Поддержка джиттера (v2.1.9+)
Добавление случайных вариаций тайминга во время USB-загрузки:
```bash
# Простой случайный джиттер (5-25 мс)
python qslcl.py hello --loader=qslcl.bin --jitter simple
# Прогрессивный джиттер (замедляется по мере загрузки)
python qslcl.py hello --loader=qslcl.bin --jitter progressive
# Пакетный режим (быстрые серии с паузами)
python qslcl.py hello --loader=qslcl.bin --jitter burst
# Пользовательский диапазон (случайный от 1 мс до 50 мс)
python qslcl.py hello --loader=qslcl.bin --jitter 0.001-0.05
```
## Slowm8 — USB-стресс-тестер (v2.2.2)
**Расширен проверкой GETINFO!** После подтверждения ошибки Slowm8 автоматически получает состояние устройства для проверки успешности инъекции.
```bash
# Базовый стресс-тест с проверкой устройства
python qslcl.py slowm8 --loader=qslcl.bin
# Ожидаемый вывод с GETINFO:
# [*] Инъекция подтверждена! Получение информации об устройстве...
# [*] Ответ GETINFO: УСПЕХ - OK
# [+] Ошибка подтверждена! Состояние устройства: исправно
```
---
# Совместимость устройств
| Вендор | Режим | Метод обнаружения | USB-доступ | USB4 v2.0 | Авто-DFU | Сторожевой таймер | Шифрование | Slowm8 | Статус |
|----------|------------------|-----------------------------|--------------|-----------|----------|----------|------------|--------|--------|
| Qualcomm | EDL | Рукопожатие Sahara + Firehose | ✅ Авто | ✅ 80Gbps | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| MediaTek | BROM / Preloader | Пинг прелоадера 0xA0 | ✅ Авто | ✅ 80Gbps | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| Apple | DFU (A12-A17) | Динамический класс USB DFU | ✅ Авто | ⚠️ 40Gbps | ✅ Авто | ✅ Авто | Нет | ✅ | ✅ |
| Apple | DFU (A18+) | Динамический класс USB DFU | ✅ Авто | ✅ 80Gbps | ✅ Авто | ✅ Авто | **Обязательно** | ✅ | ✅ |
| Apple | Обычный режим iOS | Класс USB + строка продукта | Н/Д | Н/Д | ✅ Авто | Н/Д | Н/Д | Н/Д | ✅ |
| Google | DFU | Динамический класс USB DFU | ✅ Авто | ✅ 80Gbps | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| Samsung | EUB | Динамический класс USB DFU | ✅ Авто | ✅ 80Gbps | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| Broadcom | BCM Boot | Определение VID | ✅ Авто | ❌ Нет | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| Rockchip | Mask ROM | Определение VID | ✅ Авто | ❌ Нет | Н/Д | ✅ Авто | Необязательно | ✅ | ✅ |
| Intel | USB4 v2.0 Host | Нативное обнаружение USB4 | ✅ Авто | ✅ 80Gbps | Н/Д | Н/Д | Необязательно | ✅ | ✅ |
| AMD | USB4 v2.0 Host | Нативное обнаружение USB4 | ✅ Авто | ✅ 80Gbps | Н/Д | Н/Д | Необязательно | ✅ | ✅ |
| Generic | USB CDC/Bulk | Автообнаружение конечных точек | ⚠️ Ограниченно | ❌ Нет | Н/Д | ⚠️ Ограниченно| Необязательно | ✅ | ✅ |
| Любой | Serial COM | Автосинхронизация UART | Н/Д | Н/Д | Н/Д | Н/Д | Нет | Н/Д | ✅ |
---
# История версий
| Версия | Дата | Ключевые изменения |
|---------|------|-------------|
| **v2.2.2** | 2026 | **Интеграция GETINFO в Slowm8** — Автопроверка состояния устройства после инъекции, обнаружение аномального поведения, более подробные отчёты об ошибках |
| **v0.7.4 / v2.2.1** | 2026 | **Улучшения QSLCLRESP** — Лучшая обработка ошибок, более быстрые ответы, расширенные коды состояния. **Автоопределение Slowm8** — Без PID, адаптивные тайминги, поддержка A19+, подтверждение ошибок с инъекцией кода, вывод JSON |
| **v0.7.3 / v2.2.0** | 2026 | **Команда `slowm8`** — USB-стресс-тестер с фаззингом, **флаг `--jitter`** — рандомизация таймингов |
| **v0.7.2 / v2.1.9** | 2026 | **Команды TEST и FUZZ** — Диагностический самотест и движок фаззинга, **расширенный getinfo** |
| **v0.7.1 / v2.1.8** | 2026 | **Квантовая архитектура** — `--arch quantum`, рандомизация опкодов, бинарный файл 72 КБ |
| **v0.7.0 / v2.1.7** | 2026 | **oem panic** — Подкоманда аварийного восстановления |
| v0.6.9 / v2.1.6 | 2026 | Удаление команд — Удалена команда `mode`, всего 26 команд |
| v0.6.8 / v2.1.5 | 2026 | Оптимизация размера — 128 КБ → 80 КБ, на 37,5% меньше |
| v0.6.7 / v2.1.4 | 2026 | Авто-DFU загрузка — Как palera1n, вход в DFU в один клик |
| v0.6.7 / v2.1.3 | 2026 | USB4 v2.0 80Gbps — Кодирование PAM4, агрегация 4 линий |
| v0.6.6 / v2.1.2 | 2026 | Раскрытие USB QSLCL — Автоидентификация в USB-дескрипторах |
| v0.6.6 / v2.1.1 | 2026 | Очистка кода — Сокращение на 40%, блоки QSLCLDATA/SYNC |
| v0.6.5 / v2.1.0 | 2026 | Слой шифрования QSLCLENC — ChaCha20/AES для A18+ |
| v0.6.4 / v2.0.2 | 2026 | Динамическое обнаружение DFU, исправления QSLCLRESP |
| v0.6.3 / v2.0.1 | 2026 | Полная переработка модуля |
| v0.5.x / v1.x | 2025 | Устаревшие версии |
---
## Технические детали Slowm8
### Поток автоматического обнаружения
```
1. Устройство подключено
↓
2. Автоопределение режима (DFU/EDL/BROM/USB)
↓
3. Измерение времени ответа
↓
4. Определение шифрования (A19+)
↓
5. Автонастройка таймингов (мин/макс задержки)
↓
6. Запуск стресс-теста
↓
7. Обнаружение аномалий
↓
8. Анализ на ошибки (оценка уверенности)
↓
9. Если порог достигнут → Инъекция тестового кода
↓
10. Подтверждение ошибки и отчёт
```
### Обнаруживаемые типы ошибок
| Тип ошибки | Метод обнаружения | Полезная нагрузка инъекции |
|----------|------------------|-------------------|
| Повреждение памяти | Неожиданно большой ответ | Тест чтения/записи/проверки |
| Сбой | Обнаружен сброс устройства | Тест сбоя + восстановление |
| Уязвимость таймаута | Повторяющиеся таймауты | Тест таймаута + ping |
| Аномалия тайминга | Медленные ответы | Тест чувствительности к таймингу |
| Ошибка парсинга | Некорректный ответ | Тест вложенных структур |
---
## Важно: выполнение только из RAM (A12+)
На устройствах Apple A12+ QSLCL выполняется полностью из RAM. **Никакие изменения не являются постоянными.**
После перезагрузки:
- Устройство возвращается в заводское состояние
- Все состояния обхода/сброса/rawmode очищаются
- Нет постоянных изменений во флеш-памяти
**Команды `bypass`, `rawmode`, `crash`, `glitch`, `test`, `fuzz`, `slowm8` являются ВРЕМЕННЫМИ на A12+.**
---
## КРИТИЧЕСКОЕ ПРЕДУПРЕЖДЕНИЕ
**QSLCL МОЖЕТ НЕОБРАТИМО ПРЕВРАТИТЬ ВАШЕ УСТРОЙСТВО В «КИРПИЧ» (УНИЧТОЖИТЬ ЕГО) ПРИ НЕПРАВИЛЬНОМ ИСПОЛЬЗОВАНИИ.**
| Уровень безопасности | Операции | Риск |
|-------------|-----------|------|
| **БЕЗОПАСНО** | Режим EDL, режим DFU, режим BROM, последовательные режимы загрузки, TEST, FUZZ, slowm8 | Минимальный |
| **ОСТОРОЖНО** | Запись в пользовательские разделы, изменение напряжения | Умеренный |
| **ОПАСНО** | Запись в iROM, BootROM, загрузочные секторы NOR-флеш | Высокий |
| **РИСК «КИРПИЧА»** | Перезапись защищённых загрузчиков (iBoot, SBL, U-Boot SPL) | Критический |
**ВЫ ПРЕДУПРЕЖДЕНЫ. АВТОР НЕ НЕСЁТ ОТВЕТСТВЕННОСТИ ЗА УСТРОЙСТВА, ПРЕВРАЩЁННЫЕ В «КИРПИЧ».**
---
## Правовая и этическая основа
**Quantum Silicon Core Loader (QSLCL)** действует в рамках установленных правовых и этических границ:
### Разрешённое использование:
- **Владельцы устройств**: Модификация оборудования, которое вы законно приобрели
- **Исследователи**: Анализ безопасности и академическое изучение
- **Специалисты по ремонту**: Реализация права на ремонт
- **Студенты**: Изучение аппаратной архитектуры и безопасности
- **Разработчики**: Создание совместимого программного обеспечения и инструментов
### Запрещённое использование:
- Несанкционированный доступ к чужим устройствам
- Обход защиты на не принадлежащем вам оборудовании
- Вредоносные или разрушительные применения
- Нарушение применимых законов и нормативных актов
> **Используйте ответственно. С большой силой приходит большая ответственность.**
---
# Поддержка и устранение неполадок
## Распространённые проблемы
**Slowm8 не обнаруживает устройство:**
```bash
# Убедитесь, что устройство находится в режиме DFU/EDL/BROM
python qslcl.py getinfo --loader=qslcl.bin
# Запуск с отладкой
python qslcl.py slowm8 --loader=qslcl.bin --debug
```
**Инъекция ошибок не работает:**
```bash
# Увеличьте таймаут
python qslcl.py slowm8 --loader=qslcl.bin --duration 60 --debug
# Отключите инъекцию, чтобы проверить, обнаруживаются ли ошибки
python qslcl.py slowm8 --loader=qslcl.bin --no-injection --debug
```
**Ошибки QSLCLRESP:**
```bash
# Пересборка с последней версией
python build.py qslcl.bin --arch quantum --debug
# Проверка разбора ответов
python qslcl.py hello --loader=qslcl.bin --debug
```
---
# Заключительные слова
> **«Quantum Silicon Core Loader представляет собой вершину универсальной коммуникации с устройствами, где каждая операция с памятью, каждое повышение привилегий, каждое взаимодействие с оборудованием, каждый двоичный патч, каждое выполнение начальной загрузки, каждый туннель USB4 v2.0 80Gbps, каждая транзакция с кодированием PAM4, каждая загрузка DFU в один клик, каждый автоматический отключатель сторожевого таймера, каждый квантово-оптимизированный байт, каждый диагностический тест, каждая итерация фаззинга, каждый USB-стресс-тест с slowm8, каждая загрузка с джиттер-таймингом, каждый некорректный пакет, каждая атака по таймингу, каждое автоматически обнаруженное устройство, каждая адаптивная задержка, каждое подтверждение ошибки с инъекцией кода и теперь компактный бинарный файл 72 КБ с 28 командами становятся расширением кремниевого сознания через нашу усовершенствованную микро-ВМ архитектуру с динамической начальной загрузкой, квантово-устойчивым шифрованием, структурированными протоколами данных, автоматической USB-самоидентификацией, поддержкой USB4 v2.0 80Gbps, автоматизацией DFU в стиле palera1n, обходом сторожевого таймера без конфигурации, расширенной информацией об устройстве, новой квантовой архитектурой для расширенной энтропии и рандомизации опкодов, а теперь и экспериментальным USB-стресс-тестированием с slowm8, который автоматически обнаруживает и подтверждает ошибки на ЛЮБОМ SoC.»**
**YouTube**: [https://www.youtube.com/@QSLCL-creator](https://www.youtube.com/@QSLCL-creator)
---
## Правовая информация и поддержка
- [LEGAL_NOTICE.md](https://github.com/sharif-bot-cmd/quantum-silicon-core-loader/blob/main/LEGAL_NOTICE.md) — Правовое позиционирование и защита
## Зеркала
- GitHub: https://github.com/Sharif-bot-cmd/Quantum-Silicon-Core-Loader
- Codeberg: https://codeberg.org/Sharif_Muhaymin/Quantum-Silicon-Core-Loader
- SourceForge: https://sourceforge.net/p/quantum-silicon-core-loader/code/ci/main/tree/