Мой рабочий загрузчик для ОС Ventura, подготовленный к обновлению на Sonoma / Sequoia.

# Hackintosh: Mac Mini (i7-8709G + Radeon Vega M)

Репозиторий содержит протестированную и рабочую папку `EFI` для конфигурации мини-ПК на базе процессора Kaby Lake-G под управлением macOS.

## 💻 Спецификация оборудования (Hardware Specs)

* **Процессор:** Intel Core i7-8709G (4 ядра / 8 потоков, 3.1 GHz)
* **Графика:** AMD Radeon RX Vega M GL (OCLP root patch в Sonoma+)
* **Wi-Fi / Bluetooth:** Broadcom BCM94360 (OCLP root patch + IOSkywalk block в Sonoma+)
* **Ethernet:** Dual LAN
  * Port 1: Intel (драйвер `IntelMausi`)
  * Port 2: Realtek (драйвер `RealtekRTL8111`)
* **Текущий SMBIOS:** `Macmini8,1`
* **Версия OpenCore:** 0.9.8 → требуется обновление до 1.0.0+

---

## 🚀 Статус поддержки ОС и план обновления

Текущая рабочая система — **macOS 13 Ventura**. Для обновления на **macOS 14 Sonoma** или **macOS 15 Sequoia** требуется **OpenCore Legacy Patcher (OCLP)**, так как Apple удалила нативную поддержку Vega M и Broadcom Wi-Fi.

### ✅ Уже применено в `config.plist`

| Параметр | Значение |
|---|---|
| `Misc → Security → SecureBootModel` | `Disabled` |
| `NVRAM → csr-active-config` | `03080000` (Sonoma) |
| `NVRAM → boot-args` | добавлен `amfi=0x80` |
| `Kernel → Block` | `com.apple.iokit.IOSkywalkFamily` (MinKernel 23.0.0, Strategy Exclude) |
| `Kernel → Add` | `AMFIPass.kext`, `IOSkywalkFamily.kext`, `IO80211FamilyLegacy.kext` + `AirPortBrcmNIC.kext` |

Kext-файлы Wi-Fi скачаны из [OCLP payloads](https://github.com/dortania/OpenCore-Legacy-Patcher/tree/main/payloads/Kexts/Wifi).

---

## 📋 Пошаговый план обновления

### Шаг 1. Обновить OpenCore (0.9.8 → 1.0.0+)

1. Скачайте последний [OpenCorePkg](https://github.com/acidanthera/OpenCorePkg/releases) (1.0.0 или новее).
2. Замените в `EFI/OC/`:
   * `OpenCore.efi`
   * `EFI/BOOT/BOOTx64.efi`
   * Драйверы в `EFI/OC/Drivers/` (минимум: `OpenRuntime.efi`, `OpenCanopy.efi`, `HfsPlus.efi`)
3. Сравните `config.plist` с `Sample.plist` из релиза — между 0.9.8 и 1.0.0+ могли появиться новые ключи в `Booter/Quirks`, `Kernel/Quirks`, `UEFI/Quirks`. Используйте [OCValidate](https://github.com/acidanthera/OpenCorePkg/releases) для проверки.
4. Обновите кексты до актуальных версий:
   * `Lilu`, `WhateverGreen`, `VirtualSMC`, `AppleALC`
   * `AirportBrcmFixup`, `IntelMausi`, `RealtekRTL8111`

### Шаг 2. Подготовка config.plist (уже выполнена)

Ключевые изменения для OCLP:

```xml
<!-- Kernel → Block -->
<dict>
    <key>Arch</key><string>Any</string>
    <key>Comment</key><string>Block IOSkywalkFamily for OCLP Wi-Fi (Sonoma+)</string>
    <key>Enabled</key><true/>
    <key>Identifier</key><string>com.apple.iokit.IOSkywalkFamily</string>
    <key>MaxKernel</key><string></string>
    <key>MinKernel</key><string>23.0.0</string>
    <key>Strategy</key><string>Exclude</string>
</dict>
```

```xml
<!-- NVRAM → csr-active-config -->
<!-- Sonoma: 03080000 → AwgAAA== -->
<!-- Sequoia: 030F0000 → Aw8AAA== -->
<key>csr-active-config</key>
<data>AwgAAA==</data>
```

### Шаг 3. SMBIOS для Sequoia

`Macmini8,1` **не поддерживается** в macOS 15 Sequoia.

| Вариант | Плюсы | Минусы |
|---|---|---|
| **`iMac19,1`** (рекомендуется) | Desktop SMBIOS с dGPU; хорошо подходит для Kaby Lake-G + Vega M | Нужны новые серийник/MLB/UUID |
| **`Macmini9,1`** | Ближе к форм-фактору mini | Coffee Lake; возможны несоответствия CPU |
| **Оставить `Macmini8,1` + `-no_compat_check`** | Не менять идентификаторы | Может сломаться в будущих обновлениях; iCloud/FaceTime могут работать нестабильно |

**Рекомендация:** для Sequoia смените SMBIOS на `iMac19,1`, сгенерируйте новые серийник/MLB через [GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) и выполните NVRAM Reset. Для Sonoma `Macmini8,1` пока допустим.

При смене SMBIOS на Sequoia также измените `csr-active-config` на `030F0000` (`Aw8AAA==`).

### Шаг 4. Boot-args (графика Vega M)

Текущие аргументы сохранены и актуальны для апгрейда:

```
-lilubetaall -v keepsyms=1 -amfipassbeta amfi=0x80 debug=0x100 alcid=1 -wegnoigpu agdpmod=pikera
```

| Аргумент | Назначение |
|---|---|
| `-wegnoigpu` | Отключает встроенную Intel GPU (используется Vega M) |
| `agdpmod=pikera` | Обход проверки board-id для Polaris/Vega (через WhateverGreen) |
| `-amfipassbeta amfi=0x80` | Разрешает OCLP root-патчи |
| `Polaris22Fixup.kext` + `SSDT-GpuSpoof.aml` | Спуф GPU как «Radeon Pro Vega II Duo» |

Флаги `-radgva=gh` и weapon-id spoofs **не требуются** — `agdpmod=pikera` и `Polaris22Fixup` уже решают проблему. После OCLP root patch GPU-ускорение восстанавливается нативно.

### Шаг 5. Обновление macOS

1. Скопируйте обновлённую папку `EFI` на загрузочный раздел.
2. **Reset NVRAM** (обязательно после смены csr/boot-args).
3. Обновляйтесь через «Системные настройки → Обновление ПО».
4. Wi-Fi не будет работать до OCLP — используйте Ethernet (Intel или Realtek).

### Шаг 6. OCLP root patch (после установки)

1. Скачайте [OpenCore Legacy Patcher](https://github.com/dortania/OpenCore-Legacy-Patcher/releases).
2. Запустите → **Post-Install Root Patch** → **Start Root Patching**.
3. Перезагрузка → снова **Reset NVRAM**.
4. Проверьте: Wi-Fi, AirDrop, GPU Metal, Bluetooth.

---

## ⚠️ Важные замечания

* Ethernet (IntelMausi + RealtekRTL8111) работает сразу после обновления — проводной интернет не пострадает.
* Не удаляйте `AMFIPass.kext` и `DisableLibraryValidation.kext` до завершения OCLP-патча.
* Для отладки загрузки можно временно оставить `-v debug=0x100`, затем убрать.