From fd088f9c7eedb2e833b949030115310096928c14 Mon Sep 17 00:00:00 2001 From: Renato97 Date: Tue, 31 Mar 2026 01:16:14 -0300 Subject: [PATCH] chore: clean unnecessary markdown files for CV sharing --- 01-bios-settings.md | 220 ---- 02-create-installer.md | 397 ------ 03-efi-config.md | 893 -------------- 04-installation.md | 419 ------- 04-usb-mapping-windows.md | 68 -- 05-post-install.md | 545 --------- CONTINUAR_USB_CREATION.md | 187 --- GUIDE_FOR_VM.md | 37 - QUICKSTART.md | 203 --- README-PROCESO-COMPLETO.md | 450 ------- downloads.md | 246 ---- hackintosh-guide/01-bios-settings.md | 220 ---- hackintosh-guide/02-create-installer.md | 397 ------ hackintosh-guide/03-efi-config.md | 893 -------------- hackintosh-guide/04-installation.md | 419 ------- hackintosh-guide/05-post-install.md | 545 --------- .../01-bios-settings.md | 220 ---- .../02-create-installer.md | 397 ------ .../Hackintosh-Backup-Final/03-efi-config.md | 893 -------------- .../04-installation.md | 419 ------- .../05-post-install.md | 545 --------- .../Hackintosh-Backup-Final/QUICKSTART.md | 203 --- .../README-PROCESO-COMPLETO.md | 450 ------- .../Hackintosh-Backup-Final/README.md | 191 --- .../Hackintosh-Backup-Final/downloads.md | 246 ---- hackintosh-guide/QUICKSTART.md | 203 --- hackintosh-guide/README.md | 191 --- .../README.md | 82 -- .../README.zh_CN.md | 83 -- .../Utilities/EnableGop/README.md | 184 --- .../Utilities/FindSerialPort/README.md | 4 - .../Utilities/LegacyBoot/README.md | 7 - .../Utilities/LogoutHook/README.md | 17 - .../Utilities/ShimUtils/README.md | 107 -- .../Utilities/macrecovery/README.md | 8 - .../Utilities/macserial/FORMAT.md | 224 ---- .../Utilities/macserial/README.md | 7 - .../Utilities/ocvalidate/README.md | 140 --- .../config-asus-b760-i7-13700k-rx6800xt.md | 706 ----------- hackintosh-guide/docs/Changelog.md | 1084 ----------------- hackintosh-guide/downloads.md | 246 ---- hackintosh-guide/gibMacOS-master/Readme.md | 14 - .../Contents/Resources/README.md | 19 - .../README.md | 61 - .../troubleshooting/troubleshooting.md | 382 ------ 45 files changed, 13472 deletions(-) delete mode 100755 01-bios-settings.md delete mode 100755 02-create-installer.md delete mode 100755 03-efi-config.md delete mode 100755 04-installation.md delete mode 100644 04-usb-mapping-windows.md delete mode 100755 05-post-install.md delete mode 100644 CONTINUAR_USB_CREATION.md delete mode 100644 GUIDE_FOR_VM.md delete mode 100755 QUICKSTART.md delete mode 100755 README-PROCESO-COMPLETO.md delete mode 100755 downloads.md delete mode 100755 hackintosh-guide/01-bios-settings.md delete mode 100755 hackintosh-guide/02-create-installer.md delete mode 100755 hackintosh-guide/03-efi-config.md delete mode 100755 hackintosh-guide/04-installation.md delete mode 100755 hackintosh-guide/05-post-install.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/01-bios-settings.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/02-create-installer.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/03-efi-config.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/04-installation.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/05-post-install.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/QUICKSTART.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/README-PROCESO-COMPLETO.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/README.md delete mode 100755 hackintosh-guide/Hackintosh-Backup-Final/downloads.md delete mode 100755 hackintosh-guide/QUICKSTART.md delete mode 100755 hackintosh-guide/README.md delete mode 100755 hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.md delete mode 100755 hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.zh_CN.md delete mode 100755 hackintosh-guide/Utilities/EnableGop/README.md delete mode 100755 hackintosh-guide/Utilities/FindSerialPort/README.md delete mode 100755 hackintosh-guide/Utilities/LegacyBoot/README.md delete mode 100755 hackintosh-guide/Utilities/LogoutHook/README.md delete mode 100755 hackintosh-guide/Utilities/ShimUtils/README.md delete mode 100755 hackintosh-guide/Utilities/macrecovery/README.md delete mode 100755 hackintosh-guide/Utilities/macserial/FORMAT.md delete mode 100755 hackintosh-guide/Utilities/macserial/README.md delete mode 100755 hackintosh-guide/Utilities/ocvalidate/README.md delete mode 100755 hackintosh-guide/config-examples/config-asus-b760-i7-13700k-rx6800xt.md delete mode 100755 hackintosh-guide/docs/Changelog.md delete mode 100755 hackintosh-guide/downloads.md delete mode 100755 hackintosh-guide/gibMacOS-master/Readme.md delete mode 100755 hackintosh-guide/kexts-downloaded/AppleIGC.kext/Contents/Resources/README.md delete mode 100755 hackintosh-guide/luchina-efi/EFI-ROG-MAXIMUS-Z790-HERO-INTEL-i7-13700K-RX-6900-XT-WIFI-INTEL-20251027-PUBLIC-main/README.md delete mode 100755 hackintosh-guide/troubleshooting/troubleshooting.md diff --git a/01-bios-settings.md b/01-bios-settings.md deleted file mode 100755 index c263061..0000000 --- a/01-bios-settings.md +++ /dev/null @@ -1,220 +0,0 @@ -# 01 - Configuración del BIOS - -## ⚙️ ASUS ROG STRIX B760-I GAMING WIFI - Configuración Completa - -### 🔄 Antes de Comenzar - -1. **Anota tus configuraciones actuales** (foto o notas) -2. **Conecta teclado USB** (el inalámbrico puede no funcionar en BIOS) -3. **NO guardes hasta terminar todas las configuraciones** - ---- - -## 📍 Navegación del BIOS - -``` -Presiona [Delete] o [F2] al encender para entrar al BIOS -``` - -### Estructura del Menú ASUS: -- **Main** - Información del sistema -- **Advanced** - Configuraciones avanzadas -- **Monitor** - Monitoreo y overclocking -- **Boot** - Opciones de arranque -- **Tool** - Herramientas del sistema - ---- - -## 🔧 Configuraciones Obligatorias - -### 1. Deshabilitar Fast Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot | Fast Boot | **DISABLE** | - -**¿Por qué?** Fast Boot puede causar problemas con el reconocimiento de dispositivos USB y el arranque de OpenCore. - ---- - -### 2. Configurar CFG Lock (CRÍTICO) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | CFG Lock | **DISABLE** | - -**¿Por qué?** CFG Lock habilitado impide que macOS modifique las configuraciones de energía de la CPU, causando kernel panic. - -**¿No aparece la opción?** Tu BIOS puede no tener esta opción visible. Soluciones: -- **Opción A**: Usar `AppleCpuPmCfgLock` y `AppleXcpmCfgLock` en config.plist -- **Opción B**: Modificar BIOS con UEFI tool (avanzado) -- **Opción C**: Usar un EFI que ya tenga los patches de CFG Lock - ---- - -### 3. Configurar VT-d (Intel VT-d) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology for Directed I/O (VT-d) | **DISABLE** | - -**¿Por qué?** VT-d puede causar problemas con los gráficos y dispositivos. Deshabilitarlo simplifica la instalación. - -**Alternativa**: Si necesitas VT-d para virtualización, habilitar `IoMapper` en `config.plist → Kernel → Quirks → DisableIoMapper = YES` - ---- - -### 4. Habilitar VT-x - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology (VT-x) | **ENABLE** | - -**¿Por qué?** Necesario para algunas características de macOS y para que funcione correctamente la emulación. - ---- - -### 5. Above 4G Decoding - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Above 4G Decoding | **ENABLE** | - -**¿Por qué?** Necesario para que la GPU AMD RX 6800 XT tenga acceso a toda la memoria. - -**¿No aparece la opción?** Agregar `npci=0x2000` a boot-args en config.plist - ---- - -### 6. DVMT Pre-Allocated (Memoria de Video Integrada) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration → Graphics Configuration | DVMT Pre-Allocated | **64MB** | - -**¿Por qué?** macOS requiere mínimo 32MB, pero 64MB es recomendado para evitar problemas con la iGPU (aunque uses GPU dedicada). - -**Valores posibles**: 32MB, 64MB, 128MB (recomendado: 64MB o 128MB) - ---- - -### 7. Deshabilitar CSM (Compatibility Support Module) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → CSM (Compatibility Support Module) | CSM | **DISABLE** | - -**¿Por qué?** macOS solo arranca en modo UEFI puro. CSM habilita modo Legacy. - -**Nota**: Después de deshabilitar, asegúrate de que tu GPU tenga soporte UEFI (la RX 6800 XT sí lo tiene). - ---- - -### 8. Deshabilitar Secure Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → Secure Boot | OS Type | **Other OS** | - -**¿Por qué?** Secure Boot bloquea la carga de controladores no firmados como OpenCore. - ---- - -### 9. Configurar SATA Mode - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → PCH Storage Configuration → SATA Mode Selection | **AHCI** | | - -**¿Por qué?** macOS no soporta RAID ni IDE en la mayoría de casos. - ---- - -### 10. Deshabilitar Resizable BAR (SAM) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Resize BAR (or Smart Access Memory) | **DISABLE** | - -**¿Por qué?** Resizable BAR puede causar problemas de estabilidad en macOS. - ---- - -### 11. Optimizaciones de Energía (Opcional pero Recomendado) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Power Management | ErP Ready | **DISABLE** | -| Monitor → Digi+ VRM | Power Efficiency Mode | **Standard** | - ---- - -## 📋 Resumen de Configuraciones - -``` -┌─────────────────────────────────────────────────────────────┐ -│ ASUS ROG STRIX B760-I - BIOS CONFIGURATION SUMMARY │ -├─────────────────────────────────────────────────────────────┤ -│ Boot → Fast Boot: DISABLE │ -│ Boot → CSM: DISABLE │ -│ Boot → Secure Boot: Other OS │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → CPU → CFG Lock: DISABLE │ -│ Advanced → CPU → VT-d: DISABLE │ -│ Advanced → CPU → VT-x: ENABLE │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → Chipset → Above 4G: ENABLE │ -│ Advanced → Chipset → Resizable BAR: DISABLE │ -│ Advanced → Chipset → DVMT: 64MB │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → SATA Mode: AHCI │ -└─────────────────────────────────────────────────────────────┘ -``` - ---- - -## 🔍 Verificaciones Importantes - -### Después de Configurar - -1. **Guardar y Reiniciar**: Presiona `F10` para guardar y salir -2. **Re-entrar al BIOS** para verificar que todas las configuraciones se guardaron -3. **Tomar foto** de todas las páginas de configuración para referencia - -### Comprobar Opciones que no Aparecen - -Si alguna opción **NO aparece** en tu BIOS: - -1. **Actualizar BIOS** a la última versión -2. Buscar en "Advanced Mode" (F7) -3. Algunas opciones pueden estar en sub-menús diferentes - ---- - -## ⚠️ Problemas Comunes - -| Problema | Solución | -|----------|----------| -| CFG Lock no aparece | Usar config.plist con `AppleCpuPmCfgLock=YES` y `AppleXcpmCfgLock=YES` | -| Above 4G no aparece | Agregar boot-arg `npci=0x2000` | -| DVMT solo tiene "Auto" | Dejar en Auto y agregar `igfxfw=2` boot-arg si hay problemas | -| No puede deshabilitar CSM | Asegurarse de estar en UEFI mode first | - ---- - -## 🎯 Checklist Antes de Continuar - -- [ ] Fast Boot: DISABLE -- [ ] CFG Lock: DISABLE (o configurado en config.plist) -- [ ] VT-d: DISABLE -- [ ] VT-x: ENABLE -- [ ] Above 4G Decoding: ENABLE -- [ ] DVMT Pre-Allocated: 64MB -- [ ] CSM: DISABLE -- [ ] Secure Boot: Other OS -- [ ] SATA Mode: AHCI -- [ ] Resizable BAR: DISABLE - ---- - -**Siguiente paso: [02 - Crear USB Instalador](02-create-installer.md)** diff --git a/02-create-installer.md b/02-create-installer.md deleted file mode 100755 index d265963..0000000 --- a/02-create-installer.md +++ /dev/null @@ -1,397 +0,0 @@ -# 02 - Crear USB Instalador macOS - -## 📋 Requisitos Previos - -### Hardware Necesario -- **USB Flash Drive** - Mínimo 16GB (recomendado 32GB) -- **Acceso a una Mac** o máquina virtual con macOS - -### Software Necesario -- **macOS Sequoia 15.x** (o última versión disponible) -- **OClter** o **createinstallmedia** (incluido con macOS) - ---- - -## 🍿 Paso 1: Obtener macOS - -### Opción A: Desde App Store (Mac Real) - -```bash -# Buscar "macOS Sequoia" en App Store -# Descargar automáticamente (15GB+) -``` - -### Opción B: Desde MacInTouch / Archivos - -Descargar el instalador desde: -- App Store → Buscar "macOS Sequoia" -- Guardará en `/Applications/Install macOS Sequoia.app` - -### Versión Recomendada -| Versión | Estado | Notas | -|---------|--------|-------| -| macOS Sequoia 15.x | ✅ Recomendado | Última versión estable | -| macOS Sonoma 14.x | ✅ Compatible | Más probado | -| macOS Ventura 13.x | ✅ Compatible | Más estable | - ---- - -## 💾 Paso 2: Preparar USB - -### Formatear USB en macOS - -1. **Conectar USB** a la Mac -2. Abrir **Disk Utility** (Utilidad de Discos) -3. Seleccionar el USB (no el volumen) - -``` -Nombre: MyVolume -Formato: Mac OS Extended (Journaled) -Esquema: GUID Partition Map -``` - -4. Click en **Erase** (Borrar) - ---- - -## 🔧 Paso 3: Crear Instalador con Terminal - -### Método createinstallmedia (Oficial) - -Abrir **Terminal** y ejecutar: - -```bash -# Para macOS Sequoia -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction - -# Para macOS Sonoma -sudo /Applications/Install\ macOS\ Sonoma.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction -``` - -**Tiempo estimado**: 30-45 minutos - -**Salida esperada**: -``` -Install media now available -Volume name: MyVolume -... -Ready to start. -To continue, press Y and Return. -``` - -### Usando OClter (Alternativa) - -```bash -# Descargar OClter -curl -O https://github.com/chris1111/OClter/releases/download/v1.x/OClter.tool - -# Dar permisos -chmod +x OClter.tool - -# Ejecutar -sudo ./OClter.tool -``` - ---- - -## 📱 Paso 4: Verificar USB - -### Comprobar que el USB tenga la estructura correcta - -```bash -ls -la /Volumes/MyVolume -``` - -**Debería contener**: -``` -MyVolume/ -├── System/ -├── .IAProductInfo -├── .IAPhysicalMedia -├── BaseSystem.dmg -├── BaseSystem.chunklist -└── ... -``` - ---- - -## 🖥️ Paso 5: Agregar OpenCore al USB - -### Descargar OpenCore - -Ir a: [Acidanthera/OpenCorePkg Releases](https://github.com/acidanthera/OpenCorePkg/releases) - -Descargar la última versión **stable** (ej: OpenCore-0.9.7-RELEASE.zip) - -### Estructura de Carpetas - -En el USB, crear la estructura EFI: - -```bash -# Montar EFI del USB (si no está visible) -sudo diskutil mount diskXs1 - -# Crear estructura -mkdir -p /Volumes/EFI/OC/{ACPI,Kexts,Drivers,Tools} -``` - -### Copiar Archivos de OpenCore - -Desde el ZIP descargado, copiar a `EFI/OC/`: - -| Archivo | Destino | -|---------|---------| -| `OpenCore.efi` | `EFI/OC/` | -| `BOOTx64.efi` | `EFI/BOOT/` (renombrar a BOOTx64.efi) | -| `Drivers/` | `EFI/OC/Drivers/` | - -**Drivers necesarios**: -``` -EFI/OC/Drivers/ -├── OpenRuntime.efi (REQUIRED) -├── OpenCanopy.efi (Opcional - para resolución de problemas) -└── HfsPlus.efi (Opcional - si quieres leer HFS+) -``` - ---- - -## 📦 Paso 6: Descargar Kexts Esenciales - -### Lista de Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt (Base) -├── VirtualSMC.kxt (Emulación SMC) -├── WhateverGreen.kxt (GPU) -├── AppleIGC.kxt (Ethernet I226-V) -├── AirportItlwm.kxt (Wi-Fi Intel) -├── IntelBluetoothFirmware.kxt (Bluetooth) -├── IntelBTPatcher.kxt (Parche BT) -├── AppleALC.kxt (Audio) -├── VoodooPS2Controller.kxt (Teclado/PS2) -├── FeatureUnlock.kxt (Features) -├── SMCProcessor.kxt (VirtualSMC plugin) -├── SMCSuperIO.kxt (VirtualSMC plugin) -└── Lilu.kxt (Base - repetido) -``` - -### Links de Descarga - -Ver **[downloads.md](downloads.md)** para links directos a GitHub. - -### Colocar los Kexts - -```bash -# Copiar todos los kexts descargados a: -EFI/OC/Kexts/ - -# Asegurarse de que cada kext sea una carpeta con el .kext dentro -``` - ---- - -## ⚙️ Paso 7: Crear config.plist - -### Usar OCAuxiliaryTools (Recomendado) - -1. Descargar **OCAuxiliaryTools** desde [GitHub](https://github.com/ic005k/OCAuxiliaryTools) -2. Abrir `config.plist` que viene con OpenCore -3. Editar según tu hardware - -### Configuración Mínima para este Hardware - -#### ACPI -``` -Add: [] -Delete: [] -Patch: [] -Quirks: - - FadtEnableReset: YES - - NormalizeHeaders: YES - - RebaseRegions: YES - - ResetHwSig: YES - - ResetLogoStatus: YES -``` - -#### Booter -``` -Quirks: - - AvoidRuntimeDefrag: YES - - DevirtualiseMmio: NO - - DisableSingleUser: NO - - DisableVariableWrite: NO - - DiscardHibernateMap: NO - - EnableSafeModeSlide: NO - - EnableWriteUnprotector: YES - - ForceBooterSignature: NO - - ForceExitBootServices: NO - - ProtectMemoryRegions: NO - - ProtectSecureBoot: NO - - ProtectUefiServices: NO - - ProvideCustomSlide: YES - - ProvideMaxSlide: 0 - - ResizeAppleGpuBars: -1 - - RevirtualiseMmio: NO - - SetupVirtualMap: YES - - SignalAppleOS: NO - - SyncRuntimePermissions: YES -``` - -#### DeviceProperties -``` -Add: {} -Delete: {} -``` - -#### Kernel -``` -Emulate: NO -Force: [] -Kexts: - - BundlePath: Lilu.kext - Enabled: YES - ExecutablePath: Contents/MacOS/Lilu - MaxKernel: "" - MinKernel: "" - PlistPath: Contents/Info.plist - - - BundlePath: VirtualSMC.kext - Enabled: YES - ... - - # Repetir para todos los kexts -``` - -#### Misc -``` -Boot: - - HideAuxiliary: NO - - LauncherOption: Full - - LauncherPath: Default - - PickerAttributes: 0 - - PickerAudioAssist: NO - - PickerMode: Builtin - - PickerVariant: Default - - PollAppleHotKeys: NO - - ShowPicker: YES - - TakeoffDelay: 0 - - Timeout: 5 - -Debug: - - AppleDebug: NO - - ApplePanic: NO - - DisableWatchDog: NO - - DisplayDelay: 0 - - DisplayLevel: 2147483650 - - LogModules: "*" - - SerialInit: NO - - SysReport: NO - - Target: 3 - -Entries: [] -Tools: [] -``` - -#### PlatformInfo (SMBIOS) -``` -Generic: - - AdviseFeatures: NO - - MaxBIOSVersion: NO - - ProcessorType: 0 - - SpoofVendor: NO - - SystemMemoryStatus: Auto - - SystemProductName: iMacPro1,1 - - SystemSerialNumber: ... - - SystemUUID: ... - - MLB: ... - - ROM: ... - - FirmwareFeatures: ... - - FirmwareFeaturesMask: ... - -Update: Auto -UpdateSMBIOSMode: Create -``` - -**SMBIOS Recomendado**: -- `iMacPro1,1` - Para i7-13700K (16 cores,推荐) -- `MacPro7,1` - Alternativa - -Generar valores únicos con **GenSMBIOS**: -```bash -python3 gensmbios.py -``` - -#### UEFI -``` -Drivers: - - Path: OpenRuntime.efi - -Quirks: - - IgnoreInvalidFlexRatio: NO - - ReleaseUsbOwnership: NO - - RequestBootVarRouting: YES - - TscSyncTimeout: 0 - - UnblockFsConnect: NO -``` - ---- - -## 🎯 Paso 8: Configuración Específica para i7-13700K - -### Kernel → Emulate -``` -Cpuid1Data: -Cpuid1Mask: -DummyPowerManagement: NO # IMPORTANTE para Raptor Lake -``` - -Para Raptor Lake (13th gen), usar estos patches: - -```xml -Emulate - - Cpuid1Data - - NxcB/V/QwMA= - - Cpuid1Mask - - //// - - -``` - ---- - -## 📋 Checklist USB Completado - -- [ ] USB formateado (HFS+, GUID) -- [ ] Instalador macOS creado -- [ ] OpenCore copiado -- [ ] Kexts descargados y copiados -- [ ] config.plist configurado -- [ ] SMBIOS generado -- [ ] Verificar que EFI/OC/ tenga todos los archivos - ---- - -## 🧪 Paso 9: Probar el USB - -1. **Conectar USB** al PC Hackintosh -2. **Arrancar** y presionar `F8` para Boot Menu -3. **Seleccionar "UEFI: MyVolume"** -4. Debería ver el **OpenCore Picker** - -### Si no arranca: -- Verificar configuración BIOS -- Verificar estructura EFI -- Rehacer USB si es necesario - ---- - -**Siguiente paso: [03 - Configurar EFI](03-efi-config.md)** diff --git a/03-efi-config.md b/03-efi-config.md deleted file mode 100755 index 128562b..0000000 --- a/03-efi-config.md +++ /dev/null @@ -1,893 +0,0 @@ -# 03 - Configuración EFI Detallada - -## 📋 Archivos de Configuración EFI - -### Estructura Completa EFI/OC/ - -``` -EFI/ -├── BOOT/ -│ └── BOOTx64.efi -└── OC/ - ├── ACPI/ - │ ├── SSDT-EC.aml (Fake EC) - │ ├── SSDT-PLUG.aml (Power Management) - │ ├── SSDT-AWAC.aml (Clock fix B760) - │ └── SSDT-PMC.aml (Opcional) - ├── Kexts/ - │ ├── Lilu.kext - │ ├── VirtualSMC.kext - │ ├── WhateverGreen.kext - │ ├── AppleALC.kext - │ ├── AppleIGC.kext - │ ├── AirportItlwm.kext - │ ├── IntelBluetoothFirmware.kext - │ ├── IntelBTPatcher.kext - │ ├── FeatureUnlock.kext - │ ├── VoodooPS2Controller.kext - │ ├── SMCProcessor.kext - │ ├── SMCSuperIO.kext - │ └── NVMeFix.kext - ├── Drivers/ - │ ├── OpenRuntime.efi - │ └── OpenCanopy.efi - ├── Tools/ - │ └── Haciend.efi (opcional) - ├── config.plist - └── . -``` - ---- - -## 📝 Configuración config.plist Completa - -### ACPI Section - -```xml -ACPI - - Add - - - Comment - Fake EC - Enabled - - Path - SSDT-EC.aml - - - Comment - PluginType - Enabled - - Path - SSDT-PLUG.aml - - - Comment - AWAC Fix - Enabled - - Path - SSDT-AWAC.aml - - - Delete - - Patch - - Quirks - - FadtEnableReset - - NormalizeHeaders - - RebaseRegions - - ResetHwSig - - ResetLogoStatus - - - -``` - ---- - -### Booter Section - -```xml -Booter - - MmapWhitelist - - Patch - - Quirks - - AvoidRuntimeDefrag - - DevirtualiseMmio - - DisableSingleUser - - DisableVariableWrite - - DiscardHibernateMap - - EnableSafeModeSlide - - EnableWriteUnprotector - - ForceBooterSignature - - ForceExitBootServices - - ProtectMemoryRegions - - ProtectSecureBoot - - ProtectUefiServices - - ProvideCustomSlide - - ProvideMaxSlide - 0 - ResizeAppleGpuBars - -1 - RevirtualiseMmio - - SetupVirtualMap - - SignalAppleOS - - SyncRuntimePermissions - - - -``` - ---- - -### DeviceProperties Section - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - PciRoot(0x0)/Pci(0x2,0x0) - - enable-backlight-registers-fix - AQAAAA== - enable-backlight-smoother - AQAAAA== - framebuffer-patch-enable - AQAAAA== - framebuffer-cursormem - AACQAA== - radpng - AQAAAA== - - - Delete - - -``` - -**Layout IDs Comunes para Audio Realtek**: -| Layout ID | Uso | -|-----------|-----| -| 1 | Stereo Output | -| 3 | Speaker + Line Out | -| 5 | Common for desktop | -| 7 | Common for Realtek | -| 11 | Realtek ALC897 | -| 13 | Realtek ALC1220 | -| 28 | Common alternative | -| 99 | Built-in Speaker + Headphone | - ---- - -### Kernel Section - -```xml -Kernel - - Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - - Force - - Kexts - - - - BundlePath - Lilu.kext - Comment - Patch engine - Enabled - - ExecutablePath - Contents/MacOS/Lilu - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VirtualSMC.kext - Comment - SMC emulator - Enabled - - ExecutablePath - Contents/MacOS/VirtualSMC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - WhateverGreen.kext - Comment - AMD GPU patches - Enabled - - ExecutablePath - Contents/MacOS/WhateverGreen - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleALC.kext - Comment - Realtek Audio - Enabled - - ExecutablePath - Contents/MacOS/AppleALC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleIGC.kext - Comment - Intel 2.5GbE - Enabled - - ExecutablePath - Contents/MacOS/AppleIGC - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - AirportItlwm.kext - Comment - Intel Wi-Fi - Enabled - - ExecutablePath - Contents/MacOS/AirportItlwm - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBluetoothFirmware.kext - Comment - Intel Bluetooth - Enabled - - ExecutablePath - Contents/MacOS/IntelBluetoothFirmware - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBTPatcher.kext - Comment - Intel Bluetooth Patcher - Enabled - - ExecutablePath - Contents/MacOS/IntelBTPatcher - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - FeatureUnlock.kext - Comment - Unlock macOS features - Enabled - - ExecutablePath - Contents/MacOS/FeatureUnlock - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VoodooPS2Controller.kext - Comment - PS2 Keyboard/Mouse - Enabled - - ExecutablePath - Contents/MacOS/VoodooPS2Controller - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCProcessor.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCProcessor - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCSuperIO.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCSuperIO - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - Patch - - Quirks - - AppleCpuPmCfgLock - - AppleXcpmCfgLock - - AppleXcpmExtraMsrs - - AppleXcpmForceBoost - - CustomSMBIOSGuid - - DisableIoMapper - - DisableLinkeditJettison - - DisableRtcChecksum - - ExtendBTFeatureFlags - - ExternalDiskIcons - - ForceSecureBootScheme - - IncreasePciBarSize - - LapicKernelPanic - - LegacyCommpage - - PanicNoKextDump - - PowerTimeoutKernelPanic - - ProvideCurrentCpuInfo - - SetApfsTrimTimeout - -1 - ThirdPartyDrives - - XhciPortLimit - - - Scheme - - FuzzyMatch - - KernelArch - x86_64 - KernelCache - Auto - - -``` - ---- - -### Misc Section - -```xml -Misc - - BlessOverride - - Boot - - ConsoleAttributes - 0 - HibernateMode - None - HibernateSkipsPicker - - HideAuxiliary - - LauncherOption - Full - LauncherPath - Default - PickerAttributes - 0 - PickerAudioAssist - - PickerMode - Builtin - PickerVariant - Default - PollAppleHotKeys - - ShowPicker - - TakeoffDelay - 0 - Timeout - 5 - - Debug - - AppleDebug - - ApplePanic - - DisableWatchDog - - DisplayDelay - 0 - DisplayLevel - 2147483650 - LogModules - * - SerialInit - - SysReport - - Target - 3 - - Entries - - Security - - - - AllowSetDefault - - ApECID - 0 - AuthRestart - - BlacklistAppleUpdate - - DmgLoading - Signed - EnablePassword - - ExposeSensitiveData - 6 - HaltLevel - 2147483648 - PasswordHash - - PasswordSalt - - ScanPolicy - 0 - SecureBootModel - Disabled - Vault - Optional - - Serial - - Init - - Override - - Swap - - - Tools - - -``` - ---- - -### PlatformInfo (SMBIOS) - -```xml -PlatformInfo - - Automatic - - CustomMemory - - Generic - - AdviseFeatures - - MaxBIOSVersion - - ProcessorType - 0 - SpoofVendor - - SystemMemoryStatus - Auto - SystemProductName - iMacPro1,1 - SystemSerialNumber - GENERATED_WITH_GENSMBIOS - SystemUUID - GENERATED_WITH_GENSMBIOS - MLB - GENERATED_WITH_GENSMBIOS - ROM - GENERATED_WITH_GENSMBIOS - - UpdateDataHub - - UpdateNVRAM - - UpdateSMBIOS - - UpdateSMBIOSMode - Create - -``` - -**Generar SMBIOS válido**: -```bash -# Usar GenSMBIOS -python3 gensmbios.py - -# O usar -./gensmbios -``` - ---- - -### UEFI Section - -```xml -UEFI - - APFS - - EnableJumpstart - - GlobalConnect - - HideVerbose - - JumpstartHotPlug - - MinDate - 0 - MinVersion - 0 - - Audio - - AudioCodec - 0 - AudioDevice - PciRoot(0x0)/Pci(0x1F,0x3) - AudioOut - 0 - AudioSupport - - MinimumVolume - 20 - PlayChime - Auto - ResetTrafficClass - - SetupDelay - 0 - VolumeAmplifier - 0 - - ConnectDrivers - - Drivers - - - Arguments - agdpmod=pikera - Comment - - Enabled - - LoadEarly - - Path - OpenRuntime.efi - - - Input - - KeyFiltering - - KeyForgetThreshold - 5 - KeyMergeThreshold - 2 - KeySupport - - KeySupportMode - Auto - KeySwap - - PointerSupport - - PointerSupportMode - - TimerResolution - 50000 - - Output - - ClearScreenOnModeSwitch - - ConsoleMode - - DirectGopRendering - - ForceResolution - - GopBurstMode - - GopPassThrough - Disabled - IgnoreTextInGraphics - - InitialMode - 3 - ReconnectGraphicsOnResChange - - ReplaceTabWithSpace - - Resolution - Max - SanitiseClearScreen - - TextRenderer - BuiltinGraphics - UgaPassThrough - - - ProtocolOverrides - - AppleAudio - - AppleBootPolicy - - AppleDebugLog - - AppleEg2Info - - AppleFramebufferInfo - - AppleImg4Verification - - AppleKeyMap - - AppleRtcRam - - AppleSecureBoot - - AppleSmcIo - - AppleUserInterfaceTheme - - DataHub - - DeviceProperties - - FirmwareVolume - - HashServices - - OSInfo - - PciIo - - UnicodeCollation - - - Quirks - - ActivateHpetSupport - - DisableSecurityPolicy - - EnableVectorAcceleration - - ExitBootServicesDelay - 0 - ForceOcWriteFlash - - ForgeUefiSupport - - IgnoreInvalidFlexRatio - - ReleaseUsbOwnership - - ReloadOptionRoms - - RequestBootVarRouting - - ResizeGpuBars - -1 - TscSyncTimeout - 0 - UnblockFsConnect - - - ReservedMemory - - -``` - ---- - -## 🔍 Verificar config.plist - -### Usar ProperTree u OCAuxiliaryTools - -```bash -# Validar config.plist -plutil -lint config.plist -``` - -**Salida esperada**: -``` -config.plist: OK -``` - ---- - -## 📝 Archivos SSDT Necesarios - -### SSDT-EC.aml (Fake EC) - -Necesario porque macOS espera un Embedded Controller. - -### SSDT-PLUG.aml (Plugin Type) - -Necesario para power management correcto del CPU. - -### SSDT-AWAC.aml (RTC Fix) - -**CRÍTICO PARA B760**: Corrige el reloj del sistema. Sin esto, macOS no arrancará. - -### Generar SSDTs - -```bash -# Usar SSDTTime -./SSDTTime.sh - -# O usar GenPMC -./gen-pmc.sh -``` - ---- - -## 📋 Checklist EFI Completo - -- [ ] EFI/BOOT/BOOTx64.efi presente -- [ ] EFI/OC/OpenCore.efi presente -- [ ] EFI/OC/Drivers/OpenRuntime.efi presente -- [ ] EFI/OC/Kexts/ tiene todos los kexts (incluyendo NVMeFix) -- [ ] EFI/OC/ACPI/ tiene SSDT-EC.aml, SSDT-PLUG.aml y SSDT-AWAC.aml -- [ ] config.plist validado con plutil -- [ ] SMBIOS generado con GenSMBIOS -- [ ] Cpuid1Data configurado para Raptor Lake - ---- - -**Siguiente paso: [04 - Instalación](04-installation.md)** diff --git a/04-installation.md b/04-installation.md deleted file mode 100755 index e78d3e7..0000000 --- a/04-installation.md +++ /dev/null @@ -1,419 +0,0 @@ -# 04 - Proceso de Instalación de macOS - -## 🎯 Objetivo - -Instalar macOS Sequoia (o versión elegida) en tu PC con hardware Hackintosh. - ---- - -## 📋 Pre-Instalación - Checklist - -### Antes de Arrancar el USB - -- [ ] **BIOS configurado** según [01-bios-settings.md](01-bios-settings.md) -- [ ] **USB instalador creado** con EFI OpenCore -- [ ] **Verificado SSDT-AWAC.aml** en EFI/OC/ACPI (CRÍTICO) -- [ ] **Verificado boot-arg `agdpmod=pikera`** en config.plist -- [ ] **Disco destino** preparado (mínimo 80GB recomendado) -- [ ] **Conexión a Internet** (Ethernet preferiblemente) -- [ ] **Teclado USB** conectado -- [ ] **Monitor** conectado a la GPU AMD RX 6800 XT - -### Particionamiento del Disco - -**Opción A: Usar todo el disco** (Recomendado para instalación limpia) - -**Opción B: Dual Boot con Windows** - -1. En Windows, abrir **Disk Management** -2. **Shrink** una partición (mínimo 100GB) -3. Dejar el espacio **sin asignar** (no formatear) - ---- - -## 🚀 Paso 1: Arrancar desde el USB - -### 1.1 Conectar USB y Arrancar - -1. **Conectar el USB instalador** -2. **Encender el PC** -3. Presionar **F8** repetidamente para **Boot Menu** - -### 1.2 Seleccionar el USB - -En el Boot Menu ASUS: -``` -Boot Option #1: UEFI: -``` - -Seleccionar con Enter. - ---- - -## 📱 Paso 2: OpenCore Picker - -Deberías ver el **OpenCore Boot Picker**: - -``` -OpenCore 0.9.7 - -macOS Installer -Recovery -``` - -### Si NO ves el OpenCore Picker: - -1. Verificar que EFI/OC/ está en el USB -2. Verificar config.plist -3. Verificar configuración BIOS -4. Consultar sección de **Solución de Problemas** abajo - -### Seleccionar "macOS Installer" - -Con las flechas, seleccionar **"macOS Installer"** y presionar **Enter**. - ---- - -## ⏳ Paso 3: Carga de macOS - -### 3.1 Apple Logo - -Verás el logo de Apple con una barra de progreso. - -**Tiempo**: 2-5 minutos - -### 3.2 Si se reinicia automáticamente - -Esto es **NORMAL**. OpenCore recargará el instalador. - -``` -Primera carga: Puede reiniciar 1-2 veces -``` - ---- - -## 🖥️ Paso 4: Pantalla de Instalación - -### 4.1 Selección de Idioma - -``` -Choose your language: Español (o preferencia) -Click en la flecha -``` - -### 4.2 Utilidades de macOS - -Deberías ver **"macOS Utilities"**: - -``` -- Restore from Time Machine Backup -- Reinstall macOS -- Get Help Online -- Disk Utility -``` - ---- - -## 💽 Paso 5: Disk Utility (Formatear Disco) - -### 5.1 Abrir Disk Utility - -Click en **"Disk Utility"** → **Continue** - -### 5.2 Seleccionar el Disco Destino - -En la columna izquierda, seleccionar el disco donde instalarás macOS. - -**⚠️ IMPORTANTE**: Seleccionar el disco **completo**, no una partición. - -### 5.3 Borrar y Formatear - -1. Click en el botón **"Erase"** (Borrar) -2. Configurar: - -| Campo | Valor | -|-------|-------| -| **Name** | Macintosh HD | -| **Format** | APFS | -| **Scheme** | GUID Partition Map | - -3. Click en **"Erase"** - -### 5.4 Verificar - -Deberías ver: - -``` -Macintosh HD - - Macintosh HD - Data - - Preboot - - Recovery -``` - -### 5.5 Cerrar Disk Utility - -Click en **"Done"** → **"Disk Utility"** → **Quit Disk Utility** - ---- - -## 📦 Paso 6: Instalar macOS - -### 6.1 Elegir "Reinstall macOS" - -De vuelta en macOS Utilities: -``` -Click en: Reinstall macOS Sequoia -Click en: Continue -``` - -### 6.2 Aceptar Términos - -Click en **"Agree"** → **"Agree"** nuevamente - -### 6.3 Seleccionar Disco - -``` -Select the disk where you want to install macOS: -Macintosh HD -``` - -Click en **"Install"** - -### 6.4 Iniciar Instalación - -macOS comenzará a copiar archivos: - -``` -Preparing installation... -Installing macOS... -Time remaining: ~20-30 minutos -``` - -### 6.5 Primer Reinicio - -Durante la instalación, el sistema se reiniciará **automáticamente**. - -**IMPORTANTE**: Al arrancar después del reinicio: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** otra vez -3. **NO seleccionar** el disco duro todavía - ---- - -## 🔄 Paso 7: Continuación de la Instalación - -### 7.1 Segunda Carga - -El sistema continuará la instalación: - -``` -Installing: 5 minutes remaining... -Configuración... -``` - -### 7.2 Segundo Reinicio - -Se reiniciará nuevamente. - -**Esta vez**: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** -3. En OpenCore Picker, seleccionar **"Macintosh HD"** (no el installer) - ---- - -## 🎉 Paso 8: Primer Arranque - Configuración - -### 8.1 Asistente de Configuración - -Verás la pantalla **"Hello"** con diversos idiomas. - -``` -Continúa con la configuración inicial: -1. País o región: Argentina (o tu país) -2. Teclado: Spanish - ISO o ANSI -3. Red: Seleccionar Ethernet (AppleIGC debería funcionar) -4. Transferir información: Not now -5. Apple ID: Puedes saltar este paso inicialmente -``` - -### 8.2 Crear Cuenta - -``` -Nombre: [Tu nombre] -Nombre de cuenta: [tu_usuario] -Contraseña: [tu_contraseña] -``` - -### 8.3 Express Setup - -``` -Location Services: Enable (o Disable si prefieres) -Siri: Enable o Disable -Screen Time: Set up later -``` - -### 8.4 Finalizar - -El sistema preparará tu escritorio... - ---- - -## 🔧 Paso 9: Post-Instalación Inmediata - -### 9.1 Verificar Hardware Funcional - -Abrir **Acerca de este Mac**: - -``` -Apple menu () → Acerca de este Mac -``` - -**Verificar**: -- [ ] CPU: Correcta -- [ ] Memoria: 32GB mostrados -- [ ] Gráficos: AMD RX 6800 XT -- [ ] Serie/UUID: Correctos (SMBIOS) - -### 9.2 Verificar Red - -``` -Ajustes del Sistema → Red -``` - -**Ethernet**: Debería mostrar "Conectado" -**Wi-Fi**: Puede no funcionar todavía (requiere AirportItlwm) - -### 9.3 Verificar Audio - -Reproducir un sonido desde Preferencias del Sistema → Sonido - ---- - -## 🐛 Solución de Problemas - -### Problema: Kernel Panic (Pantalla con texto vertical) - -**Causas comunes**: -- CFG Lock no deshabilitado -- config.plist incorrecto -- Kexts faltantes - -**Soluciones**: - -1. **Agregar boot-args de depuración**: - -En config.plist → Boot → NVRAM → Add → boot-args: -``` --v keepsyms=1 -``` - -2. **Verificar CFG Lock**: -``` -config.plist → Kernel → Quirks: - AppleCpuPmCfgLock: YES - AppleXcpmCfgLock: YES -``` - -3. **Verificar Kexts**: -``` -Asegurarse de tener: -- Lilu.kext -- VirtualSMC.kext -- WhateverGreen.kext -``` - -### Problema: Pantalla negra después de Apple logo - -**Soluciones**: - -1. **Verificar WhateverGreen.kext** -2. **Agregar boot-arg**: -``` --v agdpmod=pikera -``` - -3. **Verificar GPU en DeviceProperties**: -``` -config.plist → DeviceProperties → Add -PciRoot(0x0)/Pci(0x2,0x0) -``` - -### Problema: Se reinicia constantemente - -**Soluciones**: - -1. **Deshabilitar XMP** en BIOS temporalmente -2. **Verificar Cpuid1Data** para Raptor Lake -3. **Probar con SMBIOS diferente** (MacPro7,1) - -### Problema: No detecta red Ethernet - -**Soluciones**: - -1. **Verificar AppleIGC.kext** está en EFI/OC/Kexts/ -2. **Verificar config.plist** → Kernel → Kexts → AppleIGC.kext está enabled -3. **Verificar BIOS** → Network Stack está habilitado - -### Problema: No funciona Wi-Fi - -**Soluciones**: - -1. **Verificar AirportItlwm.kext** está presente -2. **Verificar versión compatible** con tu macOS -3. **Alternativa**: Usar itlwm.kext + app Helios - -### Problema: No funciona Audio - -**Soluciones**: - -1. **Verificar AppleALC.kext** está presente -2. **Probar diferentes layout-id**: - - 1, 3, 5, 7, 11, 13, 28, 99 -3. **Usar Hackintool** para detectar layout correcto - ---- - -## 📋 Checklist Instalación Completada - -- [ ] macOS instalado en el disco -- [ ] Primer arranque completado -- [ ] Cuenta de usuario creada -- [ ] Ethernet funcionando -- [ ] Gráficos AMD RX 6800 XT detectados -- [ ] Audio funcionando (o configurado) -- [ ] SMBIOS correcto en "Acerca de este Mac" - ---- - -## 🎯 Próximos Pasos - -### Instalar EFI en el Disco (Obligatorio) - -Actualmente estás arrancando desde el USB. Necesitas copiar el EFI al disco. - -1. **Arrancar desde USB** -2. **Montar EFI del disco**: -```bash -# En Terminal -diskutil list -# Identificar tu disco (ej: disk1) -sudo diskutil mount disk1s1 -``` - -3. **Copiar EFI**: -```bash -# Desde el USB EFI al disco EFI -sudo cp -R /Volumes/EFI/OC /Volumes/DESTINO_EFI/OC/ -``` - -4. **Verificar**: -```bash -ls /Volumes/DESTINO_EFI/OC/ -``` - -5. **Reiniciar y arrancar desde el disco** (sin USB) - ---- - -**Siguiente paso: [05 - Post-Instalación](05-post-install.md)** diff --git a/04-usb-mapping-windows.md b/04-usb-mapping-windows.md deleted file mode 100644 index c5ab049..0000000 --- a/04-usb-mapping-windows.md +++ /dev/null @@ -1,68 +0,0 @@ -# Guía de Mapeo USB desde Windows (USBToolBox) - -Esta guía detalla el procedimiento para crear un mapa de puertos USB personalizado (`UTBMap.kext`) desde Windows, solucionando el error de "Waiting for Root Device" (🚫) en macOS Ventura/Sonoma. - -## 1. Contexto del Problema -macOS tiene un límite estricto de **15 puertos USB por controlador**. Las placas base modernas (como ASUS B760) exceden este límite porque cada puerto físico USB 3.0 cuenta como dos puertos lógicos (uno HSxx para 2.0 y uno SSxx para 3.0), más los puertos internos (Bluetooth, RGB, etc.). - -Sin un mapa, macOS intenta enumerar los primeros 15 puertos que encuentra. Si tu pendrive de instalación está en el puerto lógico #16 o superior, macOS no lo verá y fallará el arranque. - -## 2. Prerrequisitos (En Windows) -1. **Windows 10/11** instalado en el mismo hardware. -2. **USBToolBox (Windows.exe)**: Descargar la última versión desde [Github Release](https://github.com/USBToolBox/tool/releases). -3. Un **pendrive USB 3.0** y un dispositivo **USB 2.0** (o un pendrive 2.0) para probar ambos protocolos en cada puerto. - -## 3. Procedimiento de Mapeo (Paso a Paso) - -### Paso 3.1: Descubrimiento de Puertos -1. Ejecuta `Windows.exe` como Administrador. -2. Presiona **`D`** (Discover Ports) y Enter. -3. Se abrirá una lista de puertos (HSxx, SSxx). -4. **Conecta un dispositivo USB** en CADA puerto físico de tu PC. - * **Importante**: En los puertos USB 3.0 (Azules/Rojos/Tipo-C), conecta PRIMERO un dispositivo USB 2.0 y LUEGO un dispositivo USB 3.0. - * Verás que las líneas correspondientes en la consola se iluminan en **VERDE** al detectar actividad. - * Asegúrate de identificar el puerto donde tienes conectado el teclado/mouse y el Bluetooth interno (si aparece). - -### Paso 3.2: Selección de Puertos -1. Una vez probados todos los puertos, presiona **`B`** (Back) para volver al menú principal. -2. Presiona **`S`** (Select Ports). -3. Verás la lista con los puertos "activos" resaltados en verde. -4. Escribe los números de índice de los puertos que quieres **MANTENER** (separados por comas, ej: `1,2,3,5,18,19`). - * **Regla de Oro**: Mantén el total de puertos seleccionados en **15 o menos**. - * Prioriza: El puerto donde instalarás macOS, puertos de teclado/mouse, Bluetooth interno. - * Descarta: Puertos internos que no uses (RGB headers, etc.) o puertos traseros que no necesites. - -### Paso 3.3: Generar Kext (`UTBMap.kext`) -1. Presiona Enter tras seleccionar. -2. Presiona **`K`** (Build Kext). -3. La herramienta creará una carpeta llamada `UTBMap.kext` (o un zip) en la misma ubicación del ejecutable. - -## 4. Integración en OpenCore (En macOS/Linux) - -Una vez tengas el `UTBMap.kext` generado: - -1. **Descargar Driver Base**: Necesitas el driver `USBToolBox.kext` (el motor). - * Descarga desde: [USBToolBox Kext Releases](https://github.com/USBToolBox/kext/releases). -2. **Copiar a EFI**: - * Copia `USBToolBox.kext` y `UTBMap.kext` a `/EFI/OC/Kexts/`. -3. **Configurar `config.plist`**: - * Abre tu `config.plist`. - * Ve a `Kernel -> Add`. - * Agrega `USBToolBox.kext` (debe ir **PRIMERO**). - * Agrega `UTBMap.kext` (debe ir **DESPUÉS** de USBToolBox). - * **BORRA** o deshabilita `USBInjectAll.kext` y `XHCI-unsupported.kext` si los tienes. Son incompatibles con este método. -4. **Ajustes de Quirks**: - * `Kernel -> Quirks -> XhciPortLimit`: **False** (Importante). - * `UEFI -> Quirks -> ReleaseUsbOwnership`: **True**. - -## 5. Resumen de Archivos Necesarios en `/EFI/OC/Kexts/` - -Al finalizar, tu carpeta Kexts debería tener (para USB): -* `USBToolBox.kext` -* `UTBMap.kext` -* *(Opcional)* `SSDT-RHUB.aml` en `/EFI/OC/ACPI/` (Recomendado para Asus B760). - -**¡Elimina `USBInjectAll.kext`!** - ---- -*Generado por Antigravity para reparación de Hackintosh Asus B760* diff --git a/05-post-install.md b/05-post-install.md deleted file mode 100755 index 7856cb5..0000000 --- a/05-post-install.md +++ /dev/null @@ -1,545 +0,0 @@ -# 05 - Post-Instalación y Optimización - -## 🎯 Objetivos - -1. Copiar EFI al disco duro -2. Configurar hardware restante (Wi-Fi, Bluetooth, Audio) -3. Optimizar power management -4. Verificar estabilidad del sistema - ---- - -## 💾 Paso 1: Copiar EFI al Disco Duro - -### 1.1 Identificar Volúmenes - -```bash -# Abrir Terminal y listar volúmenes -diskutil list - -# Identificar tu disco macOS (ej: disk1) -disk1s1 EFI -disk1s2 Macintosh HD -``` - -### 1.2 Montar EFI del Disco macOS - -```bash -# Montar la partición EFI -sudo diskutil mount disk1s1 -``` - -### 1.3 Copiar EFI - -```bash -# Copiar desde USB al disco -sudo cp -R /Volumes/EFI_USB/OC /Volumes/EFI_DISK/OC/ - -# Copiar BOOT -sudo cp -R /Volumes/EFI_USB/BOOT /Volumes/EFI_DISK/BOOT/ - -# Verificar -ls -la /Volumes/EFI_DISK/OC/ -``` - -### 1.4 Desmontar EFI - -```bash -sudo diskutil unmount /Volumes/EFI_DISK -``` - -### 1.5 Arrancar desde el Disco - -1. **Retirar USB** -2. **Reiniciar** -3. Presionar **F8** para Boot Menu -4. **Seleccionar** "macOS" o "Macintosh HD" - ---- - -## 🔊 Paso 2: Configurar Audio (AppleALC) - -### 2.1 Identificar Layout ID Correcto - -#### Método 1: Hackintool - -1. **Descargar Hackintool** desde [GitHub](https://github.com/headkaze/Hackintool) -2. Abrir **Hackintool** -3. Ir a **Audio** -4. **Select Audio Codec**: Realtek ALC897 (o tu codec) -5. **Probar Layout IDs**: - - Click en **"Select Audio Layout"** - - Elegir diferentes IDs - - **Test Audio** para cada uno - -#### Layout IDs Comunes para ASUS ROG B760 - -| Layout ID | Uso | -|-----------|-----| -| 1 | Salida estándar | -| 3 | Speaker + Line Out | -| 7 | Realtek genérico | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + Headphone | - -### 2.2 Configurar en config.plist - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - - -``` - -**Para cambiar Layout ID**: - -``` -Layout ID 1: AQAAAA== -Layout ID 3: AwAAAA== -Layout ID 7: BwAAAA== -Layout ID 11: CwAAAA== -Layout ID 13: DQAAAA== -Layout ID 28: GwAAAA== -Layout ID 99, bwAAAA== -``` - -### 2.3 Verificar Audio - -```bash -# En Terminal -kextstat | grep AppleALC - -# Debería mostrar proceso cargado -``` - ---- - -## 📡 Paso 3: Configurar Wi-Fi (Intel AX211) - -### 3.1 Opciones para Wi-Fi Intel - -**Opción A: AirportItlwm.kext** (Interfaz nativa macOS) - -**Opción B: itlwm.kext + Helios** (App separada) - -### 3.2 Configurar AirportItlwm - -1. **Verificar kext cargado**: -```bash -kextstat | grep itlwm -``` - -2. **Configurar** (si no funciona automáticamente): - -```xml - - - BundlePath - AirportItlwm.kext - Enabled - - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - -``` - -3. **Reiniciar** y verificar en **Ajustes del Sistema → Red** - -### 3.3 Alternativa: itlwm + Helios - -Si AirportItlwm no funciona: - -1. **Reemplazar** AirportItlwm.kext con **itlwm.kext** -2. **Descargar Helios app** desde [OpenIntelWireless](https://github.com/OpenIntelWireless/Helios) -3. **Abrir Helios** para conectarse a redes Wi-Fi - ---- - -## 🔵 Paso 4: Configurar Bluetooth (Intel AX211) - -### 4.1 Verificar Kexts de Bluetooth - -Asegurarse de tener estos 3 kexts en EFI/OC/Kexts/: - -``` -IntelBluetoothFirmware.kext -IntelBTPatcher.kext -BlueTool.kext (opcional, incluido en IntelBluetoothFirmware) -``` - -### 4.2 Configurar en config.plist - -```xml - - BundlePath - IntelBluetoothFirmware.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - - - - BundlePath - IntelBTPatcher.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - -``` - -### 4.3 Verificar - -```bash -# Verificar Bluetooth cargado -kextstat | grep Bluetooth - -# Abrir Bluetooth en Ajustes del Sistema -``` - ---- - -## ⚡ Paso 5: Power Management (CPU) - -### 5.1 Verificar Gestión de Energía - -Abrir **Acerca de este Mac** → **Reporte del Sistema** → **Energía** - -**Estado correcto**: -``` -Estado de alimentación: alimentado por CA -Batería: No hay batería -``` - -### 5.2 Generar SSDT-PM - -**Opción A: Usar SSDTTime** - -1. **Descargar SSDTTime** desde [GitHub](https://github.com/corpnewt/SSDTTime) -2. **Ejecutar**: `./SSDTTime.sh` -3. **Seleccionar**: "1" (Basic Mode) -4. **Seleccionar**: "1" (PM) -5. **Copiar** SSDT-PM.aml a EFI/OC/ACPI/ - -**Opción B: Usar GenPMC** - -```bash -./gen-pmc.sh -``` - -### 5.3 Habilitar XNU PM (Power Management) - -```xml - -Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - -``` - -### 5.4 Verificar Speed Step - -```bash -# En Terminal -sudo powermetrics --samplers cpu_power -i 1000 - -# Verificar que las frecuencias cambien -``` - ---- - -## 🌡️ Paso 6: Monitoreo de Temperaturas - -### 6.1 Instalar Stats (o similar) - -1. **Descargar Stats** desde [GitHub](https://github.com/exelban/stats) -2. **Configurar** para mostrar: - - Temperatura CPU - - Uso de CPU - - Velocidad de ventiladores - - Uso de RAM - -### 6.2 Verificar Temperaturas Normales - -| Componente | Rango Normal | -|------------|--------------| -| CPU (idle) | 30-45°C | -| CPU (load) | 60-85°C | -| GPU (idle) | 35-50°C | -| GPU (load) | 70-85°C | - ---- - -## 🖥️ Paso 7: Configurar GPU AMD RX 6800 XT - -### 7.1 Verificar Aceleración Gráfica - -```bash -# En Terminal -kextstat | grep AMD - -# Debería mostrar: -# com.apple.driver.AMDRadeonX6000 -# com.apple.driver.AMDRadeonX6000MTL -``` - -### 7.2 Verificar Metal - -```bash -# En Terminal -metalinfo - -# Debería mostrar: -# AMD Radeon RX 6800 XT -# Metal Support: YES -``` - -### 7.3 Habilitar Resizeable BAR (si lo deseas) - -**NOTA**: Generalmente **DISABLED** en BIOS para estabilidad. - -Si deseas habilitarlo: -1. Habilitar en BIOS: "Resize BAR" o "SAM" -2. Agregar a config.plist: -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x2,0x0) - - force-online - AQAAAA== - - - -``` - ---- - -## 🔧 Paso 8: Optimizaciones Adicionales - -### 8.1 Habilitar Hibernación (opcional) - -```bash -# En Terminal -sudo pmset hibernatemode 25 -sudo pmset standby 1 -sudo pmset standbydelay 10800 -sudo pmset autopoweroff 1 -``` - -### 8.2 Deshabilitar Hibernación (para ahorrar espacio) - -```bash -sudo pmset hibernatemode 0 -sudo rm -rf /var/vm/sleepimage -``` - -### 8.3 Configurar Sleep/Wake - -```bash -# Deshabilitar sleep al cerrar tap (laptops) -sudo pmset -a disablesleep 1 - -# Habilitar wake on LAN -sudo pmset -a womp 1 -``` - ---- - -## 🧪 Paso 9: Verificar Estabilidad - -### 9.1 Test de Estrés - -**Usar Geekbench 6**: -1. Descargar desde [geekbench.com](https://www.geekbench.com/) -2. Ejecutar **CPU Benchmark** -3. Ejecutar **Compute Benchmark** (OpenCL/Metal) - -**Puntuaciones esperadas** (i7-13700K): -``` -Single Core: ~2200-2600 -Multi Core: ~18000-22000 -OpenCL: ~200000-250000 (RX 6800 XT) -``` - -### 9.2 Test de Memoria - -```bash -# Memtest (opcional) -memtest /Volumes/Macintosh\ HD -``` - -### 9.3 Test de Red - -```bash -# Ping test -ping -c 100 google.com - -# Velocidad de descarga -curl -o /dev/null http://speedtest.tele2.net/100MB.zip -``` - ---- - -## 📱 Paso 10: Apps Recomendadas - -### Utilidades - -| App | Propósito | -|-----|-----------| -| **Stats** | Monitoreo de sistema | -| **Hackintool** | Configuración hardware | -| **ProperTree** | Editar config.plist | -| **OCAuxiliaryTools** | Editar config.plist | -| **KextsViewer** | Ver kexts cargados | -| **Haciend** | Consola OpenCore (en EFI) | -| **BetterDisplay** | Gestión de monitores | -| **MonitorControl** | Control de brillo DDC | - -### Apps de Producto - -| App | Propósito | -|-----|-----------| -| **Rectangle** | Gestión de ventanas | -| **AltTab** | Alt-Tab estilo Windows | -| **iStat Menus** | Monitoreo avanzado | -| **Carbon Copy Cloner** | Backups | -| **Time Machine** | Backups nativo | - ---- - -## 🔄 Paso 11: Actualizaciones de macOS - -### 11.1 Preparación para Actualizaciones - -**Antes de actualizar**: - -1. **Actualizar OpenCore** a última versión -2. **Actualizar Kexts** (Lilu, WhateverGreen, etc.) -3. **Hacer backup** con Time Machine -4. **Verificar compatibilidad** de la versión nueva - -### 11.2 Proceso de Actualización - -```bash -# 1. Actualizar desde App Store -# 2. El sistema se reiniciará -# 3. Arrancar desde EFI del disco (no USB) -# 4. La actualización continuará -``` - -### 11.3 Si la actualización falla - -1. **Arrancar en modo verbose**: - - En OpenCore Picker, presionar **Espacio** - - Seleccionar las opciones del volumen - - Agregar boot-arg: `-v` - -2. **Ver logs** para identificar el problema - -3. **Actualizar kexts** si es necesario - ---- - -## 📋 Checklist Post-Instalación Completado - -### Hardware - -- [ ] Audio funcionando (AppleALC con layout-id correcto) -- [ ] Wi-Fi funcionando (AirportItlwm o itlwm) -- [ ] Bluetooth funcionando (IntelBluetoothFirmware) -- [ ] Ethernet funcionando (AppleIGC) -- [ ] Gráficos AMD RX 6800 XT con aceleración -- [ ] Power Management configurado -- [ ] Temperaturas normales - -### Software - -- [ ] EFI copiado al disco -- [ ] Arranca sin USB -- [ ] Hackintool instalado -- [ ] Stats instalado -- [ ] Time Machine configurado (opcional) - -### Estabilidad - -- [ ] Geekbench ejecutado -- [ ] No hay kernel panics aleatorios -- [ ] Sleep/Wake funciona correctamente -- [ ] Todas las apps funcionan - ---- - -## 🎯 Mantenimiento - -### Mensual - -1. **Actualizar kexts** si hay nuevas versiones -2. **Actualizar OpenCore** si hay nueva versión -3. **Verificar temperatures** -4. **Hacer backup** con Time Machine - -### Trimestral - -1. **Actualizar macOS** a última versión menor -2. **Revisar config.plist** para optimizaciones -3. **Limpiar archivos temporales** - ---- - -## 🆘 Recursos Adicionales - -### Documentación - -- [Dortania OpenCore Post-Install Guide](https://dortania.github.io/OpenCore-Post-Install/) -- [Dortania Troubleshooting](https://dortania.github.io/Troubleshooting/) -- [r/hackintosh Subreddit](https://www.reddit.com/r/hackintosh/) - -### Comunidades - -- [TonyMacx86 Forums](https://www.tonymacx86.com/) -- [InsanelyMac Forums](https://www.insanelymac.com/) -- [Dortania Discord](https://discord.gg/AbTrsBq) - ---- - -## 🎉 ¡Felicitaciones! - -Tu Hackintosh está completamente configurado y listo para usar. - -**Acerca de este Mac** debería mostrar: - -``` -macOS Sequoia 15.x - procesador: 3,4 GHz Intel Core i7-13700K (16 cores) - Memoria: 32 GB 6400 MHz DDR5 - Gráficos: AMD Radeon RX 6800 XT 16 GB - Serie: XXXXXXXXXX -``` - ---- - -**Gracias por seguir esta guía. ¡Disfruta tu Hackintosh! 🍎** diff --git a/CONTINUAR_USB_CREATION.md b/CONTINUAR_USB_CREATION.md deleted file mode 100644 index 326e909..0000000 --- a/CONTINUAR_USB_CREATION.md +++ /dev/null @@ -1,187 +0,0 @@ -# Instrucciones para Claude Code - Continuar Creación USB Hackintosh - -## Estado Actual - -El proceso fue interrumpido durante la copia de archivos. Aquí está el estado: - -### ✅ Completado: -1. USB `/dev/sdc` particionado con GPT -2. Partición EFI (FAT32, 500MB) creada y montada en `/mnt/usb_efi` -3. Partición HFS+ (57.1GB) creada y montada en `/mnt/usb_hfs` -4. Carpeta EFI copiada a `/mnt/usb_efi/EFI/` -5. Imagen DMG montada en `/mnt/dmg_mount` - -### ⏳ Pendiente: -Copiar los archivos del instalador desde `/mnt/dmg_mount/` a `/mnt/usb_hfs/` - ---- - -## Instrucciones para Continuar - -### Paso 1: Verificar Estado -```bash -# Verificar que todo está montado -mount | grep -E "sdc|dmg_mount|usb_efi|usb_hfs" -lsblk /dev/sdc -``` - -### Paso 2: Continuar Copia de Archivos -```bash -# Copiar todo el contenido del instalador al USB -# Esto incluye: BaseSystem, Firmware, Install macOS Ventura.app, etc. -sudo rsync -av --info=progress2 /mnt/dmg_mount/ /mnt/usb_hfs/ -``` - -**Nota:** Este proceso copia ~14GB y puede tardar 10-30 minutos dependiendo de la velocidad del USB. - -### Paso 3: Verificar Copia -```bash -# Verificar que los archivos importantes están -ls -la /mnt/usb_hfs/ -ls -la /mnt/usb_hfs/Install\ macOS\ Ventura.app/ -ls -la /mnt/usb_hfs/BaseSystem/ -``` - -### Paso 4: Sincronizar y Desmontar -```bash -# Sincronizar datos al disco -sudo sync - -# Desmontar particiones -sudo umount /mnt/usb_efi -sudo umount /mnt/usb_hfs -sudo umount /mnt/dmg_mount - -# Verificar que se desmontó correctamente -lsblk /dev/sdc -``` - -### Paso 5: Verificar USB Final -```bash -# El USB debería tener: -# - Partición 1 (EFI): Con carpeta EFI/ que contiene BOOT/ y OC/ -# - Partición 2 (HFS+): Con Install macOS Ventura.app y archivos de sistema - -# Verificar estructura EFI -sudo mkdir -p /mnt/check -sudo mount /dev/sdc1 /mnt/check -ls -la /mnt/check/EFI/OC/ -sudo umount /mnt/check -``` - ---- - -## Estructura Final del USB - -``` -/dev/sdc (USB Kingston 57.6GB) -├── sdc1: EFI (FAT32, 500MB) -│ └── EFI/ -│ ├── BOOT/ -│ │ └── BOOTx64.efi -│ └── OC/ -│ ├── ACPI/ -│ ├── Drivers/ -│ ├── Kexts/ -│ └── config.plist -│ -└── sdc2: Install macOS Ventura (HFS+, 57.1GB) - ├── Install macOS Ventura.app/ - ├── BaseSystem/ - ├── Firmware/ - ├── System/ - ├── usr/ - └── ... (archivos del instalador) -``` - ---- - -## Comandos Rápidos (Copiar y Pegar) - -```bash -# 1. Verificar estado -mount | grep -E "sdc|dmg_mount|usb_efi|usb_hfs" && echo "✓ Todo montado" || echo "✗ Algo no está montado" - -# 2. Continuar copia -sudo rsync -av --info=progress2 /mnt/dmg_mount/ /mnt/usb_hfs/ - -# 3. Sincronizar y desmontar -sudo sync -sudo umount /mnt/usb_efi /mnt/usb_hfs /mnt/dmg_mount 2>/dev/null -echo "✓ USB listo" -``` - ---- - -## Próximos Pasos (Después de que el USB esté listo) - -1. **Probar en PC objetivo:** - - Insertar USB en la PC con ASUS B760-I - - Bootear desde USB - - Seleccionar "Install macOS Ventura" en OpenCore - -2. **Si funciona:** - - Formatear SSD objetivo como APFS - - Instalar macOS Ventura - - Post-instalación: copiar EFI al SSD interno - -3. **Si falla:** - - Verificar errores en pantalla - - Ajustar config.plist según sea necesario - - Probar diferentes boot-args - ---- - -## Ubicación de Archivos - -- **DMG Original:** `/home/ren/proyectos/mac/VenturaInstaller.dmg` -- **Punto de Montaje DMG:** `/mnt/dmg_mount` -- **Punto de Montaje EFI:** `/mnt/usb_efi` -- **Punto de Montaje HFS:** `/mnt/usb_hfs` -- **Dispositivo USB:** `/dev/sdc` - ---- - -## Notas Importantes - -- **No desconectes el USB** hasta que `sync` termine y lo desmontes -- Si `rsync` se interrumpe, puedes volver a ejecutarlo, continuará donde quedó -- El USB debe tener al menos 16GB libres (preferiblemente 32GB+) -- La partición EFI debe ser FAT32 para que el BIOS la reconozca -- La partición HFS+ contiene el instalador real de macOS - ---- - -## Solución de Problemas - -### Si rsync falla: -```bash -# Intentar con cp -r en lugar de rsync -sudo cp -r /mnt/dmg_mount/* /mnt/usb_hfs/ -``` - -### Si el USB no bootea: -1. Verificar que la partición EFI tenga boot flag: - ```bash - sudo parted /dev/sdc set 1 boot on - ``` - -2. Verificar que BOOTx64.efi existe: - ```bash - ls /mnt/usb_efi/EFI/BOOT/BOOTx64.efi - ``` - -### Si faltan archivos después de copiar: -```bash -# Verificar espacio disponible -df -h /mnt/usb_hfs - -# Verificar integridad del DMG -ls -lh /home/ren/proyectos/mac/VenturaInstaller.dmg -``` - ---- - -**Creado:** 2026-02-05 -**Hardware:** ASUS ROG STRIX B760-I + i7-13700K + RX 6800 XT -**Target:** macOS Ventura 13.x diff --git a/GUIDE_FOR_VM.md b/GUIDE_FOR_VM.md deleted file mode 100644 index 11f9ece..0000000 --- a/GUIDE_FOR_VM.md +++ /dev/null @@ -1,37 +0,0 @@ -# Instrucciones para crear el Instalador (Ejecutar dentro de macOS) - -Copia y pega estos comandos en tu Terminal de macOS para crear el instalador USB. - -## 1. Descargar EFI y Recursos -```bash -# Descargar repo -cd ~/Downloads -curl -L -o repo.zip https://gitea.cbcren.online/renato97/hackintosh-b760-13700k/archive/main.zip -unzip -q -o repo.zip -mv hackintosh-b760-13700k/EFI . -``` - -## 2. Asegurar que Ventura está instalado -Verifica que tengas la app "Install macOS Ventura" en la carpeta Aplicaciones. - -## 3. Crear Imagen DMG -```bash -# Crear imagen de 16GB en Escritorio -hdiutil create -o ~/Desktop/VenturaInstaller -size 16000m -volname VenturaUSB -layout SPUD -fs HFS+J - -# Montar imagen -hdiutil attach ~/Desktop/VenturaInstaller.dmg -noverify -mountpoint /Volumes/VenturaUSB - -# Escribir instalador (Te pedirá contraseña) -sudo /Applications/Install\ macOS\ Ventura.app/Contents/Resources/createinstallmedia --volume /Volumes/VenturaUSB --nointeraction - -# Copiar EFI -cp -R ~/Downloads/EFI /Volumes/Install\ macOS\ Ventura/ - -# Desmontar -hdiutil detach /Volumes/Install\ macOS\ Ventura -``` - -## 4. Final -Ahora tendrás `VenturaInstaller.dmg` en tu Escritorio. -Avísame para copiarlo fuera de la VM. diff --git a/QUICKSTART.md b/QUICKSTART.md deleted file mode 100755 index f160316..0000000 --- a/QUICKSTART.md +++ /dev/null @@ -1,203 +0,0 @@ -# Hackintosh Quick Start - ASUS ROG STRIX B760-I - -## 🎯 Tu Hardware - -``` -CPU: Intel i7-13700K (Raptor Lake, 16 cores) -MB: ASUS ROG STRIX B760-I GAMING WIFI -GPU: AMD Radeon RX 6800 XT (16GB) -RAM: 32GB DDR5 6400MHz -SSD: Crucial P3 Plus 1TB NVMe -Ethernet Intel I226-V 2.5GbE -Wi-Fi: Intel AX211 (Wi-Fi 6E) -Audio: Realtek HDA -``` - ---- - -## ⚡ 3 Pasos Rápidos - -### 1️⃣ Configurar BIOS (5 min) - -| Opción | Valor | -|--------|-------| -| Fast Boot | DISABLE | -| CFG Lock | DISABLE | -| VT-d | DISABLE | -| VT-x | ENABLE | -| Above 4G Decoding | ENABLE | -| DVMT Pre-Allocated | 64MB | -| CSM | DISABLE | -| Secure Boot | Other OS | -| SATA Mode | AHCI | -| Resizable BAR | DISABLE | - -### 2️⃣ Crear USB (30 min) - -```bash -# En Mac -# 1. Conectar USB 16GB+ -# 2. Formatear: HFS+, GUID -# 3. Crear instalador -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume --nointeraction - -# 4. Copiar EFI al USB -# 5. Configurar config.plist -``` - -### 3️⃣ Instalar (45 min) - -1. Arrancar desde USB (F8) -2. Seleccionar "macOS Installer" -3. Disk Utility → Borrar disco (APFS, GUID) -4. Instalar macOS -5. Completar configuración - ---- - -## 📦 Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt ⭐ BASE -├── VirtualSMC.kxt ⭐ SMC -├── WhateverGreen.kxt ⭐ GPU -├── AppleALC.kxt ⭐ Audio -├── AppleIGC.kxt ⭐ Ethernet -├── AirportItlwm.kxt ⭐ Wi-Fi -├── IntelBluetoothFirmware.kxt ⭐ BT -├── IntelBTPatcher.kxt ⭐ BT -├── FeatureUnlock.kxt -├── VoodooPS2Controller.kxt -├── SMCProcessor.kxt -└── SMCSuperIO.kxt -``` - ---- - -## ⚙️ config.plist Clave - -### SMBIOS -```xml -SystemProductName: iMacPro1,1 -SystemSerialNumber: GENERAR -SystemUUID: GENERAR -MLB: GENERAR -``` - -### Kernel Emulate (Raptor Lake) -```xml -Cpuid1Data: NxcB/V/QwMA= -Cpuid1Mask: //// -DummyPowerManagement: false -``` - -### Kernel Quirks -```xml -DisableIoMapper: true -AppleCpuPmCfgLock: false -AppleXcpmCfgLock: false -``` - -### ACPI Add -``` -SSDT-EC.aml ⭐ FAKE EC -SSDT-PLUG.aml ⭐ PLUG TYPE -``` - ---- - -## 🔧 Comandos Útiles - -### Verificar Kexts -```bash -kextstat | grep Lilu -kextstat | grep WhateverGreen -kextstat | grep AppleALC -``` - -### Verificar GPU -```bash -metalinfo -system_profiler SPDisplaysDataType -``` - -### Verificar Red -```bash -networksetup -listallhardwareports -ifconfig -``` - -### Verificar Audio -```bash -kextstat | grep AppleALC -system_profiler SPAudioDataType -``` - ---- - -## 🐛 Problemas Comunes - -| Problema | Solución | -|----------|----------| -| Kernel Panic | CFG Lock en BIOS o config.plist | -| Pantalla negra | agdpmod=pikera boot-arg | -| No Ethernet | AppleIGC.kext + Network Stack ON | -| No Wi-Fi | AirportItlwm.kext v2.3.0 | -| No Audio | Probar layout-id 7, 11, 13, 28 | -| Reinicios loop | Deshabilitar XMP | -| No PM | SSDT-PLUG + DummyPM=false | - ---- - -## 📱 Layout ID Audio - -| ID | Uso | -|----|-----| -| 1 | Stereo básico | -| 3 | Speaker + Line Out | -| 7 | Realtek (más común) | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + HP | - ---- - -## 🌐 Enlaces Rápidos - -| Recurso | Link | -|---------|------| -| OpenCore | [github.com/acidanthera/OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) | -| Dortania Guide | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| Kexts Acidanthera | [github.com/acidanthera](https://github.com/acidanthera) | -| AppleIGC (Ethernet) | [github.com/SongXiaoXi/AppleIGC](https://github.com/SongXiaoXi/AppleIGC) | -| itlwm (Wi-Fi) | [github.com/OpenIntelWireless/itlwm](https://github.com/OpenIntelWireless/itlwm) | -| B760 EFI Ref | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | - ---- - -## 📋 Checklist Final - -``` -[ ] BIOS configurado -[ ] USB instalador creado -[ ] EFI/OC configurado -[ ] config.plist validado -[ ] Kexts copiados -[ ] SSDTs agregados -[ ] Arranca desde USB -[ ] macOS instalado -[ ] EFI copiado al disco -[ ] Arranca sin USB -[ ] Ethernet funciona -[ ] Wi-Fi funciona -[ ] Audio funciona -[ ] GPU acelerada -[ ] PM configurado -``` - ---- - -**Para guía completa: Ver [README.md](README.md)** diff --git a/README-PROCESO-COMPLETO.md b/README-PROCESO-COMPLETO.md deleted file mode 100755 index a2cef18..0000000 --- a/README-PROCESO-COMPLETO.md +++ /dev/null @@ -1,450 +0,0 @@ -# Hackintosh USB Booteable - Proceso Completo y Estado Actual - -**Fecha**: 5 de Febrero 2026 -**Hardware**: ASUS ROG STRIX B760-I GAMING WIFI + Intel i7-13700K + AMD RX 6800 XT -**macOS**: Sequoia 15.7.3 -**OpenCore**: 1.0.6 - ---- - -## 📋 RESUMEN EJECUTIVO - -### ✅ USB Booteable LISTO -El USB booteable está **creado y funcionando** con: -- BaseSystem.dmg (938MB) restaurado con **TransMac** -- OpenCore 1.0.6 con configuración optimizada para B760/13700K -- Todos los kexts y quirks necesarios - -### 🎯 PRÓXIMO PASO -Arrancar desde el USB en la PC de destino y comenzar instalación de macOS Sequoia. - ---- - -## 🔧 HARDWARE CONFIRMADO - -### Motherboard: ASUS ROG STRIX B760-I GAMING WIFI -- **Chipset**: Intel B760 -- **CPU**: Intel Core i7-13700K (Raptor Lake, 13th Gen) -- **RAM**: Compatible (configurar en BIOS) -- **GPU**: AMD Radeon RX 6800 XT (Navi 21) - Soporte nativo en macOS -- **Ethernet**: Intel I226-V 2.5GbE (requiere AppleIGC.kext) -- **WiFi/BT**: Intel AX211 (requiere AirportItlwm + IntelBTPatcher) -- **Audio**: Realtek ALC4080 (requiere AppleALC layout-id 7) - ---- - -## 📂 ARCHIVOS EN ESTA CARPETA - -``` -Hackintosh-Backup-Final/ -├── EFI/ # Configuración OpenCore completa -│ ├── BOOT/ -│ │ └── BOOTx64.efi # Bootloader UEFI -│ └── OC/ -│ ├── config.plist # ⭐ Configuración principal -│ ├── Drivers/ -│ │ ├── HfsPlus.efi # Driver HFS+ actualizado -│ │ └── OpenRuntime.efi -│ ├── Kexts/ # Drivers de kernel -│ │ ├── Lilu.kext -│ │ ├── VirtualSMC.kext -│ │ ├── WhateverGreen.kext -│ │ ├── AppleALC.kext -│ │ ├── AppleIGC.kext # Intel I226-V Ethernet -│ │ ├── AirportItlwm.kext -│ │ ├── IntelBluetoothFirmware.kext -│ │ ├── IntelBTPatcher.kext -│ │ └── otros... -│ └── ACPI/ -│ ├── SSDT-EC.aml # Fake EC para desktop -│ └── SSDT-PLUG.aml # Power Management -│ -├── com.apple.recovery.boot/ # Imagen de recuperación macOS -│ ├── BaseSystem.dmg # 938 MB - macOS Sequoia Recovery -│ └── BaseSystem.chunklist -│ -├── README-PROCESO-COMPLETO.md # ⭐ Este archivo -├── 01-bios-settings.md # Configuración BIOS requerida -└── otros .md files # Guías complementarias -``` - ---- - -## 🚀 CÓMO SE CREÓ EL USB BOOTEABLE (MÉTODO FINAL QUE FUNCIONÓ) - -### ❌ Métodos que NO funcionaron: -1. **macrecovery.py + copia manual** → Error "OCB: Start Image failed - Aborted" -2. **Reemplazo de HfsPlus.efi** → Sin cambios -3. **GibMacOS + MakeInstall.py** → Error diskpart en Windows -4. **Extracción de InstallAssistant.pkg con 7-Zip** → Archivos corruptos/incompletos - -### ✅ Método que FUNCIONÓ: - -**TransMac (versión trial) + copia manual de EFI** - -1. **Descargar macOS Recovery** (ya hecho): - - Usamos `macrecovery.py` para obtener `BaseSystem.dmg` (938MB) - - Ubicación: `com.apple.recovery.boot/BaseSystem.dmg` - -2. **Restaurar con TransMac**: - ``` - TransMac → Right-click USB → "Format Disk for Mac" - TransMac → Right-click USB → "Restore with Disk Image" - → Seleccionar: BaseSystem.dmg - → Esperar ~5 minutos - ``` - -3. **Copiar EFI con TransMac**: - ``` - TransMac → Open USB Drive - → Arrastrar carpeta EFI/ a la raíz del USB - → Esperar copia (45 archivos) - ``` - -4. **Resultado**: USB booteable funcional - ---- - -## ⚙️ CONFIGURACIÓN CLAVE DEL config.plist - -### SMBIOS -```xml -SystemProductName -iMacPro1,1 -SystemSerialNumber -C02ZCSZTHX87 -MLB -C029361044NJG361F -SystemUUID -65e79699-dff5-4d81-a980-e85203c80120 -``` - -### Boot Arguments -```xml -boot-args --v keepsyms=1 agdpmod=pikera amfi_get_out_of_my_way=1 -``` - -**Explicación**: -- `-v`: Verbose mode (ver logs de arranque) -- `keepsyms=1`: Mantener símbolos para debugging -- `agdpmod=pikera`: Fix para AMD RX 6800 XT (previene pantalla negra) -- `amfi_get_out_of_my_way=1`: Desactiva AMFI (solo para instalación, quitar después) - -### Quirks Críticos - -**Booter → Quirks**: -```xml -DevirtualiseMmio -RebuildAppleMemoryMap -SetupVirtualMap -ProtectUefiServices -``` - -**Kernel → Quirks**: -```xml -AppleCpuPmCfgLock -AppleXcpmCfgLock -DisableIoMapper -``` - -**Misc → Security**: -```xml -DmgLoadingAny -SecureBootModelDisabled -``` - ---- - -## 🖥️ CONFIGURACIÓN DE BIOS REQUERIDA - -**ANTES de arrancar desde el USB, configurar en BIOS:** - -### Desactivar: -- ❌ Fast Boot -- ❌ Secure Boot -- ❌ CSM (Compatibility Support Module) -- ❌ VT-d -- ❌ CFG Lock (si la opción existe) - -### Activar: -- ✅ Above 4G Decoding -- ✅ XHCI Hand-off -- ✅ UEFI Boot Mode -- ✅ VT-x (Virtualization) - -### Boot Priority: -1. USB EFI (OpenCore) -2. Disco de instalación (después de instalar) - -**Ver archivo**: `01-bios-settings.md` para detalles completos - ---- - -## 🎬 PROCESO DE INSTALACIÓN (PRÓXIMOS PASOS) - -### 1. Preparación -- [ ] Desconectar otros discos (opcional, recomendado) -- [ ] Conectar USB booteable -- [ ] Configurar BIOS (ver arriba) - -### 2. Primer Arranque -- [ ] Boot desde USB -- [ ] En OpenCore, seleccionar: **"Install macOS Sequoia"** o **"macOS Base System"** -- [ ] Esperar a que cargue el instalador (~2-5 minutos) - -### 3. Disk Utility (Utilidad de Discos) -``` -Cuando arranque el instalador: -1. Seleccionar idioma -2. Ir a "Utilidad de Discos" -3. Seleccionar el disco de destino -4. Formatear como: - - Nombre: Macintosh HD (o el que quieras) - - Formato: APFS - - Scheme: GUID Partition Map -5. Aplicar -``` - -### 4. Instalación -``` -1. Cerrar Utilidad de Discos -2. Seleccionar "Instalar macOS" -3. Aceptar términos -4. Seleccionar disco "Macintosh HD" -5. Esperar descarga e instalación (~30-60 minutos) - - Requiere conexión a internet - - Se reiniciará varias veces - - SIEMPRE arrancar desde USB en cada reinicio -``` - -### 5. Post-Instalación -``` -Una vez instalado: -1. Copiar EFI del USB al disco de instalación - - Montar EFI del disco: sudo diskutil mount EFI - - Copiar carpeta EFI/ del USB a /Volumes/EFI/ -2. Reiniciar sin USB -3. Verificar hardware funcionando -4. QUITAR amfi_get_out_of_my_way=1 de boot-args -``` - ---- - -## 🔍 DIAGNÓSTICO DE PROBLEMAS COMUNES - -### Problema: "OCB: Start Image failed - Aborted" -**Causa**: Imagen de recuperación corrupta o método de copia incorrecto -**Solución**: Usar TransMac para restaurar BaseSystem.dmg (método que usamos) - -### Problema: Símbolo de prohibido (⊘) -**Causa**: Verificación de seguridad de macOS -**Solución**: -- Verificar `SecureBootModel = Disabled` -- Agregar `amfi_get_out_of_my_way=1` a boot-args - -### Problema: Pantalla negra después de logo Apple -**Causa**: GPU AMD no reconocida correctamente -**Solución**: Verificar `agdpmod=pikera` en boot-args - -### Problema: No aparece el instalador -**Causa**: Partición EFI mal configurada -**Solución**: Verificar que la carpeta EFI esté en la raíz del USB - -### Problema: Kernel Panic -**Causa**: Kext incompatible o quirk incorrecto -**Solución**: Verificar logs con `-v` y ajustar config.plist - ---- - -## 📥 ARCHIVOS DESCARGADOS (NO INCLUIDOS - MUY GRANDES) - -Estos archivos están en la PC original, NO en esta carpeta de backup: - -### macOS Sequoia 15.7.3 Completo (si necesitas instalador offline): -``` -Ubicación: gibMacOS-master/macOS Downloads/publicrelease/089-70987/ -Archivo: InstallAssistant.pkg (15.66 GB) -Uso: Si necesitas instalador completo sin internet -``` - -### Herramientas Usadas: -- **TransMac**: Software comercial ($59, trial 15 días) - CRÍTICO para crear USB -- **gibMacOS**: Descargador de macOS desde servidores Apple -- **macrecovery.py**: Parte de OpenCore, descarga recovery -- **OpenCore**: v1.0.6 (incluido en carpeta EFI/) - ---- - -## ✅ CHECKLIST PRE-ARRANQUE - -Antes de arrancar en la PC de destino, verificar: - -- [ ] USB booteable creado con TransMac -- [ ] Carpeta EFI copiada correctamente (45 archivos) -- [ ] BIOS configurada (Fast Boot OFF, Secure Boot OFF, etc.) -- [ ] Disco de destino preparado (puede estar vacío) -- [ ] Conexión a internet disponible (para descarga durante instalación) -- [ ] Backup de datos importantes (si el disco tenía algo) - ---- - -## 📚 RECURSOS Y REFERENCIAS - -### Guías Oficiales: -- **Dortania OpenCore Install Guide**: https://dortania.github.io/OpenCore-Install-Guide/ -- **Config específico para Raptor Lake (13th Gen)**: https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html - -### EFI de Referencia: -- **Luchina Gabriel B760/13700K**: https://github.com/luchina-gabriel/ROG-STRIX-B760-I-GAMING-WIFI-13600K-RX6600XT -- Usamos esta configuración como base - -### Comunidad: -- **r/hackintosh**: Reddit -- **InsanelyMac**: Foros -- **TonyMacx86**: Tutoriales (controversial, pero útil) - ---- - -## 🐛 PROBLEMAS CONOCIDOS Y SOLUCIONES - -### WiFi Intel AX211 -- **Kext actual**: AirportItlwm.kext (Sonoma 14.4+) -- **Limitación**: Solo funciona en macOS Sonoma y superior -- **Alternativa**: Usar Ethernet o dongle USB WiFi compatible - -### iGPU Intel UHD 770 -- **Estado**: Deshabilitado en config por usar dGPU -- **Nota**: Si quieres usar headless iGPU para Quick Sync, necesita configuración adicional - -### Sleep/Wake -- **Estado**: No probado aún -- **Posibles problemas**: Requiere configuración de USB mapping y power management -- **Solución futura**: Crear USBMap.kext específico para esta motherboard - ---- - -## 📝 NOTAS IMPORTANTES - -1. **Seriales SMBIOS**: Los incluidos en el config.plist son válidos pero debes verificar que no estén en uso: - - Ir a: https://checkcoverage.apple.com/ - - Ingresar el serial: `C02ZCSZTHX87` - - Si dice "válido" o "en garantía" → Generar nuevos seriales - - Si dice "no encontrado" → Perfecto, puedes usarlos - -2. **Boot-args temporales**: Después de instalar macOS, QUITAR: - - `amfi_get_out_of_my_way=1` (solo para instalación) - - `-v` (opcional, pero útil mantener para debugging) - -3. **Actualización de OpenCore**: Cuando actualices: - - Siempre hacer backup del EFI funcionando - - Leer changelog de OpenCore - - Actualizar config.plist según sample.plist nuevo - -4. **Kexts desactualizados**: Los kexts incluidos son de Nov 2025. Verifica actualizaciones en: - - Lilu: https://github.com/acidanthera/Lilu/releases - - VirtualSMC: https://github.com/acidanthera/VirtualSMC/releases - - WhateverGreen: https://github.com/acidanthera/WhateverGreen/releases - - AppleALC: https://github.com/acidanthera/AppleALC/releases - ---- - -## 🎯 QUÉ FALTA HACER - -### Inmediato (en la PC de destino): -1. ✅ USB booteable creado -2. ⏳ Configurar BIOS -3. ⏳ Arrancar desde USB -4. ⏳ Instalar macOS Sequoia -5. ⏳ Copiar EFI al disco de instalación - -### Post-Instalación: -1. ⏳ Verificar funcionamiento de: - - [ ] GPU (RX 6800 XT) - - [ ] Ethernet (Intel I226-V) - - [ ] WiFi (AX211) - - [ ] Bluetooth - - [ ] Audio (ALC4080) - - [ ] USB (puertos funcionando) - - [ ] Sleep/Wake - -2. ⏳ Optimizar: - - [ ] Crear USB Map personalizado - - [ ] Ajustar power management - - [ ] Deshabilitar logs de OpenCore (si todo funciona) - - [ ] Quitar boot-args de debugging - -3. ⏳ Actualizar: - - [ ] Verificar nuevos seriales SMBIOS si es necesario - - [ ] Actualizar kexts a últimas versiones - - [ ] Considerar actualizar OpenCore si hay nueva versión estable - ---- - -## 🆘 SOPORTE Y AYUDA - -Si encuentras problemas: - -1. **OpenCore DEBUG**: Habilita debug en config.plist: - ```xml - Target - 67 - ``` - Los logs se guardarán en EFI/OC/Logs/ - -2. **Verbose Mode**: Los boot-args ya incluyen `-v` para ver el proceso de arranque - -3. **Comunidad**: - - Reddit r/hackintosh (muy útil) - - Discord de OpenCore - - GitHub Issues de los kexts específicos - ---- - -## 📦 BACKUP Y MANTENIMIENTO - -### Hacer backup del EFI funcionando: -```bash -# Desde macOS -sudo cp -R /Volumes/EFI/EFI ~/Desktop/EFI-Backup-$(date +%Y%m%d) -``` - -### Restaurar EFI desde backup: -```bash -# 1. Montar partición EFI -sudo diskutil mount disk0s1 - -# 2. Borrar EFI actual (CUIDADO!) -sudo rm -rf /Volumes/EFI/EFI - -# 3. Copiar backup -sudo cp -R ~/Desktop/EFI-Backup-YYYYMMDD /Volumes/EFI/EFI -``` - ---- - -## ✨ CRÉDITOS - -- **OpenCore Team**: Por el bootloader -- **Acidanthera**: Por los kexts (Lilu, WhateverGreen, etc.) -- **Dortania**: Por la guía completa -- **Luchina Gabriel**: Por el EFI de referencia B760/13700K -- **corpnewt**: Por gibMacOS y otras herramientas -- **Acute Angle Software**: Por TransMac - ---- - -## 📅 HISTORIAL DE CAMBIOS - -### 2026-02-05 - Initial Creation -- Creación del USB booteable con TransMac -- Configuración completa de OpenCore 1.0.6 -- SMBIOS generado para iMacPro1,1 -- Quirks optimizados para B760/13700K -- Kexts incluidos para todo el hardware - ---- - -**¡Buena suerte con la instalación!** 🍀 - -Si todo funciona, verás el instalador de macOS. El proceso puede tardar 30-60 minutos dependiendo de tu conexión a internet. diff --git a/downloads.md b/downloads.md deleted file mode 100755 index 8f5a989..0000000 --- a/downloads.md +++ /dev/null @@ -1,246 +0,0 @@ -# Descargas - Links y Archivos Necesarios - -## 📦 Archivos Esenciales - -### Bootloader - -| Archivo | Versión | Link | -|---------|---------|------| -| **OpenCore** | 0.9.7+ | [github.com/acidanthera/OpenCorePkg/releases](https://github.com/acidanthera/OpenCorePkg/releases) | -| **OCAuxiliaryTools** | Latest | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | -| **ProperTree** | Latest | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | -| **GenSMBIOS** | Latest | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | - -### Kexts Principales (Acidanthera) - -| Kext | Versión | Link | -|------|---------|------| -| **Lilu.kext** | 1.6.8+ | [github.com/acidanthera/Lilu/releases](https://github.com/acidanthera/Lilu/releases) | -| **VirtualSMC.kext** | 1.3.4+ | [github.com/acidanthera/VirtualSMC/releases](https://github.com/acidanthera/VirtualSMC/releases) | -| **WhateverGreen.kext** | 1.6.7+ | [github.com/acidanthera/WhateverGreen/releases](https://github.com/acidanthera/WhateverGreen/releases) | -| **AppleALC.kext** | 1.8.8+ | [github.com/acidanthera/AppleALC/releases](https://github.com/acidanthera/AppleALC/releases) | -| **VoodooPS2Controller.kext** | 2.3.0+ | [github.com/acidanthera/VoodooPS2Controller/releases](https://github.com/acidanthera/VoodooPS2Controller/releases) | -| **FeatureUnlock.kext** | 1.1.4+ | [github.com/acidanthera/FeatureUnlock/releases](https://github.com/acidanthera/FeatureUnlock/releases) | -| **SMCProcessor.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | -| **SMCSuperIO.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | - -### Kexts de Red - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **AppleIGC.kext** | 1.6 (Mar 2025) | [github.com/SongXiaoXi/AppleIGC/releases](https://github.com/SongXiaoXi/AppleIGC/releases) | Ethernet I225/I226-V 2.5GbE | -| **AirportItlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (interfaz nativa) | -| **itlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (con app Helios) | -| **IntelBluetoothFirmware.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth Intel | -| **IntelBTPatcher.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Parche Bluetooth Intel | -| **BlueTool.kext** | 2.3.0+ | [incluido en IntelBluetoothFirmware](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth | - -### Kexts Adicionales - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **BrcmPatchRAM3.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom (alternativa) | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmFirmwareData.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | - ---- - -## 🛠️ Herramientas - -### Configuración - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Hackintool** | [github.com/headkaze/Hackintool](https://github.com/headkaze/Hackintool) | Configuración completa de hardware | -| **OCAuxiliaryTools (OCT)** | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | Editor config.plist con GUI | -| **ProperTree** | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | Editor plist (cross-platform) | -| **GenSMBIOS** | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | Generar SMBIOS válido | -| **SSDTTime** | [github.com/corpnewt/SSDTTime](https://github.com/corpnewt/SSDTTime) | Generar SSDTs personalizados | -| **GenPMC** | [github.com/corpnewt/gen-pmc](https://github.com/corpnewt/gen-pmc) | Generar SSDT-PM | - -### Utilidades del Sistema - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | Monitoreo de sistema (menu bar) | -| **KextsViewer** | [github.com/corpnewt/KextsViewer](https://github.com/corpnewt/KextsViewer) | Ver kexts cargados | -| **Haciend** | [incluido en OpenCore](https://github.com/acidanthera/OpenCorePkg) | Consola interactiva OpenCore | -| **BetterDisplay** | [github.com/waydabber/BetterDisplay](https://github.com/waydabber/BetterDisplay) | Gestión de monitores | -| **MonitorControl** | [github.com/MonitorControl/MonitorControl](https://github.com/MonitorControl/MonitorControl) | Control de brillo DDC | - -### Creación de Instalador - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **OClter** | [github.com/chris1111/OClter](https://github.com/chris1111/OClter) | Crear USB instalador | -| **createinstallmedia** | (Incluido con macOS) | Método oficial de Apple | -| **BalenaEtcher** | [etcher.balena.io](https://etcher.balena.io) | Flashear USB (alternativa) | - ---- - -## 📚 Documentación - -### Guías Oficiales - -| Guía | Link | -|------|------| -| **Dortania OpenCore Install Guide** | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| **Dortania Post-Install Guide** | [dortania.github.io/OpenCore-Post-Install](https://dortania.github.io/OpenCore-Post-Install/) | -| **Dortania Troubleshooting** | [dortania.github.io/Troubleshooting](https://dortania.github.io/Troubleshooting/) | -| **Dortania GPU Buyers Guide** | [dortania.github.io/GPU-Buyers-Guide](https://dortania.github.io/GPU-Buyers-Guide/) | -| **Dortania USB Mapping** | [dortania.github.io/USB-Map-Guide](https://dortania.github.io/USB-Map-Guide/) | - -### Guías Visuales - -| Guía | Link | -|------|------| -| **OpenCore Visual Beginners Guide** | [chriswayg.gitbook.io/opencore-visual-beginners-guide](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/) | -| **Dortania Getting Started** | [dortania.github.io/Getting-Started-With-ACPI](https://dortania.github.io/Getting-Started-With-ACPI/) | - -### Específicos para tu Hardware - -| Recurso | Link | Hardware | -|---------|------|----------| -| **hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore** | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | ASUS ROG STRIX B760-I | -| **rosewu550/asus-strix-b760-i-hackintosh** | [github.com/rosewu550/asus-strix-b760-i-hackintosh](https://github.com/rosewu550/asus-strix-b760-i-hackintosh) | ASUS B760-I + i9-13900F | -| **chenhe/oc-b760m-13700-6800** | [github.com/ichenhe/oc-b760m-13700-6800](https://github.com/ichenhe/oc-b760m-13700-6800) | MSI B760M + i7-13700 + RX 6800 | -| **Base EFI Raptor Lake** | [github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC](https://github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC) | Intel 13th/14th Gen | - -### Comunidad - -| Sitio | Link | -|-------|------| -| **r/hackintosh** | [reddit.com/r/hackintosh](https://www.reddit.com/r/hackintosh/) | -| **TonyMacx86** | [tonymacx86.com](https://www.tonymacx86.com/) | -| **InsanelyMac** | [insanelymac.com](https://www.insanelymac.com/) | -| **Dortania Discord** | [discord.gg/AbTrsBq](https://discord.gg/AbTrsBq) | - ---- - -## 📱 Aplicaciones macOS Recomendadas - -### Productividad - -| App | Link | -|-----|------| -| **Rectangle** | [rectangleapp.com](https://rectangleapp.com/) | -| **AltTab** | [alt-tab-macos.netlify.app](https://alt-tab-macos.netlify.app/) | -| **Karabiner-Elements** | [karabiner-elements.pqrs.org](https://karabiner-elements.pqrs.org/) | -| **BetterTouchTool** | [boastr.net](https://boastr.net/) | - -### Monitoreo - -| App | Link | -|-----|------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | -| **iStat Menus** | [bjango.com/mac/istatmenus](https://bjango.com/mac/istatmenus/) | -| **Activity Monitor** | (Incluido con macOS) | - -### Backups - -| App | Link | -|-----|------| -| **Time Machine** | (Incluido con macOS) | -| **Carbon Copy Cloner** | [bombich.com](https://bombich.com/) | -| **SuperDuper!** | [shirt-pocket.com](https://shirt-pocket.com/) | - -### Utilidades - -| App | Link | -|-----|------| -| **The Unarchiver** | [macpaw.com/the-unarchiver](https://macpaw.com/the-unarchiver) | -| **Amphetamine** | [macpaw.com/amphetamine](https://macpaw.com/amphetamine) | -| **HandBrake** | [handbrake.fr](https://handbrake.fr/) | -| **VLC** | [videolan.org/vlc](https://www.videolan.org/vlc/) | - ---- - -## 🔧 Scripts Útiles - -### Descargar y Usar GenSMBIOS - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/GenSMBIOS.git -cd GenSMBIOS - -# Ejecutar -python3 gensmbios.py - -# Seguir instrucciones -``` - -### Descargar y Usar SSDTTime - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/SSDTTime.git -cd SSDTime - -# Dar permisos -chmod +x SSDTTime.sh - -# Ejecutar -./SSDTTime.sh -``` - -### Descargar Hackintool - -```bash -# Descargar desde releases -# o usar Homebrew (si está instalado) -brew install --cask hackintool -``` - ---- - -## 📝 Notas de Versiones - -### OpenCore -- **Versión actual estable**: 0.9.7 -- **Rama de desarrollo**: 0.9.8+ (experimental) -- **Recomendación**: Usar siempre versión estable - -### macOS (2026) -- **Última versión**: macOS Sequoia 15.x -- **Soporte**: macOS Sequoia, Sonoma 14.x, Ventura 13.x -- **Recomendación**: Sequoia 15.x para hardware más nuevo - -### Kexts -- Actualizar **Lilu** primero (es la base de muchos kexts) -- **WhateverGreen** se actualiza frecuentemente para nuevas GPUs -- **AppleIGC** tiene actualizaciones específicas para Sequoia - ---- - -## ⚠️ Fuentes Confiables - -**SIEMPRE descargar desde**: -- **GitHub releases** (proyectos oficiales) -- **Dortania guides** (documentación verificada) -- **Acidanthera** (kexts oficiales) - -**NUNCA descargar desde**: -- Sitios de dudosa reputación -- Foros con archivos adjuntos -- YouTube sin verificar fuente - ---- - -## 📋 Orden de Descarga Recomendado - -1. **OpenCore** (bootloader) -2. **Lilu** (base kext) -3. **VirtualSMC** + plugins -4. **WhateverGreen** (GPU) -5. **AppleALC** (audio) -6. **AppleIGC** (Ethernet) -7. **AirportItlwm** + **IntelBluetoothFirmware** (Wi-Fi/Bluetooth) -8. **VoodooPS2Controller** (teclado/PS2) -9. **OCAuxiliaryTools** (editor config.plist) -10. **GenSMBIOS** (generar SMBIOS) - ---- - -**Volver a [README.md](README.md)** diff --git a/hackintosh-guide/01-bios-settings.md b/hackintosh-guide/01-bios-settings.md deleted file mode 100755 index c263061..0000000 --- a/hackintosh-guide/01-bios-settings.md +++ /dev/null @@ -1,220 +0,0 @@ -# 01 - Configuración del BIOS - -## ⚙️ ASUS ROG STRIX B760-I GAMING WIFI - Configuración Completa - -### 🔄 Antes de Comenzar - -1. **Anota tus configuraciones actuales** (foto o notas) -2. **Conecta teclado USB** (el inalámbrico puede no funcionar en BIOS) -3. **NO guardes hasta terminar todas las configuraciones** - ---- - -## 📍 Navegación del BIOS - -``` -Presiona [Delete] o [F2] al encender para entrar al BIOS -``` - -### Estructura del Menú ASUS: -- **Main** - Información del sistema -- **Advanced** - Configuraciones avanzadas -- **Monitor** - Monitoreo y overclocking -- **Boot** - Opciones de arranque -- **Tool** - Herramientas del sistema - ---- - -## 🔧 Configuraciones Obligatorias - -### 1. Deshabilitar Fast Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot | Fast Boot | **DISABLE** | - -**¿Por qué?** Fast Boot puede causar problemas con el reconocimiento de dispositivos USB y el arranque de OpenCore. - ---- - -### 2. Configurar CFG Lock (CRÍTICO) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | CFG Lock | **DISABLE** | - -**¿Por qué?** CFG Lock habilitado impide que macOS modifique las configuraciones de energía de la CPU, causando kernel panic. - -**¿No aparece la opción?** Tu BIOS puede no tener esta opción visible. Soluciones: -- **Opción A**: Usar `AppleCpuPmCfgLock` y `AppleXcpmCfgLock` en config.plist -- **Opción B**: Modificar BIOS con UEFI tool (avanzado) -- **Opción C**: Usar un EFI que ya tenga los patches de CFG Lock - ---- - -### 3. Configurar VT-d (Intel VT-d) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology for Directed I/O (VT-d) | **DISABLE** | - -**¿Por qué?** VT-d puede causar problemas con los gráficos y dispositivos. Deshabilitarlo simplifica la instalación. - -**Alternativa**: Si necesitas VT-d para virtualización, habilitar `IoMapper` en `config.plist → Kernel → Quirks → DisableIoMapper = YES` - ---- - -### 4. Habilitar VT-x - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology (VT-x) | **ENABLE** | - -**¿Por qué?** Necesario para algunas características de macOS y para que funcione correctamente la emulación. - ---- - -### 5. Above 4G Decoding - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Above 4G Decoding | **ENABLE** | - -**¿Por qué?** Necesario para que la GPU AMD RX 6800 XT tenga acceso a toda la memoria. - -**¿No aparece la opción?** Agregar `npci=0x2000` a boot-args en config.plist - ---- - -### 6. DVMT Pre-Allocated (Memoria de Video Integrada) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration → Graphics Configuration | DVMT Pre-Allocated | **64MB** | - -**¿Por qué?** macOS requiere mínimo 32MB, pero 64MB es recomendado para evitar problemas con la iGPU (aunque uses GPU dedicada). - -**Valores posibles**: 32MB, 64MB, 128MB (recomendado: 64MB o 128MB) - ---- - -### 7. Deshabilitar CSM (Compatibility Support Module) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → CSM (Compatibility Support Module) | CSM | **DISABLE** | - -**¿Por qué?** macOS solo arranca en modo UEFI puro. CSM habilita modo Legacy. - -**Nota**: Después de deshabilitar, asegúrate de que tu GPU tenga soporte UEFI (la RX 6800 XT sí lo tiene). - ---- - -### 8. Deshabilitar Secure Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → Secure Boot | OS Type | **Other OS** | - -**¿Por qué?** Secure Boot bloquea la carga de controladores no firmados como OpenCore. - ---- - -### 9. Configurar SATA Mode - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → PCH Storage Configuration → SATA Mode Selection | **AHCI** | | - -**¿Por qué?** macOS no soporta RAID ni IDE en la mayoría de casos. - ---- - -### 10. Deshabilitar Resizable BAR (SAM) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Resize BAR (or Smart Access Memory) | **DISABLE** | - -**¿Por qué?** Resizable BAR puede causar problemas de estabilidad en macOS. - ---- - -### 11. Optimizaciones de Energía (Opcional pero Recomendado) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Power Management | ErP Ready | **DISABLE** | -| Monitor → Digi+ VRM | Power Efficiency Mode | **Standard** | - ---- - -## 📋 Resumen de Configuraciones - -``` -┌─────────────────────────────────────────────────────────────┐ -│ ASUS ROG STRIX B760-I - BIOS CONFIGURATION SUMMARY │ -├─────────────────────────────────────────────────────────────┤ -│ Boot → Fast Boot: DISABLE │ -│ Boot → CSM: DISABLE │ -│ Boot → Secure Boot: Other OS │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → CPU → CFG Lock: DISABLE │ -│ Advanced → CPU → VT-d: DISABLE │ -│ Advanced → CPU → VT-x: ENABLE │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → Chipset → Above 4G: ENABLE │ -│ Advanced → Chipset → Resizable BAR: DISABLE │ -│ Advanced → Chipset → DVMT: 64MB │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → SATA Mode: AHCI │ -└─────────────────────────────────────────────────────────────┘ -``` - ---- - -## 🔍 Verificaciones Importantes - -### Después de Configurar - -1. **Guardar y Reiniciar**: Presiona `F10` para guardar y salir -2. **Re-entrar al BIOS** para verificar que todas las configuraciones se guardaron -3. **Tomar foto** de todas las páginas de configuración para referencia - -### Comprobar Opciones que no Aparecen - -Si alguna opción **NO aparece** en tu BIOS: - -1. **Actualizar BIOS** a la última versión -2. Buscar en "Advanced Mode" (F7) -3. Algunas opciones pueden estar en sub-menús diferentes - ---- - -## ⚠️ Problemas Comunes - -| Problema | Solución | -|----------|----------| -| CFG Lock no aparece | Usar config.plist con `AppleCpuPmCfgLock=YES` y `AppleXcpmCfgLock=YES` | -| Above 4G no aparece | Agregar boot-arg `npci=0x2000` | -| DVMT solo tiene "Auto" | Dejar en Auto y agregar `igfxfw=2` boot-arg si hay problemas | -| No puede deshabilitar CSM | Asegurarse de estar en UEFI mode first | - ---- - -## 🎯 Checklist Antes de Continuar - -- [ ] Fast Boot: DISABLE -- [ ] CFG Lock: DISABLE (o configurado en config.plist) -- [ ] VT-d: DISABLE -- [ ] VT-x: ENABLE -- [ ] Above 4G Decoding: ENABLE -- [ ] DVMT Pre-Allocated: 64MB -- [ ] CSM: DISABLE -- [ ] Secure Boot: Other OS -- [ ] SATA Mode: AHCI -- [ ] Resizable BAR: DISABLE - ---- - -**Siguiente paso: [02 - Crear USB Instalador](02-create-installer.md)** diff --git a/hackintosh-guide/02-create-installer.md b/hackintosh-guide/02-create-installer.md deleted file mode 100755 index d265963..0000000 --- a/hackintosh-guide/02-create-installer.md +++ /dev/null @@ -1,397 +0,0 @@ -# 02 - Crear USB Instalador macOS - -## 📋 Requisitos Previos - -### Hardware Necesario -- **USB Flash Drive** - Mínimo 16GB (recomendado 32GB) -- **Acceso a una Mac** o máquina virtual con macOS - -### Software Necesario -- **macOS Sequoia 15.x** (o última versión disponible) -- **OClter** o **createinstallmedia** (incluido con macOS) - ---- - -## 🍿 Paso 1: Obtener macOS - -### Opción A: Desde App Store (Mac Real) - -```bash -# Buscar "macOS Sequoia" en App Store -# Descargar automáticamente (15GB+) -``` - -### Opción B: Desde MacInTouch / Archivos - -Descargar el instalador desde: -- App Store → Buscar "macOS Sequoia" -- Guardará en `/Applications/Install macOS Sequoia.app` - -### Versión Recomendada -| Versión | Estado | Notas | -|---------|--------|-------| -| macOS Sequoia 15.x | ✅ Recomendado | Última versión estable | -| macOS Sonoma 14.x | ✅ Compatible | Más probado | -| macOS Ventura 13.x | ✅ Compatible | Más estable | - ---- - -## 💾 Paso 2: Preparar USB - -### Formatear USB en macOS - -1. **Conectar USB** a la Mac -2. Abrir **Disk Utility** (Utilidad de Discos) -3. Seleccionar el USB (no el volumen) - -``` -Nombre: MyVolume -Formato: Mac OS Extended (Journaled) -Esquema: GUID Partition Map -``` - -4. Click en **Erase** (Borrar) - ---- - -## 🔧 Paso 3: Crear Instalador con Terminal - -### Método createinstallmedia (Oficial) - -Abrir **Terminal** y ejecutar: - -```bash -# Para macOS Sequoia -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction - -# Para macOS Sonoma -sudo /Applications/Install\ macOS\ Sonoma.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction -``` - -**Tiempo estimado**: 30-45 minutos - -**Salida esperada**: -``` -Install media now available -Volume name: MyVolume -... -Ready to start. -To continue, press Y and Return. -``` - -### Usando OClter (Alternativa) - -```bash -# Descargar OClter -curl -O https://github.com/chris1111/OClter/releases/download/v1.x/OClter.tool - -# Dar permisos -chmod +x OClter.tool - -# Ejecutar -sudo ./OClter.tool -``` - ---- - -## 📱 Paso 4: Verificar USB - -### Comprobar que el USB tenga la estructura correcta - -```bash -ls -la /Volumes/MyVolume -``` - -**Debería contener**: -``` -MyVolume/ -├── System/ -├── .IAProductInfo -├── .IAPhysicalMedia -├── BaseSystem.dmg -├── BaseSystem.chunklist -└── ... -``` - ---- - -## 🖥️ Paso 5: Agregar OpenCore al USB - -### Descargar OpenCore - -Ir a: [Acidanthera/OpenCorePkg Releases](https://github.com/acidanthera/OpenCorePkg/releases) - -Descargar la última versión **stable** (ej: OpenCore-0.9.7-RELEASE.zip) - -### Estructura de Carpetas - -En el USB, crear la estructura EFI: - -```bash -# Montar EFI del USB (si no está visible) -sudo diskutil mount diskXs1 - -# Crear estructura -mkdir -p /Volumes/EFI/OC/{ACPI,Kexts,Drivers,Tools} -``` - -### Copiar Archivos de OpenCore - -Desde el ZIP descargado, copiar a `EFI/OC/`: - -| Archivo | Destino | -|---------|---------| -| `OpenCore.efi` | `EFI/OC/` | -| `BOOTx64.efi` | `EFI/BOOT/` (renombrar a BOOTx64.efi) | -| `Drivers/` | `EFI/OC/Drivers/` | - -**Drivers necesarios**: -``` -EFI/OC/Drivers/ -├── OpenRuntime.efi (REQUIRED) -├── OpenCanopy.efi (Opcional - para resolución de problemas) -└── HfsPlus.efi (Opcional - si quieres leer HFS+) -``` - ---- - -## 📦 Paso 6: Descargar Kexts Esenciales - -### Lista de Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt (Base) -├── VirtualSMC.kxt (Emulación SMC) -├── WhateverGreen.kxt (GPU) -├── AppleIGC.kxt (Ethernet I226-V) -├── AirportItlwm.kxt (Wi-Fi Intel) -├── IntelBluetoothFirmware.kxt (Bluetooth) -├── IntelBTPatcher.kxt (Parche BT) -├── AppleALC.kxt (Audio) -├── VoodooPS2Controller.kxt (Teclado/PS2) -├── FeatureUnlock.kxt (Features) -├── SMCProcessor.kxt (VirtualSMC plugin) -├── SMCSuperIO.kxt (VirtualSMC plugin) -└── Lilu.kxt (Base - repetido) -``` - -### Links de Descarga - -Ver **[downloads.md](downloads.md)** para links directos a GitHub. - -### Colocar los Kexts - -```bash -# Copiar todos los kexts descargados a: -EFI/OC/Kexts/ - -# Asegurarse de que cada kext sea una carpeta con el .kext dentro -``` - ---- - -## ⚙️ Paso 7: Crear config.plist - -### Usar OCAuxiliaryTools (Recomendado) - -1. Descargar **OCAuxiliaryTools** desde [GitHub](https://github.com/ic005k/OCAuxiliaryTools) -2. Abrir `config.plist` que viene con OpenCore -3. Editar según tu hardware - -### Configuración Mínima para este Hardware - -#### ACPI -``` -Add: [] -Delete: [] -Patch: [] -Quirks: - - FadtEnableReset: YES - - NormalizeHeaders: YES - - RebaseRegions: YES - - ResetHwSig: YES - - ResetLogoStatus: YES -``` - -#### Booter -``` -Quirks: - - AvoidRuntimeDefrag: YES - - DevirtualiseMmio: NO - - DisableSingleUser: NO - - DisableVariableWrite: NO - - DiscardHibernateMap: NO - - EnableSafeModeSlide: NO - - EnableWriteUnprotector: YES - - ForceBooterSignature: NO - - ForceExitBootServices: NO - - ProtectMemoryRegions: NO - - ProtectSecureBoot: NO - - ProtectUefiServices: NO - - ProvideCustomSlide: YES - - ProvideMaxSlide: 0 - - ResizeAppleGpuBars: -1 - - RevirtualiseMmio: NO - - SetupVirtualMap: YES - - SignalAppleOS: NO - - SyncRuntimePermissions: YES -``` - -#### DeviceProperties -``` -Add: {} -Delete: {} -``` - -#### Kernel -``` -Emulate: NO -Force: [] -Kexts: - - BundlePath: Lilu.kext - Enabled: YES - ExecutablePath: Contents/MacOS/Lilu - MaxKernel: "" - MinKernel: "" - PlistPath: Contents/Info.plist - - - BundlePath: VirtualSMC.kext - Enabled: YES - ... - - # Repetir para todos los kexts -``` - -#### Misc -``` -Boot: - - HideAuxiliary: NO - - LauncherOption: Full - - LauncherPath: Default - - PickerAttributes: 0 - - PickerAudioAssist: NO - - PickerMode: Builtin - - PickerVariant: Default - - PollAppleHotKeys: NO - - ShowPicker: YES - - TakeoffDelay: 0 - - Timeout: 5 - -Debug: - - AppleDebug: NO - - ApplePanic: NO - - DisableWatchDog: NO - - DisplayDelay: 0 - - DisplayLevel: 2147483650 - - LogModules: "*" - - SerialInit: NO - - SysReport: NO - - Target: 3 - -Entries: [] -Tools: [] -``` - -#### PlatformInfo (SMBIOS) -``` -Generic: - - AdviseFeatures: NO - - MaxBIOSVersion: NO - - ProcessorType: 0 - - SpoofVendor: NO - - SystemMemoryStatus: Auto - - SystemProductName: iMacPro1,1 - - SystemSerialNumber: ... - - SystemUUID: ... - - MLB: ... - - ROM: ... - - FirmwareFeatures: ... - - FirmwareFeaturesMask: ... - -Update: Auto -UpdateSMBIOSMode: Create -``` - -**SMBIOS Recomendado**: -- `iMacPro1,1` - Para i7-13700K (16 cores,推荐) -- `MacPro7,1` - Alternativa - -Generar valores únicos con **GenSMBIOS**: -```bash -python3 gensmbios.py -``` - -#### UEFI -``` -Drivers: - - Path: OpenRuntime.efi - -Quirks: - - IgnoreInvalidFlexRatio: NO - - ReleaseUsbOwnership: NO - - RequestBootVarRouting: YES - - TscSyncTimeout: 0 - - UnblockFsConnect: NO -``` - ---- - -## 🎯 Paso 8: Configuración Específica para i7-13700K - -### Kernel → Emulate -``` -Cpuid1Data: -Cpuid1Mask: -DummyPowerManagement: NO # IMPORTANTE para Raptor Lake -``` - -Para Raptor Lake (13th gen), usar estos patches: - -```xml -Emulate - - Cpuid1Data - - NxcB/V/QwMA= - - Cpuid1Mask - - //// - - -``` - ---- - -## 📋 Checklist USB Completado - -- [ ] USB formateado (HFS+, GUID) -- [ ] Instalador macOS creado -- [ ] OpenCore copiado -- [ ] Kexts descargados y copiados -- [ ] config.plist configurado -- [ ] SMBIOS generado -- [ ] Verificar que EFI/OC/ tenga todos los archivos - ---- - -## 🧪 Paso 9: Probar el USB - -1. **Conectar USB** al PC Hackintosh -2. **Arrancar** y presionar `F8` para Boot Menu -3. **Seleccionar "UEFI: MyVolume"** -4. Debería ver el **OpenCore Picker** - -### Si no arranca: -- Verificar configuración BIOS -- Verificar estructura EFI -- Rehacer USB si es necesario - ---- - -**Siguiente paso: [03 - Configurar EFI](03-efi-config.md)** diff --git a/hackintosh-guide/03-efi-config.md b/hackintosh-guide/03-efi-config.md deleted file mode 100755 index 128562b..0000000 --- a/hackintosh-guide/03-efi-config.md +++ /dev/null @@ -1,893 +0,0 @@ -# 03 - Configuración EFI Detallada - -## 📋 Archivos de Configuración EFI - -### Estructura Completa EFI/OC/ - -``` -EFI/ -├── BOOT/ -│ └── BOOTx64.efi -└── OC/ - ├── ACPI/ - │ ├── SSDT-EC.aml (Fake EC) - │ ├── SSDT-PLUG.aml (Power Management) - │ ├── SSDT-AWAC.aml (Clock fix B760) - │ └── SSDT-PMC.aml (Opcional) - ├── Kexts/ - │ ├── Lilu.kext - │ ├── VirtualSMC.kext - │ ├── WhateverGreen.kext - │ ├── AppleALC.kext - │ ├── AppleIGC.kext - │ ├── AirportItlwm.kext - │ ├── IntelBluetoothFirmware.kext - │ ├── IntelBTPatcher.kext - │ ├── FeatureUnlock.kext - │ ├── VoodooPS2Controller.kext - │ ├── SMCProcessor.kext - │ ├── SMCSuperIO.kext - │ └── NVMeFix.kext - ├── Drivers/ - │ ├── OpenRuntime.efi - │ └── OpenCanopy.efi - ├── Tools/ - │ └── Haciend.efi (opcional) - ├── config.plist - └── . -``` - ---- - -## 📝 Configuración config.plist Completa - -### ACPI Section - -```xml -ACPI - - Add - - - Comment - Fake EC - Enabled - - Path - SSDT-EC.aml - - - Comment - PluginType - Enabled - - Path - SSDT-PLUG.aml - - - Comment - AWAC Fix - Enabled - - Path - SSDT-AWAC.aml - - - Delete - - Patch - - Quirks - - FadtEnableReset - - NormalizeHeaders - - RebaseRegions - - ResetHwSig - - ResetLogoStatus - - - -``` - ---- - -### Booter Section - -```xml -Booter - - MmapWhitelist - - Patch - - Quirks - - AvoidRuntimeDefrag - - DevirtualiseMmio - - DisableSingleUser - - DisableVariableWrite - - DiscardHibernateMap - - EnableSafeModeSlide - - EnableWriteUnprotector - - ForceBooterSignature - - ForceExitBootServices - - ProtectMemoryRegions - - ProtectSecureBoot - - ProtectUefiServices - - ProvideCustomSlide - - ProvideMaxSlide - 0 - ResizeAppleGpuBars - -1 - RevirtualiseMmio - - SetupVirtualMap - - SignalAppleOS - - SyncRuntimePermissions - - - -``` - ---- - -### DeviceProperties Section - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - PciRoot(0x0)/Pci(0x2,0x0) - - enable-backlight-registers-fix - AQAAAA== - enable-backlight-smoother - AQAAAA== - framebuffer-patch-enable - AQAAAA== - framebuffer-cursormem - AACQAA== - radpng - AQAAAA== - - - Delete - - -``` - -**Layout IDs Comunes para Audio Realtek**: -| Layout ID | Uso | -|-----------|-----| -| 1 | Stereo Output | -| 3 | Speaker + Line Out | -| 5 | Common for desktop | -| 7 | Common for Realtek | -| 11 | Realtek ALC897 | -| 13 | Realtek ALC1220 | -| 28 | Common alternative | -| 99 | Built-in Speaker + Headphone | - ---- - -### Kernel Section - -```xml -Kernel - - Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - - Force - - Kexts - - - - BundlePath - Lilu.kext - Comment - Patch engine - Enabled - - ExecutablePath - Contents/MacOS/Lilu - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VirtualSMC.kext - Comment - SMC emulator - Enabled - - ExecutablePath - Contents/MacOS/VirtualSMC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - WhateverGreen.kext - Comment - AMD GPU patches - Enabled - - ExecutablePath - Contents/MacOS/WhateverGreen - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleALC.kext - Comment - Realtek Audio - Enabled - - ExecutablePath - Contents/MacOS/AppleALC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleIGC.kext - Comment - Intel 2.5GbE - Enabled - - ExecutablePath - Contents/MacOS/AppleIGC - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - AirportItlwm.kext - Comment - Intel Wi-Fi - Enabled - - ExecutablePath - Contents/MacOS/AirportItlwm - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBluetoothFirmware.kext - Comment - Intel Bluetooth - Enabled - - ExecutablePath - Contents/MacOS/IntelBluetoothFirmware - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBTPatcher.kext - Comment - Intel Bluetooth Patcher - Enabled - - ExecutablePath - Contents/MacOS/IntelBTPatcher - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - FeatureUnlock.kext - Comment - Unlock macOS features - Enabled - - ExecutablePath - Contents/MacOS/FeatureUnlock - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VoodooPS2Controller.kext - Comment - PS2 Keyboard/Mouse - Enabled - - ExecutablePath - Contents/MacOS/VoodooPS2Controller - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCProcessor.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCProcessor - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCSuperIO.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCSuperIO - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - Patch - - Quirks - - AppleCpuPmCfgLock - - AppleXcpmCfgLock - - AppleXcpmExtraMsrs - - AppleXcpmForceBoost - - CustomSMBIOSGuid - - DisableIoMapper - - DisableLinkeditJettison - - DisableRtcChecksum - - ExtendBTFeatureFlags - - ExternalDiskIcons - - ForceSecureBootScheme - - IncreasePciBarSize - - LapicKernelPanic - - LegacyCommpage - - PanicNoKextDump - - PowerTimeoutKernelPanic - - ProvideCurrentCpuInfo - - SetApfsTrimTimeout - -1 - ThirdPartyDrives - - XhciPortLimit - - - Scheme - - FuzzyMatch - - KernelArch - x86_64 - KernelCache - Auto - - -``` - ---- - -### Misc Section - -```xml -Misc - - BlessOverride - - Boot - - ConsoleAttributes - 0 - HibernateMode - None - HibernateSkipsPicker - - HideAuxiliary - - LauncherOption - Full - LauncherPath - Default - PickerAttributes - 0 - PickerAudioAssist - - PickerMode - Builtin - PickerVariant - Default - PollAppleHotKeys - - ShowPicker - - TakeoffDelay - 0 - Timeout - 5 - - Debug - - AppleDebug - - ApplePanic - - DisableWatchDog - - DisplayDelay - 0 - DisplayLevel - 2147483650 - LogModules - * - SerialInit - - SysReport - - Target - 3 - - Entries - - Security - - - - AllowSetDefault - - ApECID - 0 - AuthRestart - - BlacklistAppleUpdate - - DmgLoading - Signed - EnablePassword - - ExposeSensitiveData - 6 - HaltLevel - 2147483648 - PasswordHash - - PasswordSalt - - ScanPolicy - 0 - SecureBootModel - Disabled - Vault - Optional - - Serial - - Init - - Override - - Swap - - - Tools - - -``` - ---- - -### PlatformInfo (SMBIOS) - -```xml -PlatformInfo - - Automatic - - CustomMemory - - Generic - - AdviseFeatures - - MaxBIOSVersion - - ProcessorType - 0 - SpoofVendor - - SystemMemoryStatus - Auto - SystemProductName - iMacPro1,1 - SystemSerialNumber - GENERATED_WITH_GENSMBIOS - SystemUUID - GENERATED_WITH_GENSMBIOS - MLB - GENERATED_WITH_GENSMBIOS - ROM - GENERATED_WITH_GENSMBIOS - - UpdateDataHub - - UpdateNVRAM - - UpdateSMBIOS - - UpdateSMBIOSMode - Create - -``` - -**Generar SMBIOS válido**: -```bash -# Usar GenSMBIOS -python3 gensmbios.py - -# O usar -./gensmbios -``` - ---- - -### UEFI Section - -```xml -UEFI - - APFS - - EnableJumpstart - - GlobalConnect - - HideVerbose - - JumpstartHotPlug - - MinDate - 0 - MinVersion - 0 - - Audio - - AudioCodec - 0 - AudioDevice - PciRoot(0x0)/Pci(0x1F,0x3) - AudioOut - 0 - AudioSupport - - MinimumVolume - 20 - PlayChime - Auto - ResetTrafficClass - - SetupDelay - 0 - VolumeAmplifier - 0 - - ConnectDrivers - - Drivers - - - Arguments - agdpmod=pikera - Comment - - Enabled - - LoadEarly - - Path - OpenRuntime.efi - - - Input - - KeyFiltering - - KeyForgetThreshold - 5 - KeyMergeThreshold - 2 - KeySupport - - KeySupportMode - Auto - KeySwap - - PointerSupport - - PointerSupportMode - - TimerResolution - 50000 - - Output - - ClearScreenOnModeSwitch - - ConsoleMode - - DirectGopRendering - - ForceResolution - - GopBurstMode - - GopPassThrough - Disabled - IgnoreTextInGraphics - - InitialMode - 3 - ReconnectGraphicsOnResChange - - ReplaceTabWithSpace - - Resolution - Max - SanitiseClearScreen - - TextRenderer - BuiltinGraphics - UgaPassThrough - - - ProtocolOverrides - - AppleAudio - - AppleBootPolicy - - AppleDebugLog - - AppleEg2Info - - AppleFramebufferInfo - - AppleImg4Verification - - AppleKeyMap - - AppleRtcRam - - AppleSecureBoot - - AppleSmcIo - - AppleUserInterfaceTheme - - DataHub - - DeviceProperties - - FirmwareVolume - - HashServices - - OSInfo - - PciIo - - UnicodeCollation - - - Quirks - - ActivateHpetSupport - - DisableSecurityPolicy - - EnableVectorAcceleration - - ExitBootServicesDelay - 0 - ForceOcWriteFlash - - ForgeUefiSupport - - IgnoreInvalidFlexRatio - - ReleaseUsbOwnership - - ReloadOptionRoms - - RequestBootVarRouting - - ResizeGpuBars - -1 - TscSyncTimeout - 0 - UnblockFsConnect - - - ReservedMemory - - -``` - ---- - -## 🔍 Verificar config.plist - -### Usar ProperTree u OCAuxiliaryTools - -```bash -# Validar config.plist -plutil -lint config.plist -``` - -**Salida esperada**: -``` -config.plist: OK -``` - ---- - -## 📝 Archivos SSDT Necesarios - -### SSDT-EC.aml (Fake EC) - -Necesario porque macOS espera un Embedded Controller. - -### SSDT-PLUG.aml (Plugin Type) - -Necesario para power management correcto del CPU. - -### SSDT-AWAC.aml (RTC Fix) - -**CRÍTICO PARA B760**: Corrige el reloj del sistema. Sin esto, macOS no arrancará. - -### Generar SSDTs - -```bash -# Usar SSDTTime -./SSDTTime.sh - -# O usar GenPMC -./gen-pmc.sh -``` - ---- - -## 📋 Checklist EFI Completo - -- [ ] EFI/BOOT/BOOTx64.efi presente -- [ ] EFI/OC/OpenCore.efi presente -- [ ] EFI/OC/Drivers/OpenRuntime.efi presente -- [ ] EFI/OC/Kexts/ tiene todos los kexts (incluyendo NVMeFix) -- [ ] EFI/OC/ACPI/ tiene SSDT-EC.aml, SSDT-PLUG.aml y SSDT-AWAC.aml -- [ ] config.plist validado con plutil -- [ ] SMBIOS generado con GenSMBIOS -- [ ] Cpuid1Data configurado para Raptor Lake - ---- - -**Siguiente paso: [04 - Instalación](04-installation.md)** diff --git a/hackintosh-guide/04-installation.md b/hackintosh-guide/04-installation.md deleted file mode 100755 index e78d3e7..0000000 --- a/hackintosh-guide/04-installation.md +++ /dev/null @@ -1,419 +0,0 @@ -# 04 - Proceso de Instalación de macOS - -## 🎯 Objetivo - -Instalar macOS Sequoia (o versión elegida) en tu PC con hardware Hackintosh. - ---- - -## 📋 Pre-Instalación - Checklist - -### Antes de Arrancar el USB - -- [ ] **BIOS configurado** según [01-bios-settings.md](01-bios-settings.md) -- [ ] **USB instalador creado** con EFI OpenCore -- [ ] **Verificado SSDT-AWAC.aml** en EFI/OC/ACPI (CRÍTICO) -- [ ] **Verificado boot-arg `agdpmod=pikera`** en config.plist -- [ ] **Disco destino** preparado (mínimo 80GB recomendado) -- [ ] **Conexión a Internet** (Ethernet preferiblemente) -- [ ] **Teclado USB** conectado -- [ ] **Monitor** conectado a la GPU AMD RX 6800 XT - -### Particionamiento del Disco - -**Opción A: Usar todo el disco** (Recomendado para instalación limpia) - -**Opción B: Dual Boot con Windows** - -1. En Windows, abrir **Disk Management** -2. **Shrink** una partición (mínimo 100GB) -3. Dejar el espacio **sin asignar** (no formatear) - ---- - -## 🚀 Paso 1: Arrancar desde el USB - -### 1.1 Conectar USB y Arrancar - -1. **Conectar el USB instalador** -2. **Encender el PC** -3. Presionar **F8** repetidamente para **Boot Menu** - -### 1.2 Seleccionar el USB - -En el Boot Menu ASUS: -``` -Boot Option #1: UEFI: -``` - -Seleccionar con Enter. - ---- - -## 📱 Paso 2: OpenCore Picker - -Deberías ver el **OpenCore Boot Picker**: - -``` -OpenCore 0.9.7 - -macOS Installer -Recovery -``` - -### Si NO ves el OpenCore Picker: - -1. Verificar que EFI/OC/ está en el USB -2. Verificar config.plist -3. Verificar configuración BIOS -4. Consultar sección de **Solución de Problemas** abajo - -### Seleccionar "macOS Installer" - -Con las flechas, seleccionar **"macOS Installer"** y presionar **Enter**. - ---- - -## ⏳ Paso 3: Carga de macOS - -### 3.1 Apple Logo - -Verás el logo de Apple con una barra de progreso. - -**Tiempo**: 2-5 minutos - -### 3.2 Si se reinicia automáticamente - -Esto es **NORMAL**. OpenCore recargará el instalador. - -``` -Primera carga: Puede reiniciar 1-2 veces -``` - ---- - -## 🖥️ Paso 4: Pantalla de Instalación - -### 4.1 Selección de Idioma - -``` -Choose your language: Español (o preferencia) -Click en la flecha -``` - -### 4.2 Utilidades de macOS - -Deberías ver **"macOS Utilities"**: - -``` -- Restore from Time Machine Backup -- Reinstall macOS -- Get Help Online -- Disk Utility -``` - ---- - -## 💽 Paso 5: Disk Utility (Formatear Disco) - -### 5.1 Abrir Disk Utility - -Click en **"Disk Utility"** → **Continue** - -### 5.2 Seleccionar el Disco Destino - -En la columna izquierda, seleccionar el disco donde instalarás macOS. - -**⚠️ IMPORTANTE**: Seleccionar el disco **completo**, no una partición. - -### 5.3 Borrar y Formatear - -1. Click en el botón **"Erase"** (Borrar) -2. Configurar: - -| Campo | Valor | -|-------|-------| -| **Name** | Macintosh HD | -| **Format** | APFS | -| **Scheme** | GUID Partition Map | - -3. Click en **"Erase"** - -### 5.4 Verificar - -Deberías ver: - -``` -Macintosh HD - - Macintosh HD - Data - - Preboot - - Recovery -``` - -### 5.5 Cerrar Disk Utility - -Click en **"Done"** → **"Disk Utility"** → **Quit Disk Utility** - ---- - -## 📦 Paso 6: Instalar macOS - -### 6.1 Elegir "Reinstall macOS" - -De vuelta en macOS Utilities: -``` -Click en: Reinstall macOS Sequoia -Click en: Continue -``` - -### 6.2 Aceptar Términos - -Click en **"Agree"** → **"Agree"** nuevamente - -### 6.3 Seleccionar Disco - -``` -Select the disk where you want to install macOS: -Macintosh HD -``` - -Click en **"Install"** - -### 6.4 Iniciar Instalación - -macOS comenzará a copiar archivos: - -``` -Preparing installation... -Installing macOS... -Time remaining: ~20-30 minutos -``` - -### 6.5 Primer Reinicio - -Durante la instalación, el sistema se reiniciará **automáticamente**. - -**IMPORTANTE**: Al arrancar después del reinicio: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** otra vez -3. **NO seleccionar** el disco duro todavía - ---- - -## 🔄 Paso 7: Continuación de la Instalación - -### 7.1 Segunda Carga - -El sistema continuará la instalación: - -``` -Installing: 5 minutes remaining... -Configuración... -``` - -### 7.2 Segundo Reinicio - -Se reiniciará nuevamente. - -**Esta vez**: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** -3. En OpenCore Picker, seleccionar **"Macintosh HD"** (no el installer) - ---- - -## 🎉 Paso 8: Primer Arranque - Configuración - -### 8.1 Asistente de Configuración - -Verás la pantalla **"Hello"** con diversos idiomas. - -``` -Continúa con la configuración inicial: -1. País o región: Argentina (o tu país) -2. Teclado: Spanish - ISO o ANSI -3. Red: Seleccionar Ethernet (AppleIGC debería funcionar) -4. Transferir información: Not now -5. Apple ID: Puedes saltar este paso inicialmente -``` - -### 8.2 Crear Cuenta - -``` -Nombre: [Tu nombre] -Nombre de cuenta: [tu_usuario] -Contraseña: [tu_contraseña] -``` - -### 8.3 Express Setup - -``` -Location Services: Enable (o Disable si prefieres) -Siri: Enable o Disable -Screen Time: Set up later -``` - -### 8.4 Finalizar - -El sistema preparará tu escritorio... - ---- - -## 🔧 Paso 9: Post-Instalación Inmediata - -### 9.1 Verificar Hardware Funcional - -Abrir **Acerca de este Mac**: - -``` -Apple menu () → Acerca de este Mac -``` - -**Verificar**: -- [ ] CPU: Correcta -- [ ] Memoria: 32GB mostrados -- [ ] Gráficos: AMD RX 6800 XT -- [ ] Serie/UUID: Correctos (SMBIOS) - -### 9.2 Verificar Red - -``` -Ajustes del Sistema → Red -``` - -**Ethernet**: Debería mostrar "Conectado" -**Wi-Fi**: Puede no funcionar todavía (requiere AirportItlwm) - -### 9.3 Verificar Audio - -Reproducir un sonido desde Preferencias del Sistema → Sonido - ---- - -## 🐛 Solución de Problemas - -### Problema: Kernel Panic (Pantalla con texto vertical) - -**Causas comunes**: -- CFG Lock no deshabilitado -- config.plist incorrecto -- Kexts faltantes - -**Soluciones**: - -1. **Agregar boot-args de depuración**: - -En config.plist → Boot → NVRAM → Add → boot-args: -``` --v keepsyms=1 -``` - -2. **Verificar CFG Lock**: -``` -config.plist → Kernel → Quirks: - AppleCpuPmCfgLock: YES - AppleXcpmCfgLock: YES -``` - -3. **Verificar Kexts**: -``` -Asegurarse de tener: -- Lilu.kext -- VirtualSMC.kext -- WhateverGreen.kext -``` - -### Problema: Pantalla negra después de Apple logo - -**Soluciones**: - -1. **Verificar WhateverGreen.kext** -2. **Agregar boot-arg**: -``` --v agdpmod=pikera -``` - -3. **Verificar GPU en DeviceProperties**: -``` -config.plist → DeviceProperties → Add -PciRoot(0x0)/Pci(0x2,0x0) -``` - -### Problema: Se reinicia constantemente - -**Soluciones**: - -1. **Deshabilitar XMP** en BIOS temporalmente -2. **Verificar Cpuid1Data** para Raptor Lake -3. **Probar con SMBIOS diferente** (MacPro7,1) - -### Problema: No detecta red Ethernet - -**Soluciones**: - -1. **Verificar AppleIGC.kext** está en EFI/OC/Kexts/ -2. **Verificar config.plist** → Kernel → Kexts → AppleIGC.kext está enabled -3. **Verificar BIOS** → Network Stack está habilitado - -### Problema: No funciona Wi-Fi - -**Soluciones**: - -1. **Verificar AirportItlwm.kext** está presente -2. **Verificar versión compatible** con tu macOS -3. **Alternativa**: Usar itlwm.kext + app Helios - -### Problema: No funciona Audio - -**Soluciones**: - -1. **Verificar AppleALC.kext** está presente -2. **Probar diferentes layout-id**: - - 1, 3, 5, 7, 11, 13, 28, 99 -3. **Usar Hackintool** para detectar layout correcto - ---- - -## 📋 Checklist Instalación Completada - -- [ ] macOS instalado en el disco -- [ ] Primer arranque completado -- [ ] Cuenta de usuario creada -- [ ] Ethernet funcionando -- [ ] Gráficos AMD RX 6800 XT detectados -- [ ] Audio funcionando (o configurado) -- [ ] SMBIOS correcto en "Acerca de este Mac" - ---- - -## 🎯 Próximos Pasos - -### Instalar EFI en el Disco (Obligatorio) - -Actualmente estás arrancando desde el USB. Necesitas copiar el EFI al disco. - -1. **Arrancar desde USB** -2. **Montar EFI del disco**: -```bash -# En Terminal -diskutil list -# Identificar tu disco (ej: disk1) -sudo diskutil mount disk1s1 -``` - -3. **Copiar EFI**: -```bash -# Desde el USB EFI al disco EFI -sudo cp -R /Volumes/EFI/OC /Volumes/DESTINO_EFI/OC/ -``` - -4. **Verificar**: -```bash -ls /Volumes/DESTINO_EFI/OC/ -``` - -5. **Reiniciar y arrancar desde el disco** (sin USB) - ---- - -**Siguiente paso: [05 - Post-Instalación](05-post-install.md)** diff --git a/hackintosh-guide/05-post-install.md b/hackintosh-guide/05-post-install.md deleted file mode 100755 index 7856cb5..0000000 --- a/hackintosh-guide/05-post-install.md +++ /dev/null @@ -1,545 +0,0 @@ -# 05 - Post-Instalación y Optimización - -## 🎯 Objetivos - -1. Copiar EFI al disco duro -2. Configurar hardware restante (Wi-Fi, Bluetooth, Audio) -3. Optimizar power management -4. Verificar estabilidad del sistema - ---- - -## 💾 Paso 1: Copiar EFI al Disco Duro - -### 1.1 Identificar Volúmenes - -```bash -# Abrir Terminal y listar volúmenes -diskutil list - -# Identificar tu disco macOS (ej: disk1) -disk1s1 EFI -disk1s2 Macintosh HD -``` - -### 1.2 Montar EFI del Disco macOS - -```bash -# Montar la partición EFI -sudo diskutil mount disk1s1 -``` - -### 1.3 Copiar EFI - -```bash -# Copiar desde USB al disco -sudo cp -R /Volumes/EFI_USB/OC /Volumes/EFI_DISK/OC/ - -# Copiar BOOT -sudo cp -R /Volumes/EFI_USB/BOOT /Volumes/EFI_DISK/BOOT/ - -# Verificar -ls -la /Volumes/EFI_DISK/OC/ -``` - -### 1.4 Desmontar EFI - -```bash -sudo diskutil unmount /Volumes/EFI_DISK -``` - -### 1.5 Arrancar desde el Disco - -1. **Retirar USB** -2. **Reiniciar** -3. Presionar **F8** para Boot Menu -4. **Seleccionar** "macOS" o "Macintosh HD" - ---- - -## 🔊 Paso 2: Configurar Audio (AppleALC) - -### 2.1 Identificar Layout ID Correcto - -#### Método 1: Hackintool - -1. **Descargar Hackintool** desde [GitHub](https://github.com/headkaze/Hackintool) -2. Abrir **Hackintool** -3. Ir a **Audio** -4. **Select Audio Codec**: Realtek ALC897 (o tu codec) -5. **Probar Layout IDs**: - - Click en **"Select Audio Layout"** - - Elegir diferentes IDs - - **Test Audio** para cada uno - -#### Layout IDs Comunes para ASUS ROG B760 - -| Layout ID | Uso | -|-----------|-----| -| 1 | Salida estándar | -| 3 | Speaker + Line Out | -| 7 | Realtek genérico | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + Headphone | - -### 2.2 Configurar en config.plist - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - - -``` - -**Para cambiar Layout ID**: - -``` -Layout ID 1: AQAAAA== -Layout ID 3: AwAAAA== -Layout ID 7: BwAAAA== -Layout ID 11: CwAAAA== -Layout ID 13: DQAAAA== -Layout ID 28: GwAAAA== -Layout ID 99, bwAAAA== -``` - -### 2.3 Verificar Audio - -```bash -# En Terminal -kextstat | grep AppleALC - -# Debería mostrar proceso cargado -``` - ---- - -## 📡 Paso 3: Configurar Wi-Fi (Intel AX211) - -### 3.1 Opciones para Wi-Fi Intel - -**Opción A: AirportItlwm.kext** (Interfaz nativa macOS) - -**Opción B: itlwm.kext + Helios** (App separada) - -### 3.2 Configurar AirportItlwm - -1. **Verificar kext cargado**: -```bash -kextstat | grep itlwm -``` - -2. **Configurar** (si no funciona automáticamente): - -```xml - - - BundlePath - AirportItlwm.kext - Enabled - - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - -``` - -3. **Reiniciar** y verificar en **Ajustes del Sistema → Red** - -### 3.3 Alternativa: itlwm + Helios - -Si AirportItlwm no funciona: - -1. **Reemplazar** AirportItlwm.kext con **itlwm.kext** -2. **Descargar Helios app** desde [OpenIntelWireless](https://github.com/OpenIntelWireless/Helios) -3. **Abrir Helios** para conectarse a redes Wi-Fi - ---- - -## 🔵 Paso 4: Configurar Bluetooth (Intel AX211) - -### 4.1 Verificar Kexts de Bluetooth - -Asegurarse de tener estos 3 kexts en EFI/OC/Kexts/: - -``` -IntelBluetoothFirmware.kext -IntelBTPatcher.kext -BlueTool.kext (opcional, incluido en IntelBluetoothFirmware) -``` - -### 4.2 Configurar en config.plist - -```xml - - BundlePath - IntelBluetoothFirmware.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - - - - BundlePath - IntelBTPatcher.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - -``` - -### 4.3 Verificar - -```bash -# Verificar Bluetooth cargado -kextstat | grep Bluetooth - -# Abrir Bluetooth en Ajustes del Sistema -``` - ---- - -## ⚡ Paso 5: Power Management (CPU) - -### 5.1 Verificar Gestión de Energía - -Abrir **Acerca de este Mac** → **Reporte del Sistema** → **Energía** - -**Estado correcto**: -``` -Estado de alimentación: alimentado por CA -Batería: No hay batería -``` - -### 5.2 Generar SSDT-PM - -**Opción A: Usar SSDTTime** - -1. **Descargar SSDTTime** desde [GitHub](https://github.com/corpnewt/SSDTTime) -2. **Ejecutar**: `./SSDTTime.sh` -3. **Seleccionar**: "1" (Basic Mode) -4. **Seleccionar**: "1" (PM) -5. **Copiar** SSDT-PM.aml a EFI/OC/ACPI/ - -**Opción B: Usar GenPMC** - -```bash -./gen-pmc.sh -``` - -### 5.3 Habilitar XNU PM (Power Management) - -```xml - -Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - -``` - -### 5.4 Verificar Speed Step - -```bash -# En Terminal -sudo powermetrics --samplers cpu_power -i 1000 - -# Verificar que las frecuencias cambien -``` - ---- - -## 🌡️ Paso 6: Monitoreo de Temperaturas - -### 6.1 Instalar Stats (o similar) - -1. **Descargar Stats** desde [GitHub](https://github.com/exelban/stats) -2. **Configurar** para mostrar: - - Temperatura CPU - - Uso de CPU - - Velocidad de ventiladores - - Uso de RAM - -### 6.2 Verificar Temperaturas Normales - -| Componente | Rango Normal | -|------------|--------------| -| CPU (idle) | 30-45°C | -| CPU (load) | 60-85°C | -| GPU (idle) | 35-50°C | -| GPU (load) | 70-85°C | - ---- - -## 🖥️ Paso 7: Configurar GPU AMD RX 6800 XT - -### 7.1 Verificar Aceleración Gráfica - -```bash -# En Terminal -kextstat | grep AMD - -# Debería mostrar: -# com.apple.driver.AMDRadeonX6000 -# com.apple.driver.AMDRadeonX6000MTL -``` - -### 7.2 Verificar Metal - -```bash -# En Terminal -metalinfo - -# Debería mostrar: -# AMD Radeon RX 6800 XT -# Metal Support: YES -``` - -### 7.3 Habilitar Resizeable BAR (si lo deseas) - -**NOTA**: Generalmente **DISABLED** en BIOS para estabilidad. - -Si deseas habilitarlo: -1. Habilitar en BIOS: "Resize BAR" o "SAM" -2. Agregar a config.plist: -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x2,0x0) - - force-online - AQAAAA== - - - -``` - ---- - -## 🔧 Paso 8: Optimizaciones Adicionales - -### 8.1 Habilitar Hibernación (opcional) - -```bash -# En Terminal -sudo pmset hibernatemode 25 -sudo pmset standby 1 -sudo pmset standbydelay 10800 -sudo pmset autopoweroff 1 -``` - -### 8.2 Deshabilitar Hibernación (para ahorrar espacio) - -```bash -sudo pmset hibernatemode 0 -sudo rm -rf /var/vm/sleepimage -``` - -### 8.3 Configurar Sleep/Wake - -```bash -# Deshabilitar sleep al cerrar tap (laptops) -sudo pmset -a disablesleep 1 - -# Habilitar wake on LAN -sudo pmset -a womp 1 -``` - ---- - -## 🧪 Paso 9: Verificar Estabilidad - -### 9.1 Test de Estrés - -**Usar Geekbench 6**: -1. Descargar desde [geekbench.com](https://www.geekbench.com/) -2. Ejecutar **CPU Benchmark** -3. Ejecutar **Compute Benchmark** (OpenCL/Metal) - -**Puntuaciones esperadas** (i7-13700K): -``` -Single Core: ~2200-2600 -Multi Core: ~18000-22000 -OpenCL: ~200000-250000 (RX 6800 XT) -``` - -### 9.2 Test de Memoria - -```bash -# Memtest (opcional) -memtest /Volumes/Macintosh\ HD -``` - -### 9.3 Test de Red - -```bash -# Ping test -ping -c 100 google.com - -# Velocidad de descarga -curl -o /dev/null http://speedtest.tele2.net/100MB.zip -``` - ---- - -## 📱 Paso 10: Apps Recomendadas - -### Utilidades - -| App | Propósito | -|-----|-----------| -| **Stats** | Monitoreo de sistema | -| **Hackintool** | Configuración hardware | -| **ProperTree** | Editar config.plist | -| **OCAuxiliaryTools** | Editar config.plist | -| **KextsViewer** | Ver kexts cargados | -| **Haciend** | Consola OpenCore (en EFI) | -| **BetterDisplay** | Gestión de monitores | -| **MonitorControl** | Control de brillo DDC | - -### Apps de Producto - -| App | Propósito | -|-----|-----------| -| **Rectangle** | Gestión de ventanas | -| **AltTab** | Alt-Tab estilo Windows | -| **iStat Menus** | Monitoreo avanzado | -| **Carbon Copy Cloner** | Backups | -| **Time Machine** | Backups nativo | - ---- - -## 🔄 Paso 11: Actualizaciones de macOS - -### 11.1 Preparación para Actualizaciones - -**Antes de actualizar**: - -1. **Actualizar OpenCore** a última versión -2. **Actualizar Kexts** (Lilu, WhateverGreen, etc.) -3. **Hacer backup** con Time Machine -4. **Verificar compatibilidad** de la versión nueva - -### 11.2 Proceso de Actualización - -```bash -# 1. Actualizar desde App Store -# 2. El sistema se reiniciará -# 3. Arrancar desde EFI del disco (no USB) -# 4. La actualización continuará -``` - -### 11.3 Si la actualización falla - -1. **Arrancar en modo verbose**: - - En OpenCore Picker, presionar **Espacio** - - Seleccionar las opciones del volumen - - Agregar boot-arg: `-v` - -2. **Ver logs** para identificar el problema - -3. **Actualizar kexts** si es necesario - ---- - -## 📋 Checklist Post-Instalación Completado - -### Hardware - -- [ ] Audio funcionando (AppleALC con layout-id correcto) -- [ ] Wi-Fi funcionando (AirportItlwm o itlwm) -- [ ] Bluetooth funcionando (IntelBluetoothFirmware) -- [ ] Ethernet funcionando (AppleIGC) -- [ ] Gráficos AMD RX 6800 XT con aceleración -- [ ] Power Management configurado -- [ ] Temperaturas normales - -### Software - -- [ ] EFI copiado al disco -- [ ] Arranca sin USB -- [ ] Hackintool instalado -- [ ] Stats instalado -- [ ] Time Machine configurado (opcional) - -### Estabilidad - -- [ ] Geekbench ejecutado -- [ ] No hay kernel panics aleatorios -- [ ] Sleep/Wake funciona correctamente -- [ ] Todas las apps funcionan - ---- - -## 🎯 Mantenimiento - -### Mensual - -1. **Actualizar kexts** si hay nuevas versiones -2. **Actualizar OpenCore** si hay nueva versión -3. **Verificar temperatures** -4. **Hacer backup** con Time Machine - -### Trimestral - -1. **Actualizar macOS** a última versión menor -2. **Revisar config.plist** para optimizaciones -3. **Limpiar archivos temporales** - ---- - -## 🆘 Recursos Adicionales - -### Documentación - -- [Dortania OpenCore Post-Install Guide](https://dortania.github.io/OpenCore-Post-Install/) -- [Dortania Troubleshooting](https://dortania.github.io/Troubleshooting/) -- [r/hackintosh Subreddit](https://www.reddit.com/r/hackintosh/) - -### Comunidades - -- [TonyMacx86 Forums](https://www.tonymacx86.com/) -- [InsanelyMac Forums](https://www.insanelymac.com/) -- [Dortania Discord](https://discord.gg/AbTrsBq) - ---- - -## 🎉 ¡Felicitaciones! - -Tu Hackintosh está completamente configurado y listo para usar. - -**Acerca de este Mac** debería mostrar: - -``` -macOS Sequoia 15.x - procesador: 3,4 GHz Intel Core i7-13700K (16 cores) - Memoria: 32 GB 6400 MHz DDR5 - Gráficos: AMD Radeon RX 6800 XT 16 GB - Serie: XXXXXXXXXX -``` - ---- - -**Gracias por seguir esta guía. ¡Disfruta tu Hackintosh! 🍎** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/01-bios-settings.md b/hackintosh-guide/Hackintosh-Backup-Final/01-bios-settings.md deleted file mode 100755 index c263061..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/01-bios-settings.md +++ /dev/null @@ -1,220 +0,0 @@ -# 01 - Configuración del BIOS - -## ⚙️ ASUS ROG STRIX B760-I GAMING WIFI - Configuración Completa - -### 🔄 Antes de Comenzar - -1. **Anota tus configuraciones actuales** (foto o notas) -2. **Conecta teclado USB** (el inalámbrico puede no funcionar en BIOS) -3. **NO guardes hasta terminar todas las configuraciones** - ---- - -## 📍 Navegación del BIOS - -``` -Presiona [Delete] o [F2] al encender para entrar al BIOS -``` - -### Estructura del Menú ASUS: -- **Main** - Información del sistema -- **Advanced** - Configuraciones avanzadas -- **Monitor** - Monitoreo y overclocking -- **Boot** - Opciones de arranque -- **Tool** - Herramientas del sistema - ---- - -## 🔧 Configuraciones Obligatorias - -### 1. Deshabilitar Fast Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot | Fast Boot | **DISABLE** | - -**¿Por qué?** Fast Boot puede causar problemas con el reconocimiento de dispositivos USB y el arranque de OpenCore. - ---- - -### 2. Configurar CFG Lock (CRÍTICO) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | CFG Lock | **DISABLE** | - -**¿Por qué?** CFG Lock habilitado impide que macOS modifique las configuraciones de energía de la CPU, causando kernel panic. - -**¿No aparece la opción?** Tu BIOS puede no tener esta opción visible. Soluciones: -- **Opción A**: Usar `AppleCpuPmCfgLock` y `AppleXcpmCfgLock` en config.plist -- **Opción B**: Modificar BIOS con UEFI tool (avanzado) -- **Opción C**: Usar un EFI que ya tenga los patches de CFG Lock - ---- - -### 3. Configurar VT-d (Intel VT-d) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology for Directed I/O (VT-d) | **DISABLE** | - -**¿Por qué?** VT-d puede causar problemas con los gráficos y dispositivos. Deshabilitarlo simplifica la instalación. - -**Alternativa**: Si necesitas VT-d para virtualización, habilitar `IoMapper` en `config.plist → Kernel → Quirks → DisableIoMapper = YES` - ---- - -### 4. Habilitar VT-x - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → CPU Configuration | Intel Virtualization Technology (VT-x) | **ENABLE** | - -**¿Por qué?** Necesario para algunas características de macOS y para que funcione correctamente la emulación. - ---- - -### 5. Above 4G Decoding - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Above 4G Decoding | **ENABLE** | - -**¿Por qué?** Necesario para que la GPU AMD RX 6800 XT tenga acceso a toda la memoria. - -**¿No aparece la opción?** Agregar `npci=0x2000` a boot-args en config.plist - ---- - -### 6. DVMT Pre-Allocated (Memoria de Video Integrada) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration → Graphics Configuration | DVMT Pre-Allocated | **64MB** | - -**¿Por qué?** macOS requiere mínimo 32MB, pero 64MB es recomendado para evitar problemas con la iGPU (aunque uses GPU dedicada). - -**Valores posibles**: 32MB, 64MB, 128MB (recomendado: 64MB o 128MB) - ---- - -### 7. Deshabilitar CSM (Compatibility Support Module) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → CSM (Compatibility Support Module) | CSM | **DISABLE** | - -**¿Por qué?** macOS solo arranca en modo UEFI puro. CSM habilita modo Legacy. - -**Nota**: Después de deshabilitar, asegúrate de que tu GPU tenga soporte UEFI (la RX 6800 XT sí lo tiene). - ---- - -### 8. Deshabilitar Secure Boot - -| Menú | Opción | Valor | -|-----|--------|-------| -| Boot → Secure Boot | OS Type | **Other OS** | - -**¿Por qué?** Secure Boot bloquea la carga de controladores no firmados como OpenCore. - ---- - -### 9. Configurar SATA Mode - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → PCH Storage Configuration → SATA Mode Selection | **AHCI** | | - -**¿Por qué?** macOS no soporta RAID ni IDE en la mayoría de casos. - ---- - -### 10. Deshabilitar Resizable BAR (SAM) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Chipset Configuration | Resize BAR (or Smart Access Memory) | **DISABLE** | - -**¿Por qué?** Resizable BAR puede causar problemas de estabilidad en macOS. - ---- - -### 11. Optimizaciones de Energía (Opcional pero Recomendado) - -| Menú | Opción | Valor | -|-----|--------|-------| -| Advanced → Power Management | ErP Ready | **DISABLE** | -| Monitor → Digi+ VRM | Power Efficiency Mode | **Standard** | - ---- - -## 📋 Resumen de Configuraciones - -``` -┌─────────────────────────────────────────────────────────────┐ -│ ASUS ROG STRIX B760-I - BIOS CONFIGURATION SUMMARY │ -├─────────────────────────────────────────────────────────────┤ -│ Boot → Fast Boot: DISABLE │ -│ Boot → CSM: DISABLE │ -│ Boot → Secure Boot: Other OS │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → CPU → CFG Lock: DISABLE │ -│ Advanced → CPU → VT-d: DISABLE │ -│ Advanced → CPU → VT-x: ENABLE │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → Chipset → Above 4G: ENABLE │ -│ Advanced → Chipset → Resizable BAR: DISABLE │ -│ Advanced → Chipset → DVMT: 64MB │ -├─────────────────────────────────────────────────────────────┤ -│ Advanced → SATA Mode: AHCI │ -└─────────────────────────────────────────────────────────────┘ -``` - ---- - -## 🔍 Verificaciones Importantes - -### Después de Configurar - -1. **Guardar y Reiniciar**: Presiona `F10` para guardar y salir -2. **Re-entrar al BIOS** para verificar que todas las configuraciones se guardaron -3. **Tomar foto** de todas las páginas de configuración para referencia - -### Comprobar Opciones que no Aparecen - -Si alguna opción **NO aparece** en tu BIOS: - -1. **Actualizar BIOS** a la última versión -2. Buscar en "Advanced Mode" (F7) -3. Algunas opciones pueden estar en sub-menús diferentes - ---- - -## ⚠️ Problemas Comunes - -| Problema | Solución | -|----------|----------| -| CFG Lock no aparece | Usar config.plist con `AppleCpuPmCfgLock=YES` y `AppleXcpmCfgLock=YES` | -| Above 4G no aparece | Agregar boot-arg `npci=0x2000` | -| DVMT solo tiene "Auto" | Dejar en Auto y agregar `igfxfw=2` boot-arg si hay problemas | -| No puede deshabilitar CSM | Asegurarse de estar en UEFI mode first | - ---- - -## 🎯 Checklist Antes de Continuar - -- [ ] Fast Boot: DISABLE -- [ ] CFG Lock: DISABLE (o configurado en config.plist) -- [ ] VT-d: DISABLE -- [ ] VT-x: ENABLE -- [ ] Above 4G Decoding: ENABLE -- [ ] DVMT Pre-Allocated: 64MB -- [ ] CSM: DISABLE -- [ ] Secure Boot: Other OS -- [ ] SATA Mode: AHCI -- [ ] Resizable BAR: DISABLE - ---- - -**Siguiente paso: [02 - Crear USB Instalador](02-create-installer.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/02-create-installer.md b/hackintosh-guide/Hackintosh-Backup-Final/02-create-installer.md deleted file mode 100755 index d265963..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/02-create-installer.md +++ /dev/null @@ -1,397 +0,0 @@ -# 02 - Crear USB Instalador macOS - -## 📋 Requisitos Previos - -### Hardware Necesario -- **USB Flash Drive** - Mínimo 16GB (recomendado 32GB) -- **Acceso a una Mac** o máquina virtual con macOS - -### Software Necesario -- **macOS Sequoia 15.x** (o última versión disponible) -- **OClter** o **createinstallmedia** (incluido con macOS) - ---- - -## 🍿 Paso 1: Obtener macOS - -### Opción A: Desde App Store (Mac Real) - -```bash -# Buscar "macOS Sequoia" en App Store -# Descargar automáticamente (15GB+) -``` - -### Opción B: Desde MacInTouch / Archivos - -Descargar el instalador desde: -- App Store → Buscar "macOS Sequoia" -- Guardará en `/Applications/Install macOS Sequoia.app` - -### Versión Recomendada -| Versión | Estado | Notas | -|---------|--------|-------| -| macOS Sequoia 15.x | ✅ Recomendado | Última versión estable | -| macOS Sonoma 14.x | ✅ Compatible | Más probado | -| macOS Ventura 13.x | ✅ Compatible | Más estable | - ---- - -## 💾 Paso 2: Preparar USB - -### Formatear USB en macOS - -1. **Conectar USB** a la Mac -2. Abrir **Disk Utility** (Utilidad de Discos) -3. Seleccionar el USB (no el volumen) - -``` -Nombre: MyVolume -Formato: Mac OS Extended (Journaled) -Esquema: GUID Partition Map -``` - -4. Click en **Erase** (Borrar) - ---- - -## 🔧 Paso 3: Crear Instalador con Terminal - -### Método createinstallmedia (Oficial) - -Abrir **Terminal** y ejecutar: - -```bash -# Para macOS Sequoia -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction - -# Para macOS Sonoma -sudo /Applications/Install\ macOS\ Sonoma.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume \ - --nointeraction -``` - -**Tiempo estimado**: 30-45 minutos - -**Salida esperada**: -``` -Install media now available -Volume name: MyVolume -... -Ready to start. -To continue, press Y and Return. -``` - -### Usando OClter (Alternativa) - -```bash -# Descargar OClter -curl -O https://github.com/chris1111/OClter/releases/download/v1.x/OClter.tool - -# Dar permisos -chmod +x OClter.tool - -# Ejecutar -sudo ./OClter.tool -``` - ---- - -## 📱 Paso 4: Verificar USB - -### Comprobar que el USB tenga la estructura correcta - -```bash -ls -la /Volumes/MyVolume -``` - -**Debería contener**: -``` -MyVolume/ -├── System/ -├── .IAProductInfo -├── .IAPhysicalMedia -├── BaseSystem.dmg -├── BaseSystem.chunklist -└── ... -``` - ---- - -## 🖥️ Paso 5: Agregar OpenCore al USB - -### Descargar OpenCore - -Ir a: [Acidanthera/OpenCorePkg Releases](https://github.com/acidanthera/OpenCorePkg/releases) - -Descargar la última versión **stable** (ej: OpenCore-0.9.7-RELEASE.zip) - -### Estructura de Carpetas - -En el USB, crear la estructura EFI: - -```bash -# Montar EFI del USB (si no está visible) -sudo diskutil mount diskXs1 - -# Crear estructura -mkdir -p /Volumes/EFI/OC/{ACPI,Kexts,Drivers,Tools} -``` - -### Copiar Archivos de OpenCore - -Desde el ZIP descargado, copiar a `EFI/OC/`: - -| Archivo | Destino | -|---------|---------| -| `OpenCore.efi` | `EFI/OC/` | -| `BOOTx64.efi` | `EFI/BOOT/` (renombrar a BOOTx64.efi) | -| `Drivers/` | `EFI/OC/Drivers/` | - -**Drivers necesarios**: -``` -EFI/OC/Drivers/ -├── OpenRuntime.efi (REQUIRED) -├── OpenCanopy.efi (Opcional - para resolución de problemas) -└── HfsPlus.efi (Opcional - si quieres leer HFS+) -``` - ---- - -## 📦 Paso 6: Descargar Kexts Esenciales - -### Lista de Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt (Base) -├── VirtualSMC.kxt (Emulación SMC) -├── WhateverGreen.kxt (GPU) -├── AppleIGC.kxt (Ethernet I226-V) -├── AirportItlwm.kxt (Wi-Fi Intel) -├── IntelBluetoothFirmware.kxt (Bluetooth) -├── IntelBTPatcher.kxt (Parche BT) -├── AppleALC.kxt (Audio) -├── VoodooPS2Controller.kxt (Teclado/PS2) -├── FeatureUnlock.kxt (Features) -├── SMCProcessor.kxt (VirtualSMC plugin) -├── SMCSuperIO.kxt (VirtualSMC plugin) -└── Lilu.kxt (Base - repetido) -``` - -### Links de Descarga - -Ver **[downloads.md](downloads.md)** para links directos a GitHub. - -### Colocar los Kexts - -```bash -# Copiar todos los kexts descargados a: -EFI/OC/Kexts/ - -# Asegurarse de que cada kext sea una carpeta con el .kext dentro -``` - ---- - -## ⚙️ Paso 7: Crear config.plist - -### Usar OCAuxiliaryTools (Recomendado) - -1. Descargar **OCAuxiliaryTools** desde [GitHub](https://github.com/ic005k/OCAuxiliaryTools) -2. Abrir `config.plist` que viene con OpenCore -3. Editar según tu hardware - -### Configuración Mínima para este Hardware - -#### ACPI -``` -Add: [] -Delete: [] -Patch: [] -Quirks: - - FadtEnableReset: YES - - NormalizeHeaders: YES - - RebaseRegions: YES - - ResetHwSig: YES - - ResetLogoStatus: YES -``` - -#### Booter -``` -Quirks: - - AvoidRuntimeDefrag: YES - - DevirtualiseMmio: NO - - DisableSingleUser: NO - - DisableVariableWrite: NO - - DiscardHibernateMap: NO - - EnableSafeModeSlide: NO - - EnableWriteUnprotector: YES - - ForceBooterSignature: NO - - ForceExitBootServices: NO - - ProtectMemoryRegions: NO - - ProtectSecureBoot: NO - - ProtectUefiServices: NO - - ProvideCustomSlide: YES - - ProvideMaxSlide: 0 - - ResizeAppleGpuBars: -1 - - RevirtualiseMmio: NO - - SetupVirtualMap: YES - - SignalAppleOS: NO - - SyncRuntimePermissions: YES -``` - -#### DeviceProperties -``` -Add: {} -Delete: {} -``` - -#### Kernel -``` -Emulate: NO -Force: [] -Kexts: - - BundlePath: Lilu.kext - Enabled: YES - ExecutablePath: Contents/MacOS/Lilu - MaxKernel: "" - MinKernel: "" - PlistPath: Contents/Info.plist - - - BundlePath: VirtualSMC.kext - Enabled: YES - ... - - # Repetir para todos los kexts -``` - -#### Misc -``` -Boot: - - HideAuxiliary: NO - - LauncherOption: Full - - LauncherPath: Default - - PickerAttributes: 0 - - PickerAudioAssist: NO - - PickerMode: Builtin - - PickerVariant: Default - - PollAppleHotKeys: NO - - ShowPicker: YES - - TakeoffDelay: 0 - - Timeout: 5 - -Debug: - - AppleDebug: NO - - ApplePanic: NO - - DisableWatchDog: NO - - DisplayDelay: 0 - - DisplayLevel: 2147483650 - - LogModules: "*" - - SerialInit: NO - - SysReport: NO - - Target: 3 - -Entries: [] -Tools: [] -``` - -#### PlatformInfo (SMBIOS) -``` -Generic: - - AdviseFeatures: NO - - MaxBIOSVersion: NO - - ProcessorType: 0 - - SpoofVendor: NO - - SystemMemoryStatus: Auto - - SystemProductName: iMacPro1,1 - - SystemSerialNumber: ... - - SystemUUID: ... - - MLB: ... - - ROM: ... - - FirmwareFeatures: ... - - FirmwareFeaturesMask: ... - -Update: Auto -UpdateSMBIOSMode: Create -``` - -**SMBIOS Recomendado**: -- `iMacPro1,1` - Para i7-13700K (16 cores,推荐) -- `MacPro7,1` - Alternativa - -Generar valores únicos con **GenSMBIOS**: -```bash -python3 gensmbios.py -``` - -#### UEFI -``` -Drivers: - - Path: OpenRuntime.efi - -Quirks: - - IgnoreInvalidFlexRatio: NO - - ReleaseUsbOwnership: NO - - RequestBootVarRouting: YES - - TscSyncTimeout: 0 - - UnblockFsConnect: NO -``` - ---- - -## 🎯 Paso 8: Configuración Específica para i7-13700K - -### Kernel → Emulate -``` -Cpuid1Data: -Cpuid1Mask: -DummyPowerManagement: NO # IMPORTANTE para Raptor Lake -``` - -Para Raptor Lake (13th gen), usar estos patches: - -```xml -Emulate - - Cpuid1Data - - NxcB/V/QwMA= - - Cpuid1Mask - - //// - - -``` - ---- - -## 📋 Checklist USB Completado - -- [ ] USB formateado (HFS+, GUID) -- [ ] Instalador macOS creado -- [ ] OpenCore copiado -- [ ] Kexts descargados y copiados -- [ ] config.plist configurado -- [ ] SMBIOS generado -- [ ] Verificar que EFI/OC/ tenga todos los archivos - ---- - -## 🧪 Paso 9: Probar el USB - -1. **Conectar USB** al PC Hackintosh -2. **Arrancar** y presionar `F8` para Boot Menu -3. **Seleccionar "UEFI: MyVolume"** -4. Debería ver el **OpenCore Picker** - -### Si no arranca: -- Verificar configuración BIOS -- Verificar estructura EFI -- Rehacer USB si es necesario - ---- - -**Siguiente paso: [03 - Configurar EFI](03-efi-config.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/03-efi-config.md b/hackintosh-guide/Hackintosh-Backup-Final/03-efi-config.md deleted file mode 100755 index 128562b..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/03-efi-config.md +++ /dev/null @@ -1,893 +0,0 @@ -# 03 - Configuración EFI Detallada - -## 📋 Archivos de Configuración EFI - -### Estructura Completa EFI/OC/ - -``` -EFI/ -├── BOOT/ -│ └── BOOTx64.efi -└── OC/ - ├── ACPI/ - │ ├── SSDT-EC.aml (Fake EC) - │ ├── SSDT-PLUG.aml (Power Management) - │ ├── SSDT-AWAC.aml (Clock fix B760) - │ └── SSDT-PMC.aml (Opcional) - ├── Kexts/ - │ ├── Lilu.kext - │ ├── VirtualSMC.kext - │ ├── WhateverGreen.kext - │ ├── AppleALC.kext - │ ├── AppleIGC.kext - │ ├── AirportItlwm.kext - │ ├── IntelBluetoothFirmware.kext - │ ├── IntelBTPatcher.kext - │ ├── FeatureUnlock.kext - │ ├── VoodooPS2Controller.kext - │ ├── SMCProcessor.kext - │ ├── SMCSuperIO.kext - │ └── NVMeFix.kext - ├── Drivers/ - │ ├── OpenRuntime.efi - │ └── OpenCanopy.efi - ├── Tools/ - │ └── Haciend.efi (opcional) - ├── config.plist - └── . -``` - ---- - -## 📝 Configuración config.plist Completa - -### ACPI Section - -```xml -ACPI - - Add - - - Comment - Fake EC - Enabled - - Path - SSDT-EC.aml - - - Comment - PluginType - Enabled - - Path - SSDT-PLUG.aml - - - Comment - AWAC Fix - Enabled - - Path - SSDT-AWAC.aml - - - Delete - - Patch - - Quirks - - FadtEnableReset - - NormalizeHeaders - - RebaseRegions - - ResetHwSig - - ResetLogoStatus - - - -``` - ---- - -### Booter Section - -```xml -Booter - - MmapWhitelist - - Patch - - Quirks - - AvoidRuntimeDefrag - - DevirtualiseMmio - - DisableSingleUser - - DisableVariableWrite - - DiscardHibernateMap - - EnableSafeModeSlide - - EnableWriteUnprotector - - ForceBooterSignature - - ForceExitBootServices - - ProtectMemoryRegions - - ProtectSecureBoot - - ProtectUefiServices - - ProvideCustomSlide - - ProvideMaxSlide - 0 - ResizeAppleGpuBars - -1 - RevirtualiseMmio - - SetupVirtualMap - - SignalAppleOS - - SyncRuntimePermissions - - - -``` - ---- - -### DeviceProperties Section - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - PciRoot(0x0)/Pci(0x2,0x0) - - enable-backlight-registers-fix - AQAAAA== - enable-backlight-smoother - AQAAAA== - framebuffer-patch-enable - AQAAAA== - framebuffer-cursormem - AACQAA== - radpng - AQAAAA== - - - Delete - - -``` - -**Layout IDs Comunes para Audio Realtek**: -| Layout ID | Uso | -|-----------|-----| -| 1 | Stereo Output | -| 3 | Speaker + Line Out | -| 5 | Common for desktop | -| 7 | Common for Realtek | -| 11 | Realtek ALC897 | -| 13 | Realtek ALC1220 | -| 28 | Common alternative | -| 99 | Built-in Speaker + Headphone | - ---- - -### Kernel Section - -```xml -Kernel - - Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - - Force - - Kexts - - - - BundlePath - Lilu.kext - Comment - Patch engine - Enabled - - ExecutablePath - Contents/MacOS/Lilu - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VirtualSMC.kext - Comment - SMC emulator - Enabled - - ExecutablePath - Contents/MacOS/VirtualSMC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - WhateverGreen.kext - Comment - AMD GPU patches - Enabled - - ExecutablePath - Contents/MacOS/WhateverGreen - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleALC.kext - Comment - Realtek Audio - Enabled - - ExecutablePath - Contents/MacOS/AppleALC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleIGC.kext - Comment - Intel 2.5GbE - Enabled - - ExecutablePath - Contents/MacOS/AppleIGC - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - AirportItlwm.kext - Comment - Intel Wi-Fi - Enabled - - ExecutablePath - Contents/MacOS/AirportItlwm - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBluetoothFirmware.kext - Comment - Intel Bluetooth - Enabled - - ExecutablePath - Contents/MacOS/IntelBluetoothFirmware - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBTPatcher.kext - Comment - Intel Bluetooth Patcher - Enabled - - ExecutablePath - Contents/MacOS/IntelBTPatcher - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - FeatureUnlock.kext - Comment - Unlock macOS features - Enabled - - ExecutablePath - Contents/MacOS/FeatureUnlock - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VoodooPS2Controller.kext - Comment - PS2 Keyboard/Mouse - Enabled - - ExecutablePath - Contents/MacOS/VoodooPS2Controller - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCProcessor.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCProcessor - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCSuperIO.kext - Comment - VirtualSMC Plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCSuperIO - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - Patch - - Quirks - - AppleCpuPmCfgLock - - AppleXcpmCfgLock - - AppleXcpmExtraMsrs - - AppleXcpmForceBoost - - CustomSMBIOSGuid - - DisableIoMapper - - DisableLinkeditJettison - - DisableRtcChecksum - - ExtendBTFeatureFlags - - ExternalDiskIcons - - ForceSecureBootScheme - - IncreasePciBarSize - - LapicKernelPanic - - LegacyCommpage - - PanicNoKextDump - - PowerTimeoutKernelPanic - - ProvideCurrentCpuInfo - - SetApfsTrimTimeout - -1 - ThirdPartyDrives - - XhciPortLimit - - - Scheme - - FuzzyMatch - - KernelArch - x86_64 - KernelCache - Auto - - -``` - ---- - -### Misc Section - -```xml -Misc - - BlessOverride - - Boot - - ConsoleAttributes - 0 - HibernateMode - None - HibernateSkipsPicker - - HideAuxiliary - - LauncherOption - Full - LauncherPath - Default - PickerAttributes - 0 - PickerAudioAssist - - PickerMode - Builtin - PickerVariant - Default - PollAppleHotKeys - - ShowPicker - - TakeoffDelay - 0 - Timeout - 5 - - Debug - - AppleDebug - - ApplePanic - - DisableWatchDog - - DisplayDelay - 0 - DisplayLevel - 2147483650 - LogModules - * - SerialInit - - SysReport - - Target - 3 - - Entries - - Security - - - - AllowSetDefault - - ApECID - 0 - AuthRestart - - BlacklistAppleUpdate - - DmgLoading - Signed - EnablePassword - - ExposeSensitiveData - 6 - HaltLevel - 2147483648 - PasswordHash - - PasswordSalt - - ScanPolicy - 0 - SecureBootModel - Disabled - Vault - Optional - - Serial - - Init - - Override - - Swap - - - Tools - - -``` - ---- - -### PlatformInfo (SMBIOS) - -```xml -PlatformInfo - - Automatic - - CustomMemory - - Generic - - AdviseFeatures - - MaxBIOSVersion - - ProcessorType - 0 - SpoofVendor - - SystemMemoryStatus - Auto - SystemProductName - iMacPro1,1 - SystemSerialNumber - GENERATED_WITH_GENSMBIOS - SystemUUID - GENERATED_WITH_GENSMBIOS - MLB - GENERATED_WITH_GENSMBIOS - ROM - GENERATED_WITH_GENSMBIOS - - UpdateDataHub - - UpdateNVRAM - - UpdateSMBIOS - - UpdateSMBIOSMode - Create - -``` - -**Generar SMBIOS válido**: -```bash -# Usar GenSMBIOS -python3 gensmbios.py - -# O usar -./gensmbios -``` - ---- - -### UEFI Section - -```xml -UEFI - - APFS - - EnableJumpstart - - GlobalConnect - - HideVerbose - - JumpstartHotPlug - - MinDate - 0 - MinVersion - 0 - - Audio - - AudioCodec - 0 - AudioDevice - PciRoot(0x0)/Pci(0x1F,0x3) - AudioOut - 0 - AudioSupport - - MinimumVolume - 20 - PlayChime - Auto - ResetTrafficClass - - SetupDelay - 0 - VolumeAmplifier - 0 - - ConnectDrivers - - Drivers - - - Arguments - agdpmod=pikera - Comment - - Enabled - - LoadEarly - - Path - OpenRuntime.efi - - - Input - - KeyFiltering - - KeyForgetThreshold - 5 - KeyMergeThreshold - 2 - KeySupport - - KeySupportMode - Auto - KeySwap - - PointerSupport - - PointerSupportMode - - TimerResolution - 50000 - - Output - - ClearScreenOnModeSwitch - - ConsoleMode - - DirectGopRendering - - ForceResolution - - GopBurstMode - - GopPassThrough - Disabled - IgnoreTextInGraphics - - InitialMode - 3 - ReconnectGraphicsOnResChange - - ReplaceTabWithSpace - - Resolution - Max - SanitiseClearScreen - - TextRenderer - BuiltinGraphics - UgaPassThrough - - - ProtocolOverrides - - AppleAudio - - AppleBootPolicy - - AppleDebugLog - - AppleEg2Info - - AppleFramebufferInfo - - AppleImg4Verification - - AppleKeyMap - - AppleRtcRam - - AppleSecureBoot - - AppleSmcIo - - AppleUserInterfaceTheme - - DataHub - - DeviceProperties - - FirmwareVolume - - HashServices - - OSInfo - - PciIo - - UnicodeCollation - - - Quirks - - ActivateHpetSupport - - DisableSecurityPolicy - - EnableVectorAcceleration - - ExitBootServicesDelay - 0 - ForceOcWriteFlash - - ForgeUefiSupport - - IgnoreInvalidFlexRatio - - ReleaseUsbOwnership - - ReloadOptionRoms - - RequestBootVarRouting - - ResizeGpuBars - -1 - TscSyncTimeout - 0 - UnblockFsConnect - - - ReservedMemory - - -``` - ---- - -## 🔍 Verificar config.plist - -### Usar ProperTree u OCAuxiliaryTools - -```bash -# Validar config.plist -plutil -lint config.plist -``` - -**Salida esperada**: -``` -config.plist: OK -``` - ---- - -## 📝 Archivos SSDT Necesarios - -### SSDT-EC.aml (Fake EC) - -Necesario porque macOS espera un Embedded Controller. - -### SSDT-PLUG.aml (Plugin Type) - -Necesario para power management correcto del CPU. - -### SSDT-AWAC.aml (RTC Fix) - -**CRÍTICO PARA B760**: Corrige el reloj del sistema. Sin esto, macOS no arrancará. - -### Generar SSDTs - -```bash -# Usar SSDTTime -./SSDTTime.sh - -# O usar GenPMC -./gen-pmc.sh -``` - ---- - -## 📋 Checklist EFI Completo - -- [ ] EFI/BOOT/BOOTx64.efi presente -- [ ] EFI/OC/OpenCore.efi presente -- [ ] EFI/OC/Drivers/OpenRuntime.efi presente -- [ ] EFI/OC/Kexts/ tiene todos los kexts (incluyendo NVMeFix) -- [ ] EFI/OC/ACPI/ tiene SSDT-EC.aml, SSDT-PLUG.aml y SSDT-AWAC.aml -- [ ] config.plist validado con plutil -- [ ] SMBIOS generado con GenSMBIOS -- [ ] Cpuid1Data configurado para Raptor Lake - ---- - -**Siguiente paso: [04 - Instalación](04-installation.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/04-installation.md b/hackintosh-guide/Hackintosh-Backup-Final/04-installation.md deleted file mode 100755 index e78d3e7..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/04-installation.md +++ /dev/null @@ -1,419 +0,0 @@ -# 04 - Proceso de Instalación de macOS - -## 🎯 Objetivo - -Instalar macOS Sequoia (o versión elegida) en tu PC con hardware Hackintosh. - ---- - -## 📋 Pre-Instalación - Checklist - -### Antes de Arrancar el USB - -- [ ] **BIOS configurado** según [01-bios-settings.md](01-bios-settings.md) -- [ ] **USB instalador creado** con EFI OpenCore -- [ ] **Verificado SSDT-AWAC.aml** en EFI/OC/ACPI (CRÍTICO) -- [ ] **Verificado boot-arg `agdpmod=pikera`** en config.plist -- [ ] **Disco destino** preparado (mínimo 80GB recomendado) -- [ ] **Conexión a Internet** (Ethernet preferiblemente) -- [ ] **Teclado USB** conectado -- [ ] **Monitor** conectado a la GPU AMD RX 6800 XT - -### Particionamiento del Disco - -**Opción A: Usar todo el disco** (Recomendado para instalación limpia) - -**Opción B: Dual Boot con Windows** - -1. En Windows, abrir **Disk Management** -2. **Shrink** una partición (mínimo 100GB) -3. Dejar el espacio **sin asignar** (no formatear) - ---- - -## 🚀 Paso 1: Arrancar desde el USB - -### 1.1 Conectar USB y Arrancar - -1. **Conectar el USB instalador** -2. **Encender el PC** -3. Presionar **F8** repetidamente para **Boot Menu** - -### 1.2 Seleccionar el USB - -En el Boot Menu ASUS: -``` -Boot Option #1: UEFI: -``` - -Seleccionar con Enter. - ---- - -## 📱 Paso 2: OpenCore Picker - -Deberías ver el **OpenCore Boot Picker**: - -``` -OpenCore 0.9.7 - -macOS Installer -Recovery -``` - -### Si NO ves el OpenCore Picker: - -1. Verificar que EFI/OC/ está en el USB -2. Verificar config.plist -3. Verificar configuración BIOS -4. Consultar sección de **Solución de Problemas** abajo - -### Seleccionar "macOS Installer" - -Con las flechas, seleccionar **"macOS Installer"** y presionar **Enter**. - ---- - -## ⏳ Paso 3: Carga de macOS - -### 3.1 Apple Logo - -Verás el logo de Apple con una barra de progreso. - -**Tiempo**: 2-5 minutos - -### 3.2 Si se reinicia automáticamente - -Esto es **NORMAL**. OpenCore recargará el instalador. - -``` -Primera carga: Puede reiniciar 1-2 veces -``` - ---- - -## 🖥️ Paso 4: Pantalla de Instalación - -### 4.1 Selección de Idioma - -``` -Choose your language: Español (o preferencia) -Click en la flecha -``` - -### 4.2 Utilidades de macOS - -Deberías ver **"macOS Utilities"**: - -``` -- Restore from Time Machine Backup -- Reinstall macOS -- Get Help Online -- Disk Utility -``` - ---- - -## 💽 Paso 5: Disk Utility (Formatear Disco) - -### 5.1 Abrir Disk Utility - -Click en **"Disk Utility"** → **Continue** - -### 5.2 Seleccionar el Disco Destino - -En la columna izquierda, seleccionar el disco donde instalarás macOS. - -**⚠️ IMPORTANTE**: Seleccionar el disco **completo**, no una partición. - -### 5.3 Borrar y Formatear - -1. Click en el botón **"Erase"** (Borrar) -2. Configurar: - -| Campo | Valor | -|-------|-------| -| **Name** | Macintosh HD | -| **Format** | APFS | -| **Scheme** | GUID Partition Map | - -3. Click en **"Erase"** - -### 5.4 Verificar - -Deberías ver: - -``` -Macintosh HD - - Macintosh HD - Data - - Preboot - - Recovery -``` - -### 5.5 Cerrar Disk Utility - -Click en **"Done"** → **"Disk Utility"** → **Quit Disk Utility** - ---- - -## 📦 Paso 6: Instalar macOS - -### 6.1 Elegir "Reinstall macOS" - -De vuelta en macOS Utilities: -``` -Click en: Reinstall macOS Sequoia -Click en: Continue -``` - -### 6.2 Aceptar Términos - -Click en **"Agree"** → **"Agree"** nuevamente - -### 6.3 Seleccionar Disco - -``` -Select the disk where you want to install macOS: -Macintosh HD -``` - -Click en **"Install"** - -### 6.4 Iniciar Instalación - -macOS comenzará a copiar archivos: - -``` -Preparing installation... -Installing macOS... -Time remaining: ~20-30 minutos -``` - -### 6.5 Primer Reinicio - -Durante la instalación, el sistema se reiniciará **automáticamente**. - -**IMPORTANTE**: Al arrancar después del reinicio: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** otra vez -3. **NO seleccionar** el disco duro todavía - ---- - -## 🔄 Paso 7: Continuación de la Instalación - -### 7.1 Segunda Carga - -El sistema continuará la instalación: - -``` -Installing: 5 minutes remaining... -Configuración... -``` - -### 7.2 Segundo Reinicio - -Se reiniciará nuevamente. - -**Esta vez**: -1. **Presionar F8** para Boot Menu -2. **Seleccionar el USB** -3. En OpenCore Picker, seleccionar **"Macintosh HD"** (no el installer) - ---- - -## 🎉 Paso 8: Primer Arranque - Configuración - -### 8.1 Asistente de Configuración - -Verás la pantalla **"Hello"** con diversos idiomas. - -``` -Continúa con la configuración inicial: -1. País o región: Argentina (o tu país) -2. Teclado: Spanish - ISO o ANSI -3. Red: Seleccionar Ethernet (AppleIGC debería funcionar) -4. Transferir información: Not now -5. Apple ID: Puedes saltar este paso inicialmente -``` - -### 8.2 Crear Cuenta - -``` -Nombre: [Tu nombre] -Nombre de cuenta: [tu_usuario] -Contraseña: [tu_contraseña] -``` - -### 8.3 Express Setup - -``` -Location Services: Enable (o Disable si prefieres) -Siri: Enable o Disable -Screen Time: Set up later -``` - -### 8.4 Finalizar - -El sistema preparará tu escritorio... - ---- - -## 🔧 Paso 9: Post-Instalación Inmediata - -### 9.1 Verificar Hardware Funcional - -Abrir **Acerca de este Mac**: - -``` -Apple menu () → Acerca de este Mac -``` - -**Verificar**: -- [ ] CPU: Correcta -- [ ] Memoria: 32GB mostrados -- [ ] Gráficos: AMD RX 6800 XT -- [ ] Serie/UUID: Correctos (SMBIOS) - -### 9.2 Verificar Red - -``` -Ajustes del Sistema → Red -``` - -**Ethernet**: Debería mostrar "Conectado" -**Wi-Fi**: Puede no funcionar todavía (requiere AirportItlwm) - -### 9.3 Verificar Audio - -Reproducir un sonido desde Preferencias del Sistema → Sonido - ---- - -## 🐛 Solución de Problemas - -### Problema: Kernel Panic (Pantalla con texto vertical) - -**Causas comunes**: -- CFG Lock no deshabilitado -- config.plist incorrecto -- Kexts faltantes - -**Soluciones**: - -1. **Agregar boot-args de depuración**: - -En config.plist → Boot → NVRAM → Add → boot-args: -``` --v keepsyms=1 -``` - -2. **Verificar CFG Lock**: -``` -config.plist → Kernel → Quirks: - AppleCpuPmCfgLock: YES - AppleXcpmCfgLock: YES -``` - -3. **Verificar Kexts**: -``` -Asegurarse de tener: -- Lilu.kext -- VirtualSMC.kext -- WhateverGreen.kext -``` - -### Problema: Pantalla negra después de Apple logo - -**Soluciones**: - -1. **Verificar WhateverGreen.kext** -2. **Agregar boot-arg**: -``` --v agdpmod=pikera -``` - -3. **Verificar GPU en DeviceProperties**: -``` -config.plist → DeviceProperties → Add -PciRoot(0x0)/Pci(0x2,0x0) -``` - -### Problema: Se reinicia constantemente - -**Soluciones**: - -1. **Deshabilitar XMP** en BIOS temporalmente -2. **Verificar Cpuid1Data** para Raptor Lake -3. **Probar con SMBIOS diferente** (MacPro7,1) - -### Problema: No detecta red Ethernet - -**Soluciones**: - -1. **Verificar AppleIGC.kext** está en EFI/OC/Kexts/ -2. **Verificar config.plist** → Kernel → Kexts → AppleIGC.kext está enabled -3. **Verificar BIOS** → Network Stack está habilitado - -### Problema: No funciona Wi-Fi - -**Soluciones**: - -1. **Verificar AirportItlwm.kext** está presente -2. **Verificar versión compatible** con tu macOS -3. **Alternativa**: Usar itlwm.kext + app Helios - -### Problema: No funciona Audio - -**Soluciones**: - -1. **Verificar AppleALC.kext** está presente -2. **Probar diferentes layout-id**: - - 1, 3, 5, 7, 11, 13, 28, 99 -3. **Usar Hackintool** para detectar layout correcto - ---- - -## 📋 Checklist Instalación Completada - -- [ ] macOS instalado en el disco -- [ ] Primer arranque completado -- [ ] Cuenta de usuario creada -- [ ] Ethernet funcionando -- [ ] Gráficos AMD RX 6800 XT detectados -- [ ] Audio funcionando (o configurado) -- [ ] SMBIOS correcto en "Acerca de este Mac" - ---- - -## 🎯 Próximos Pasos - -### Instalar EFI en el Disco (Obligatorio) - -Actualmente estás arrancando desde el USB. Necesitas copiar el EFI al disco. - -1. **Arrancar desde USB** -2. **Montar EFI del disco**: -```bash -# En Terminal -diskutil list -# Identificar tu disco (ej: disk1) -sudo diskutil mount disk1s1 -``` - -3. **Copiar EFI**: -```bash -# Desde el USB EFI al disco EFI -sudo cp -R /Volumes/EFI/OC /Volumes/DESTINO_EFI/OC/ -``` - -4. **Verificar**: -```bash -ls /Volumes/DESTINO_EFI/OC/ -``` - -5. **Reiniciar y arrancar desde el disco** (sin USB) - ---- - -**Siguiente paso: [05 - Post-Instalación](05-post-install.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/05-post-install.md b/hackintosh-guide/Hackintosh-Backup-Final/05-post-install.md deleted file mode 100755 index 7856cb5..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/05-post-install.md +++ /dev/null @@ -1,545 +0,0 @@ -# 05 - Post-Instalación y Optimización - -## 🎯 Objetivos - -1. Copiar EFI al disco duro -2. Configurar hardware restante (Wi-Fi, Bluetooth, Audio) -3. Optimizar power management -4. Verificar estabilidad del sistema - ---- - -## 💾 Paso 1: Copiar EFI al Disco Duro - -### 1.1 Identificar Volúmenes - -```bash -# Abrir Terminal y listar volúmenes -diskutil list - -# Identificar tu disco macOS (ej: disk1) -disk1s1 EFI -disk1s2 Macintosh HD -``` - -### 1.2 Montar EFI del Disco macOS - -```bash -# Montar la partición EFI -sudo diskutil mount disk1s1 -``` - -### 1.3 Copiar EFI - -```bash -# Copiar desde USB al disco -sudo cp -R /Volumes/EFI_USB/OC /Volumes/EFI_DISK/OC/ - -# Copiar BOOT -sudo cp -R /Volumes/EFI_USB/BOOT /Volumes/EFI_DISK/BOOT/ - -# Verificar -ls -la /Volumes/EFI_DISK/OC/ -``` - -### 1.4 Desmontar EFI - -```bash -sudo diskutil unmount /Volumes/EFI_DISK -``` - -### 1.5 Arrancar desde el Disco - -1. **Retirar USB** -2. **Reiniciar** -3. Presionar **F8** para Boot Menu -4. **Seleccionar** "macOS" o "Macintosh HD" - ---- - -## 🔊 Paso 2: Configurar Audio (AppleALC) - -### 2.1 Identificar Layout ID Correcto - -#### Método 1: Hackintool - -1. **Descargar Hackintool** desde [GitHub](https://github.com/headkaze/Hackintool) -2. Abrir **Hackintool** -3. Ir a **Audio** -4. **Select Audio Codec**: Realtek ALC897 (o tu codec) -5. **Probar Layout IDs**: - - Click en **"Select Audio Layout"** - - Elegir diferentes IDs - - **Test Audio** para cada uno - -#### Layout IDs Comunes para ASUS ROG B760 - -| Layout ID | Uso | -|-----------|-----| -| 1 | Salida estándar | -| 3 | Speaker + Line Out | -| 7 | Realtek genérico | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + Headphone | - -### 2.2 Configurar en config.plist - -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - - -``` - -**Para cambiar Layout ID**: - -``` -Layout ID 1: AQAAAA== -Layout ID 3: AwAAAA== -Layout ID 7: BwAAAA== -Layout ID 11: CwAAAA== -Layout ID 13: DQAAAA== -Layout ID 28: GwAAAA== -Layout ID 99, bwAAAA== -``` - -### 2.3 Verificar Audio - -```bash -# En Terminal -kextstat | grep AppleALC - -# Debería mostrar proceso cargado -``` - ---- - -## 📡 Paso 3: Configurar Wi-Fi (Intel AX211) - -### 3.1 Opciones para Wi-Fi Intel - -**Opción A: AirportItlwm.kext** (Interfaz nativa macOS) - -**Opción B: itlwm.kext + Helios** (App separada) - -### 3.2 Configurar AirportItlwm - -1. **Verificar kext cargado**: -```bash -kextstat | grep itlwm -``` - -2. **Configurar** (si no funciona automáticamente): - -```xml - - - BundlePath - AirportItlwm.kext - Enabled - - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - -``` - -3. **Reiniciar** y verificar en **Ajustes del Sistema → Red** - -### 3.3 Alternativa: itlwm + Helios - -Si AirportItlwm no funciona: - -1. **Reemplazar** AirportItlwm.kext con **itlwm.kext** -2. **Descargar Helios app** desde [OpenIntelWireless](https://github.com/OpenIntelWireless/Helios) -3. **Abrir Helios** para conectarse a redes Wi-Fi - ---- - -## 🔵 Paso 4: Configurar Bluetooth (Intel AX211) - -### 4.1 Verificar Kexts de Bluetooth - -Asegurarse de tener estos 3 kexts en EFI/OC/Kexts/: - -``` -IntelBluetoothFirmware.kext -IntelBTPatcher.kext -BlueTool.kext (opcional, incluido en IntelBluetoothFirmware) -``` - -### 4.2 Configurar en config.plist - -```xml - - BundlePath - IntelBluetoothFirmware.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - - - - BundlePath - IntelBTPatcher.kext - Enabled - - MaxKernel - - MinKernel - 19.0.0 - -``` - -### 4.3 Verificar - -```bash -# Verificar Bluetooth cargado -kextstat | grep Bluetooth - -# Abrir Bluetooth en Ajustes del Sistema -``` - ---- - -## ⚡ Paso 5: Power Management (CPU) - -### 5.1 Verificar Gestión de Energía - -Abrir **Acerca de este Mac** → **Reporte del Sistema** → **Energía** - -**Estado correcto**: -``` -Estado de alimentación: alimentado por CA -Batería: No hay batería -``` - -### 5.2 Generar SSDT-PM - -**Opción A: Usar SSDTTime** - -1. **Descargar SSDTTime** desde [GitHub](https://github.com/corpnewt/SSDTTime) -2. **Ejecutar**: `./SSDTTime.sh` -3. **Seleccionar**: "1" (Basic Mode) -4. **Seleccionar**: "1" (PM) -5. **Copiar** SSDT-PM.aml a EFI/OC/ACPI/ - -**Opción B: Usar GenPMC** - -```bash -./gen-pmc.sh -``` - -### 5.3 Habilitar XNU PM (Power Management) - -```xml - -Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - -``` - -### 5.4 Verificar Speed Step - -```bash -# En Terminal -sudo powermetrics --samplers cpu_power -i 1000 - -# Verificar que las frecuencias cambien -``` - ---- - -## 🌡️ Paso 6: Monitoreo de Temperaturas - -### 6.1 Instalar Stats (o similar) - -1. **Descargar Stats** desde [GitHub](https://github.com/exelban/stats) -2. **Configurar** para mostrar: - - Temperatura CPU - - Uso de CPU - - Velocidad de ventiladores - - Uso de RAM - -### 6.2 Verificar Temperaturas Normales - -| Componente | Rango Normal | -|------------|--------------| -| CPU (idle) | 30-45°C | -| CPU (load) | 60-85°C | -| GPU (idle) | 35-50°C | -| GPU (load) | 70-85°C | - ---- - -## 🖥️ Paso 7: Configurar GPU AMD RX 6800 XT - -### 7.1 Verificar Aceleración Gráfica - -```bash -# En Terminal -kextstat | grep AMD - -# Debería mostrar: -# com.apple.driver.AMDRadeonX6000 -# com.apple.driver.AMDRadeonX6000MTL -``` - -### 7.2 Verificar Metal - -```bash -# En Terminal -metalinfo - -# Debería mostrar: -# AMD Radeon RX 6800 XT -# Metal Support: YES -``` - -### 7.3 Habilitar Resizeable BAR (si lo deseas) - -**NOTA**: Generalmente **DISABLED** en BIOS para estabilidad. - -Si deseas habilitarlo: -1. Habilitar en BIOS: "Resize BAR" o "SAM" -2. Agregar a config.plist: -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x2,0x0) - - force-online - AQAAAA== - - - -``` - ---- - -## 🔧 Paso 8: Optimizaciones Adicionales - -### 8.1 Habilitar Hibernación (opcional) - -```bash -# En Terminal -sudo pmset hibernatemode 25 -sudo pmset standby 1 -sudo pmset standbydelay 10800 -sudo pmset autopoweroff 1 -``` - -### 8.2 Deshabilitar Hibernación (para ahorrar espacio) - -```bash -sudo pmset hibernatemode 0 -sudo rm -rf /var/vm/sleepimage -``` - -### 8.3 Configurar Sleep/Wake - -```bash -# Deshabilitar sleep al cerrar tap (laptops) -sudo pmset -a disablesleep 1 - -# Habilitar wake on LAN -sudo pmset -a womp 1 -``` - ---- - -## 🧪 Paso 9: Verificar Estabilidad - -### 9.1 Test de Estrés - -**Usar Geekbench 6**: -1. Descargar desde [geekbench.com](https://www.geekbench.com/) -2. Ejecutar **CPU Benchmark** -3. Ejecutar **Compute Benchmark** (OpenCL/Metal) - -**Puntuaciones esperadas** (i7-13700K): -``` -Single Core: ~2200-2600 -Multi Core: ~18000-22000 -OpenCL: ~200000-250000 (RX 6800 XT) -``` - -### 9.2 Test de Memoria - -```bash -# Memtest (opcional) -memtest /Volumes/Macintosh\ HD -``` - -### 9.3 Test de Red - -```bash -# Ping test -ping -c 100 google.com - -# Velocidad de descarga -curl -o /dev/null http://speedtest.tele2.net/100MB.zip -``` - ---- - -## 📱 Paso 10: Apps Recomendadas - -### Utilidades - -| App | Propósito | -|-----|-----------| -| **Stats** | Monitoreo de sistema | -| **Hackintool** | Configuración hardware | -| **ProperTree** | Editar config.plist | -| **OCAuxiliaryTools** | Editar config.plist | -| **KextsViewer** | Ver kexts cargados | -| **Haciend** | Consola OpenCore (en EFI) | -| **BetterDisplay** | Gestión de monitores | -| **MonitorControl** | Control de brillo DDC | - -### Apps de Producto - -| App | Propósito | -|-----|-----------| -| **Rectangle** | Gestión de ventanas | -| **AltTab** | Alt-Tab estilo Windows | -| **iStat Menus** | Monitoreo avanzado | -| **Carbon Copy Cloner** | Backups | -| **Time Machine** | Backups nativo | - ---- - -## 🔄 Paso 11: Actualizaciones de macOS - -### 11.1 Preparación para Actualizaciones - -**Antes de actualizar**: - -1. **Actualizar OpenCore** a última versión -2. **Actualizar Kexts** (Lilu, WhateverGreen, etc.) -3. **Hacer backup** con Time Machine -4. **Verificar compatibilidad** de la versión nueva - -### 11.2 Proceso de Actualización - -```bash -# 1. Actualizar desde App Store -# 2. El sistema se reiniciará -# 3. Arrancar desde EFI del disco (no USB) -# 4. La actualización continuará -``` - -### 11.3 Si la actualización falla - -1. **Arrancar en modo verbose**: - - En OpenCore Picker, presionar **Espacio** - - Seleccionar las opciones del volumen - - Agregar boot-arg: `-v` - -2. **Ver logs** para identificar el problema - -3. **Actualizar kexts** si es necesario - ---- - -## 📋 Checklist Post-Instalación Completado - -### Hardware - -- [ ] Audio funcionando (AppleALC con layout-id correcto) -- [ ] Wi-Fi funcionando (AirportItlwm o itlwm) -- [ ] Bluetooth funcionando (IntelBluetoothFirmware) -- [ ] Ethernet funcionando (AppleIGC) -- [ ] Gráficos AMD RX 6800 XT con aceleración -- [ ] Power Management configurado -- [ ] Temperaturas normales - -### Software - -- [ ] EFI copiado al disco -- [ ] Arranca sin USB -- [ ] Hackintool instalado -- [ ] Stats instalado -- [ ] Time Machine configurado (opcional) - -### Estabilidad - -- [ ] Geekbench ejecutado -- [ ] No hay kernel panics aleatorios -- [ ] Sleep/Wake funciona correctamente -- [ ] Todas las apps funcionan - ---- - -## 🎯 Mantenimiento - -### Mensual - -1. **Actualizar kexts** si hay nuevas versiones -2. **Actualizar OpenCore** si hay nueva versión -3. **Verificar temperatures** -4. **Hacer backup** con Time Machine - -### Trimestral - -1. **Actualizar macOS** a última versión menor -2. **Revisar config.plist** para optimizaciones -3. **Limpiar archivos temporales** - ---- - -## 🆘 Recursos Adicionales - -### Documentación - -- [Dortania OpenCore Post-Install Guide](https://dortania.github.io/OpenCore-Post-Install/) -- [Dortania Troubleshooting](https://dortania.github.io/Troubleshooting/) -- [r/hackintosh Subreddit](https://www.reddit.com/r/hackintosh/) - -### Comunidades - -- [TonyMacx86 Forums](https://www.tonymacx86.com/) -- [InsanelyMac Forums](https://www.insanelymac.com/) -- [Dortania Discord](https://discord.gg/AbTrsBq) - ---- - -## 🎉 ¡Felicitaciones! - -Tu Hackintosh está completamente configurado y listo para usar. - -**Acerca de este Mac** debería mostrar: - -``` -macOS Sequoia 15.x - procesador: 3,4 GHz Intel Core i7-13700K (16 cores) - Memoria: 32 GB 6400 MHz DDR5 - Gráficos: AMD Radeon RX 6800 XT 16 GB - Serie: XXXXXXXXXX -``` - ---- - -**Gracias por seguir esta guía. ¡Disfruta tu Hackintosh! 🍎** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/QUICKSTART.md b/hackintosh-guide/Hackintosh-Backup-Final/QUICKSTART.md deleted file mode 100755 index f160316..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/QUICKSTART.md +++ /dev/null @@ -1,203 +0,0 @@ -# Hackintosh Quick Start - ASUS ROG STRIX B760-I - -## 🎯 Tu Hardware - -``` -CPU: Intel i7-13700K (Raptor Lake, 16 cores) -MB: ASUS ROG STRIX B760-I GAMING WIFI -GPU: AMD Radeon RX 6800 XT (16GB) -RAM: 32GB DDR5 6400MHz -SSD: Crucial P3 Plus 1TB NVMe -Ethernet Intel I226-V 2.5GbE -Wi-Fi: Intel AX211 (Wi-Fi 6E) -Audio: Realtek HDA -``` - ---- - -## ⚡ 3 Pasos Rápidos - -### 1️⃣ Configurar BIOS (5 min) - -| Opción | Valor | -|--------|-------| -| Fast Boot | DISABLE | -| CFG Lock | DISABLE | -| VT-d | DISABLE | -| VT-x | ENABLE | -| Above 4G Decoding | ENABLE | -| DVMT Pre-Allocated | 64MB | -| CSM | DISABLE | -| Secure Boot | Other OS | -| SATA Mode | AHCI | -| Resizable BAR | DISABLE | - -### 2️⃣ Crear USB (30 min) - -```bash -# En Mac -# 1. Conectar USB 16GB+ -# 2. Formatear: HFS+, GUID -# 3. Crear instalador -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume --nointeraction - -# 4. Copiar EFI al USB -# 5. Configurar config.plist -``` - -### 3️⃣ Instalar (45 min) - -1. Arrancar desde USB (F8) -2. Seleccionar "macOS Installer" -3. Disk Utility → Borrar disco (APFS, GUID) -4. Instalar macOS -5. Completar configuración - ---- - -## 📦 Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt ⭐ BASE -├── VirtualSMC.kxt ⭐ SMC -├── WhateverGreen.kxt ⭐ GPU -├── AppleALC.kxt ⭐ Audio -├── AppleIGC.kxt ⭐ Ethernet -├── AirportItlwm.kxt ⭐ Wi-Fi -├── IntelBluetoothFirmware.kxt ⭐ BT -├── IntelBTPatcher.kxt ⭐ BT -├── FeatureUnlock.kxt -├── VoodooPS2Controller.kxt -├── SMCProcessor.kxt -└── SMCSuperIO.kxt -``` - ---- - -## ⚙️ config.plist Clave - -### SMBIOS -```xml -SystemProductName: iMacPro1,1 -SystemSerialNumber: GENERAR -SystemUUID: GENERAR -MLB: GENERAR -``` - -### Kernel Emulate (Raptor Lake) -```xml -Cpuid1Data: NxcB/V/QwMA= -Cpuid1Mask: //// -DummyPowerManagement: false -``` - -### Kernel Quirks -```xml -DisableIoMapper: true -AppleCpuPmCfgLock: false -AppleXcpmCfgLock: false -``` - -### ACPI Add -``` -SSDT-EC.aml ⭐ FAKE EC -SSDT-PLUG.aml ⭐ PLUG TYPE -``` - ---- - -## 🔧 Comandos Útiles - -### Verificar Kexts -```bash -kextstat | grep Lilu -kextstat | grep WhateverGreen -kextstat | grep AppleALC -``` - -### Verificar GPU -```bash -metalinfo -system_profiler SPDisplaysDataType -``` - -### Verificar Red -```bash -networksetup -listallhardwareports -ifconfig -``` - -### Verificar Audio -```bash -kextstat | grep AppleALC -system_profiler SPAudioDataType -``` - ---- - -## 🐛 Problemas Comunes - -| Problema | Solución | -|----------|----------| -| Kernel Panic | CFG Lock en BIOS o config.plist | -| Pantalla negra | agdpmod=pikera boot-arg | -| No Ethernet | AppleIGC.kext + Network Stack ON | -| No Wi-Fi | AirportItlwm.kext v2.3.0 | -| No Audio | Probar layout-id 7, 11, 13, 28 | -| Reinicios loop | Deshabilitar XMP | -| No PM | SSDT-PLUG + DummyPM=false | - ---- - -## 📱 Layout ID Audio - -| ID | Uso | -|----|-----| -| 1 | Stereo básico | -| 3 | Speaker + Line Out | -| 7 | Realtek (más común) | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + HP | - ---- - -## 🌐 Enlaces Rápidos - -| Recurso | Link | -|---------|------| -| OpenCore | [github.com/acidanthera/OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) | -| Dortania Guide | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| Kexts Acidanthera | [github.com/acidanthera](https://github.com/acidanthera) | -| AppleIGC (Ethernet) | [github.com/SongXiaoXi/AppleIGC](https://github.com/SongXiaoXi/AppleIGC) | -| itlwm (Wi-Fi) | [github.com/OpenIntelWireless/itlwm](https://github.com/OpenIntelWireless/itlwm) | -| B760 EFI Ref | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | - ---- - -## 📋 Checklist Final - -``` -[ ] BIOS configurado -[ ] USB instalador creado -[ ] EFI/OC configurado -[ ] config.plist validado -[ ] Kexts copiados -[ ] SSDTs agregados -[ ] Arranca desde USB -[ ] macOS instalado -[ ] EFI copiado al disco -[ ] Arranca sin USB -[ ] Ethernet funciona -[ ] Wi-Fi funciona -[ ] Audio funciona -[ ] GPU acelerada -[ ] PM configurado -``` - ---- - -**Para guía completa: Ver [README.md](README.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/README-PROCESO-COMPLETO.md b/hackintosh-guide/Hackintosh-Backup-Final/README-PROCESO-COMPLETO.md deleted file mode 100755 index a2cef18..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/README-PROCESO-COMPLETO.md +++ /dev/null @@ -1,450 +0,0 @@ -# Hackintosh USB Booteable - Proceso Completo y Estado Actual - -**Fecha**: 5 de Febrero 2026 -**Hardware**: ASUS ROG STRIX B760-I GAMING WIFI + Intel i7-13700K + AMD RX 6800 XT -**macOS**: Sequoia 15.7.3 -**OpenCore**: 1.0.6 - ---- - -## 📋 RESUMEN EJECUTIVO - -### ✅ USB Booteable LISTO -El USB booteable está **creado y funcionando** con: -- BaseSystem.dmg (938MB) restaurado con **TransMac** -- OpenCore 1.0.6 con configuración optimizada para B760/13700K -- Todos los kexts y quirks necesarios - -### 🎯 PRÓXIMO PASO -Arrancar desde el USB en la PC de destino y comenzar instalación de macOS Sequoia. - ---- - -## 🔧 HARDWARE CONFIRMADO - -### Motherboard: ASUS ROG STRIX B760-I GAMING WIFI -- **Chipset**: Intel B760 -- **CPU**: Intel Core i7-13700K (Raptor Lake, 13th Gen) -- **RAM**: Compatible (configurar en BIOS) -- **GPU**: AMD Radeon RX 6800 XT (Navi 21) - Soporte nativo en macOS -- **Ethernet**: Intel I226-V 2.5GbE (requiere AppleIGC.kext) -- **WiFi/BT**: Intel AX211 (requiere AirportItlwm + IntelBTPatcher) -- **Audio**: Realtek ALC4080 (requiere AppleALC layout-id 7) - ---- - -## 📂 ARCHIVOS EN ESTA CARPETA - -``` -Hackintosh-Backup-Final/ -├── EFI/ # Configuración OpenCore completa -│ ├── BOOT/ -│ │ └── BOOTx64.efi # Bootloader UEFI -│ └── OC/ -│ ├── config.plist # ⭐ Configuración principal -│ ├── Drivers/ -│ │ ├── HfsPlus.efi # Driver HFS+ actualizado -│ │ └── OpenRuntime.efi -│ ├── Kexts/ # Drivers de kernel -│ │ ├── Lilu.kext -│ │ ├── VirtualSMC.kext -│ │ ├── WhateverGreen.kext -│ │ ├── AppleALC.kext -│ │ ├── AppleIGC.kext # Intel I226-V Ethernet -│ │ ├── AirportItlwm.kext -│ │ ├── IntelBluetoothFirmware.kext -│ │ ├── IntelBTPatcher.kext -│ │ └── otros... -│ └── ACPI/ -│ ├── SSDT-EC.aml # Fake EC para desktop -│ └── SSDT-PLUG.aml # Power Management -│ -├── com.apple.recovery.boot/ # Imagen de recuperación macOS -│ ├── BaseSystem.dmg # 938 MB - macOS Sequoia Recovery -│ └── BaseSystem.chunklist -│ -├── README-PROCESO-COMPLETO.md # ⭐ Este archivo -├── 01-bios-settings.md # Configuración BIOS requerida -└── otros .md files # Guías complementarias -``` - ---- - -## 🚀 CÓMO SE CREÓ EL USB BOOTEABLE (MÉTODO FINAL QUE FUNCIONÓ) - -### ❌ Métodos que NO funcionaron: -1. **macrecovery.py + copia manual** → Error "OCB: Start Image failed - Aborted" -2. **Reemplazo de HfsPlus.efi** → Sin cambios -3. **GibMacOS + MakeInstall.py** → Error diskpart en Windows -4. **Extracción de InstallAssistant.pkg con 7-Zip** → Archivos corruptos/incompletos - -### ✅ Método que FUNCIONÓ: - -**TransMac (versión trial) + copia manual de EFI** - -1. **Descargar macOS Recovery** (ya hecho): - - Usamos `macrecovery.py` para obtener `BaseSystem.dmg` (938MB) - - Ubicación: `com.apple.recovery.boot/BaseSystem.dmg` - -2. **Restaurar con TransMac**: - ``` - TransMac → Right-click USB → "Format Disk for Mac" - TransMac → Right-click USB → "Restore with Disk Image" - → Seleccionar: BaseSystem.dmg - → Esperar ~5 minutos - ``` - -3. **Copiar EFI con TransMac**: - ``` - TransMac → Open USB Drive - → Arrastrar carpeta EFI/ a la raíz del USB - → Esperar copia (45 archivos) - ``` - -4. **Resultado**: USB booteable funcional - ---- - -## ⚙️ CONFIGURACIÓN CLAVE DEL config.plist - -### SMBIOS -```xml -SystemProductName -iMacPro1,1 -SystemSerialNumber -C02ZCSZTHX87 -MLB -C029361044NJG361F -SystemUUID -65e79699-dff5-4d81-a980-e85203c80120 -``` - -### Boot Arguments -```xml -boot-args --v keepsyms=1 agdpmod=pikera amfi_get_out_of_my_way=1 -``` - -**Explicación**: -- `-v`: Verbose mode (ver logs de arranque) -- `keepsyms=1`: Mantener símbolos para debugging -- `agdpmod=pikera`: Fix para AMD RX 6800 XT (previene pantalla negra) -- `amfi_get_out_of_my_way=1`: Desactiva AMFI (solo para instalación, quitar después) - -### Quirks Críticos - -**Booter → Quirks**: -```xml -DevirtualiseMmio -RebuildAppleMemoryMap -SetupVirtualMap -ProtectUefiServices -``` - -**Kernel → Quirks**: -```xml -AppleCpuPmCfgLock -AppleXcpmCfgLock -DisableIoMapper -``` - -**Misc → Security**: -```xml -DmgLoadingAny -SecureBootModelDisabled -``` - ---- - -## 🖥️ CONFIGURACIÓN DE BIOS REQUERIDA - -**ANTES de arrancar desde el USB, configurar en BIOS:** - -### Desactivar: -- ❌ Fast Boot -- ❌ Secure Boot -- ❌ CSM (Compatibility Support Module) -- ❌ VT-d -- ❌ CFG Lock (si la opción existe) - -### Activar: -- ✅ Above 4G Decoding -- ✅ XHCI Hand-off -- ✅ UEFI Boot Mode -- ✅ VT-x (Virtualization) - -### Boot Priority: -1. USB EFI (OpenCore) -2. Disco de instalación (después de instalar) - -**Ver archivo**: `01-bios-settings.md` para detalles completos - ---- - -## 🎬 PROCESO DE INSTALACIÓN (PRÓXIMOS PASOS) - -### 1. Preparación -- [ ] Desconectar otros discos (opcional, recomendado) -- [ ] Conectar USB booteable -- [ ] Configurar BIOS (ver arriba) - -### 2. Primer Arranque -- [ ] Boot desde USB -- [ ] En OpenCore, seleccionar: **"Install macOS Sequoia"** o **"macOS Base System"** -- [ ] Esperar a que cargue el instalador (~2-5 minutos) - -### 3. Disk Utility (Utilidad de Discos) -``` -Cuando arranque el instalador: -1. Seleccionar idioma -2. Ir a "Utilidad de Discos" -3. Seleccionar el disco de destino -4. Formatear como: - - Nombre: Macintosh HD (o el que quieras) - - Formato: APFS - - Scheme: GUID Partition Map -5. Aplicar -``` - -### 4. Instalación -``` -1. Cerrar Utilidad de Discos -2. Seleccionar "Instalar macOS" -3. Aceptar términos -4. Seleccionar disco "Macintosh HD" -5. Esperar descarga e instalación (~30-60 minutos) - - Requiere conexión a internet - - Se reiniciará varias veces - - SIEMPRE arrancar desde USB en cada reinicio -``` - -### 5. Post-Instalación -``` -Una vez instalado: -1. Copiar EFI del USB al disco de instalación - - Montar EFI del disco: sudo diskutil mount EFI - - Copiar carpeta EFI/ del USB a /Volumes/EFI/ -2. Reiniciar sin USB -3. Verificar hardware funcionando -4. QUITAR amfi_get_out_of_my_way=1 de boot-args -``` - ---- - -## 🔍 DIAGNÓSTICO DE PROBLEMAS COMUNES - -### Problema: "OCB: Start Image failed - Aborted" -**Causa**: Imagen de recuperación corrupta o método de copia incorrecto -**Solución**: Usar TransMac para restaurar BaseSystem.dmg (método que usamos) - -### Problema: Símbolo de prohibido (⊘) -**Causa**: Verificación de seguridad de macOS -**Solución**: -- Verificar `SecureBootModel = Disabled` -- Agregar `amfi_get_out_of_my_way=1` a boot-args - -### Problema: Pantalla negra después de logo Apple -**Causa**: GPU AMD no reconocida correctamente -**Solución**: Verificar `agdpmod=pikera` en boot-args - -### Problema: No aparece el instalador -**Causa**: Partición EFI mal configurada -**Solución**: Verificar que la carpeta EFI esté en la raíz del USB - -### Problema: Kernel Panic -**Causa**: Kext incompatible o quirk incorrecto -**Solución**: Verificar logs con `-v` y ajustar config.plist - ---- - -## 📥 ARCHIVOS DESCARGADOS (NO INCLUIDOS - MUY GRANDES) - -Estos archivos están en la PC original, NO en esta carpeta de backup: - -### macOS Sequoia 15.7.3 Completo (si necesitas instalador offline): -``` -Ubicación: gibMacOS-master/macOS Downloads/publicrelease/089-70987/ -Archivo: InstallAssistant.pkg (15.66 GB) -Uso: Si necesitas instalador completo sin internet -``` - -### Herramientas Usadas: -- **TransMac**: Software comercial ($59, trial 15 días) - CRÍTICO para crear USB -- **gibMacOS**: Descargador de macOS desde servidores Apple -- **macrecovery.py**: Parte de OpenCore, descarga recovery -- **OpenCore**: v1.0.6 (incluido en carpeta EFI/) - ---- - -## ✅ CHECKLIST PRE-ARRANQUE - -Antes de arrancar en la PC de destino, verificar: - -- [ ] USB booteable creado con TransMac -- [ ] Carpeta EFI copiada correctamente (45 archivos) -- [ ] BIOS configurada (Fast Boot OFF, Secure Boot OFF, etc.) -- [ ] Disco de destino preparado (puede estar vacío) -- [ ] Conexión a internet disponible (para descarga durante instalación) -- [ ] Backup de datos importantes (si el disco tenía algo) - ---- - -## 📚 RECURSOS Y REFERENCIAS - -### Guías Oficiales: -- **Dortania OpenCore Install Guide**: https://dortania.github.io/OpenCore-Install-Guide/ -- **Config específico para Raptor Lake (13th Gen)**: https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html - -### EFI de Referencia: -- **Luchina Gabriel B760/13700K**: https://github.com/luchina-gabriel/ROG-STRIX-B760-I-GAMING-WIFI-13600K-RX6600XT -- Usamos esta configuración como base - -### Comunidad: -- **r/hackintosh**: Reddit -- **InsanelyMac**: Foros -- **TonyMacx86**: Tutoriales (controversial, pero útil) - ---- - -## 🐛 PROBLEMAS CONOCIDOS Y SOLUCIONES - -### WiFi Intel AX211 -- **Kext actual**: AirportItlwm.kext (Sonoma 14.4+) -- **Limitación**: Solo funciona en macOS Sonoma y superior -- **Alternativa**: Usar Ethernet o dongle USB WiFi compatible - -### iGPU Intel UHD 770 -- **Estado**: Deshabilitado en config por usar dGPU -- **Nota**: Si quieres usar headless iGPU para Quick Sync, necesita configuración adicional - -### Sleep/Wake -- **Estado**: No probado aún -- **Posibles problemas**: Requiere configuración de USB mapping y power management -- **Solución futura**: Crear USBMap.kext específico para esta motherboard - ---- - -## 📝 NOTAS IMPORTANTES - -1. **Seriales SMBIOS**: Los incluidos en el config.plist son válidos pero debes verificar que no estén en uso: - - Ir a: https://checkcoverage.apple.com/ - - Ingresar el serial: `C02ZCSZTHX87` - - Si dice "válido" o "en garantía" → Generar nuevos seriales - - Si dice "no encontrado" → Perfecto, puedes usarlos - -2. **Boot-args temporales**: Después de instalar macOS, QUITAR: - - `amfi_get_out_of_my_way=1` (solo para instalación) - - `-v` (opcional, pero útil mantener para debugging) - -3. **Actualización de OpenCore**: Cuando actualices: - - Siempre hacer backup del EFI funcionando - - Leer changelog de OpenCore - - Actualizar config.plist según sample.plist nuevo - -4. **Kexts desactualizados**: Los kexts incluidos son de Nov 2025. Verifica actualizaciones en: - - Lilu: https://github.com/acidanthera/Lilu/releases - - VirtualSMC: https://github.com/acidanthera/VirtualSMC/releases - - WhateverGreen: https://github.com/acidanthera/WhateverGreen/releases - - AppleALC: https://github.com/acidanthera/AppleALC/releases - ---- - -## 🎯 QUÉ FALTA HACER - -### Inmediato (en la PC de destino): -1. ✅ USB booteable creado -2. ⏳ Configurar BIOS -3. ⏳ Arrancar desde USB -4. ⏳ Instalar macOS Sequoia -5. ⏳ Copiar EFI al disco de instalación - -### Post-Instalación: -1. ⏳ Verificar funcionamiento de: - - [ ] GPU (RX 6800 XT) - - [ ] Ethernet (Intel I226-V) - - [ ] WiFi (AX211) - - [ ] Bluetooth - - [ ] Audio (ALC4080) - - [ ] USB (puertos funcionando) - - [ ] Sleep/Wake - -2. ⏳ Optimizar: - - [ ] Crear USB Map personalizado - - [ ] Ajustar power management - - [ ] Deshabilitar logs de OpenCore (si todo funciona) - - [ ] Quitar boot-args de debugging - -3. ⏳ Actualizar: - - [ ] Verificar nuevos seriales SMBIOS si es necesario - - [ ] Actualizar kexts a últimas versiones - - [ ] Considerar actualizar OpenCore si hay nueva versión estable - ---- - -## 🆘 SOPORTE Y AYUDA - -Si encuentras problemas: - -1. **OpenCore DEBUG**: Habilita debug en config.plist: - ```xml - Target - 67 - ``` - Los logs se guardarán en EFI/OC/Logs/ - -2. **Verbose Mode**: Los boot-args ya incluyen `-v` para ver el proceso de arranque - -3. **Comunidad**: - - Reddit r/hackintosh (muy útil) - - Discord de OpenCore - - GitHub Issues de los kexts específicos - ---- - -## 📦 BACKUP Y MANTENIMIENTO - -### Hacer backup del EFI funcionando: -```bash -# Desde macOS -sudo cp -R /Volumes/EFI/EFI ~/Desktop/EFI-Backup-$(date +%Y%m%d) -``` - -### Restaurar EFI desde backup: -```bash -# 1. Montar partición EFI -sudo diskutil mount disk0s1 - -# 2. Borrar EFI actual (CUIDADO!) -sudo rm -rf /Volumes/EFI/EFI - -# 3. Copiar backup -sudo cp -R ~/Desktop/EFI-Backup-YYYYMMDD /Volumes/EFI/EFI -``` - ---- - -## ✨ CRÉDITOS - -- **OpenCore Team**: Por el bootloader -- **Acidanthera**: Por los kexts (Lilu, WhateverGreen, etc.) -- **Dortania**: Por la guía completa -- **Luchina Gabriel**: Por el EFI de referencia B760/13700K -- **corpnewt**: Por gibMacOS y otras herramientas -- **Acute Angle Software**: Por TransMac - ---- - -## 📅 HISTORIAL DE CAMBIOS - -### 2026-02-05 - Initial Creation -- Creación del USB booteable con TransMac -- Configuración completa de OpenCore 1.0.6 -- SMBIOS generado para iMacPro1,1 -- Quirks optimizados para B760/13700K -- Kexts incluidos para todo el hardware - ---- - -**¡Buena suerte con la instalación!** 🍀 - -Si todo funciona, verás el instalador de macOS. El proceso puede tardar 30-60 minutos dependiendo de tu conexión a internet. diff --git a/hackintosh-guide/Hackintosh-Backup-Final/README.md b/hackintosh-guide/Hackintosh-Backup-Final/README.md deleted file mode 100755 index 59896d8..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/README.md +++ /dev/null @@ -1,191 +0,0 @@ -# 🍎 Guía Completa Hackintosh - ASUS ROG STRIX B760-I + i7-13700K + RX 6800 XT - -## 📋 Información del Sistema - -| Componente | Especificación | -|------------|----------------| -| **CPU** | Intel Core i7-13700K (13th Gen, Raptor Lake) | -| **Placa Madre** | ASUS ROG STRIX B760-I GAMING WIFI | -| **GPU** | AMD Radeon RX 6800 XT (Navi 21, 16GB) | -| **RAM** | 32GB DDR5 6400MHz Patriot (2x16GB) | -| **Almacenamiento** | Crucial P3 Plus 1TB NVMe SSD | -| **Ethernet** | Intel I226-V 2.5GbE | -| **Wi-Fi** | Intel AX211 (Wi-Fi 6E) | -| **Audio** | Realtek High Definition Audio | -| **BIOS** | AMI 1825 | - -## ✅ Estado de Compatibilidad - -| Componente | Compatibilidad | Notas | -|------------|----------------|-------| -| CPU | ✅ Compatible | Requiere CPU spoofing | -| GPU | ✅ Nativo | Soporte nativo macOS Big Sur+ | -| Ethernet | ✅ Compatible | AppleIGC.kext v1.6 | -| Wi-Fi | ✅ Compatible | itlwm/AirportItlwm | -| Bluetooth | ✅ Compatible | IntelBluetoothFirmware | -| Audio | ⚠️ Requiere config | AppleALC con layout-id | - ---- - -## 📁 Estructura de Archivos - -``` -hackintosh-guide/ -├── README.md (Esta guía) -├── 01-bios-settings.md (Configuración BIOS) -├── 02-create-installer.md (Crear USB instalador) -├── 03-efi-config.md (Configurar EFI) -├── 04-installation.md (Proceso de instalación) -├── 05-post-install.md (Post-instalación) -├── downloads.md (Links de descarga) -├── EFI/ -│ └── OC/ -│ ├── ACPI/ (SSDTs) -│ ├── Kexts/ (Drivers) -│ ├── Drivers/ (OpenCore drivers) -│ └── Tools/ (Haciend, etc.) -├── docs/ (Documentación adicional) -└── kexts-downloaded/ (Kexts descargados) -``` - ---- - -## 🔗 Índice de la Guía - -1. **[Configuración del BIOS](01-bios-settings.md)** - Configuraciones críticas -2. **[Crear USB Instalador](02-create-installer.md)** - Crear medio de instalación -3. **[Configuración EFI](03-efi-config.md)** - Configurar OpenCore -4. **[Instalación](04-installation.md)** - Instalar macOS -5. **[Post-Instalación](05-post-install.md)** - Configuraciones finales -6. **[Descargas](downloads.md)** - Links de descarga - ---- - -## 🎯 Resumen Rápido - Archivos Necesarios - -### Kexts Esenciales -| Kext | Versión | Propósito | -|------|---------|-----------| -| **Lilu.kext** | 1.6.8+ | Base para muchos parches | -| **VirtualSMC.kext** | 1.3.4+ | Emulación SMC | -| **WhateverGreen.kext** | 1.6.7+ | Soporte GPU AMD | -| **AppleIGC.kext** | 1.6 | Ethernet I226-V | -| **AirportItlwm.kext** | 2.3.0 | Wi-Fi Intel AX211 | -| **IntelBluetoothFirmware.kext** | 2.3.0+ | Bluetooth Intel | -| **IntelBTPatcher.kext** | 2.3.0+ | Parche Bluetooth | -| **AppleALC.kext** | 1.8.8+ | Audio Realtek | -| **VoodooPS2Controller.kext** | 2.3.0+ | Teclado/PS2 | -| **FeatureUnlock.kext** | 1.1.4+ | Desbloquear features | - -### OpenCore -- **OpenCore 0.9.7+** (última versión estable) -- **OCAuxiliaryTools** (editor config.plist) - -### Herramientas -- **Hackintool** - Configuración hardware -- **ProperTree** - Editor plist -- **GenSMBIOS** - Generar SMBIOS - ---- - -## ⚙️ Configuración BIOS Crítica - -### ASUS ROG STRIX B760-I - Configuraciones Requeridas - -| Opción | Valor | Ubicación | -|--------|-------|-----------| -| **Fast Boot** | DISABLE | Boot | -| **CFG Lock** | DISABLE | Advanced → CPU Configuration | -| **VT-d** | DISABLE | Advanced → CPU Configuration | -| **VT-x** | ENABLE | Advanced → CPU Configuration | -| **Above 4G Decoding** | ENABLE | Advanced → Chipset Configuration | -| **DVMT Pre-Allocated** | 64MB | Advanced → Chipset → Graphics | -| **CSM** | DISABLE | Boot | -| **Resizable BAR** | DISABLE | Advanced → Chipset | -| **SATA Mode** | AHCI | Advanced → PCH Storage | - ---- - -## 📦 Plan de Instalación - -### Paso 1: Configurar BIOS -Ver [01-bios-settings.md](01-bios-settings.md) - -### Paso 2: Crear USB Instalador -Ver [02-create-installer.md](02-create-installer.md) - -### Paso 3: Configurar EFI -Ver [03-efi-config.md](03-efi-config.md) - -### Paso 4: Instalar macOS -Ver [04-installation.md](04-installation.md) - -### Paso 5: Post-Instalación -Ver [05-post-install.md](05-post-install.md) - ---- - -## 🌐 Recursos y Fuentes - -### EFI de Referencia para B760 -- [hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) - EFI específico para esta placa -- [rosewu550/asus-strix-b760-i-hackintosh](https://github.com/rosewu550/asus-strix-b760-i-hackintosh) - Config con i9-13900F - -### Guías Generales -- [Dortania OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) - La biblia del Hackintosh -- [OpenCore Visual Beginners Guide](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/) - Guía visual -- [Dortania GPU Buyers Guide - AMD](https://dortania.github.io/GPU-Buyers-Guide/modern-gpus/amd-gpu.html) - -### Repositorios de Kexts -- [Acidanthera](https://github.com/acidanthera) - Kexts oficiales (Lilu, WhateverGreen, VirtualSMC, etc.) -- [OpenIntelWireless/itlwm](https://github.com/OpenIntelWireless/itlwm) - Wi-Fi Intel -- [OpenIntelWireless/IntelBluetoothFirmware](https://github.com/OpenIntelWireless/IntelBluetoothFirmware) - Bluetooth Intel -- [SongXiaoXi/AppleIGC](https://github.com/SongXiaoXi/AppleIGC) - Ethernet I225/I226 - -### Herramientas -- [OC-Gen-X](https://github.com/Pavo-IM/OC-Gen-X) - Generador de configuración OpenCore -- [OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) - Editor de config.plist - ---- - -## ⚠️ Advertencias Importantes - -1. **Respaldar todo** antes de comenzar -2. **NO actualizar BIOS** durante la instalación -3. **Seguir el orden** de la guía -4. **Solo descargar desde fuentes oficiales** (GitHub, Dortania) - ---- - -## 🆘 Soporte y Comunidad - -- [r/hackintosh Reddit](https://www.reddit.com/r/hackintosh/) -- [TonyMacx86 Forums](https://www.tonymacx86.com/) -- [InsanelyMac Forums](https://www.insanelymac.com/) - ---- - -## 📝 Notas Específicas para este Hardware - -### Intel i7-13700K (Raptor Lake) -- Requiere **CPU spoofing** a iMacPro1,1 o MacPro7,1 -- P-Cores/E-Cores necesitan configuración correcta -- No usar XMP profile si hay problemas de estabilidad - -### AMD RX 6800 XT -- **Soporte nativo** en macOS Big Sur y posteriores -- No requiere kexts especiales (WhateverGreen para patches) -- Disable ASAPU en config.plist si hay problemas - -### Intel I226-V Ethernet -- Usar **AppleIGC.kext v1.6** para Sequoia 15 -- Versions anteriores usar v1.4 o v1.5 - -### Intel AX211 Wi-Fi -- **AirportItlwm.kext** para interfaz nativa macOS -- **itlwm.kext** + Helios (app) como alternativa -- Bluetooth requiere 3 kexts: BlueTool, IntelBluetoothFirmware, IntelBTPatcher - ---- - -**Comienza con [01-bios-settings.md](01-bios-settings.md)** diff --git a/hackintosh-guide/Hackintosh-Backup-Final/downloads.md b/hackintosh-guide/Hackintosh-Backup-Final/downloads.md deleted file mode 100755 index 8f5a989..0000000 --- a/hackintosh-guide/Hackintosh-Backup-Final/downloads.md +++ /dev/null @@ -1,246 +0,0 @@ -# Descargas - Links y Archivos Necesarios - -## 📦 Archivos Esenciales - -### Bootloader - -| Archivo | Versión | Link | -|---------|---------|------| -| **OpenCore** | 0.9.7+ | [github.com/acidanthera/OpenCorePkg/releases](https://github.com/acidanthera/OpenCorePkg/releases) | -| **OCAuxiliaryTools** | Latest | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | -| **ProperTree** | Latest | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | -| **GenSMBIOS** | Latest | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | - -### Kexts Principales (Acidanthera) - -| Kext | Versión | Link | -|------|---------|------| -| **Lilu.kext** | 1.6.8+ | [github.com/acidanthera/Lilu/releases](https://github.com/acidanthera/Lilu/releases) | -| **VirtualSMC.kext** | 1.3.4+ | [github.com/acidanthera/VirtualSMC/releases](https://github.com/acidanthera/VirtualSMC/releases) | -| **WhateverGreen.kext** | 1.6.7+ | [github.com/acidanthera/WhateverGreen/releases](https://github.com/acidanthera/WhateverGreen/releases) | -| **AppleALC.kext** | 1.8.8+ | [github.com/acidanthera/AppleALC/releases](https://github.com/acidanthera/AppleALC/releases) | -| **VoodooPS2Controller.kext** | 2.3.0+ | [github.com/acidanthera/VoodooPS2Controller/releases](https://github.com/acidanthera/VoodooPS2Controller/releases) | -| **FeatureUnlock.kext** | 1.1.4+ | [github.com/acidanthera/FeatureUnlock/releases](https://github.com/acidanthera/FeatureUnlock/releases) | -| **SMCProcessor.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | -| **SMCSuperIO.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | - -### Kexts de Red - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **AppleIGC.kext** | 1.6 (Mar 2025) | [github.com/SongXiaoXi/AppleIGC/releases](https://github.com/SongXiaoXi/AppleIGC/releases) | Ethernet I225/I226-V 2.5GbE | -| **AirportItlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (interfaz nativa) | -| **itlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (con app Helios) | -| **IntelBluetoothFirmware.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth Intel | -| **IntelBTPatcher.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Parche Bluetooth Intel | -| **BlueTool.kext** | 2.3.0+ | [incluido en IntelBluetoothFirmware](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth | - -### Kexts Adicionales - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **BrcmPatchRAM3.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom (alternativa) | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmFirmwareData.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | - ---- - -## 🛠️ Herramientas - -### Configuración - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Hackintool** | [github.com/headkaze/Hackintool](https://github.com/headkaze/Hackintool) | Configuración completa de hardware | -| **OCAuxiliaryTools (OCT)** | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | Editor config.plist con GUI | -| **ProperTree** | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | Editor plist (cross-platform) | -| **GenSMBIOS** | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | Generar SMBIOS válido | -| **SSDTTime** | [github.com/corpnewt/SSDTTime](https://github.com/corpnewt/SSDTTime) | Generar SSDTs personalizados | -| **GenPMC** | [github.com/corpnewt/gen-pmc](https://github.com/corpnewt/gen-pmc) | Generar SSDT-PM | - -### Utilidades del Sistema - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | Monitoreo de sistema (menu bar) | -| **KextsViewer** | [github.com/corpnewt/KextsViewer](https://github.com/corpnewt/KextsViewer) | Ver kexts cargados | -| **Haciend** | [incluido en OpenCore](https://github.com/acidanthera/OpenCorePkg) | Consola interactiva OpenCore | -| **BetterDisplay** | [github.com/waydabber/BetterDisplay](https://github.com/waydabber/BetterDisplay) | Gestión de monitores | -| **MonitorControl** | [github.com/MonitorControl/MonitorControl](https://github.com/MonitorControl/MonitorControl) | Control de brillo DDC | - -### Creación de Instalador - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **OClter** | [github.com/chris1111/OClter](https://github.com/chris1111/OClter) | Crear USB instalador | -| **createinstallmedia** | (Incluido con macOS) | Método oficial de Apple | -| **BalenaEtcher** | [etcher.balena.io](https://etcher.balena.io) | Flashear USB (alternativa) | - ---- - -## 📚 Documentación - -### Guías Oficiales - -| Guía | Link | -|------|------| -| **Dortania OpenCore Install Guide** | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| **Dortania Post-Install Guide** | [dortania.github.io/OpenCore-Post-Install](https://dortania.github.io/OpenCore-Post-Install/) | -| **Dortania Troubleshooting** | [dortania.github.io/Troubleshooting](https://dortania.github.io/Troubleshooting/) | -| **Dortania GPU Buyers Guide** | [dortania.github.io/GPU-Buyers-Guide](https://dortania.github.io/GPU-Buyers-Guide/) | -| **Dortania USB Mapping** | [dortania.github.io/USB-Map-Guide](https://dortania.github.io/USB-Map-Guide/) | - -### Guías Visuales - -| Guía | Link | -|------|------| -| **OpenCore Visual Beginners Guide** | [chriswayg.gitbook.io/opencore-visual-beginners-guide](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/) | -| **Dortania Getting Started** | [dortania.github.io/Getting-Started-With-ACPI](https://dortania.github.io/Getting-Started-With-ACPI/) | - -### Específicos para tu Hardware - -| Recurso | Link | Hardware | -|---------|------|----------| -| **hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore** | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | ASUS ROG STRIX B760-I | -| **rosewu550/asus-strix-b760-i-hackintosh** | [github.com/rosewu550/asus-strix-b760-i-hackintosh](https://github.com/rosewu550/asus-strix-b760-i-hackintosh) | ASUS B760-I + i9-13900F | -| **chenhe/oc-b760m-13700-6800** | [github.com/ichenhe/oc-b760m-13700-6800](https://github.com/ichenhe/oc-b760m-13700-6800) | MSI B760M + i7-13700 + RX 6800 | -| **Base EFI Raptor Lake** | [github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC](https://github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC) | Intel 13th/14th Gen | - -### Comunidad - -| Sitio | Link | -|-------|------| -| **r/hackintosh** | [reddit.com/r/hackintosh](https://www.reddit.com/r/hackintosh/) | -| **TonyMacx86** | [tonymacx86.com](https://www.tonymacx86.com/) | -| **InsanelyMac** | [insanelymac.com](https://www.insanelymac.com/) | -| **Dortania Discord** | [discord.gg/AbTrsBq](https://discord.gg/AbTrsBq) | - ---- - -## 📱 Aplicaciones macOS Recomendadas - -### Productividad - -| App | Link | -|-----|------| -| **Rectangle** | [rectangleapp.com](https://rectangleapp.com/) | -| **AltTab** | [alt-tab-macos.netlify.app](https://alt-tab-macos.netlify.app/) | -| **Karabiner-Elements** | [karabiner-elements.pqrs.org](https://karabiner-elements.pqrs.org/) | -| **BetterTouchTool** | [boastr.net](https://boastr.net/) | - -### Monitoreo - -| App | Link | -|-----|------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | -| **iStat Menus** | [bjango.com/mac/istatmenus](https://bjango.com/mac/istatmenus/) | -| **Activity Monitor** | (Incluido con macOS) | - -### Backups - -| App | Link | -|-----|------| -| **Time Machine** | (Incluido con macOS) | -| **Carbon Copy Cloner** | [bombich.com](https://bombich.com/) | -| **SuperDuper!** | [shirt-pocket.com](https://shirt-pocket.com/) | - -### Utilidades - -| App | Link | -|-----|------| -| **The Unarchiver** | [macpaw.com/the-unarchiver](https://macpaw.com/the-unarchiver) | -| **Amphetamine** | [macpaw.com/amphetamine](https://macpaw.com/amphetamine) | -| **HandBrake** | [handbrake.fr](https://handbrake.fr/) | -| **VLC** | [videolan.org/vlc](https://www.videolan.org/vlc/) | - ---- - -## 🔧 Scripts Útiles - -### Descargar y Usar GenSMBIOS - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/GenSMBIOS.git -cd GenSMBIOS - -# Ejecutar -python3 gensmbios.py - -# Seguir instrucciones -``` - -### Descargar y Usar SSDTTime - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/SSDTTime.git -cd SSDTime - -# Dar permisos -chmod +x SSDTTime.sh - -# Ejecutar -./SSDTTime.sh -``` - -### Descargar Hackintool - -```bash -# Descargar desde releases -# o usar Homebrew (si está instalado) -brew install --cask hackintool -``` - ---- - -## 📝 Notas de Versiones - -### OpenCore -- **Versión actual estable**: 0.9.7 -- **Rama de desarrollo**: 0.9.8+ (experimental) -- **Recomendación**: Usar siempre versión estable - -### macOS (2026) -- **Última versión**: macOS Sequoia 15.x -- **Soporte**: macOS Sequoia, Sonoma 14.x, Ventura 13.x -- **Recomendación**: Sequoia 15.x para hardware más nuevo - -### Kexts -- Actualizar **Lilu** primero (es la base de muchos kexts) -- **WhateverGreen** se actualiza frecuentemente para nuevas GPUs -- **AppleIGC** tiene actualizaciones específicas para Sequoia - ---- - -## ⚠️ Fuentes Confiables - -**SIEMPRE descargar desde**: -- **GitHub releases** (proyectos oficiales) -- **Dortania guides** (documentación verificada) -- **Acidanthera** (kexts oficiales) - -**NUNCA descargar desde**: -- Sitios de dudosa reputación -- Foros con archivos adjuntos -- YouTube sin verificar fuente - ---- - -## 📋 Orden de Descarga Recomendado - -1. **OpenCore** (bootloader) -2. **Lilu** (base kext) -3. **VirtualSMC** + plugins -4. **WhateverGreen** (GPU) -5. **AppleALC** (audio) -6. **AppleIGC** (Ethernet) -7. **AirportItlwm** + **IntelBluetoothFirmware** (Wi-Fi/Bluetooth) -8. **VoodooPS2Controller** (teclado/PS2) -9. **OCAuxiliaryTools** (editor config.plist) -10. **GenSMBIOS** (generar SMBIOS) - ---- - -**Volver a [README.md](README.md)** diff --git a/hackintosh-guide/QUICKSTART.md b/hackintosh-guide/QUICKSTART.md deleted file mode 100755 index f160316..0000000 --- a/hackintosh-guide/QUICKSTART.md +++ /dev/null @@ -1,203 +0,0 @@ -# Hackintosh Quick Start - ASUS ROG STRIX B760-I - -## 🎯 Tu Hardware - -``` -CPU: Intel i7-13700K (Raptor Lake, 16 cores) -MB: ASUS ROG STRIX B760-I GAMING WIFI -GPU: AMD Radeon RX 6800 XT (16GB) -RAM: 32GB DDR5 6400MHz -SSD: Crucial P3 Plus 1TB NVMe -Ethernet Intel I226-V 2.5GbE -Wi-Fi: Intel AX211 (Wi-Fi 6E) -Audio: Realtek HDA -``` - ---- - -## ⚡ 3 Pasos Rápidos - -### 1️⃣ Configurar BIOS (5 min) - -| Opción | Valor | -|--------|-------| -| Fast Boot | DISABLE | -| CFG Lock | DISABLE | -| VT-d | DISABLE | -| VT-x | ENABLE | -| Above 4G Decoding | ENABLE | -| DVMT Pre-Allocated | 64MB | -| CSM | DISABLE | -| Secure Boot | Other OS | -| SATA Mode | AHCI | -| Resizable BAR | DISABLE | - -### 2️⃣ Crear USB (30 min) - -```bash -# En Mac -# 1. Conectar USB 16GB+ -# 2. Formatear: HFS+, GUID -# 3. Crear instalador -sudo /Applications/Install\ macOS\ Sequoia.app/Contents/Resources/createinstallmedia \ - --volume /Volumes/MyVolume --nointeraction - -# 4. Copiar EFI al USB -# 5. Configurar config.plist -``` - -### 3️⃣ Instalar (45 min) - -1. Arrancar desde USB (F8) -2. Seleccionar "macOS Installer" -3. Disk Utility → Borrar disco (APFS, GUID) -4. Instalar macOS -5. Completar configuración - ---- - -## 📦 Kexts Necesarios - -``` -EFI/OC/Kexts/ -├── Lilu.kxt ⭐ BASE -├── VirtualSMC.kxt ⭐ SMC -├── WhateverGreen.kxt ⭐ GPU -├── AppleALC.kxt ⭐ Audio -├── AppleIGC.kxt ⭐ Ethernet -├── AirportItlwm.kxt ⭐ Wi-Fi -├── IntelBluetoothFirmware.kxt ⭐ BT -├── IntelBTPatcher.kxt ⭐ BT -├── FeatureUnlock.kxt -├── VoodooPS2Controller.kxt -├── SMCProcessor.kxt -└── SMCSuperIO.kxt -``` - ---- - -## ⚙️ config.plist Clave - -### SMBIOS -```xml -SystemProductName: iMacPro1,1 -SystemSerialNumber: GENERAR -SystemUUID: GENERAR -MLB: GENERAR -``` - -### Kernel Emulate (Raptor Lake) -```xml -Cpuid1Data: NxcB/V/QwMA= -Cpuid1Mask: //// -DummyPowerManagement: false -``` - -### Kernel Quirks -```xml -DisableIoMapper: true -AppleCpuPmCfgLock: false -AppleXcpmCfgLock: false -``` - -### ACPI Add -``` -SSDT-EC.aml ⭐ FAKE EC -SSDT-PLUG.aml ⭐ PLUG TYPE -``` - ---- - -## 🔧 Comandos Útiles - -### Verificar Kexts -```bash -kextstat | grep Lilu -kextstat | grep WhateverGreen -kextstat | grep AppleALC -``` - -### Verificar GPU -```bash -metalinfo -system_profiler SPDisplaysDataType -``` - -### Verificar Red -```bash -networksetup -listallhardwareports -ifconfig -``` - -### Verificar Audio -```bash -kextstat | grep AppleALC -system_profiler SPAudioDataType -``` - ---- - -## 🐛 Problemas Comunes - -| Problema | Solución | -|----------|----------| -| Kernel Panic | CFG Lock en BIOS o config.plist | -| Pantalla negra | agdpmod=pikera boot-arg | -| No Ethernet | AppleIGC.kext + Network Stack ON | -| No Wi-Fi | AirportItlwm.kext v2.3.0 | -| No Audio | Probar layout-id 7, 11, 13, 28 | -| Reinicios loop | Deshabilitar XMP | -| No PM | SSDT-PLUG + DummyPM=false | - ---- - -## 📱 Layout ID Audio - -| ID | Uso | -|----|-----| -| 1 | Stereo básico | -| 3 | Speaker + Line Out | -| 7 | Realtek (más común) | -| 11 | ALC897/1220 | -| 13 | ALC1220 | -| 28 | 5.1 Surround | -| 99 | Built-in + HP | - ---- - -## 🌐 Enlaces Rápidos - -| Recurso | Link | -|---------|------| -| OpenCore | [github.com/acidanthera/OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) | -| Dortania Guide | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| Kexts Acidanthera | [github.com/acidanthera](https://github.com/acidanthera) | -| AppleIGC (Ethernet) | [github.com/SongXiaoXi/AppleIGC](https://github.com/SongXiaoXi/AppleIGC) | -| itlwm (Wi-Fi) | [github.com/OpenIntelWireless/itlwm](https://github.com/OpenIntelWireless/itlwm) | -| B760 EFI Ref | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | - ---- - -## 📋 Checklist Final - -``` -[ ] BIOS configurado -[ ] USB instalador creado -[ ] EFI/OC configurado -[ ] config.plist validado -[ ] Kexts copiados -[ ] SSDTs agregados -[ ] Arranca desde USB -[ ] macOS instalado -[ ] EFI copiado al disco -[ ] Arranca sin USB -[ ] Ethernet funciona -[ ] Wi-Fi funciona -[ ] Audio funciona -[ ] GPU acelerada -[ ] PM configurado -``` - ---- - -**Para guía completa: Ver [README.md](README.md)** diff --git a/hackintosh-guide/README.md b/hackintosh-guide/README.md deleted file mode 100755 index 59896d8..0000000 --- a/hackintosh-guide/README.md +++ /dev/null @@ -1,191 +0,0 @@ -# 🍎 Guía Completa Hackintosh - ASUS ROG STRIX B760-I + i7-13700K + RX 6800 XT - -## 📋 Información del Sistema - -| Componente | Especificación | -|------------|----------------| -| **CPU** | Intel Core i7-13700K (13th Gen, Raptor Lake) | -| **Placa Madre** | ASUS ROG STRIX B760-I GAMING WIFI | -| **GPU** | AMD Radeon RX 6800 XT (Navi 21, 16GB) | -| **RAM** | 32GB DDR5 6400MHz Patriot (2x16GB) | -| **Almacenamiento** | Crucial P3 Plus 1TB NVMe SSD | -| **Ethernet** | Intel I226-V 2.5GbE | -| **Wi-Fi** | Intel AX211 (Wi-Fi 6E) | -| **Audio** | Realtek High Definition Audio | -| **BIOS** | AMI 1825 | - -## ✅ Estado de Compatibilidad - -| Componente | Compatibilidad | Notas | -|------------|----------------|-------| -| CPU | ✅ Compatible | Requiere CPU spoofing | -| GPU | ✅ Nativo | Soporte nativo macOS Big Sur+ | -| Ethernet | ✅ Compatible | AppleIGC.kext v1.6 | -| Wi-Fi | ✅ Compatible | itlwm/AirportItlwm | -| Bluetooth | ✅ Compatible | IntelBluetoothFirmware | -| Audio | ⚠️ Requiere config | AppleALC con layout-id | - ---- - -## 📁 Estructura de Archivos - -``` -hackintosh-guide/ -├── README.md (Esta guía) -├── 01-bios-settings.md (Configuración BIOS) -├── 02-create-installer.md (Crear USB instalador) -├── 03-efi-config.md (Configurar EFI) -├── 04-installation.md (Proceso de instalación) -├── 05-post-install.md (Post-instalación) -├── downloads.md (Links de descarga) -├── EFI/ -│ └── OC/ -│ ├── ACPI/ (SSDTs) -│ ├── Kexts/ (Drivers) -│ ├── Drivers/ (OpenCore drivers) -│ └── Tools/ (Haciend, etc.) -├── docs/ (Documentación adicional) -└── kexts-downloaded/ (Kexts descargados) -``` - ---- - -## 🔗 Índice de la Guía - -1. **[Configuración del BIOS](01-bios-settings.md)** - Configuraciones críticas -2. **[Crear USB Instalador](02-create-installer.md)** - Crear medio de instalación -3. **[Configuración EFI](03-efi-config.md)** - Configurar OpenCore -4. **[Instalación](04-installation.md)** - Instalar macOS -5. **[Post-Instalación](05-post-install.md)** - Configuraciones finales -6. **[Descargas](downloads.md)** - Links de descarga - ---- - -## 🎯 Resumen Rápido - Archivos Necesarios - -### Kexts Esenciales -| Kext | Versión | Propósito | -|------|---------|-----------| -| **Lilu.kext** | 1.6.8+ | Base para muchos parches | -| **VirtualSMC.kext** | 1.3.4+ | Emulación SMC | -| **WhateverGreen.kext** | 1.6.7+ | Soporte GPU AMD | -| **AppleIGC.kext** | 1.6 | Ethernet I226-V | -| **AirportItlwm.kext** | 2.3.0 | Wi-Fi Intel AX211 | -| **IntelBluetoothFirmware.kext** | 2.3.0+ | Bluetooth Intel | -| **IntelBTPatcher.kext** | 2.3.0+ | Parche Bluetooth | -| **AppleALC.kext** | 1.8.8+ | Audio Realtek | -| **VoodooPS2Controller.kext** | 2.3.0+ | Teclado/PS2 | -| **FeatureUnlock.kext** | 1.1.4+ | Desbloquear features | - -### OpenCore -- **OpenCore 0.9.7+** (última versión estable) -- **OCAuxiliaryTools** (editor config.plist) - -### Herramientas -- **Hackintool** - Configuración hardware -- **ProperTree** - Editor plist -- **GenSMBIOS** - Generar SMBIOS - ---- - -## ⚙️ Configuración BIOS Crítica - -### ASUS ROG STRIX B760-I - Configuraciones Requeridas - -| Opción | Valor | Ubicación | -|--------|-------|-----------| -| **Fast Boot** | DISABLE | Boot | -| **CFG Lock** | DISABLE | Advanced → CPU Configuration | -| **VT-d** | DISABLE | Advanced → CPU Configuration | -| **VT-x** | ENABLE | Advanced → CPU Configuration | -| **Above 4G Decoding** | ENABLE | Advanced → Chipset Configuration | -| **DVMT Pre-Allocated** | 64MB | Advanced → Chipset → Graphics | -| **CSM** | DISABLE | Boot | -| **Resizable BAR** | DISABLE | Advanced → Chipset | -| **SATA Mode** | AHCI | Advanced → PCH Storage | - ---- - -## 📦 Plan de Instalación - -### Paso 1: Configurar BIOS -Ver [01-bios-settings.md](01-bios-settings.md) - -### Paso 2: Crear USB Instalador -Ver [02-create-installer.md](02-create-installer.md) - -### Paso 3: Configurar EFI -Ver [03-efi-config.md](03-efi-config.md) - -### Paso 4: Instalar macOS -Ver [04-installation.md](04-installation.md) - -### Paso 5: Post-Instalación -Ver [05-post-install.md](05-post-install.md) - ---- - -## 🌐 Recursos y Fuentes - -### EFI de Referencia para B760 -- [hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) - EFI específico para esta placa -- [rosewu550/asus-strix-b760-i-hackintosh](https://github.com/rosewu550/asus-strix-b760-i-hackintosh) - Config con i9-13900F - -### Guías Generales -- [Dortania OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) - La biblia del Hackintosh -- [OpenCore Visual Beginners Guide](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/) - Guía visual -- [Dortania GPU Buyers Guide - AMD](https://dortania.github.io/GPU-Buyers-Guide/modern-gpus/amd-gpu.html) - -### Repositorios de Kexts -- [Acidanthera](https://github.com/acidanthera) - Kexts oficiales (Lilu, WhateverGreen, VirtualSMC, etc.) -- [OpenIntelWireless/itlwm](https://github.com/OpenIntelWireless/itlwm) - Wi-Fi Intel -- [OpenIntelWireless/IntelBluetoothFirmware](https://github.com/OpenIntelWireless/IntelBluetoothFirmware) - Bluetooth Intel -- [SongXiaoXi/AppleIGC](https://github.com/SongXiaoXi/AppleIGC) - Ethernet I225/I226 - -### Herramientas -- [OC-Gen-X](https://github.com/Pavo-IM/OC-Gen-X) - Generador de configuración OpenCore -- [OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) - Editor de config.plist - ---- - -## ⚠️ Advertencias Importantes - -1. **Respaldar todo** antes de comenzar -2. **NO actualizar BIOS** durante la instalación -3. **Seguir el orden** de la guía -4. **Solo descargar desde fuentes oficiales** (GitHub, Dortania) - ---- - -## 🆘 Soporte y Comunidad - -- [r/hackintosh Reddit](https://www.reddit.com/r/hackintosh/) -- [TonyMacx86 Forums](https://www.tonymacx86.com/) -- [InsanelyMac Forums](https://www.insanelymac.com/) - ---- - -## 📝 Notas Específicas para este Hardware - -### Intel i7-13700K (Raptor Lake) -- Requiere **CPU spoofing** a iMacPro1,1 o MacPro7,1 -- P-Cores/E-Cores necesitan configuración correcta -- No usar XMP profile si hay problemas de estabilidad - -### AMD RX 6800 XT -- **Soporte nativo** en macOS Big Sur y posteriores -- No requiere kexts especiales (WhateverGreen para patches) -- Disable ASAPU en config.plist si hay problemas - -### Intel I226-V Ethernet -- Usar **AppleIGC.kext v1.6** para Sequoia 15 -- Versions anteriores usar v1.4 o v1.5 - -### Intel AX211 Wi-Fi -- **AirportItlwm.kext** para interfaz nativa macOS -- **itlwm.kext** + Helios (app) como alternativa -- Bluetooth requiere 3 kexts: BlueTool, IntelBluetoothFirmware, IntelBTPatcher - ---- - -**Comienza con [01-bios-settings.md](01-bios-settings.md)** diff --git a/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.md b/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.md deleted file mode 100755 index 697cd5e..0000000 --- a/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.md +++ /dev/null @@ -1,82 +0,0 @@ -## ROG STRIX B760-I GAMING WiFi Hackintosh OpenCore EFI - -![image](ScreenShot/ROGB760I.png) - -### [简体中文](README.zh_CN.md) - -### OpenCore - -[OpenCore 1.0.4](https://github.com/acidanthera/OpenCorePkg) - -### OS Version Tested - -- macOS Monterey 12.x -- macOS Ventura 13.x -- macOS Sonoma 14.x -- macOS Sequoia 15.x - -### Hardware - -- Motherboard: ROG STRIX B760-I GAMING WiFi -- Bios Version:1003（2023/04/20） -- CPU: Intel i5-13600k -- RAM: KINGBANK 16GB*2 DDR5 6800MHz -- SSD: 1.WD SN770 512G MacOS -- SSD: 2.WD SN770 512G Windows -- iGPU: Intel UHD Graphic 730 (Only work in Windows) -- GPU: yeston Radeon RX6600 -- Audio:ROG SupremeFX 7.1-Channel High Definition Audio CODEC S1220A -- Ethernet Card: Intel® 2.5Gb Ethernet -- Ethernet Card: UGREEN USB LAN （RTL8156） -- WiFi Card: BCM94360CS2 -- CPU Cooling: AXP 120 X67 With PHANTEKS T30 -- PSU: TT thermaltake Toughpower GF1 650W -- Case: NZXT H1 - -### Notes - - - Use [OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) build your SMBIOS - - If you want to use a CPU without Efficient-Core, you must uncheck the option in the config.plist file Kernel--ProvideCurrentCpuinfo - -### Bios Setup - -``` -Advanced - - |-- UEFI Variables Protection - |-- password protection of Runtime Variables ：Disabled - - |-- System Agent(SA)Configuration - |-- VT-D ：Enabled - |-- Control Iommu Pre-boot Behavior ：Disable IOMMU - - |--PCI Subsystem Settings - |-- Above 4G Decoding ：Enabled - |-- Resize BAR Support ：Disabled - |-- SR-IOV Support ：Disabled - -Boot - - |-- Secure Boot - |-- OS Type ：Other OS - |-- Secure Boot Mode ：Custom - - |-- Boot Configuration - |-- Fast Boot ：Disabled - - |-- CSM (Compatibility Support Module) - |-- Launch CSM ：Disabled -``` - -### Contact UsScreenShot - - - Geekbench5 & Cinebench R20 - -![image](ScreenShot/geekbenchR20.jpg) - - -### Contact Us - - - QQ Group: 23304408 - -![image](ScreenShot/QRCode.png) \ No newline at end of file diff --git a/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.zh_CN.md b/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.zh_CN.md deleted file mode 100755 index 712740b..0000000 --- a/hackintosh-guide/ROG-STRIX-B760-I-GAMING-OpenCore-main/README.zh_CN.md +++ /dev/null @@ -1,83 +0,0 @@ -## ROG STRIX B760-I GAMING WiFi Hackintosh OpenCore EFI - -![image](ScreenShot/ROGB760I.png) - -### [English](https://github.com/hackintosh-efi/ROG-STRIX-B760-I-GAMING-OpenCore) - -### OpenCore - -[OpenCore 1.0.4](https://github.com/acidanthera/OpenCorePkg) - -### 支持的系统版本 - -- macOS Monterey 12.x -- macOS Ventura 13.x -- macOS Sonoma 14.x -- macOS Sequoia 15.x - -### 硬件 - -- 主板 ROG STRIX B760-I GAMING WiFi -- Bios版本:1003（2023/04/20） -- CPU: Intel i5-13600k -- 内存: KINGBANK 16GB*2 DDR5 6800MHz -- 固态硬盘: 1.WD SN770 512G MacOS -- 固态硬盘: 2.WD SN770 512G Windows -- 核显: Intel UHD Graphic 730 (仅在Windows中使用) -- 独显: 盈通 Radeon RX6600 -- 声卡:ROG SupremeFX 7.1-Channel High Definition Audio CODEC S1220A -- 网卡: Intel® 2.5Gb Ethernet -- 网卡: 绿联 USB LAN （RTL8156） -- 无线网卡: BCM94360CS2 -- CPU散热器: AXP 120 X67 With PHANTEKS T30 -- 电源: TT thermaltake Toughpower GF1 650W -- 机箱: NZXT H1 - -### 注意事项 - - - 安装成功后必须使用 [OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) 生成你自己的 SMBIOS - - 如需使用没有小核心的CPU，必须取消勾选配置文件中Kernel--ProvideCurrentCpuinfo选项 - -### Bios Setup - -``` -dvanced - - |-- UEFI Variables Protection - |-- password protection of Runtime Variables ：Disabled - - |-- System Agent(SA)Configuration - |-- VT-D ：Enabled - |-- Control Iommu Pre-boot Behavior ：Disable IOMMU - - |--PCI Subsystem Settings - |-- Above 4G Decoding ：Enabled - |-- Resize BAR Support ：Disabled - |-- SR-IOV Support ：Disabled - -Boot - - |-- Secure Boot - |-- OS Type ：Other OS - |-- Secure Boot Mode ：Custom - - |-- Boot Configuration - |-- Fast Boot ：Disabled - - |-- CSM (Compatibility Support Module) - |-- Launch CSM ：Disabled -``` - - -### 系统截图 - - - Geekbench5 & Cinebench R20 - -![image](ScreenShot/geekbenchR20.jpg) - - -### 联系我们 - - - QQ群: 23304408 - -![image](ScreenShot/QRCode.png) \ No newline at end of file diff --git a/hackintosh-guide/Utilities/EnableGop/README.md b/hackintosh-guide/Utilities/EnableGop/README.md deleted file mode 100755 index f997635..0000000 --- a/hackintosh-guide/Utilities/EnableGop/README.md +++ /dev/null @@ -1,184 +0,0 @@ -# Provides standalone GOP driver for EFI era Mac Pro and iMac - -## Releases - -EnableGop version (OpenCore version) - -### 1.4 (0.9.3) - - Incorporates recent updates to OpenCore console control code, but no difference in behaviour compared - to version 1.3 is expected on any supported systems. - -### 1.3 (0.9.2) - - Included fix to GopBurstMode for non-standard frame buffer information on AMD Radeon HD 7970 and similar - - Applied GopBurstMode even on natively supported cards, as it can provide a noticable speed up - -### 1.2 (0.9.1) - - Added GopBurstMode support - -*Note 1*: This should provide faster GOP rendering on all EnableGopDirect systems; and rendering at least at -the same speed as before, and on some systems noticeably faster than before, on almost all EnableGop systems. - -*Note 2*: The compressed driver for version 1.2 is 1KB larger than for version 1.1, so for AMD GPU firmware which is -tight on space version 1.1 may be used instead to avoid the need for VGA stripping to make additional space. - -### 1.1 (0.9.0) - - Fixed early verbose boot lines appearing over picker - - Added EnableGop version number to UI section - -### 1.0 (0.8.9) - - Initial public release - -## Status -**Current status: Beta release.** - -This driver has been tested and is working on several iMac models -with several different GPUs, and on several MacPro4,1/5,1 machines with several different GPUs. However, in the worst -case (and still possible) scenario, an incompatible or incorrectly installed driver -in firmware may brick your hardware. - -*In all cases take a backup of the main firmware or GPU firmware which you are modifying, and confirm that -you can successfully restore from this, before starting.* - -## Recovery from bricked hardware - - If attempting main firmware insertion on a MacPro4,1/5,1, for recovery from a bricked device you will either -need a Matt card (which may breach intellectual property laws in some jurisdictions) or the ability to -desolder and reprogram your own SPI flash chip. - - If testing via main firmware insertion on an iMac, you will need the ability to disassemble your iMac and -reprogram its SPI flash chip using a SOIC clip attached to a CH341A controller running on another computer. - - If testing via GPU firmware insertion (iMac or Mac Pro), you will need the ability to disassemble your system, -likely remove the heat sink from the graphics card, and then reprogram its SPI flash chip using a SOIC -clip attached to a CH341A controller running on another computer. - - If testing via GPU firmware insertion, in some cases it may also be possible -to use physical electrical connection to your GPU in order to enable booting with no graphics even though the GPU -is present, then connect to your machine with `ssh` (which must have been enabled beforehand) and reprogram the GPU -firmware. Advice on this headless boot approach is not provided here, but may be found for instance on the iMac GPU -related forum threads listed below. - -*If you are not familiar with the above procedures, you are strongly recommended to wait for further testing by -users who are. No further help can be provided here, and you proceed entirely at your own risk.* - -## Summary -Targetting EFI-era (~2009-2012) MacPro4,1/5,1 and iMac firmware, this driver gathers and injects the parts of -OpenCore needed for pre-boot graphics support with non-natively supported GPUs. - -The requirements for using this driver are: - - - EFI-era (~2009-2012) MacPro4,1/5,1 or iMac with most recent main firmware. - - A GPU which does not produce native pre-boot graphics (such as native picker when pressing ALT key during boot) - before OpenCore starts (otherwise, you do not need it). - - A GPU which produces graphics when using OpenCore (this must include successfully showing the native Apple boot - picker when started via the latest version of OpenCore tool `BootKicker.efi`) (otherwise, the driver will not work). - - *Note*: If your OpenCore installation includes a required GOP driver for your graphics card, then you would - also need to burn that driver to the firmware of your graphics card in order to obtain pre-OpenCore graphics; - instructions for this are outside the scope of this tutorial, although the procedures required for modifying - GPU firmware are similar to what is covered here. - Note that such a driver is added by the OCLP **Enable AMD GOP** option, which is enabled automatically on some - systems by recent versions of OpenCore Legacy Patcher, as a way to enable the OpenCore menu in cards such as ex-mining GPUs. - -When installed, the driver should enable: - - - Native boot picker via ALT key - - Firmware password UI - - Target disk mode UI - - macOS boot progress screen - - etc. - -Compiled versions of the driver files and these instructions may be found in the `Utilities/EnableGop` -directory of the OpenCore release package. - -For GPUs needing `DirectGopRendering` in OpenCore configuration, use `EnableGopDirect.efi`, otherwise use `EnableGop.efi` -as it renders faster on most other systems. - -The driver may be installed to GPU or main motherboard firmware. It is expected that most Mac Pro users will use main firmware insertion -and most iMac users will chose GPU firmware insertion, however both techniques work on both systems (but it is harder to modify the -iMac main firmware, since there is no simple way to enable writing to it). - -Further discussion and community support for this driver is available at: - - - https://forums.macrumors.com/threads/pre-opencore-gop-support-for-efi-era-imacs-and-mac-pros.2378942/ - -## Usage - -## Install to main firmware - -For reading and writing to main firmware on the Mac Pro, @Macschrauber's [Rom Dump](https://github.com/Macschrauber/Macschrauber-s-Rom-Dump) works -well. Alternatively the kexts and executables which this uses can be sourced individually (or extracted from the Rom Dump app) and -run from the command line. - -The main firmware on the iMac cannot be updated without an initial hardware flash (SOIC clip plus CH341A controller), therefore -the recommended approach on iMac systems is [GPU firmware injection](#install-to-gpu-firmware). However, the below instructions for firmware -injection do work, if you are willing to do a hardware flash of the resulting firmware file, or if you have already -[unprotected your iMac firmware](https://forums.macrumors.com/threads/imac-2011-see-more-uefi-firmware-mod.2257435/page-3?post=31087001#post-31087001) - -which reduces security, and is only recommended for those actively developing firmware modifications. - -The `.ffs` file provided in this directory can be manually added to the extracted firmware file using [`UEFITool`](https://github.com/LongSoft/UEFITool), -or automatically added using @dosdude1's [`DXEInject`](https://dosdude1.com/apps/). Once more, if you are not familiar with these procedures, -you are recommended to proceed with extreme caution. - -### Using DXEInject - -To install the driver via `DXEInject`, the command is: - - - `DXEInject {original}.rom {modified}.rom EnableGop.ffs` - -The file `{modifed}.rom` is ready for burning, although the result can be checked using UEFITool, if required. - -> *Note*: If only reading a file with UEFITool, the latest version is recommended, as it provides the most information. -For writing, the older version 0.25.1 must be used, as described below. - -### Using UEFITool - -The `.ffs` file may be inserted anywhere within the same firmware volume which contains `DuetBds` -(file GUID `A6F691AC-31C8-4444-854C-E2C1A6950F92`). However, for simplicity, these instructions -will insert it in the same place that `DXEInject` does: - - - Use UEFITool 0.25.1 (it must be that old version, not the newer NE or new engine versions, which -cannot yet edit) - - Perform a header-only GUID search for `BAE7599F-3C6B-43B7-BDF0-9CE07AA91AA6` - - Double-click on the search result - - Right-click on the DXE driver with that GUID which should then appear - - Choose "Insert after..." and select `EnableGop.ffs` - - Save the modified firmware - -The end result, after saving and re-loading, should look like this: - - - -## Install to GPU firmware - -Instructions and a script for inserting the driver into Nvidia or AMD GPU firmware (aka VBIOS) are provided. - -Please note all the cautions already given above about the difficulty of recovering, unless you are familiar with -the procedures necessary, if this process fails. - -To use the provided `vBiosInsert.sh` script: - - - Locate an appropriate version of the `nvflash` tool (Nvidia) or `amdvbflash` tool (AMD) (both are available for - Linux and Windows), which can be used to read from and write to the GPU firmware. - - Use that tool to read a copy of the GPU firmware. - - Run `./vBiosInsert.sh [-a|-n] {original}.rom EnableGop.efi {modified}.rom`, with `-a` for AMD and `-n` for Nvidia. - - If you have any problems with `vBiosInsert.sh` from a specific release - of EnableGop, please try the version included with the latest release of OpenCore - before reporting any issues. - The script receives updates to support additional graphics cards independently - of any bumps to the release version of EnableGop. If you need to, you can use - the latest version of `vBiosInsert.sh` to inject older versions of EnableGop. - - The new file `{modified}.rom` may be burnt to the GPU firmware. - -In the case of AMD, considerably less space is normally available, due to a strict limit of 128k for legacy and EFI -parts of the larger ROM image. If there is not enough space (i.e. script reports -data would be truncated) then it is necessary to [strip some legacy VGA parts of the -GPU firmware](https://github.com/Ausdauersportler/IMAC-EFI-BOOT-SCREEN/wiki/Deleting-the-VGA). This is beyond the scope -of these instructions. - -If required to manually detect the GOP offset (this should normally be autodetected): - -> Using a hex editor, search in the GPU firmware dump for the byte sequence `F1 0E 00 00` with the byte sequence `55 AA` coming - close before it; the start address of the `55 AA` is the GOP offset value needed. - -For further information on GPU firmware modification, see: - - - https://forums.macrumors.com/threads/2011-imac-graphics-card-upgrade.1596614/ - - https://forums.macrumors.com/threads/imac-2011-maxwell-and-pascal-gpu-upgrade.2300989/ - - https://github.com/Ausdauersportler/IMAC-EFI-BOOT-SCREEN/wiki - - https://winraid.level1techs.com/t/amd-and-nvidia-gop-update-no-requests-diy/30917 diff --git a/hackintosh-guide/Utilities/FindSerialPort/README.md b/hackintosh-guide/Utilities/FindSerialPort/README.md deleted file mode 100755 index df36949..0000000 --- a/hackintosh-guide/Utilities/FindSerialPort/README.md +++ /dev/null @@ -1,4 +0,0 @@ -FindSerialPort -================ - -This script finds PCIe serial ports and outputs their paths. Thanks [joevt](https://github.com/joevt) for writing it. diff --git a/hackintosh-guide/Utilities/LegacyBoot/README.md b/hackintosh-guide/Utilities/LegacyBoot/README.md deleted file mode 100755 index ee7aac5..0000000 --- a/hackintosh-guide/Utilities/LegacyBoot/README.md +++ /dev/null @@ -1,7 +0,0 @@ -BootInstall -=========== - -This tool installs legacy DuetPkg environment on GPT-formatted disk -to enable UEFI environment on BIOS-based systems. - -Source code: https://github.com/acidanthera/DuetPkg diff --git a/hackintosh-guide/Utilities/LogoutHook/README.md b/hackintosh-guide/Utilities/LogoutHook/README.md deleted file mode 100755 index 119c140..0000000 --- a/hackintosh-guide/Utilities/LogoutHook/README.md +++ /dev/null @@ -1,17 +0,0 @@ -# LogoutHook - -## Script - -### Usage -```./Launchd.command``` - -### Installation -```./Launchd.command install``` - -### Status -```./Launchd.command status``` - -Shows non-empty daemon pid only, if installed with default settings. - -### Log -```/var/log/org.acidanthera.nvramhook.launchd/launchd.log``` diff --git a/hackintosh-guide/Utilities/ShimUtils/README.md b/hackintosh-guide/Utilities/ShimUtils/README.md deleted file mode 100755 index 00b8de0..0000000 --- a/hackintosh-guide/Utilities/ShimUtils/README.md +++ /dev/null @@ -1,107 +0,0 @@ -## OpenCore + OpenLinuxBoot + Secure Boot - -If you want to use OpenCore + OpenLinuxBoot + Secure Boot it is possible to sign everything -manually yourself, including any new Linux kernels after updates. This is possible since most -standard distros leave at least the previous kernel bootable (and OpenLinuxBoot exposes -this, via the Auxiliary menu), so you can boot into the old kernel, then sign the new -kernel yourself. - -More convenient may be to trust the signing keys of the specific distros which you -want to boot, which are bundled into the `shimx64.efi` file installed with each distro. -You can extract these with `shim-to-cert.tool` distributed with OpenCore, then install -them in your system Secure Boot `db` variable. Best practice would be to install the deny -list (`vendor.dbx`) from `shimx64.efi`, if any, into your system `dbx` variable, as well. -(Otherwise you are ignoring any revocations which the vendor has made.) - -Recently, Shim has added SBAT support, as a more efficient way to revoke unsafe -binaries. Unfortunately, the SBAT enforcement code is part of Shim, and is not -something you can extract and add to your system Secure Boot database. - -To work round this, the new recommended way to boot OpenCore + OpenLinuxBoot + -Secure Boot is to make a user build of Shim. The vendor certificates -and revocation lists extracted from the distro `shimx64.efi` files are combined -and signed by you, into your own build of Shim; in this approach, these vendor -certificates should NOT also be included in the system Secure Boot database, -and should be removed if you added them previously. Including them in both places -will still boot under Secure Boot, but will effectively disable SBAT revocation. - -> If you are signing everything yourself, including Linux kernels after updates, that -will still work as before and the below is not needed. Equally, if you are not -using Secure Boot the below is not needed. - -The advantages of using a user build of Shim are: - - No need to sign every kernel after updates (same as previous method) - - Linux SBAT integration (new) - - Linux MOK integration (new) - - No need to include the Windows intermediate CA - you are trusting whichever distro - keys you choose to include in your own Shim, directly (new) - -Disadvantages are: - - Need to update when distro keys or distro revocation lists within Shim are updated - (same as previous method) - - Need to udpate when Shim SBAT level is updated (new) - -### Method -`Utilities/ShimUtils` includes a script `shim-make.tool` which will download the -current Shim source and build it for you, on macOS (using Ubuntu multipass) or on -Linux (Ubuntu and Fedora supported, others may work). - - - Extract `vendor.db` and `vendor.dbx` files from the `shimx64.efi` file of each distro - which you want to load (using `shim-to-cert.tool`) - - For non-GRUB distros, the required public keys for this process cannot be extracted - from `shimx64.efi` and so must be found by additional user research - - Concatentate these (e.g. `cat fedora/vendor.db ubuntu/vendor.db > combined/vendor.db` - and `cat fedora/vendor.dbx ubuntu/vendor.dbx > combined/vendor.dbx`) - - Do not concatenate `.der` files directly, it will not work - - If you have a single distro with a single `.der` file, you can use `VENDOR_CERT_FILE` - instead of `VENDOR_DB_FILE` in the `make` options below; otherwise, you will need to use - `cert-to-efi-sig-list` from `efitools` to convert the `.der` file to a sig list - this - is done automatically by `shim-to-cert.tool` when `efitools` are available (in - Linux; or from within Ubuntu multipass on macOS, e.g. `multipass shell oc-shim`) - - Build a version of Shim which includes these concatenated signature lists (and - launches OpenCore.efi directly): - - `./shim-make.tool setup` - - `./shim-make.tool clean` (only needed if remaking after the initial make) - - `./shim-make.tool make VENDOR_DB_FILE={full-path-to}/vendor.db VENDOR_DBX_FILE={full-path-to}/vendor.dbx` - - On macOS, the paths to these files must either be within the multipass VM, or - within a subdirectory visible to macOS and the VM on the same path, such as - `/Users/{username}/shim_root` when using `shim-make.tool` default settings - - Copy the relevant files (`shimx64.efi` and `mmx64.efi` as well as `BOOTX64.CSV`) to your mounted ESP volume, e.g.: - - `./shim-make.tool install /Volumes/EFI` (macOS) - - `sudo ./shim-make.tool install /boot/efi` (Linux) - - Sign the newly built `shimx64.efi` and `mmx64.efi` with your own ISK (see e.g. - https://habr.com/en/articles/273497/ - Google translate is your friend) - - If you do not copy and sign `mmx64.efi` as well as `shimx64.efi`, your system will hang if any MOK operations are attempted - - `BOOTX64.CSV` is not required and is for information only - -As before you need to sign `OpenCore.efi` and any drivers it loads with your ISK. -You now also need to add an empty SBAT section to `OpenCore.efi` before signing it. - -> An empty SBAT section means: 'I'm not part of the system which allocates SBAT names -and signs them into boot files, and I don't want this boot file to be revoked by any -future SBAT revocations'. Of course, you can still revoke boot files you signed yourself -by rotating your own signing keys. - -As noted [here](https://github.com/fwupd/fwupd/issues/2910) and -[here](https://github.com/rhboot/shim/issues/376), -the [documented](https://github.com/rhboot/shim/blob/main/SBAT.md) method for adding an -SBAT section to an already-linked `.efi` file does not work correctly (GNU `objcopy` -corrupts the executable). This -[third party python script](https://github.com/rhboot/shim/issues/376#issuecomment-1628004034) -does work. A suitable command is: - -`pe-add-sections.py -s .sbat <(echo -n) -z .sbat -i OpenCore.efi -o OpenCore_empty_sbat.efi` - -This file then needs to be signed and copied back into place, e.g.: - -`sbsign --key {path-to}/ISK.key --cert {path-to}/ISK.pem OpenCore_empty_sbat.efi --output OpenCore.efi` - -Finally, in order for OpenCore integration with Shim to work correctly -`UEFI/Quirks/ShimRetainProtocol` must be enabled in `config.plist`, and -`LauncherPath` should be set to `\EFI\OC\shimx64.efi`. - -> Using Ubuntu multipass, it is now possible to operate entirely within macOS for signing, -key generation, etc. Note that the `~/shim_root` directory is already shared between -macOS and the `oc-shim` multipass VM (under its macOS path, e.g. `/Users/username/shim_root`), -and other macOS folders and volumes can be mounted if you wish, e.g. -`multipass mount /Volumes/EFI oc-shim:/Volumes/EFI`. diff --git a/hackintosh-guide/Utilities/macrecovery/README.md b/hackintosh-guide/Utilities/macrecovery/README.md deleted file mode 100755 index 4cf122b..0000000 --- a/hackintosh-guide/Utilities/macrecovery/README.md +++ /dev/null @@ -1,8 +0,0 @@ -## macrecovery - -macrecovery is a tool that helps to automate recovery interaction. It can be used to download diagnostics and recovery as well as analyse MLB. - -Requires python3 to run. Run with `-h` argument to see all available arguments. - -To create a disk image for a virtual machine installation use `build-image.sh`. - diff --git a/hackintosh-guide/Utilities/macserial/FORMAT.md b/hackintosh-guide/Utilities/macserial/FORMAT.md deleted file mode 100755 index 58b822f..0000000 --- a/hackintosh-guide/Utilities/macserial/FORMAT.md +++ /dev/null @@ -1,224 +0,0 @@ -Apple Mac Serial Format -======================= - -It is reasonably important to get more information about the goods you buy, especially if they are not new, and you do not have absolute confidence in the seller. Serial numbers are the first thing to look at. For Apple products [Apple Check Coverage](https://checkcoverage.apple.com) is your best friend. - -However, it does not show all the details encoded in the serial, and in some case it may be important. For example, certain shady dealers may change one valid serial by the other, and it will not be obvious at a glance that the serial does not belong to the actual model. This FAQ attempts to explain the reverse-engineered structure of the serials used in Apple hardware. - -You could always receive information about the current serial number of your Mac by running `./macserial`. For the other serial use `./macserial -i SERIALNUMBER`, where `SERIALNUMBER` is the serial you check. - -## Apple base 34 - -Select fields in the numbers are encoded values in base 34. So, certain alpha-numeric characters represent a slightly uncommon base 34 code excluding `O` and `I`. - -| Char | Value | Char | Value | -| ---- | ----- | ---- | ----- | -| `0` | `0` | `H` | `17` | -| `1` | `1` | `J` | `18` | -| `2` | `2` | `K` | `19` | -| `3` | `3` | `L` | `20` | -| `4` | `4` | `M` | `21` | -| `5` | `5` | `N` | `22` | -| `6` | `6` | `P` | `23` | -| `7` | `7` | `Q` | `24` | -| `8` | `8` | `R` | `25` | -| `9` | `9` | `S` | `26` | -| `A` | `10` | `T` | `27` | -| `B` | `11` | `U` | `28` | -| `C` | `12` | `V` | `29` | -| `D` | `13` | `W` | `30` | -| `E` | `14` | `X` | `31` | -| `F` | `15` | `Y` | `32` | -| `G` | `16` | `Z` | `33` | - -## Serial number (SN) - -There generally are 2 similar formats of serial encoding: the old 11 character format, and the new 12 character format. - -| Type | Location | Year | Week | Line | Product | -| --------- | --------- | ---- | ---- | ----- | -------- | -| Old (11) | `LL` | `Y` | `WW` | `SSS` | `PPP` | -| New (12) | `LLL` | `Y` | `W` | `SSS` | `PPPP` | - -Note: Models late 2021+ contain SN with 10 character format. - -### Location - -This value encodes the manufacturing location, which is often more descriptive than `Made in China`, since it may reveal the responsible company and the city. For example, `F5K` means `USA (Flextronics)` and `QT` means `Taiwan (Quanta Computer)`. The list is not standardised or published anywhere, but you can see several known locations by running `./macserial -l`. - -One of the important locations for old-style serials (11 characters) is `RM`. It means that the model was refurbished. For new-style serials you have to call [Apple support](https://support.apple.com) to know this. - -### Year - -Year encodes the actual manufacturing year of each model. For refurbished models it is unknown whether it is replaced by the remanufacturing year. - -For old-style serials it always is a digit that encodes the last digit of the year. For example, `8` means 2008 and `1` means 2011. Only `0` to `9` digitis are used for year encoding. Old-style serials are out of use starting with 2013, so `3` means 2003 not 2013. - -| Char | Year | -| ---- | ---- | -| `3` | 2003 | -| `4` | 2004 | -| `5` | 2005 | -| `6` | 2006 | -| `7` | 2007 | -| `8` | 2008 | -| `9` | 2009 | -| `0` | 2010 | -| `1` | 2011 | -| `2` | 2012 | - - -For new-style serials it is an alphanumeric value, which not only encodes the year, but its half as well. Not all the values are allowed. The table below outlines the pairs of characters which are assumed to encode each supported year. First character in the pair is believed to encode the first half of the year, and the second character — the second half. - -| Pair | Year | -| -------- | ---- | -| `C`, `D` | 2010 | -| `F`, `G` | 2011 | -| `H`, `J` | 2012 | -| `K`, `L` | 2013 | -| `M`, `N` | 2014 | -| `P`, `Q` | 2015 | -| `R`, `S` | 2016 | -| `T`, `V` | 2017 | -| `W`, `X` | 2018 | -| `Y`, `Z` | 2019 | -| `C`, `D` | 2020 | -| `F`, `G` | 2021 | - -### Week - -Week encodes the actual manufacturing week of each model. This week has nothing in common with [ISO 8601](https://en.wikipedia.org/wiki/ISO_week_date), and appears to be encoded literally as 7-day sequences starting from January, 1st. Since each year has either 365 or 366 days, 53rd week is extremely rare, and you are lucky to have such a serial. - -For old-style serials week is encoded in plain numeric digits with leading zeroes. `01`, `02`, ... `53`. For new-style serials an alpha-numeric code is used. Encoded year half also counts and means adds 26 weeks for the second one. - -| Char | 1st half | 2nd half | -| ---- | -------- | -------- | -| `1` | `1` | `27` | -| `2` | `2` | `28` | -| `3` | `3` | `29` | -| `4` | `4` | `30` | -| `5` | `5` | `31` | -| `6` | `6` | `32` | -| `7` | `7` | `33` | -| `8` | `8` | `34` | -| `9` | `9` | `35` | -| `C` | `10` | `36` | -| `D` | `11` | `37` | -| `F` | `12` | `38` | -| `G` | `13` | `39` | -| `H` | `14` | `40` | -| `J` | `15` | `41` | -| `K` | `16` | `42` | -| `L` | `17` | `43` | -| `M` | `18` | `44` | -| `N` | `19` | `45` | -| `P` | `20` | `46` | -| `Q` | `21` | `47` | -| `R` | `22` | `48` | -| `T` | `23` | `49` | -| `V` | `24` | `50` | -| `W` | `25` | `51` | -| `X` | `26` | `52` | -| `Y` | `-` | `53` | - -For old-style serials it is a pair of two digits, which encode the manufacturing week. - -### Production line and copy - -Production line is believed to be related to some identifier at assembly stage. It is encoded in base 34, but the actual derivation process is unknown and can only be guessed with relative success. - -Current model, which apparently works well, represents it as a sum of three alpha-numeric characters with `1`, `34`, and `68` multipliers. The actual formula looks as follows: - -``` -base34[S1] * 68 + base34[S2] * 34 + base34[S3] = production line -``` - -This formula effectively defines a compression function, which allows to encode a total of `3400` production lines from `0` to `3399`. The compression produced by shortening `39304` space to `3400` allows multiple encodings of the same line. For example, for `939` line there can be `14` derivatives or "copies": `0TM`, `1RM`, `2PM`, `3MM`, `4KM`, ..., `D1M`. - -While the formula does look strange, it was experimentally discovered that up to `N` first encoded derivatives are valid, and starting with the first invalid derivative there will be no valid ones. Thus for a complete serial list made up with all the derivatives from the above the following is assumed to be true: if `0TM` and `2PM` are valid and `3MM` is invalid, then `1RM` will also be valid, and `4KM` to `D1M` will be invalid. From this data it could be theorised that the encoded value is incremented for each model produced from the same line. So `0TM` is the first copy produced, and `D1M` is the last copy. - -**Update**: At a later stage very few examples of valid derivatives after invalid were found. These exceptions disprove at least some parts of the model, but currently there exists no better theory. - -### Product model - -Last 3 (for legacy serials) or 4 (for new serials) symbols encode the actual product identifier of this exact piece of the hardware. This is probably the most useful part of the serial, since it allows you to get the detailed description of your hardware directly from the dedicated Apple Specs portal. To do so you need to modify the following URI to contain your real product code instead of `PPPP` and follow it in your browser: - -``` -http://support-sp.apple.com/sp/index?page=cpuspec&cc=PPPP -``` - -For example, for iMacPro1,1 it could be [HX87](http://support-sp.apple.com/sp/index?page=cpuspec&cc=HX87) and for MacBookPro14,3 it could be [HTD5](http://support-sp.apple.com/sp/index?page=cpuspec&cc=HTD5). - -The list is not standardised or published anywhere, but you can see most products by running `./macserial -lp` and `./macserial -l` to match against mac models. The value seems to be a classic base 34 sequence: `P1 * 39304 + P2 * 1156 + P3 * 34 + P4`. The ranges seem to be allocated in chunks in non-decreasing manner. Normally each chunk is distanced from another chunk by up to 64 (90% matches). - -## Logic board serial number (MLB) - -There generally are 2 formats of logic board serial encoding: the old 13 character format, and the new 17 character format. Unlike serial number, these formats are quite different and in addition very little is known about MLB in general. - -| Type | Location | Year | Week | Item | Infix | Product | Suffix | -| --------- | --------- | ---- | ---- | ------ | ------ | -------- | ------ | -| Old (13) | `LL` | `Y` | `WW` | `IIII` | | `EEE` | `C` | -| New (17) | `LLL` | `Y` | `WW` | `III` | `AA` | `EEEE` | `CC` | - -While it is unclear if this is intentional, for 17 character MLB it is possible to perform basic validation online through `osrecovery.apple.com`. The recovery server will return valid latest recovery image only when MLB is valid. Use `./macrecovery.py verify -m MLB -b BOARD-ID` to try verifying your MLB number. - -It is not clear how strongly MLB is attached to serial number (SN). The following is known: - -- Minimal supported macOS version is identified by `EEEE` -- Maximum supported macOS version is identified by `EEEE` and `board-id` -- Recovery server accepts a range of models with the same MLB (with only latest os different) - -The following is suspected: -- `EEEE` is unique number for all MLBs -- `EEEE` are shared across different models and thus cannot identify the model - -### Location - -MLB location is equivalent to serial number location but does not necessarily match it, as logic boards can be manufactured at a different place. - -### Year and week - -MLB year and week in both 13-character and 17-character MLB are equivalent to legacy serial number year and week. The values are slightly lower as logic board is manufactured prior to the complete product. - -### Item - -MLB item is encoded differently for 13-character and 17-character MLB. It might serve as a production item per week and could be similar to 'Production line and copy' in the serial number. - -- For old MLB, this is a variant of base 34 value. First item character is always `0`. -- For new MLB, this value always is a number. - -### Infix - -Base 34 value present in new MLBs only. No information is known about it. Could actually be part of Item. - -### Product board - -Similarly to 'Product model' this field encodes logic board model number. This code is often referred to as `EEE code` in part catalogues and is useful for purchasing a compatible logic board for replacement. - -For new 17 character MLBs this field is also used for identification at `osrecovery.apple.com` to provide a compatible internet recovery image and diagnostic tools upon request. - -### Suffix - -Base 34 value with unclear designation. Might be used for checksum validation. Checksum validation algorithm is reverse engineered from diagnostics tools and is valid for all 17 character MLBs. It is not clear whether 13 character MLBs have any checksum. 17 character MLB checksum follows. - -```C -static bool verify_mlb_checksum(const char *mlb, size_t len) { - const char alphabet[] = "0123456789ABCDEFGHJKLMNPQRSTUVWXYZ"; - size_t checksum = 0; - for (size_t i = 0; i < len; ++i) { - for (size_t j = 0; j <= sizeof (alphabet); ++j) { - if (j == sizeof (alphabet)) - return false; - if (mlb[i] == alphabet[j]) { - checksum += (((i & 1) == (len & 1)) * 2 + 1) * j; - break; - } - } - } - return checksum % (sizeof(alphabet) - 1) == 0; -} -``` - -## Appendix - -This information was obtained experimentally and may not be accurate in certain details. Be warned that it is published at no warranty for educational and introductory purposes only. diff --git a/hackintosh-guide/Utilities/macserial/README.md b/hackintosh-guide/Utilities/macserial/README.md deleted file mode 100755 index 4ee34bb..0000000 --- a/hackintosh-guide/Utilities/macserial/README.md +++ /dev/null @@ -1,7 +0,0 @@ -## macserial - -macserial is a tool that obtains and decodes Mac serial number and board identifier to provide more information about the production of your hardware. Works as a decent companion to [Apple Check Coverage](https://checkcoverage.apple.com) and [Apple Specs](http://support-sp.apple.com/sp/index?page=cpuspec&cc=HTD5) portal. Check the [format description](https://github.com/acidanthera/OpenCorePkg/blob/master/Utilities/macserial/FORMAT.md) for more details. - -Should be built with a compiler supporting C99. Prebuilt binaries are available for macOS 10.4 and higher. - -Run with `-h` argument to see all available arguments. diff --git a/hackintosh-guide/Utilities/ocvalidate/README.md b/hackintosh-guide/Utilities/ocvalidate/README.md deleted file mode 100755 index 8658847..0000000 --- a/hackintosh-guide/Utilities/ocvalidate/README.md +++ /dev/null @@ -1,140 +0,0 @@ -ocvalidate -==================== - -Utility to validate whether a `config.plist` matches requirements and conventions imposed by OpenCore. - -## Usage -- Pass one single path to `config.plist` to verify it. -- Pass `--version` for current supported OpenCore version. - -## Technical background -### At a glance -- ocvalidate firstly calls `OcSerializeLib` which performs fundamental checks in terms of syntax and semantics. After that, the following will be checked. -- The error message `` complained by `OcSerializeLib` indicates unknown keys that can be deprecated in new versions of OpenCore. Such keys should be ***removed*** in order to avoid undefined behaviours. -- Under active development, newer versions of OpenCore hardly have backward compatibility at this moment. As a result, please first run `ocvalidate --version` to check which version of OpenCore is supported, and thus please only use the specific version. - -### Global Rules -- All entries must be set once only. Duplication is strictly prohibited. -- All strings (fields with plist `String` format) throughout the whole config only accept ASCII printable characters at most. Stricter rules may apply. For instance, some fields only accept specified values, as indicated in [Configuration.pdf](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Configuration.pdf). -- All the paths relative to OpenCore root must be less than or equal to 192 bytes (`OC_STORAGE_SAFE_PATH_MAX`) in total including '\0' terminator. -- Most binary patches must have `Find`, `Replace`, `Mask` (if used), and `ReplaceMask` (if used) identical size set. Also, `Find` requires `Mask` (or `Replace` requires `ReplaceMask`) to be active (set to non-zero) for corresponding bits. -- `MinKernel` and `MaxKernel` entries should follow conventions specified in [Configuration.pdf](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Configuration.pdf). (TODO: Bring decent checks for this) -- `MinKernel` cannot be a value that is below macOS 10.4 (Darwin version 8). -- Entries taking file system path only accept `0-9, A-Z, a-z, '_', '-', '.', '/', and '\'`. -- Device Paths (e.g. `PciRoot(0x0)/Pci(0x1b,0x0)`) only accept strings in canonic string format. -- Paths of UEFI Drivers only accept `0-9, A-Z, a-z, '_', '-', '.', and '/'`. -- Entries requiring bitwise operations (e.g. `ConsoleAttributes`, `PickerAttributes`, or `ScanPolicy`) only allow known bits stated in [Configuration.pdf](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Configuration.pdf) to be set. -- Entries involving GUID (mainly in Section `NVRAM`) must have correct format set. - -### ACPI -#### Add -- Entry[N]->Path: Only `.aml` and `.bin` filename suffix are accepted. - -### Booter -#### MmioWhitelist -- Entry[N]->Enabled: When at least one entry is enabled, `DevirtualiseMmio` in `Booter->Quirks` should be enabled. -#### Patch -- Entry[N]->Arch: Only `Any`, `i386`, or `x86_64` are accepted. -- Entry[N]->Identifier: Only `Any`, `Apple`, or a specified bootloader with `.efi` sufffix, are accepted. -#### Quirks -- When `AllowRelocationBlock` is enabled, `ProvideCustomSlide` should be enabled altogether. -- When `EnableSafeModeSlide` is enabled, `ProvideCustomSlide` should be enabled altogether. -- If `ProvideMaxSlide` is set to a number greater than zero, `ProvideCustomSlide` should be enabled altogether. -- `ResizeAppleGpuBars` must be set to `0` or `-1`. -- When `DisableVariableWrite`, `EnableWriteUnprotector`, or `ProvideCustomSlide` is enabled, `OpenRuntime.efi` should be loaded in `UEFI->Drivers`. - -### DeviceProperties -- Requirements here all follow Global Rules. - -### Kernel -#### Add -- Entry[N]->Arch: Only `Any`, `i386`, or `x86_64` are accepted. -- Entry[N]->BundlePath: Filename should have `.kext` suffix. -- Entry[N]->PlistPath: Filename should have `.plist` suffix. -- Entry[N]: If `Lilu.kext` is used, `DisableLinkeditJettison` should be enabled in `Kernel->Quirks`. -- `BrcmFirmwareRepo.kext` must not be injected by OpenCore. -- For some known kexts, their `BundlePath`, `ExecutablePath`, and `PlistPath` must match against each other. Current list of rules can be found [here](https://github.com/acidanthera/OpenCorePkg/blob/master/Utilities/ocvalidate/KextInfo.c). -- Plugin kext must be placed after parent kext. For example, [plugins of Lilu](https://github.com/acidanthera/Lilu/blob/master/KnownPlugins.md) must be placed after `Lilu.kext`. -#### Delete -- Entry[N]->Arch: Only `Any`, `i386`, or `x86_64` are accepted. -- Entry[N]->Identifier: At least one dot (`.`) should exist, because any identifier looks like a domain sequence (`vendor.product`). -#### Quirks -- `CustomSMBIOSGuid` requires `PlatformInfo->UpdateSMBIOSMode` set to `Custom`. -- `SetApfsTrimTimeout` cannot be a value that is greater than `MAX_UINT32`, or less than `-1`. -#### Scheme -- KernelArch: Only `Auto`, `i386`, `i386-user32`, or `x86_64` are accepted. -- KernelCache: Only `Auto`, `Cacheless`, `Mkext`, or `Prelinked` are accepted. - -### Misc -#### BlessOverride -- Entries cannot be `\EFI\Microsoft\Boot\bootmgfw.efi` or `\System\Library\CoreServices\boot.efi` since OpenCore knows these paths. -#### Boot -- HibernateMode: Only `None`, `Auto`, `RTC`, or `NVRAM` are accepted. -- PickerMode: Only `Builtin`, `External`, or `Apple` are accepted. -- `PickerAudioAssist` requires `AudioSupport` in `UEFI->Audio` to be enabled. -- LauncherOption: Only `Disabled`, `Full`, `Short`, or `System` are accepted. -- `LauncherPath` cannot be empty string. -#### Security -- AuthRestart: If enabled, `VirtualSMC.kext` should be present in `Kernel->Add`. -- DmgLoading: Only `Disabled`, `Signed`, or `Any` are accepted. -- Vault: Only `Optional`, `Basic`, or `Secure` are accepted. -- SecureBootModel: Only `Default`, `Disabled`, `j137`, `j680`, `j132`, `j174`, `j140k`, `j780`, `j213`, `j140a`, `j152f`, `j160`, `j230k`, `j214k`, `j223`, `j215`, `j185`, `j185f`, or `x86legacy` are accepted. -#### Serial -- RegisterAccessWidth: Only `8` or `32` are accepted. -- BaudRate: Only `921600`, `460800`, `230400`, `115200`, `57600`, `38400`, `19200`, `9600`, `7200`, `4800`, `3600`, `2400`, `2000`, `1800`, `1200`, `600`, `300`, `150`, `134`, `110`, `75`, or `50` are accepted. -- PciDeviceInfo: The last byte must be `0xFF`. -- PciDeviceInfo: Excluding the last byte `0xFF`, the rest must be divisible by 4. -- PciDeviceInfo: Maximum allowed size is 41. - -### NVRAM -- Requirements here all follow Global Rules. In addition, the following keys and values are checked: -#### gAppleBootVariableGuid (`7C436110-AB2A-4BBB-A880-FE41995C9F82`) -- `nvda_drv` must have type `Plist Data` with the value of `0x30` or `0x31`. -- `boot-args` must be an ASCII string (thus `Plist String`) without trailing `\0`. -- `bootercfg` must be an ASCII string (thus `Plist String`) without trailing `\0`. -- `csr-active-config` must have type `Plist Data` and have length of 4 bytes. -- `StartupMute` must have type `Plist Data` and have length of 1 byte. -- `SystemAudioVolume` must have type `Plist Data` and have length of 1 byte. -#### gAppleVendorVariableGuid (`4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14`) -- `UIScale` must have type `Plist Data` with the value of `0x01` or `0x02`. -- `FirmwareFeatures` must have type `Plist Data` and have length of 4 bytes. -- `ExtendedFirmwareFeatures` must have type `Plist Data` and have length of 8 bytes. -- `FirmwareFeaturesMask` must have type `Plist Data` and have length of 4 bytes. -- `ExtendedFirmwareFeatures` must have type `Plist Data` and have length of 8 bytes. -- `DefaultBackgroundColor` must have type `Plist Data` and have length of 4 bytes. Also, its last byte must be `0x00`. - -### PlatformInfo -- UpdateSMBIOSMode: Only `TryOverwrite`, `Create`, `Overwrite`, or `Custom` are accepted. -#### Generic -- SystemProductName: Only real Mac models are accepted. -- SystemMemoryStatus: Only `Auto`, `Upgradable`, or `Soldered` are accepted. -- SystemUUID: Only empty string, `OEM` or valid UUID are accepted. -- ProcessorType: Only known first byte can be set. - -### UEFI -#### APFS -- When `EnableJumpstart` is enabled, `ScanPolicy` in `Misc->Security` should have `OC_SCAN_ALLOW_FS_APFS` (bit 8) set, together with `OC_SCAN_FILE_SYSTEM_LOCK` (bit 0) set. Or `ScanPolicy` should be `0` (failsafe value). -#### Audio -- When `AudioSupport` is enabled, `AudioDevice` must be either empty or a valid path. -- When `AudioSupport` is enabled, `AudioOutMask` must be non-zero. -#### Quirks -- When `RequestBootVarRouting` is enabled, `OpenRuntime.efi` should be loaded in `UEFI->Drivers`. -- `ResizeGpuBars` must be set to an integer value between `-1` and `19`. -#### Drivers -- When `OpenUsbKbDxe.efi` is in use, `KeySupport` in `UEFI->Input` should never be enabled altogether. -- When `Ps2KeyboardDxe.efi` is in use, `KeySupport` in `UEFI->Input` should always be enabled altogether. -- `OpenUsbKbDxe.efi` and `Ps2KeyboardDxe.efi` should never co-exist. -- When HFS+ filesystem driver or `AudioDxe.efi` is in use, `ConnectDrivers` should be enabled altogether. -- When `OpenCanopy.efi` is in use, `PickerMode` in `Misc->Boot` should be set to `External`. -- When `OpenVariableRuntimeDxe.efi` is in use, its `LoadEarly` option must be set to `TRUE`. -- `OpenRuntime.efi` must be placed after `OpenVariableRuntimeDxe.efi` when both are in use. -- `LoadEarly` for any other driver but `OpenVariableRuntimeDxe.efi` and `OpenRuntime.efi` must be set to `FALSE`. -#### Input -- KeySupportMode: Only `Auto`, `V1`, `V2`, or `AMI` are accepted. -- When `PointerSupport` is enabled, the value of `PointerSupportMode` should only be `ASUS`. -#### Output -- `ClearScreenOnModeSwitch`, `IgnoreTextInGraphics`, `ReplaceTabWithSpace`, and `SanitiseClearScreen` only apply to `System` TextRenderer -- `Resolution` should match `NUMBERxNUMBER` or `NUMBERxNUMBER@NUMBER` sequences (unless it is an `Empty string` or is set to `Max`). -- `UIScale` must be set to an integer value between `-1` and `2`. -#### ReservedMemory -- Type: Only `Reserved`, `LoaderCode`, `LoaderData`, `BootServiceCode`, `BootServiceData`, `RuntimeCode`, `RuntimeData`, `Available`, `Persistent`, `UnusableMemory`, `ACPIReclaimMemory`, `ACPIMemoryNVS`, `MemoryMappedIO`, `MemoryMappedIOPortSpace`, or `PalCode` are accepted. diff --git a/hackintosh-guide/config-examples/config-asus-b760-i7-13700k-rx6800xt.md b/hackintosh-guide/config-examples/config-asus-b760-i7-13700k-rx6800xt.md deleted file mode 100755 index 1113f47..0000000 --- a/hackintosh-guide/config-examples/config-asus-b760-i7-13700k-rx6800xt.md +++ /dev/null @@ -1,706 +0,0 @@ -# config.plist de Ejemplo - ASUS B760 + i7-13700K + RX 6800 XT - -## ⚠️ IMPORTANTE - -Este es un **ejemplo de referencia**. NO usar directamente sin: - -1. **Generar SMBIOS único** con GenSMBIOS -2. **Ajustar a tu hardware exacto** -3. **Validar con ProperTree u OCAuxiliaryTools** - ---- - -## 📋 Configuración Completa - -### ACPI -```xml -ACPI - - Add - - - Comment - Fake EC for desktop - Enabled - - Path - SSDT-EC.aml - - - Comment - Plugin Type for PM - Enabled - - Path - SSDT-PLUG.aml - - - Delete - - Patch - - Quirks - - FadtEnableReset - - NormalizeHeaders - - RebaseRegions - - ResetHwSig - - ResetLogoStatus - - - -``` - ---- - -### Booter -```xml -Booter - - MmapWhitelist - - Patch - - Quirks - - AvoidRuntimeDefrag - - DevirtualiseMmio - - DisableSingleUser - - DisableVariableWrite - - DiscardHibernateMap - - EnableSafeModeSlide - - EnableWriteUnprotector - - ForceBooterSignature - - ForceExitBootServices - - ProtectMemoryRegions - - ProtectSecureBoot - - ProtectUefiServices - - ProvideCustomSlide - - ProvideMaxSlide - 0 - ResizeAppleGpuBars - -1 - RevirtualiseMmio - - SetupVirtualMap - - SignalAppleOS - - SyncRuntimePermissions - - - -``` - ---- - -### DeviceProperties -```xml -DeviceProperties - - Add - - - PciRoot(0x0)/Pci(0x1B,0x0) - - layout-id - BwAAAA== - - - - PciRoot(0x0)/Pci(0x2,0x0) - - enable-backlight-registers-fix - AQAAAA== - enable-backlight-smoother - AQAAAA== - framebuffer-patch-enable - AQAAAA== - framebuffer-cursormem - AACQAA== - radpng - AQAAAA== - - - Delete - - -``` - ---- - -### Kernel - Emulate (CRÍTICO para Raptor Lake) -```xml -Kernel - - Emulate - - Cpuid1Data - NxcB/V/QwMA= - Cpuid1Mask - //// - DummyPowerManagement - - - Force - - Kexts - - - - BundlePath - Lilu.kext - Comment - Patch engine v1.6.8 - Enabled - - ExecutablePath - Contents/MacOS/Lilu - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VirtualSMC.kext - Comment - SMC emulator v1.3.4 - Enabled - - ExecutablePath - Contents/MacOS/VirtualSMC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - WhateverGreen.kext - Comment - AMD GPU patches v1.6.7 - Enabled - - ExecutablePath - Contents/MacOS/WhateverGreen - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleALC.kext - Comment - Realtek Audio v1.8.8 - Enabled - - ExecutablePath - Contents/MacOS/AppleALC - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - AppleIGC.kext - Comment - Intel 2.5GbE v1.6 - Enabled - - ExecutablePath - Contents/MacOS/AppleIGC - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - AirportItlwm.kext - Comment - Intel Wi-Fi v2.3.0 - Enabled - - ExecutablePath - Contents/MacOS/AirportItlwm - MaxKernel - 23.9.9 - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBluetoothFirmware.kext - Comment - Intel BT v2.3.0 - Enabled - - ExecutablePath - Contents/MacOS/IntelBluetoothFirmware - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - IntelBTPatcher.kext - Comment - Intel BT Patcher v2.3.0 - Enabled - - ExecutablePath - Contents/MacOS/IntelBTPatcher - MaxKernel - - MinKernel - 19.0.0 - PlistPath - Contents/Info.plist - - - - - BundlePath - FeatureUnlock.kext - Comment - Unlock features v1.1.4 - Enabled - - ExecutablePath - Contents/MacOS/FeatureUnlock - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - VoodooPS2Controller.kext - Comment - PS2 Keyboard/Mouse v2.3.0 - Enabled - - ExecutablePath - Contents/MacOS/VoodooPS2Controller - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCProcessor.kext - Comment - VirtualSMC plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCProcessor - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - - BundlePath - SMCSuperIO.kext - Comment - VirtualSMC plugin - Enabled - - ExecutablePath - Contents/MacOS/SMCSuperIO - MaxKernel - - MinKernel - - PlistPath - Contents/Info.plist - - - - Patch - - - Quirks - - AppleCpuPmCfgLock - - AppleXcpmCfgLock - - AppleXcpmExtraMsrs - - AppleXcpmForceBoost - - CustomSMBIOSGuid - - DisableIoMapper - - DisableLinkeditJettison - - DisableRtcChecksum - - ExtendBTFeatureFlags - - ExternalDiskIcons - - ForceSecureBootScheme - - IncreasePciBarSize - - LapicKernelPanic - - LegacyCommpage - - PanicNoKextDump - - PowerTimeoutKernelPanic - - ProvideCurrentCpuInfo - - SetApfsTrimTimeout - -1 - ThirdPartyDrives - - XhciPortLimit - - - - Scheme - - FuzzyMatch - - KernelArch - x86_64 - KernelCache - Auto - - -``` - ---- - -### Misc -```xml -Misc - - BlessOverride - - Boot - - ConsoleAttributes - 0 - HibernateMode - None - HibernateSkipsPicker - - HideAuxiliary - - LauncherOption - Full - LauncherPath - Default - PickerAttributes - 0 - PickerAudioAssist - - PickerMode - Builtin - PickerVariant - Default - PollAppleHotKeys - - ShowPicker - - TakeoffDelay - 0 - Timeout - 5 - - - Debug - - AppleDebug - - ApplePanic - - DisableWatchDog - - DisplayDelay - 0 - DisplayLevel - 2147483650 - LogModules - * - SerialInit - - SysReport - - Target - 3 - - - Entries - - - Security - - AllowNvramReset - - AllowSetDefault - - ApECID - 0 - AuthRestart - - BlacklistAppleUpdate - - DmgLoading - Signed - EnablePassword - - ExposeSensitiveData - 6 - HaltLevel - 2147483648 - PasswordHash - - PasswordSalt - - ScanPolicy - 0 - SecureBootModel - Disabled - Vault - Optional - - - Tools - - -``` - ---- - -### PlatformInfo - SMBIOS (GENERAR CON GENSMBIOS) -```xml -PlatformInfo - - Automatic - - CustomMemory - - Generic - - AdviseFeatures - - MaxBIOSVersion - - ProcessorType - 0 - SpoofVendor - - SystemMemoryStatus - Auto - - - SystemProductName - iMacPro1,1 - - - SystemSerialNumber - GENERAR_CON_GENSMBIOS - SystemUUID - GENERAR_CON_GENSMBIOS - MLB - GENERAR_CON_GENSMBIOS - ROM - GENERAR_CON_GENSMBIOS - - - UpdateDataHub - - UpdateNVRAM - - UpdateSMBIOS - - UpdateSMBIOSMode - Create - -``` - ---- - -### UEFI -```xml -UEFI - - APFS - - EnableJumpstart - - GlobalConnect - - HideVerbose - - JumpstartHotPlug - - MinDate - 0 - MinVersion - 0 - - - ConnectDrivers - - - Drivers - - - Arguments - - Comment - - Enabled - - LoadEarly - - Path - OpenRuntime.efi - - - - Input - - KeyFiltering - - KeySupport - - KeySupportMode - Auto - - - Quirks - - ActivateHpetSupport - - DisableSecurityPolicy - - EnableVectorAcceleration - - ExitBootServicesDelay - 0 - ForceOcWriteFlash - - IgnoreInvalidFlexRatio - - ReleaseUsbOwnership - - RequestBootVarRouting - - ResizeGpuBars - -1 - TscSyncTimeout - 0 - UnblockFsConnect - - - -``` - ---- - -## 📝 Notas Importantes - -### SMBIOS Alternativos para i7-13700K - -| SMBIOS | Cuándo Usar | -|--------|-------------| -| iMacPro1,1 | Recomendado (16 cores) | -| MacPro7,1 | Alternativa | -| iMac20,1 | Para problemas de compatibilidad | -| iMac20,2 | Otra alternativa | - -### Boot-args Útiles - -``` --v # Modo verbose (debug) -keepsyms=1 # Mantener símbolos en KP -agdpmod=pikera # Para AMD GPU -darkwake=0 # Problemas de sleep -npci=0x2000 # Si Above 4G no funciona -``` - ---- - -## ✅ Verificación - -1. **Generar SMBIOS único** con GenSMBIOS -2. **Validar config.plist** con ProperTree -3. **Verificar estructura EFI** con verify-efi.sh -4. **Probar en USB** antes de instalar - ---- - -**Volver a [README.md](../README.md)** diff --git a/hackintosh-guide/docs/Changelog.md b/hackintosh-guide/docs/Changelog.md deleted file mode 100755 index 77149c8..0000000 --- a/hackintosh-guide/docs/Changelog.md +++ /dev/null @@ -1,1084 +0,0 @@ -OpenCore Changelog -================== -#### v1.0.6 -- Added workaround for not detected CPU frequency in ProvideCpuInfo quirk, thx @hg13bs -- Updated QemuBuild.command to support `EFI` mode without Duet -- Increased `OC_STORAGE_SAFE_PATH_MAX` to 192 to support various plugin kexts -- Fixed vaulting failures when custom fonts are used, thx @al3xtjames -- Updated documentation for several Booter quirks -- Added `background-color` NVRAM variable to fix 10.9 boot screen -- Fixed debug build of OpenShell not starting on Mac EFI with > 25 file systems -- Improved build speed for Utilities in CI and local build -- Fixed ACPI 1.0 RSDP being reported under ACPI 2.0 GUID with Duet -- Improved logic for RSDP version checking in ACPI patching code -- Downgraded routine log messages such as 'Needs journal recovery, mounting read-only' from WARN to INFO in Ext4Dxe (allows DEBUG_WARN in HaltLevel) -- Improved OpenNtfsDxe stability, thx @stokescat - -#### v1.0.5 -- Fixed incorrect print in PCI device info dumping in `SysReport` -- Fixed ocvalidate error messages for overlong kext paths in Kernel section, thx @corpnewt -- Fixed kext injection compatibility issues with macOS 26 -- Updated builtin firmware versions for SMBIOS and the rest -- Migrated to edk2-stable-202502 - -#### v1.0.4 -- Added support for booting from static IPv4 address in OpenCore-specific HttpBootDxe -- Added static IPv4 configuration options to OpenNetworkBoot -- Removed `--` prefix from OpenNetworkBoot arguments (modify driver arguments if using this driver) -- Updated `Unload` option to unload drivers in reverse of the order in which they were loaded -- Fixed `MSR_IA32_TSC_ADJUST` access on unsupported CPUs (e.g. Virtualization.framework), thx @t0rr3sp3dr0 -- Downgraded WARN log level to INFO for ALREADY_STARTED in AudioDxe (restores ability to include DEBUG_WARN in HaltLevel if required when using this driver) -- Added `ClearTaskSwitchBit` Booter quirk to fix crashes when using 32-bit versions of macOS on Hyper-V Gen2 VMs -- Fixed `ProvideCurrentCpuInfo` and CPUID patching on older versions of macOS 10.4 -- Removed ACPI0007 objects from `SSDT-HV-DEV.dsl` -- Removed `SSDT-HV-DEV-WS2022.dsl` as it is no longer required -- Added PCI class names to PCI device info dumping in `SysReport` - -#### v1.0.3 -- Fixed support for `AMD_CPU_EXT_FAMILY_1AH`, thx @Shaneee -- Fixed EHCI handoff logic in OpenDuet, causing older machines to hang at start -- Added Arrow Lake CPU detection -- Fixed Raptor Lake CPU detection -- Supported booting with TuneD in Fedora 41 in OpenLinuxBoot -- Fixed failure of vault `sign.command` to insert signature in correct location in some circumstances -- Added OpenNetworkBoot driver to support HTTP(S) and PXE boot -- Supported DMG loading and verification (e.g. macOS Recovery) over HTTP(S) boot - -#### v1.0.2 -- Fixed error in macrecovery when running headless, thx @mkorje -- Added support for `AMD_CPU_EXT_FAMILY_1AH`, thx @Shaneee -- Updated builtin firmware versions for SMBIOS and the rest -- Enabled `XcpmExtraMsrs MSR_MISC_PWR_MGMT` patch back on macOS 12+ -- Fixed `XcpmExtraMsrs MSR_MISC_PWR_MGMT` patch on macOS 15 -- Added `UEFI` `Unload` option to unload existing firmware drivers -- Fixed boot device selection with VirtIO disk drives used for macOS installations - -#### v1.0.1 -- Updated code and added progress bar to macrecovery, thx @soyeonswife63 -- Bundled fat binary i386/x64 10.6+ compatible `nvramdump` with LogoutHook release -- Added support for manual build of i386/x64 10.6+ versions of userspace tools via `FATBIN32=1 make` -- Disabled `XcpmExtraMsrs MSR_MISC_PWR_MGMT` patch on macOS 12+ due to non-existence -- Fixed `ThirdPartyDrives` quirk on macOS 14.4 and above -- Resolved issue booting recovery for OS X 10.8 and earlier since 0.9.7 -- Migrated to edk2-stable202405 - -#### v1.0.0 -- Updated builtin firmware versions for SMBIOS and the rest -- Switched to Apple silicon GitHub runner for CI, thx @Goooler -- Added Apple Silicon support in all provided utilities -- Utilities now require macOS 10.9+ (OpenCore itself still supports macOS 10.4+) -- Added `AllowRelocationBlock` support for 32-bit version -- Enabled additional serial logging in non-RELEASE builds of OpenDuet -- Added missing DxeCore ImageContext HOB in OpenDuet -- Fixed assert caused by dependency ordering in OpenDuet -- Prevented assert in normal situation when freeing memory above 4GB in OpenDuet -- Prevented debug assert reporting that optional Hii protocols are not present in OpenDuet -- Fixed problem loading non-firmware runtime drivers (e.g. OpenRuntime.efi) in OpenDuet -- Resolved issue using NOOPT debugging in OpenDuet -- Fixed alphabetical ordering in Configuration.pdf, thx @leon9078 - -#### v0.9.9 -- Fixed incorrect warning in ocvalidate -- Modified `Launchd.command` to recreate its log file if deleted -- Updated `Launchd.command` to work with macOS Sonoma (re-run `./Launchd.command install` after upgrading to Sonoma) -- Fixed an incorrectly labelled MacBookPro11,3 model code in `macserial`, thx @Macschrauber -- Improved macrecovery download logic for slow connections to get chunklist first, thx @scriptod911 - -#### v0.9.8 -- Updated OpenDuet to allow loading unsigned, unaligned legacy Apple images such as HfsPlusLegacy.efi -- Fixed CPU frequency calculation on AMD 10h family -- Swapped the position of Shutdown and Restart buttons to better match recent macOS -- Added `OC_ATTR_USE_REVERSED_UI` to allow access to previous default Shutdown and Restart button arrangement -- Fixed intro animation getting stuck in OpenCanopy if an entry which returns to menu is selected before animation ends -- Modified OpenCanopy to require presence of label images only when used due to `OC_ATTR_USE_GENERIC_LABEL_IMAGE` -- Provided `OC_ATTR_REDUCE_MOTION` to optionally disable non-required OpenCanopy menu animations -- Modified NVRAM logout hook to handle XML entities in string vars -- Fixed CPU frequency calculation on AMD 0Fh family -- Added kext blocker `Exclude` strategy for mkext -- Re-enabled AudioDxe failover to protocol GET mode for systems such as Acer E5 where it works when DisconnectHda doesn't -- Added `FirmwareSettingsEntry.efi` driver which adds menu entry to reboot into UEFI firmware settings -- Enabled use of picker shortcut keys which are read out in OpenCanopy when using `PickerAudioAssist` -- Modified builtin picker so as not to respond to keys queued while audio assist menu is being read out -- Fixed Linux EFI stub loading error when using OpenDuet since 0.8.8 -- Fixed APFS JumpStart with OpenDuet and `SecureBootModel` `Disabled` -- Added TSC frequency calculation for xen hypervisor, thx @netanelc305 -- Supported additional early Nvidia UEFI VBIOS in `EnableGop` `vBiosInsert.sh` - -#### v0.9.7 -- Updated recovery_urls.txt -- Changed OpenDuet to enforce `W^X` settings rather than fixing them in loaded images -- Updated `FixupAppleEfiImages` quirk to fix `W^X` errors in all non-Secure Boot Apple signed binaries -- Updated builtin firmware versions for SMBIOS and the rest -- Updated `AppleEfiSignTool` to work with new PE COFF loader -- Fixed recovery failing to boot on some systems -- Updated `ProvideCurrentCpuInfo` quirk to support CPUID leaf 0x2 cache size reporting on Mac OS X 10.5 and 10.6 -- Updated `efidebug.tool` to support new standard image format - -#### v0.9.6 -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed hang while generating boot entries on some systems -- Added `efidebug.tool` support for 32-bit on 32-bit using GDB or LLDB -- Fixed potential incorrect values in kernel image capabilities calculation -- Added `FixupAppleEfiImages` quirk to allow booting Mac OS X 10.4 and 10.5 boot.efi images on modern secure image loaders - -#### v0.9.5 -- Fixed GUID formatting for legacy NVRAM saving -- Fixed inability to open files in root directory on an NTFS filesystem -- Fixed hang while unloading NTFS driver -- Added UEFI quirk `ShimRetainProtocol`, allowing OpenCore chained from shim to verify Linux using shim's certificates -- Added `OpenLegacyBoot` driver for supporting legacy OS booting -- Added `shim-make.tool` to download and build rhboot/shim, for Linux SBAT and MOK integration - -#### v0.9.4 -- Fixed kext blocker `Exclude` strategy for prelinked on 32-bit versions of macOS -- Fixed `ForceAquantiaEthernet` quirk on macOS 14 beta 2, thx @Shikumo -- Added `InstanceIdentifier` to OpenCore and option to target `.contentVisibility` to specific instances (thx @dakanji) -- Improved `LapicKernelPanic` quirk on legacy versions of macOS -- Allowed `.contentVisibility` in same boot FS root locations as `.VolumeIcon.icns`, in order to survive macOS updates -- Fixed incorrect core count on Silvermont Atom/Celeron processors -- Fixed PM timer detection on Silvermont Atom/Celeron processors for TSC calculations -- Fixed PM timer detection on non-Intel chipsets when booted through OpenDuet -- Fixed `FadtEnableReset` on NVIDIA nForce chipset platforms -- Added BlockIoDxe alternative OpenDuet variant -- Added support for ATI cards when using `ForceResolution` option - -#### v0.9.3 -- Added `--force-codec` option to AudioDxe, thx @xCuri0 -- Downgraded additional warning message in normal operation of emulated NVRAM to info -- Disabled not present DVL0 device in SSDT-SBUS-MCHC by default, thx @stevezhengshiqi -- Added EFI mandated box drawing, block element and arrow characters to `Builtin` renderer console font -- Improved support for overlong menu entries and very narrow console modes in builtin picker -- Made `Builtin` text renderer ignore UI Scale, when required to ensure that text mode reaches minimum UEFI supported size of 80x25 -- Added save and restore of text and graphics mode round tools and failed boot entries -- Updated out-of-range cursor handling to work round minor display issue in memtest86 -- Added optional `--enable-mouse-click` argument to `CrScreenshotDxe` driver to additionally respond on mouse click -- Added `--use-conn-none` option to `AudioDxe` driver to discover additional usable output channels on some systems -- Added `PciIo` protocol override used to fix Aptio IV compatiblity with Above 4G BARs, thx @xCuri0 -- Fixed `AppleXcpmForceBoost` quirk on macOS 14 -- Updated builtin firmware versions for SMBIOS and the rest -- Added `ConsoleFont` option to load custom console font for `Builtin` renderer -- Improved `XhciPortLimit` quirk on macOS 11 to 14 - -#### v0.9.2 -- Added `DisableIoMapperMapping` quirk, thx @CaseySJ -- Fixed disabling single user mode when Apple Secure Boot is enabled -- Improved guard checks for `GopBurstMode` on systems where it's not needed -- Improved compatibility of `GopBurstMode` with some very non-standard GOP implementations -- Fixed possible hang with `GopBurstMode` enabled on DEBUG builds -- Enabled `GopBurstMode` even with natively supported cards, in EnableGop firmware driver -- Fixed inability to patch force-injected kexts -- Fixed `ExternalDiskIcons` quirk on macOS 13.3+, thx @fusion71au -- Fixed various recent reversions and some longer-standing minor bugs in `Builtin` text renderer -- Applied some additional minor optimizations to `Builtin` text renderer -- Implemented `InitialMode` option to allow fine control over text renderer operating mode -- Added support for `ConsoleMode` text resolution setting to `Builtin` renderer -- Fixed regression for ACPI quirks `RebaseRegions` and `SyncTableIds` -- Updated build process to provide stable and bleeding-edge versions of `EnableGop` -- Implemented minor improvements in `PickerMode` `Apple` -- Improved filtering algorithm for `LogModules` and added `?` filter for matching non-standard log lines -- Fixed crash when gathering system report on virtualised CPUs -- Fixed unnecessary warning when first booting with emulated NVRAM -- Enabled `AppleCpuPmCfgLock` quirk on macOS 13 - -#### v0.9.1 -- Fixed long comment printing for ACPI patches, thx @corpnewt -- Added sample config for VS Code source level debugging with `gdb` -- Updated builtin firmware versions for SMBIOS and the rest -- Added GOP memory caching report to `SysReport` -- Implemented `GopBurstMode` quirk for faster GOP operation on older firmware -- Fixed `ThirdPartyDrives` quirk on macOS 13.3 and above - -#### v0.9.0 -- Resolved issues with verbose boot log appearing over picker graphics -- Added version number to EnableGop UI section, so tool builders can track it -- Added `ProvideCurrentCpuInfo` support for macOS 13.3 DP -- Added AMD support, GOP offset auto-detection and macOS 10.11+ support to EnableGop vBIOS insertion script -- Included precompiled EDK-II `EfiRom` and `GenFfs` in `Utilities/BaseTools` with OpenCore releases - -#### v0.8.9 -- Improved debug logging when applying ACPI patches -- Fixed loading macOS with legacy boot without Apple Secure Boot -- Added Linux support to legacy boot BootInstall script -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed incomplete console mode initialisation when started in graphics mode -- Provided additional UEFI forge mode, for use in firmware drivers -- Implemented firmware driver enabling pre-OpenCore graphics on non-natively supported GPUs on EFI-era Macs -- Added `ResizeUsePciRbIo` quirk to workaround broken PciIo on some UEFI firmwares, thx @xCuri0 -- Prevented unwanted clear screen to console background colour when in graphics mode -- Fixed crash while using `SysReport` on older Atom systems -- Fixed kexts without a Contents folder not being patched during a cacheless boot -- Added read-only sections (`.rdata`) to all drivers for better memory protection when supported -- Fixed crash while using `SysReport` on systems with non-audio HDA codecs -- Fixed debug script support for GDB and LLDB -- Fixed legacy boot debug builds asserting on macOS loading - -#### v0.8.8 -- Updated underlying EDK II package to edk2-stable202211 -- Updated AppleKeyboardLayouts.txt from macOS 13.1 -- Updated builtin firmware versions for SMBIOS and the rest -- Updated ocvalidate to allow duplicate tool if FullNvramAccess is different -- Fixed `Kernel` -> `Block` entries not being processed if one was skipped due to `Arch` -- Fixed intermittent prelinking failures caused by XML corruption when kext blocking is enabled -- Removed magic Acidanthera sequence from OpenCore files used for picker hiding -- Added `.contentVisibility` to hide and disable boot entries -- Added Linux support to QemuBuild.command used for Duet debugging -- Built in new secure PE/COFF loader -- Added prebuilt mtoc universal binary with Apple Silicon support -- Corrected OpenDuet build on Apple Silicon -- Added SD card device path support for boot device selection - -#### v0.8.7 -- Removed unwanted clear screen when launching non-text boot entry -- Fixed TSC/FSB for AMD CPUs in ProvideCurrentCpuInfo, thx @Shaneee -- Added `Misc` -> `Boot` -> `HibernateSkipsPicker` not to show picker if waking from macOS hibernation -- Changed macrecovery to download files into `com.apple.recovery.boot` by default, thx @dreamwhite -- Supported Apple native picker (using `BootKicker.efi` or `PickerMode` `Apple`) when running GPUs without Mac-EFI support on units such as the MacPro5,1 (thx @cdf, @tsialex) -- Enabled `PickerMode` `Apple` to successfully launch selected entry -- Enabled `BootKicker.efi` to successfully launch selected entry (via reboot) (thx @cdf) -- Added spoof proof UEFI 2.x checking to OpenVariableRuntimeDxe, thx @dakanji - -#### v0.8.6 -- Updated NVRAM save script for compatibilty with earlier macOS (Snow Leopard+ tested) -- Updated NVRAM save script to automatically install as launch daemon (Yosemite+) or logout hook (older macOS) -- Fixed maximum click duration and double click speed for non-standard poll frequencies -- Added support for pointer dwell-clicking -- Fixed recursive loop crash at first non-early log line on some systems -- Fixed early log preservation when using unsafe fast file logging -- Updated builtin firmware versions for SMBIOS and the rest -- Resolved wake-from-sleep failure on EFI 1.1 systems (including earlier Macs) with standalone emulated NVRAM driver -- Updated macrecovery commands with macOS 12 and 13, thx @Core-i99 -- Updates SSDT-BRG0 with macOS-specific STA to avoid compatibility issues on Windows, thx @Lorys89 -- Fixed memory issues in OpenLinuxBoot causing crashes on 32-bit UEFI firmware - -#### v0.8.5 -- Updated builtin firmware versions for SMBIOS and the rest -- Moved CPU objects that exist only in Windows Server 2022 into `SSDT-HV-DEV-WS2022.dsl` -- Updated Hyper-V device path expansion to support hot add/remove of disks -- Improved verbose logging during kernel patching - -#### v0.8.4 -- Added checks for `Driver` -> `LoadEarly` in ocvalidate -- Added `FullNvramAccess` option for tools which require direct access to NVRAM -- Replaced `SSDT-HV-CPU.dsl` with `SSDT-HV-DEV.dsl` for compatiblity with older macOS versions on Windows 10 and newer -- Updated builtin zlib library to 1.2.12 -- Changed ocpasswordgen not to print characters on password input -- Added ProcessKernel utility for testing kext injection based on configs -- Fixed crash while using `SysReport` on Pentium 4 systems -- Fixed crash after ExitBootServices() is called while using DEBUG builds and file logging -- Fixed 32-bit userspace build support on macOS (use High Sierra 10.13 and below) -- Added basic set of NetworkPkg drivers with HTTP boot support - -#### v0.8.3 -- Added ext4 file system driver -- Added support for macOS 13 DP3 Kernel Collection -- Added `--force-device` option to AudioDxe, allowing UEFI audio on HDA contollers which misreport themselves as non-HDA audio devices -- Provided optional unsafe fast file logging (suitable only for firmware with a fully compliant FAT32 driver) -- Fixed incorrect OSBundleLibraries_x86_64 handling during cacheless injection -- Changed RsaTool not to link against system ssl on macOS -- Fixed crash during cacheless injection when kext blocking is enabled -- Removed default codec connection delay from AudioDxe -- Added optional `--codec-setup-delay` argument to AudioDxe -- Changed units of `Audio` -> `SetupDelay` from microseconds to milliseconds (divide previous value by 1000 if using this setting) -- Fixed incorrect FAT binary slice being selected under macOS 10.4.11 when performing a cacheless boot -- Fixed rare assertion caused by label animation initialisation in OpenCanopy -- Added `--show-csr` option for `Toggle SIP` boot menu entry -- Added macOS 10.4 and 10.5 support to `AllowRelocationBlock` Booter quirk -- Added CPU cache info injection for macOS 10.4 to `ProvideCurrentCpuInfo` quirk -- Added emulated NVRAM driver for use separately from OpenDuet -- Added support for NVRAM reset and set default boot entry when using emulated NVRAM -- Upgraded emulated NVRAM logout script to allow unsupervised installation of recent macOS OTA updates -- Added `Driver` -> `LoadEarly` for drivers which need to be loaded before NVRAM init - -#### v0.8.2 -- Fixed `AppleCpuPmCfgLock` on macOS 13 -- Fixed `DummyPowerManagement` on macOS 13 -- Updated builtin firmware versions for SMBIOS and the rest -- Added macOS 13 support for `AvoidRuntimeDefrag` Booter quirk -- Added injected kext bundle version printing in DEBUG builds -- Added Linux compatibility for CreateVault scripts - -#### v0.8.1 -- Improved `ExtendBTFeatureFlags` quirk on newer macOS versions, thx @lvs1974 -- Added notes about DMAR table and `ForceAquantiaEthernet`, thx @kokowski -- Added System option in `LauncherOption` property, thx @stevezhengshiqi -- Updated note about `CustomPciSerialDevice`, thx @joevt -- Added read-only driver for NTFS -- Switched `Reset NVRAM` and `Toggle SIP` to configurable boot entry protocol drivers -- Supported optional Apple firmware-native NVRAM reset, thx @Syncretic -- Supported NVRAM reset optionally retaining BIOS boot entries -- Supported user specified `csr-active-config` value for Toggle SIP -- Added optional `Enabled` and `Disabled` flavours for `Toggle SIP` (allows theme designers to provide distinct icons) -- Added PIIX4 ACPI PM timer detection for TSC calculations on Hyper-V Gen1 VMs - -#### v0.8.0 -- Added support for early log preservation -- Switched to Python 3 in scripts (use `python /path/to/script` to force Python 2) -- Added `ForceAquantiaEthernet` for Aquantia AQtion AQC-107s based 10GbE network cards support, thx @Mieze and @Shikumo -- Updated builtin firmware versions for SMBIOS and the rest -- Added `Misc` -> `Serial` section to customise serial port properties -- Added `CustomPciSerialDevice` quirk for XNU to correctly recognise customised external serial devices - -#### v0.7.9 -- Added auto-detect `macOS Installer` volume name for use when `.disk_label` file cannot be displayed -- Added `--restore-nosnoop` flag to AudioDxe, making v0.7.7 fix for Windows sound opt-in -- Added new method to disable trim when `SetApfsTrimTimeout` is set to zero -- Fixed `SetApfsTrimTimeout` on macOS 12 (only works when set to zero) -- Added script to build qemu recovery images to macrecovery -- Fixed selecting `SecureBootModel` on hypervisors (should be `x86legacy`) -- Added kext blocking `Strategy` for prelinked and newer -- Added global MSR 35h fix to `ProvideCurrentCpuInfo`, allowing `-cpu host` in KVM -- Fixed potential memory corruption with AVX acceleration enabled -- Added `LogModules` for positive and negative log filtering by modules -- Renamed OpenLinuxBoot driver argument from `partuuidopts:{PARTUUID}` to `autoopts:{PARTUUID}` -- Supported booting Linux from stand-alone `/boot` partition without `/loader/entries` files (user must specify full kernel boot options) -- Handled XML entities in driver arguments -- Updated underlying EDK II package to edk2-stable202202 - -#### v0.7.8 -- Updated ocvalidate to warn about insecure `DmgLoading` with secure `SecureBootModel` (already disallowed in runtime) -- Fixed AudioDxe not disabling unused channels after recent updates -- Allow gain to track OS volume on old macOS without `SystemAudioVolumeDB` -- Fixed crash on no mouse support when verifying password -- Fixed AppleInternal CSR bit being set with `ProvideCustomSlide` enabled -- Added support for `.contentFlavour` and `.contentDetails` files for boot entry protocol entries including OpenLinuxBoot -- Added `LINUX_BOOT_ADD_RW` flag to OpenLinuxBoot to support e.g. EndeavourOS -- Added `flags+=` and `flags-=` arguments to OpenLinuxBoot to simplify setting driver flags if needed -- Fixed OpenLinuxBoot entry name disambiguation when `LINUX_BOOT_USE_LATEST` flag is clear -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed crash in OpenLinuxBoot with partly (re-)installed Linux distro -- Improved robustness in malformed PE image file parsing - -#### v0.7.7 -- Fixed rare crash caused by register corruption in the entry point -- Added `ProvideCurrentCpuInfo` support for Intel Alder Lake -- Fixed typo in `Cpuid1Data` recommendations for Intel Rocket Lake and newer -- Updated builtin firmware versions for SMBIOS and the rest -- Updated underlying EDK II package to edk2-stable202111 -- Resolved crashes in QEMU with AudioDxe -- Added AudioDxe settings caching (avoids non-needed setup delays) -- Added DisconnectHda quirk to allow UEFI sound on Apple hardware and others -- Added workarounds for bugs in QEMU `intel-hda` driver to allow UEFI sound in QEMU -- Implemented multi-channel (e.g. bass+main speaker; speakers+headphones) UEFI sound with `AudioOutMask` -- Fixed AudioDxe startup stalls when Nvidia HDA audio is present -- Resolved AudioDxe disabling sound in Windows on some firmware -- Added pointer polling period tuning in the builtin AppleEvent implementation -- Added pointer device list tuning in the builtin AppleEvent implementation -- Added VREF handling to support UEFI sound on more Apple hardware -- Updated audio output channel detection to support UEFI sound on more Apple hardware -- Added manual GPIO config (use `--gpio-setup` AudioDxe driver argument for UEFI sound on Apple hardware) -- Switched UEFI audio levels to decibel gain to allow accurate matching of saved macOS volume levels -- Separated settings for minimum audio assist volume and minimum audible volume - -#### v0.7.6 -- Fixed stack canary support when compiling with GCC -- Added automatic scaling factor detection -- Explicitly restricted `ResizeAppleGpuBars` to 0 and -1 -- Fixed OpenCanopy long labels fade-out over graphics background -- Fixed `ProvideConsoleGop` not disabling blit-only modes (e.g. on Z690) -- Fixed Alder Lake SMBIOS CPU model information -- Added XCPM CPU power management ACPI table for Intel Alder Lake -- Updated draw order to avoid graphics tearing in OpenCanopy -- Fixed handling PCI device paths with logical units in ScanPolicy -- Added `ReconnectGraphicsOnConnect` option for enabling alternative UEFI graphics drivers -- Added BiosVideo.efi driver to use with `ReconnectGraphicsOnConnect` -- Changed `FadtEnableReset` to avoid unreliable keyboard controller reset -- Added `EnableVmx` quirk to allow virtualization in other OS on some Macs -- Upgraded `ProtectUefiServices` to prevent GRUB shim overwriting service pointers when chainloading with Secure Boot enabled -- Removed deprecated SSDT-PNLFCFL -- Fixed handling of zero-sized Memory Attributes Table - -#### v0.7.5 -- Revised OpenLinuxBoot documentation -- Supported Linux ostree boot layout -- Fixed external drive icons for Boot Entry Protocol -- Added GPU Resize BAR quirks to reduce BARs on per-OS basis -- Fixed OpenLinuxBoot hang bug after correct detection of some distros -- Added DMG signature check during download, thx @jspraul and @zhangyoufu -- Updated builtin firmware versions for SMBIOS and the rest -- Updated recovery downloading commands to include macOS 11 and 12 - -#### v0.7.4 -- Fixed Linux kernel sort order -- Added Linux detection optional log detail -- Fixed CPU core count detection for more legacy CPUs -- Added ability to fully override autodetect Linux boot options -- Added large BaseSystem support in `AdviseFeatures` -- Updated builtin firmware versions for SMBIOS and the rest -- Added tool to extract vendor secure boot certificate from GRUB shim file -- Added `BridgeOSHardwareModel` NVRAM variable to fix T2 SB AP models on macOS 12 -- Changed `Default` Apple Secure Boot model to match SMBIOS for macOS 12 -- Fixed `opencore-version` not being added to NVRAM variables - -#### v0.7.3 -- Improved SSDT-PNLF compatibility with CFL+ graphics -- Fixed OpenCanopy performance loss due to redrawing introduced in 0.6.9 -- Added pattern-based automatic variable initialisation for better security -- Updated underlying EDK II package to edk2-stable202108 -- Updated Apple Secure Boot variables for `x86legacy` -- Updated Linux variants in Flavours.md -- Implemented Boot Entry Protocol, allowing plug-in boot entry drivers -- Added StringBuffer and FlexArray libraries -- Updated Drivers to support arguments (requires config.plist update, see samples) -- Added OpenLinuxBoot driver: OC-native Linux autodetect and boot without chaining via GRUB -- Fixed overlong boot entry names breaking text flow in builtin menu -- Added `ForceOcWriteFlash` UEFI quirk to enable writing OC system variables - -#### v0.7.2 -- Fixed OSBundleLibraries/OSBundleLibaries64 handling -- Added `GraphicsInputMirroring` to fix lost keystrokes in some non-Apple graphical UEFI apps -- Added support for stack canaries (security cookies / stack guards) -- Fixed unintialised memory access in AudioDxe causing audio playback failure -- Changed `Default` Apple Secure Boot model to `x86legacy` for better security and compatibility -- Increased default APFS `MinDate` and `MinVersion` to macOS Big Sur for better security -- Updated builtin firmware versions for SMBIOS and the rest -- Improved SSDT-PNLF compatibility with Windows and newer graphics -- Fixed CLANGPDB OpenCore builds by shortening OC magic - -#### v0.7.1 -- Added `SyncTableIds` quirk to sync modified table OEM identifiers -- Added CPU Info (MSRs) dumping to `SysReport` -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed `PowerTimeoutKernelPanic` on macOS 12 -- Fixed transparency click detection on OpenCanopy boot entries -- Added PCI device info dumping to `SysReport` -- Fixed `SetApfsTrimTimeout` on macOS 12 -- Documented requirement for SetDefault.icns width to match Selector.icns width -- Added explicit warn and safe fallback to builtin picker on failure to match the above -- Added VSCode source level IDE debug config example to debug docs -- Added other minor debug docs updates -- Fixed incorrect timeout of built-in picker on IA32 -- Added support for custom kernels on ESP partition -- Fixed DEBUG ASSERT on pressing change entry keys with single boot entry in OpenCanopy -- Added recommended `Apple12` and `Windows11` flavours -- Added `TpmInfo` tool to DEBUG TPM status -- Fixed incorrect OpenCanopy initial display when default entry beyond right of screen -- Fixed `ProvideCurrentCpuInfo` MSR patch on macOS 12 -- Fixed `AppleXcpmForceBoost` patch on macOS 12 - -#### v0.7.0 -- Fixed NVRAM reset on firmware with write-protected `BootOptionSupport` -- Improved direct GOP renderer performance for certain cases -- Added support for display rotation in direct GOP renderer -- Fixed handling multinode device paths in LoadedImage and elsewhere -- Changed OpenCanopy image directory to support directory prefixes -- Changed OpenCanopy preferred image set to `Acidanthera\GoldenGate` -- Removed `.icns` and `.icns` support -- Added content flavour system allowing custom boot entry icons compatible across icon packs -- Added automatic flavour detection for macOS boot entries -- Added `ProvideCurrentCpuInfo` quirk to provide correct TSC/FSB for Hyper-V virtual machines -- Added Hyper-V device path expansion to allow setting default boot volume -- Added `Apple` variant of `GopPassThrough` to handle only `AppleFramebufferInfo` handles -- Fixed further kernel patches not being processed if a patch was skipped due to arch mismatch -- Added optional Toggle SIP system boot menu option -- Added `CsrUtil.efi` tool, similar to Apple `csrutil` -- Removed support for `.lbl`/`.l2x` pre-drawn entry labels -- Fixed previous text not cleared before console mode tools and entries in OpenCanopy -- Fixed DEBUG build crashes with `GopPassThrough` and `UgaPassThrough` -- Added flavour for memory testing utilities -- Updated recommended `memtest86` config in sample `.plist` files -- Defined bootloader flavours -- Applied own flavour to OC build -- Added CPU topology fixes to `ProvideCurrentCpuInfo` quirk -- Updated OC default SIP disabled value -- Documented SIP values which affect macOS updates -- Added `csr-data` Apple NVRAM var to docs -- Fixed file alignment causing codesign issues with CLANGPDB images -- Replaced `AdviseWindows` with `AdviseFeatures` to support APFS - -#### v0.6.9 -- Fixed out-of-sync cursor movement rectangle when loading e.g. CrScreenshotDxe -- Updated underlying EDK II package to edk2-stable202102 -- Applied consistent enforcement of required minimum Apple OEM Apple Event protocol version -- Changed CustomDelays to less surprising boolean setting with failsafe of false -- Changed key repeat failsafes and sample values to Apple OEM values -- Changed PointerSpeedMul failsafe to Apple OEM value -- Updated docs to include configuration of key repeat settings with and without KeySupport -- Prevented 'set default' UI when action not permitted by security config -- Added `ForgeUefiSupport` quirk to workaround legacy EFI 1.x firmwares compatibility -- Added `ReloadOptionRoms` quirk to force-load Option ROMs on PCI devices -- Added `OC_ATTR_USE_MINIMAL_UI` to allow running pickers with no Shutdown and Restart buttons -- Added display of OpenCore version number to OpenCanopy as well as builtin picker, depending on existing ExposeSensitiveData bit -- Added support for case-insensitive argument handling in the UEFI tools -- Added vector acceleration of SHA-512 and SHA-384 hashing algorithms, thx @MikhailKrichanov -- Fixed wraparound when using arrow keys in OpenCanopy -- Updated builtin firmware versions for SMBIOS and the rest -- Added bundled Linux versions for userspace utilities -- Fixed fallback SMBIOS `Manufacturer` value to `NO DIMM` for empty slots -- Fixed assertions when running OpenCanopy with low resolution, will fallbacks to builtin now - -#### v0.6.8 -- Switched to VS2019 toolchain for Windows builds -- Reduced legacy boot install interaction effort -- Increased OpenCanopy rendering performance -- Added OpenCanopy Shut Down and Restart buttons -- Reduced OpenCanopy mouse pointer input lag -- Fixed that cursor bounds could be different from OpenCanopy's -- Improved builtin picker rendering performance -- Added Memory Type decoding for SMBIOS in `Automatic` mode -- Properly support setting custom entries as default boot options -- Fixed creating log file when root file system is not writable -- Fixed `DisableSingleUser` not being enabled in certain cases -- Added `ForceBooterSignature` quirk for Mac EFI firmware -- Fixed OpenCanopy sometimes cutting off shown boot entries -- Further improved CPU frequency calculation on legacy CPUs -- Fixed SMBIOS SMC version encoding sequence -- Added TSC frequency reading from Apple Platform Info -- Added TSC frequency reading for Apple devices with nForce chipsets -- Added `Base` and `BaseSkip` lookup for ACPI patches -- Fixed ACPI table magic corruption during patching -- Fixed unnatural OpenCanopy and FileVault 2 cursor movement -- Fixed OpenCanopy interrupt handling causing missed events and lag -- Improved OpenCanopy double-click detection -- Reduced OpenCanopy touch input lag and improved usability -- Improved keypress responsiveness in OpenCanopy and builtin pickers -- Improved non-repeating key detection in OpenCanopy and builtin pickers -- Fixed Escape preventing OpenCanopy fade up until released, on some systems -- Fixed fast repeat then stall issue with key handling on some PS/2 systems -- Added accurate Shift+Enter/Shift+Index detection when using PollAppleHotKeys -- Added 'set default' indicator to builtin picker -- Replaced VerifyMsrE2 with ControlMsrE2 also allowing unlock on some firmwares -- Fixed OpenCanopy flicker when refreshing the entry view -- Added OpenCanopy TAB navigation support -- Added OpenCanopy graphical password interface -- Added OpenCanopy pulsing animation to signal timeout -- Added OpenCanopy 'set default' indicator -- Fixed OpenCanopy not aborting timeout on pointer click -- Fixed OpenCanopy intro animation not scaling with UIScale -- Add OpenCanopy boot entry label scrolling (fixes missing long labels) -- Added tabbable Shutdown and Restart buttons to builtin picker -- Fixed in-firmware shutdown for some systems running OpenDuet -- Added Zero as alias hotkey for Escape, to force show picker if hidden -- Added =/+ key as alias for CTRL to set default OS -- Added additional support for configuring correct key repeat behaviour with KeySupport mode -- Fixed CPU multiplier detection on pre-Nehalem Intel CPUs -- Fixed incorrect handling of multiple processors and processor cache in SMBIOS -- Matched default Apple boot picker cursor start position -- Updated OpenShell `devices` command to support misaligned device names returned by some Apple firmware -- Added `(dmg)` suffix to DMG boot options in OpenCanopy -- Added identifiers for Rocket Lake and Tiger Lake CPUs -- Added PickerAudioAssist 'disk image' indication -- Fixed PickerAudioAssist indications played twice in rare cases -- Improved OpenCanopy pointer acceleration -- Added more precise control on `AppleEvent` protocol properties and features -- Added dynamic keyboard protocol installation on CrScreenshotDxe -- Support starting UEFI tools with argument support (e.g. `ControlMsrE2`) without arguments from picker -- Fixed OpenCanopy font height calculation, may reject previously working fonts and mitigate memory corruption -- Fixed incorrect identification of Xeon E5XXX/E5-XXXX and Xeon WXXXX/W-XXXX CPUs -- Added RSDP, RSDT, and XSDT handling to `NormalizeHeaders` ACPI quirk - -#### v0.6.7 -- Fixed ocvalidate return code to be non-zero when issues are found -- Added `OEM` values to `PlatformInfo` in `Automatic` mode -- Improved CPU frequency calculation on Haswell and earlier -- Fixed issues when applying certain patches -- Added `SSN` (and `HW_SSN`) variable support -- Added onscreen early logging in DEBUG builds for legacy firmware -- Added workaround for firmware not specifying DeviceHandle at bootstrap -- Added support for R/O page tables in `SetupVirtualMap` quirk -- Added OEM preservation for certain Apple SMBIOS tables -- Fixed switching to graphics mode when entering OpenCanopy -- Fixed installing Apple FB Info protocol when no GOP exists -- Fixed abort timeout sound in OpenCanopy on key press -- Added `GopPassThrough` option to support GOP protocol over UGA -- Fixed CPU speed rounding for certain Xeon and Core 2 CPUs -- Removed `KeyMergeThreshold` as it never functioned anyway -- Added `acdtinfo` utility to lookup certain products -- Fixed `FSBFrequency` calculation with fractional multiplier -- Fixed showing core count for some AMD CPUs -- Added `ResetTrafficClass` to reset TCSEL to T0 on legacy HDA -- Fixed default boot entry selection without timeout for builtin picker -- Added ocpasswordgen utility to generate OpenCore password data -- Added `ActivateHpetSupport` quirk to activate HPET support -- Fixed `opencore-version` reporting the incorrect version in rare cases - -#### v0.6.6 -- Added keyboard and pointer entry scroll support in OpenCanopy -- Added background image support in OpenCanopy -- Fixed selector boot option choice in OpenCanopy -- Relaxed selector dimensions for OpenCanopy -- Added `MaxBIOSVersion` option to `Generic` -- Fixed MLB verification feature in macrecovery -- Replaced `VBoxHfs` driver with `OpenHfsPlus` -- Added audio codec dumping to `SysReport` -- Fixed compatibility with page protection for all binaries -- Fixed crashes in OpenUsbKbDxe when handling unsupported devices -- Removed `HdaCodecDump` application in favor of `SysReport` -- Added `SetApfsTrimTimeout` to tune APFS trim command -- Changed `OpenCore.efi` to application to improve FW compatibility -- Added `DisableSecurityPolicy` UEFI quirk to workaround driver loading -- Added support for ranged widget connections in AudioDxe -- Fixed supplying non-RT `SetVirtualAddressMap` for non-macOS systems -- Fixed using `SystemUuid` from `DataHub` in non-Automatic mode for `SMBIOS` -- Dropped failsafe defaults from `Generic` to match non-Automatic mode -- Replaced `BootProtect` with `LauncherOption` and `LauncherPath` -- Added `OpenPartitionDxe` with Apple Partition Management scheme -- Improved ocvalidate checks in `Misc`, `NVRAM`, and `UEFI` sections -- Fixed multiple flaws in EFI image loading, APFS driver in particular -- Fixed NVRAM `system-id` being accidentally stored in Little Endian format -- Added `UseRawUuidEncoding` to choose SMBIOS UUID encoding style -- Updated builtin firmware versions for SMBIOS and the rest - -#### v0.6.5 -- Fixed installing OpenDuet on protected volumes -- Updated underlying EDK II package to edk2-stable202011 -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed macrecovery server protocol compatibility -- Added basic audio assistant support in OpenCanopy -- Added compiled ACPI samples to the package -- Fixed timer resolution restoration at boot time -- Fixed memory capacity when using custom SMBIOS memory config -- Removed no longer required `DeduplicateBootOrder` quirk -- Fixed macserial crashes when processing invalid serials -- Fixed macserial issues when processing 2021 year serials -- Added advanced error checking in ocvalidate utility -- Added `SetupDelay` to configure audio setup delay -- Reworked LogoutHook.command to support older macOS -- Implemented MP3 audio decoding for audio assistant support -- Added support for `PickerVariant` for more theme variants -- Added `OC_ATTR_HIDE_THEMED_ICONS` `PickerAttribute` for Time Machine -- Fixed OpenUsbKb compatibility with certain keyboards - -#### v0.6.4 -- Added `BlacklistAppleUpdate` to fix macOS 11 broken update optout -- Dropped HII services from OpenDuet improving size and performance -- Fixed patching of injected kexts in mkext -- Added support for launching from relative paths -- Added direct path passing for tools via `RealPath` -- Allowed launching tools and entries in text mode via `TextMode` -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed ACPI patches not applying if tables are in locked memory -- Fixed `EnableSafeModeSlide` on macOS 11 -- Added `AllowRelocationBlock` quirk for older macOS and safe mode -- Fixed CPU frequency calculation on AMD 19h family -- Updated recovery_urls -- Fixed `DisableSingleUser` quirk when Apple Secure Boot is enabled -- Added `BootstrapShort` to workaround buggy Insyde firmware -- Changed `Bootstrap(Short)` to choose dynamic entry (requires NVRAM reset) -- Avoided `Boot` prefix in `RequestBootVarRouting` to workaround AMI issues -- Added bootloader patch support in `Booter` `Patch` section -- Fixed startup hang on firmware that permit timer function re-entrance -- Made pointer control optional for OpenCanopy via `PickerAttributes` -- Added support for `StartupMute` variable in `PlayChime` -- Added support for per-volume icons for APFS on Preboot -- Removed HII dependency from OpenUsbKbDxe driver -- Fixed undefined behavior in OpenDuet causing random crashes and hangs - -#### v0.6.3 -- Added support for xml comments in plist files -- Updated underlying EDK II package to edk2-stable202008 -- Provide fallbacks for NULL memory SMBIOS strings -- Fixed `BOOTx64.efi` and `BOOTIA32.efi` convention -- Fixed SMBIOS handling with multiple memory arrays -- Fixed memory array handle assignment on empty slots -- Fixed CPUID patching on certain versions of macOS 10.4.10 and 10.4.11 -- Fixed incorrect core/thread counts on Pentium M processors -- Added `SSDT-UNC.dsl` ACPI sample to resolve X99 issues, thx @RemB -- Updated builtin firmware versions for SMBIOS and the rest -- Increased slide allocation reserve to 200 MB for Big Sur beta 10 -- Fixed assert when trying to enable direct renderer on blit-only GOP -- Added support for custom memory properties -- Fixed intermittent 32-bit prelinking failures caused by improper Mach-O expansion -- Fixed failures in cacheless injection dependency resolution -- Fixed detection issues with older Atom CPUs -- Fixed `ScanPolicy` NVMe handling on MacPro5,1 -- Fixed I/O issues on platforms incapable of reading over 1MB at once -- Fixed plist-only kext injection in Big Sur -- Add `ForceResolution` option for enabling non-default resolutions -- Fixed Ps2MouseDxe not properly loading under OpenDuetPkg -- Added workaround for read-only errors on some X299 boards -- Added support for `x86legacy` Secure Boot model -- Added missing Secure Boot NVRAM variables required by 11.0 -- Added setting of `system-id` NVRAM variable -- Added `ForceSecureBootScheme` quirk for virtual machines -- Fixed kernel and ACPI patches failing to replace last bytes of memory - -#### v0.6.2 -- Updated builtin firmware versions for SMBIOS and the rest -- Added `ProcessorType` option to `Generic` allowing custom CPU names -- Fixed `UnblockFsConnect` option not working with APFS JumpStart -- Added IA32 binary variant to the release bundles -- Fixed improper handling of cacheless kexts without an Info.plist -- Fixed improper calculation of kext startup address for blocking -- Added mkext 32-bit kext injection (10.4-10.6) -- Added cacheless 32-bit kext injection (10.4-10.7) -- Added 32-bit kernel/kext patching/blocking support -- Fixed issues loading 10.7 EfiBoot -- Added `Type` to `ReservedMemory` to fulfil hibernation hack needs -- Added workaround to displaying `Preboot` instead of `Macintosh HD` -- Added prelinkedkernel 32-bit kext injection (10.6-10.7) -- Added `SystemMemoryStatus` to override memory replacement on some models -- Added older Pentium CPU recognition in SMBIOS -- Added `ExtendBTFeatureFlags` to properly set `FeatureFlags` for Bluetooth (which substitutes BT4LEContinuityFixup) -- Added `MinKernel`/`MaxKernel` to CPUID emulation and `DummyPowerManagement` -- Fixed `-legacy` not being added in `KernelArch` `Auto` mode -- Fixed `i386-user32` not forcing `i386` on macOS 10.7 on X64 firmware -- Fixed `i386-user32` being incorrectly enabled in macOS 10.4, 10.5, and 10.7 -- Disabled prelinked boot for macOS 10.4 and 10.5 in `KernelCache` `Auto` mode -- Fixed `macserial` compatibility with iMac20,x serials and other models from 2020 -- Added `LegacyCommpage` quirk to improve pre-SSSE3 userspace compatibility -- Fixed legacy SATA HDDs displaying as external drives in the picker - -#### v0.6.1 -- Improved recognition of early pressed hotkeys, thx @varahash -- Made DMG loading support configurable via `DmgLoading` -- Added iMac20,1 and iMac20,2 model codes -- Fixed display name for older Xeon CPUs like Xeon E5450 -- Added Comet Lake-LP HDA device code -- Fixed OS boot selection on SATA controllers with legacy OPROMs -- Fixed RSDP ACPI table checksum recalculation -- Added immutablekernel loading support for 10.13+ -- Fixed solving some symbols to zero in 11.0 kext inject -- Reduced OpenCanopy size by restricting boot management access -- Added `BuiltinText` variant for `TextRenderer` for older laptops -- Fixed `SyncRuntimePermissions` creating invalid MAT table -- Added EFI FAT image loading support (macOS 10.8 and earlier) -- Added 64-bit cacheless kext injection and patching support (macOS 10.9 and earlier) -- Added 64-bit mkext kext injection and patching support (macOS 10.6 and earlier) -- Fixed XNU hook matching non-kernel files -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed patching of ACPI tables in low memory -- Fixed macOS 11.0 DMG recovery loading without hotplug -- Fixed `XhciPortLimit` quirk on 10.12.6 and possibly other versions -- Fixed `IncreasePciBarSize` quirk on 10.11.5 and possibly other versions -- Fixed `LapicKernelPanic` quirk on 10.8.5 and possibly other versions -- Fixed hard-lock caused by EHCI SMI in OpenDuetPkg -- Added preview UEFI Secure Boot compatibility -- Added `FuzzyMatch` option to support fuzzy kernelcache matching on 10.6 and earlier -- Added `KernelArch` option to specify architecture preference on older kernels -- Added `KernelCache` option to specify kernel caching preference for older kernels -- Added `Force` section to provide support for injecting drivers in older macOS -- Changed kernel driver injection to happen prior to kernel driver patching -- Added `Arch` filtering option to `Add`, `Block`, `Force`, and `Patch` sections -- Added `DisableLinkeditJettison` quirk to workaround 11.0b5 kernel panics -- Added debugging of missing fields in the configuration - -#### v0.6.0 -- Fixed sound corruption with AudioDxe -- Fixed icon choice for Apple FW update in OpenCanopy -- Fixed APFS driver loading on Fusion Drive -- Added Comet Lake HDA device code -- Fixed audio stream position reporting on non-Intel platforms -- Added `Firmware` mode to `ResetSystem` to reboot into preferences -- Replaced `BlacklistAppleUpdate` with `run-efi-updater` NVRAM variable -- Fixed reset value and detection in `FadtEnableReset` ACPI quirk -- Fixed freezes during boot option expansion with PXE boot entries -- Updated underlying EDK II package to edk2-stable202005 -- Added `ProvideMaxSlide` quirk to improve laptop stability, thx @zhen-zen -- Fixed slide choice on platforms when 0 slide is unavailable, thx @zhen-zen -- Fixed assertions caused by unaligned file path access in DEBUG builds -- Renamed `ConfigValidity` utility to `ocvalidate` for consistency -- Added `GlobalConnect` for APFS loading to workaround older firmware issues -- Added 11.0 support for `AvoidRuntimeDefrag` Booter quirk -- Fixed 11.0 lapic kernel quirk as of DP1 -- Improved boot selection scripts for macOS without NVRAM -- Added UGA protocol compatibility in `ProvideConsoleGop` quirk -- Added `UgaPassThrough` option to support UGA protocol over GOP -- Added `AppleFramebufferInfo` protocol implementation and override -- Fixed serial initialisation when file logging is disabled -- Fixed FSBFrequency reporting on Meron and similar CPUs -- Fixed incorrect volume icon dimension requirements in OpenCanopy -- Added preview version of KernelCollection injection code -- Fixed ACPI reset register detection in DxeIpl -- Added MacBookPro16,4 model code -- Updated builtin firmware versions for SMBIOS and the rest -- Fixed OSXSAVE reporting when emulating CPUID on newer CPUs -- Added `SerialInit` option to perform serial initialisation separately -- Fixed OpenDuetPkg booting on Intel G33 with SATA controller in RAID mode -- `PlatformInfo` `Automatic` for all models -- Fixed 32-bit OpenDuetPkg booting on machines with over 4 GBs of RAM -- Fixed delays with OpenDuetPkg booting with certain SATA controllers in IDE mode -- Fixed display name for some high core count i9 CPUs like 7920X -- Fixed SSDT-EC-USBX - -#### v0.5.9 -- Added full HiDPI support in OpenCanopy -- Improved OpenCanopy font rendering by using CoreText -- Fixed light and custom background font rendering -- Added `Boot####` options support in boot entry listing -- Removed `HideSelf` by pattern recognising `BOOTx64.efi` -- Added `BlacklistAppleUpdate` to avoid Apple FW updates -- Fixed accidental tool and NVRAM reset booting by default -- Fixed unrecognised select `com.apple.recovery.boot` entries -- Changed NVRAM reset not to erase `BootProtect` boot options -- Improved boot performance when picker UI is disabled -- Enforced the use of builtin picker when external fails -- Fixed warnings for empty NVRAM variables (e.g. rtc-blacklist) -- Added `ApplePanic` to store panic logs on ESP root -- Fixed `ReconnectOnResChange` reconnecting even without res change -- Fixed OpenCanopy showing internal icons for external drives -- Fixed OpenCanopy launching Shell with text over it -- Added partial hotkey support to OpenCanopy (e.g. Ctrl+Enter) -- Added builtin text renderer compatibility with Shell page mode -- Fixed `FadtEnableReset` with too small FACP tables and some laptops -- Fixed CPU detection crash with QEMU 5.0 and KVM accelerator -- Removed `RequestBootVarFallback` due to numerous bugs -- Added `DeduplicateBootOrder` UEFI quirk -- Removed `DirectGopCacheMode` due to being ineffective -- Fixed assertions on log exhaustion causing boot failures -- Fixed builtin text renderer failing to provide ConsoleControl -- Fixed compatibility with blit-only GOP (e.g. OVMF Bochs) -- Fixed ignoring `#` in DeviceProperty and NVRAM `Delete` -- Renamed `Block` to `Delete` in `ACPI`,`DeviceProperties`, and `NVRAM` -- Added MacBookPro16,2 and MacBookPro16,3 model codes -- Added PCI device scanning policy support (e.g. VIRTIO) -- Improved playback performance in AudioDxe -- Updated builtin firmware versions for SMBIOS and the rest -- Added improved CPU type detection for newer CPU types -- Added ConfigValidity utility and improved config validation -- Added serial port initialisation for serial debug logging -- Disabled empty debug log file creation to avoid ESP cluttering -- Added `TscSyncTimeout` quirk to workaround debug kernel assertions -- Added first-class Windows support to bless model -- Fixed `LapicKernelPanic` kernel quirk on 10.9 -- Added prebuilt version of `CrScreenshotDxe` driver -- Fixed Hyper-V frequency detection compatibility -- Added `SysReport` option for DEBUG builds to dump system info -- Fixed crashes on some AMD firmware when performing keyboard input - -#### v0.5.8 -- Fixed invalid CPU object reference in SSDT-PLUG -- Fixed incorrect utilities and resources packaging -- Fixed `Custom` `UpdateSMBIOSMode` modifying SMBIOSv3 table -- Updated docs to cover separating SMBIOS via `UpdateSMBIOSMode` -- Fixed rendering macOS installer icons in OpenCanopy -- Added APFS support with Fusion Drive and enhanced security -- Added AppleEvent mouse support in OpenCanopy -- Fixed AppleEvent and OpenCanopy compatibility with OVMF TPL restrictions -- Added mouse drivers to the package as OVMF needs one -- Added memory region reservation support -- Added RtcRw tool to manipulate RTC memory -- Added `PatchAppleRtcChecksum` kernel quirk -- Added `AppleRtcRam` protocol implementation -- Renamed `Protocols` to `ProtocolOverrides` for clarity -- Added ResetSystem tool to allow shutdown/reset actions in the menu -- Added experimental `BootProtect` `Security` option -- Fixed kext injection in 10.8 installer -- Added timeout support to OpenCanopy user interface -- Fixed handling 24-bit screen resolutions -- Added `Ps2KeyboardDxe` driver for DuetPkg -- Updated `BootInstall` DuetPkg version (now opensource) -- Added partial HiDPI support in OpenCanopy -- Update builtin firmware -- Fixed invalid checksum checks when creating vault (thx @dakanji) - -#### v0.5.7 -- Added TimeMachine detection to picker -- Added early preview version of OpenCanopy -- Fixed FS discovery on NVMe with legacy drivers -- Added `DirectGopCacheMode` option for FB cache policy -- Added `KeyFiltering` option to workaround buggy KB drivers -- Added tool and custom entry separation in audio assistant -- Added `OpenControl` tool to configure full NVRAM access from Shell -- Added `boot.efi` debug protocol support for 10.15.4+ -- Added `boot.efi` performance logging for 10.15.4+ -- Added `ProtectUefiServices` quirk to fix `DevirtualiseMmio` on Z390 -- Replaced `BOOTCAMP Windows` with `Windows` to match the original -- Added bundled `OpenShell` originally available as OpenCoreShell -- Rework `readlabel` utility into `disklabel` with encoding support -- Renamed `FwRuntimeServices` driver to `OpenRuntime` -- Renamed `AppleUsbKbDxe` driver to `OpenUsbKbDxe` -- Update builtin firmware -- Fixed `PowerTimeoutKernelPanic` on 10.15.4 -- Fixed 4K section alignment in `OpenRuntime` to fix Linux booting on SKL -- Introduced `SyncRuntimePermissions` to fix multiple memory permission flaws -- Introduced `RebuildAppleMemoryMap` to fix macOS booting on Dell 5490 -- Removed `ShrinkMemoryMap` in favour of more advanced `RebuildAppleMemoryMap` -- Marked `EnableWriteUnprotector` as deprecated on modern systems -- Introduced `ProtectMemoryRegions` to fix memory region handling -- Removed `ProtectCsmRegion` in favour of `ProtectMemoryRegions` -- Renamed `PickerAttributes` to `ConsoleAttributes` -- Introduced `PickerAttributes` as a matter of UI configuration - -#### v0.5.6 -- Various improvements to builtin text renderer -- Fixed locating DMG recovery in APTIO IV firmware on FAT32 -- Fixed loading DMG recovery in APTIO IV firmware on FAT32 -- Removed `AvoidHighAlloc` quirk due to removed I/O over 4GB -- Moved `ConsoleMode`, `Resolution` options to `Output` section -- Moved console-related UEFI quirks to `Output` section -- Replaced `ConsoleControl` and `BuiltinTextRenderer` with `TextRenderer` -- Removed `ConsoleBehaviourOs` and `ConsoleBehaviourUi` -- Fixed providing ConsoleOutHandle GOP when running from Shell -- Added `PickerAttributes` option to colour picker -- Added `ProtectSecureBoot` option through FwRuntimeServices -- Replaced `RequireVault` and `RequireSignature` with `Vault` -- Added `BootKicker` tool to support launching Apple BootPicker -- Added BootPicker support as an external UI in OC through `PickerMode` -- Added `DirectGopRendering` option to use direct GOP output -- Multiple memory corruption and performance fixes for PNG support -- Fixed `DefaultBackgroundColor` variable handling -- Added `HideAuxiliary` and `Auxiliary` options -- Fixed picker timeout and log timestamps for VMware -- Fixed NULL parent DeviceHandle for launched tools -- Added bundled HiiDatabase driver for very old firmware -- Added SSE2 support in memory intrinsics for better performance -- Improved ACPI PM timer CPU frequency calculation performance -- Improved LapicKernelPanic compatibility with newer macOS versions -- Fixed drivers starting with `#` not being skipped -- Added audio support through AudioDxe with optional boot chime -- Added VoiceOver accessability support in boot.efi for 10.13+ -- Added `PickerAudioAssist` option for audio assistance in picker -- Added `HdaCodecDump.efi` tool in default package -- Added legacy AudioDxe and Microsoft namespaces to Reset NVRAM -- Merged `OcSupportPkg` with `OpenCorePkg` for easier bisection -- Disabled warnings in release versions of NVMe and XHCI drivers - -#### v0.5.5 -- Fixed CPU bus ratio calculation for Nehalem and Westmere -- Fixed CPU package calculation on MacPro5,1 and similar -- Improved OpenCore rerun detection for new versions -- Fixed loading picker on boot failure when it is hidden -- Added PMC ACPI sample for 300-series chipsets -- Improved driver connection performance on APTIO IV -- Fixed boot option saving in LogoutHook.command -- Added support for OEM information in `ExposeSensitiveData` -- Improved `SanitiseClearScreen` to avoid mode switching -- Replaced `SupportsCsm` with `AdviseWindows` enabling UEFI mode -- Fixed issues with default boot path selection on some boards -- Update builtin firmware versions -- Fixed `AdviseWindows` not setting `FirmwareFeatures` in NVRAM -- Added `TakeoffDelay` option for improved action hotkey support -- Added Mac GOP support to `ProvideConsoleGop` quirk -- Added experimental `BuiltinTextRenderer` boot option -- Added `DummyPowerManagement` kernel quirk to disable CPU PM - -#### v0.5.4 -- Added Enter key handling in boot menu for quick proceed -- Update builtin firmware versions -- Bundled FwRuntimeServices driver with OpenCore -- Allowed writing to non-volatile variables with disabled write -- Fixed microcode reading on Intel CPUs -- Fixed SMBIOS Type4 External Clock values -- Improved Windows compatibility on some setups (acidanthera/bugtracker#614) -- Added `SupportsCsm` and option in `PlatformInfo/Generic` -- Added `OSInfo` protocol support -- Added `SignalAppleOS` `Booter` quirk to enable IGPU on Macs in other OS -- Added `AppleSmcIo`protocol support (replaces `VirtualSmc` UEFI driver) -- Added `AuthRestart` security property for VirtualSMC authenticated restart -- Fixed input protocol initialisation on VMware fusion -- Added arrow key handling in boot menu -- FileVault 2-like key input is now the only supported input in boot menu -- Fixed 5 second delay when exiting Shell to OpenCore Picker -- Added default boot option update and `AllowSetDefault` `Security` option -- Fixed CPU package detection on configurations with multiple CPUs -- Bundled CleanNvram and VerifyMsrE2 tools for debugging -- Added screen clearing after choosing boot entry in picker -- Added `WriteFlash` NVRAM option to enable writing variables in `Add` -- Added `LegacyOverwrite` NVRAM option to allow overwriting variables by nvram.plist -- Added `AppleXcpmForceBoost` kernel quirk to maximise select Xeon performance -- Bundled NvmExpressDxe and XhciDxe drivers for platforms that need them -- Added `IncreasePciBarSize` kernel quirk for select platforms with PCI space issues - -#### v0.5.3 -- Update builtin firmware versions -- Fixed interpreting letters in boot menu -- Fixed timeout abortion with PollAppleHotKeys quirk -- Fixed rare kext injection failure due to plist-only kext in prelinkedkernel -- Fixed error reporting for dmg loading -- Added various debugging improvements -- Added new crypto stack resulting in vault key format changes -- Added `UnblockFsConnect` UEFI quirk to fix missing filesystems on some laptops -- Added `RequestBootVarFallback` UEFI quirk to circumvent firmware boot option issues -- Added `ThirdPartyDrives` kernel quirk fixing SSD trim and 10.15 SATA hibernation (thx @lvs1974) -- Removed `ThirdPartyTrim` kernel quirk in favour of `ThirdPartyDrives` -- Added Intel Xeon E5 (Broadwell-EP) support (thx @crazyi) -- Switched to edk2-stable201911, which is now the minimum supportd EDK II version - -#### v0.5.2 -- Fixed `MinKernel` and `MaxKernel` logic (thx @dhinakg, @reitermarkus) -- Fixed ASSERT when booting non-Apple OSes without arguments from the DEBUG version -- Added `MmioWhitelist` configuration option -- Added `PowerTimeoutKernelPanic` kernel quirk -- Fixed erratic cursor appearing in release builds -- Moved `ReconnectOnResChange` to a user-configurable quirk to avoid freezes -- Added OpenCore version to picker ui, configured by `ExposeSensitiveData` -- Added hypervisor CPUID support to work with virtualization (thx @Leoyzen) - -#### v0.5.1 -- Added support of kernel resource kext injection -- Added support for 0.25% clock slowdown on Xeon Scalable CPUs (thx @mrmiller) -- Replaced `MatchKernel` with `MinKernel` and `MaxKernel` -- Added `Arguments` to `Tools` and `Entries` sections -- Fixed broken timer for 300 series Intel chipsets -- Added `Input` section for mouse and keyboard aggregation - -#### v0.5.0 -- Added builtin firmware versions for new models 2019 -- Fixed LogoutHook leaving random directories in `$HOME` -- Fixed FSBFrequency calculation on Xeon Scalable CPUs (thx @mrmiller) -- Fixed ARTFrequency specifying on Intel server and atom models -- Increased log size to 256 KB by default -- Added `ReplaceTabWithSpace` quirk to improve Shell experience -- Added `ClearScreenOnModeSwitch` quirk to avoid visual glitches -- Added `MISC_PWR_MGMT` patch to `AppleXcpmExtraMsrs` quirk (thx @mrmiller) -- Added `DevirtualiseMmio` quirk to `Booter` section -- Added FileVault 2 user interface protocols formerly in AppleUiSupport -- Improved kernel patch logging to include configuration comments -- Added MSFT basic data and Linux root fs recognition to `ScanPolicy` -- Fixed RT region protection restoration regression (thx Sniki) -- Added `OPT`, `CMD+R`, `CMD+OPT+P+R` boot action hotkey support -- Added `PollAppleHotKeys` to register boot.efi hotkeys in the picker -- Added `DisableSingleUser` quirk to prohibit single user mode -- Upgraded EDK II base package to edk2-stable201908 -- Prohibited argument changing by BootNext - -#### v0.0.4 -- Fixed kext injection issues with dummy dependencies -- Fixed kext injection issues with reused vtables -- Fixed Custom SMBIOS table update patches -- Added timestamp to the log file and changed extension to txt -- Enhanced `LogoutHook` script used for emulated NVRAM saving -- Fixed multiple operating system support in APFS containers -- Added `AvoidHighAlloc` UEFI quirk to avoid high memory allocs -- Updated builtin firmware versions for 10.15 beta support -- Added `Booter` section for Apple bootloader preferences -- Dropped `AptioMemoryFix.efi` support for `Booter` and `FwRuntimeServices.efi` -- Fixed hibernation issues in Windows with `RequestBootVarRouting` -- Significantly improved boot stability on APTIO -- Added support for Windows & OpenCore on the same drive through `BlessOverride` -- Added advanced user-specified boot entries through `Misc` -> `Entries` -- Added `DisableVariableWrite` quirk to disable hardware NVRAM write in macOS - -#### v0.0.3 -- Added complete modern platform database (2012+) -- Added `DisableIoMapper` kernel quirk -- Fixed ACPI modification failures with nested multiboot -- Dropped `IgnoreForWindows` quirk legacy -- Added basic AMD Zen CPU support -- Added `Misc` -> `Tools` section to add third-party tools -- Added `Kernel` -> `Emulate` section for CPUID patches -- Added `CustomSMBIOSGuid` quirk for Custom SMBIOS update mode -- Added `PanicNoKextDump` quirk to avoid kext dump in panics -- Switched to EDK II stable and reduced image size -- Added `LapicKernelPanic` kernel quirk -- Added `AppleXcpmExtraMsrs` quirk and improved XCPM patches -- Added `(external)` suffix for external drives in boot menu -- Added `UsePicker` option, do enable for OC boot management -- Added nvram.plist loading for legacy and incompatible platforms -- Improved instructions for legacy and Windows installation -- Added Windows Boot Camp switching support -- Added basic hibernation detection & support -- Added `ResetHwSig` ACPI quirk to workaround hibernation -- Removed `Custom` subfolder requirement from `ACPI` tables -- Fixed kext injection in 10.7.x and 10.8.x -- Added ESP partition type detection to ScanPolicy -- Added support for third-party user interfaces - -#### v0.0.2 -- Documentation improvements (see Differences.pdf) -- Platform information database updates -- Fixed misbehaving `Debug` -> `Target` enable bit -- Added `ResetLogoStatus` ACPI quirk -- Added `SpoofVendor` PlatformInfo feature -- Replaced `ExposeBootPath` with `ExposeSensitiveData` -- Added builtin implementation of Data Hub protocol -- Dropped `UpdateSMBIOSMode` `Auto` mode in favour of `Create` -- Fixed SMBIOS CPU detection for Xeon and Core models -- Moved `ConsoleControl` configuration to `Protocols` -- Added `Security` -> `ScanPolicy` preference -- Fixed invalid `board-rev` exposure in Data Hub -- Fixed SMBIOS Type 133 table exposure -- Added support for SMBIOS Type 134 table exposure - -#### v0.0.1 -- Initial developer preview release diff --git a/hackintosh-guide/downloads.md b/hackintosh-guide/downloads.md deleted file mode 100755 index 8f5a989..0000000 --- a/hackintosh-guide/downloads.md +++ /dev/null @@ -1,246 +0,0 @@ -# Descargas - Links y Archivos Necesarios - -## 📦 Archivos Esenciales - -### Bootloader - -| Archivo | Versión | Link | -|---------|---------|------| -| **OpenCore** | 0.9.7+ | [github.com/acidanthera/OpenCorePkg/releases](https://github.com/acidanthera/OpenCorePkg/releases) | -| **OCAuxiliaryTools** | Latest | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | -| **ProperTree** | Latest | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | -| **GenSMBIOS** | Latest | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | - -### Kexts Principales (Acidanthera) - -| Kext | Versión | Link | -|------|---------|------| -| **Lilu.kext** | 1.6.8+ | [github.com/acidanthera/Lilu/releases](https://github.com/acidanthera/Lilu/releases) | -| **VirtualSMC.kext** | 1.3.4+ | [github.com/acidanthera/VirtualSMC/releases](https://github.com/acidanthera/VirtualSMC/releases) | -| **WhateverGreen.kext** | 1.6.7+ | [github.com/acidanthera/WhateverGreen/releases](https://github.com/acidanthera/WhateverGreen/releases) | -| **AppleALC.kext** | 1.8.8+ | [github.com/acidanthera/AppleALC/releases](https://github.com/acidanthera/AppleALC/releases) | -| **VoodooPS2Controller.kext** | 2.3.0+ | [github.com/acidanthera/VoodooPS2Controller/releases](https://github.com/acidanthera/VoodooPS2Controller/releases) | -| **FeatureUnlock.kext** | 1.1.4+ | [github.com/acidanthera/FeatureUnlock/releases](https://github.com/acidanthera/FeatureUnlock/releases) | -| **SMCProcessor.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | -| **SMCSuperIO.kext** | 1.3.4+ | [incluido en VirtualSMC](https://github.com/acidanthera/VirtualSMC/releases) | - -### Kexts de Red - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **AppleIGC.kext** | 1.6 (Mar 2025) | [github.com/SongXiaoXi/AppleIGC/releases](https://github.com/SongXiaoXi/AppleIGC/releases) | Ethernet I225/I226-V 2.5GbE | -| **AirportItlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (interfaz nativa) | -| **itlwm.kext** | 2.3.0 | [github.com/OpenIntelWireless/itlwm/releases](https://github.com/OpenIntelWireless/itlwm/releases) | Wi-Fi Intel (con app Helios) | -| **IntelBluetoothFirmware.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth Intel | -| **IntelBTPatcher.kext** | 2.3.0+ | [github.com/OpenIntelWireless/IntelBluetoothFirmware/releases](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Parche Bluetooth Intel | -| **BlueTool.kext** | 2.3.0+ | [incluido en IntelBluetoothFirmware](https://github.com/OpenIntelWireless/IntelBluetoothFirmware/releases) | Bluetooth | - -### Kexts Adicionales - -| Kext | Versión | Link | Propósito | -|------|---------|------|-----------| -| **BrcmPatchRAM3.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom (alternativa) | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmFirmwareData.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | -| **BrcmBluetoothInjector.kext** | Latest | [github.com/acidanthera/BrcmPatchRAM/releases](https://github.com/acidanthera/BrcmPatchRAM/releases) | Bluetooth Broadcom | - ---- - -## 🛠️ Herramientas - -### Configuración - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Hackintool** | [github.com/headkaze/Hackintool](https://github.com/headkaze/Hackintool) | Configuración completa de hardware | -| **OCAuxiliaryTools (OCT)** | [github.com/ic005k/OCAuxiliaryTools](https://github.com/ic005k/OCAuxiliaryTools) | Editor config.plist con GUI | -| **ProperTree** | [github.com/corpnewt/ProperTree](https://github.com/corpnewt/ProperTree) | Editor plist (cross-platform) | -| **GenSMBIOS** | [github.com/corpnewt/GenSMBIOS](https://github.com/corpnewt/GenSMBIOS) | Generar SMBIOS válido | -| **SSDTTime** | [github.com/corpnewt/SSDTTime](https://github.com/corpnewt/SSDTTime) | Generar SSDTs personalizados | -| **GenPMC** | [github.com/corpnewt/gen-pmc](https://github.com/corpnewt/gen-pmc) | Generar SSDT-PM | - -### Utilidades del Sistema - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | Monitoreo de sistema (menu bar) | -| **KextsViewer** | [github.com/corpnewt/KextsViewer](https://github.com/corpnewt/KextsViewer) | Ver kexts cargados | -| **Haciend** | [incluido en OpenCore](https://github.com/acidanthera/OpenCorePkg) | Consola interactiva OpenCore | -| **BetterDisplay** | [github.com/waydabber/BetterDisplay](https://github.com/waydabber/BetterDisplay) | Gestión de monitores | -| **MonitorControl** | [github.com/MonitorControl/MonitorControl](https://github.com/MonitorControl/MonitorControl) | Control de brillo DDC | - -### Creación de Instalador - -| Herramienta | Link | Propósito | -|-------------|------|-----------| -| **OClter** | [github.com/chris1111/OClter](https://github.com/chris1111/OClter) | Crear USB instalador | -| **createinstallmedia** | (Incluido con macOS) | Método oficial de Apple | -| **BalenaEtcher** | [etcher.balena.io](https://etcher.balena.io) | Flashear USB (alternativa) | - ---- - -## 📚 Documentación - -### Guías Oficiales - -| Guía | Link | -|------|------| -| **Dortania OpenCore Install Guide** | [dortania.github.io/OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Install-Guide/) | -| **Dortania Post-Install Guide** | [dortania.github.io/OpenCore-Post-Install](https://dortania.github.io/OpenCore-Post-Install/) | -| **Dortania Troubleshooting** | [dortania.github.io/Troubleshooting](https://dortania.github.io/Troubleshooting/) | -| **Dortania GPU Buyers Guide** | [dortania.github.io/GPU-Buyers-Guide](https://dortania.github.io/GPU-Buyers-Guide/) | -| **Dortania USB Mapping** | [dortania.github.io/USB-Map-Guide](https://dortania.github.io/USB-Map-Guide/) | - -### Guías Visuales - -| Guía | Link | -|------|------| -| **OpenCore Visual Beginners Guide** | [chriswayg.gitbook.io/opencore-visual-beginners-guide](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/) | -| **Dortania Getting Started** | [dortania.github.io/Getting-Started-With-ACPI](https://dortania.github.io/Getting-Started-With-ACPI/) | - -### Específicos para tu Hardware - -| Recurso | Link | Hardware | -|---------|------|----------| -| **hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore** | [github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore](https://github.com/hackintosh-club/ROG-STRIX-B760-I-GAMING-OpenCore) | ASUS ROG STRIX B760-I | -| **rosewu550/asus-strix-b760-i-hackintosh** | [github.com/rosewu550/asus-strix-b760-i-hackintosh](https://github.com/rosewu550/asus-strix-b760-i-hackintosh) | ASUS B760-I + i9-13900F | -| **chenhe/oc-b760m-13700-6800** | [github.com/ichenhe/oc-b760m-13700-6800](https://github.com/ichenhe/oc-b760m-13700-6800) | MSI B760M + i7-13700 + RX 6800 | -| **Base EFI Raptor Lake** | [github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC](https://github.com/luchina-gabriel/BASE-EFI-INTEL-DESKTOP-13THGEN-14THGEN-RAPTOR-LAKE-PUBLIC) | Intel 13th/14th Gen | - -### Comunidad - -| Sitio | Link | -|-------|------| -| **r/hackintosh** | [reddit.com/r/hackintosh](https://www.reddit.com/r/hackintosh/) | -| **TonyMacx86** | [tonymacx86.com](https://www.tonymacx86.com/) | -| **InsanelyMac** | [insanelymac.com](https://www.insanelymac.com/) | -| **Dortania Discord** | [discord.gg/AbTrsBq](https://discord.gg/AbTrsBq) | - ---- - -## 📱 Aplicaciones macOS Recomendadas - -### Productividad - -| App | Link | -|-----|------| -| **Rectangle** | [rectangleapp.com](https://rectangleapp.com/) | -| **AltTab** | [alt-tab-macos.netlify.app](https://alt-tab-macos.netlify.app/) | -| **Karabiner-Elements** | [karabiner-elements.pqrs.org](https://karabiner-elements.pqrs.org/) | -| **BetterTouchTool** | [boastr.net](https://boastr.net/) | - -### Monitoreo - -| App | Link | -|-----|------| -| **Stats** | [github.com/exelban/stats](https://github.com/exelban/stats) | -| **iStat Menus** | [bjango.com/mac/istatmenus](https://bjango.com/mac/istatmenus/) | -| **Activity Monitor** | (Incluido con macOS) | - -### Backups - -| App | Link | -|-----|------| -| **Time Machine** | (Incluido con macOS) | -| **Carbon Copy Cloner** | [bombich.com](https://bombich.com/) | -| **SuperDuper!** | [shirt-pocket.com](https://shirt-pocket.com/) | - -### Utilidades - -| App | Link | -|-----|------| -| **The Unarchiver** | [macpaw.com/the-unarchiver](https://macpaw.com/the-unarchiver) | -| **Amphetamine** | [macpaw.com/amphetamine](https://macpaw.com/amphetamine) | -| **HandBrake** | [handbrake.fr](https://handbrake.fr/) | -| **VLC** | [videolan.org/vlc](https://www.videolan.org/vlc/) | - ---- - -## 🔧 Scripts Útiles - -### Descargar y Usar GenSMBIOS - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/GenSMBIOS.git -cd GenSMBIOS - -# Ejecutar -python3 gensmbios.py - -# Seguir instrucciones -``` - -### Descargar y Usar SSDTTime - -```bash -# Clonar repositorio -git clone https://github.com/corpnewt/SSDTTime.git -cd SSDTime - -# Dar permisos -chmod +x SSDTTime.sh - -# Ejecutar -./SSDTTime.sh -``` - -### Descargar Hackintool - -```bash -# Descargar desde releases -# o usar Homebrew (si está instalado) -brew install --cask hackintool -``` - ---- - -## 📝 Notas de Versiones - -### OpenCore -- **Versión actual estable**: 0.9.7 -- **Rama de desarrollo**: 0.9.8+ (experimental) -- **Recomendación**: Usar siempre versión estable - -### macOS (2026) -- **Última versión**: macOS Sequoia 15.x -- **Soporte**: macOS Sequoia, Sonoma 14.x, Ventura 13.x -- **Recomendación**: Sequoia 15.x para hardware más nuevo - -### Kexts -- Actualizar **Lilu** primero (es la base de muchos kexts) -- **WhateverGreen** se actualiza frecuentemente para nuevas GPUs -- **AppleIGC** tiene actualizaciones específicas para Sequoia - ---- - -## ⚠️ Fuentes Confiables - -**SIEMPRE descargar desde**: -- **GitHub releases** (proyectos oficiales) -- **Dortania guides** (documentación verificada) -- **Acidanthera** (kexts oficiales) - -**NUNCA descargar desde**: -- Sitios de dudosa reputación -- Foros con archivos adjuntos -- YouTube sin verificar fuente - ---- - -## 📋 Orden de Descarga Recomendado - -1. **OpenCore** (bootloader) -2. **Lilu** (base kext) -3. **VirtualSMC** + plugins -4. **WhateverGreen** (GPU) -5. **AppleALC** (audio) -6. **AppleIGC** (Ethernet) -7. **AirportItlwm** + **IntelBluetoothFirmware** (Wi-Fi/Bluetooth) -8. **VoodooPS2Controller** (teclado/PS2) -9. **OCAuxiliaryTools** (editor config.plist) -10. **GenSMBIOS** (generar SMBIOS) - ---- - -**Volver a [README.md](README.md)** diff --git a/hackintosh-guide/gibMacOS-master/Readme.md b/hackintosh-guide/gibMacOS-master/Readme.md deleted file mode 100755 index 518a57a..0000000 --- a/hackintosh-guide/gibMacOS-master/Readme.md +++ /dev/null @@ -1,14 +0,0 @@ -Py2/py3 script that can download macOS components direct from Apple - -Can also now build Internet Recovery USB installers from Windows using [dd](http://www.chrysocome.net/dd) and [7zip](https://www.7-zip.org/download.html). - -**NOTE:** As of macOS 11 (Big Sur), Apple has changed the way they distribute macOS, and internet recovery USBs can no longer be built via MakeInstall on Windows. macOS versions through Catalina will still work though. - -**NOTE 2:** As of macOS 11 (Big Sur), Apple distributes the OS via an InstallAssistant.pkg file. `BuildmacOSInstallApp.command` is not needed to create the install application when in macOS in this case - and you can simply run `InstallAssistant.pkg`, which will place the install app in your /Applications folder on macOS. - -Thanks to: - -* FoxletFox for [FetchMacOS](http://www.insanelymac.com/forum/topic/326366-fetchmacos-a-tool-to-download-macos-on-non-mac-platforms/) and outlining the URL setup -* munki for his [macadmin-scripts](https://github.com/munki/macadmin-scripts) -* timsutton for [brigadier](https://github.com/timsutton/brigadier) -* wolfmannight for [manOSDownloader_rc](https://www.insanelymac.com/forum/topic/338810-create-legit-copy-of-macos-from-apple-catalog/) off which BuildmacOSInstallApp.command is based diff --git a/hackintosh-guide/kexts-downloaded/AppleIGC.kext/Contents/Resources/README.md b/hackintosh-guide/kexts-downloaded/AppleIGC.kext/Contents/Resources/README.md deleted file mode 100755 index 1b64af0..0000000 --- a/hackintosh-guide/kexts-downloaded/AppleIGC.kext/Contents/Resources/README.md +++ /dev/null @@ -1,19 +0,0 @@ -# AppleIGC - -Intel 2.5G Ethernet driver for macOS. Based on the Intel igc implementation in Linux commit 0bf913e07b377cfc288cfe488ca30b7d67059d8a. - -In theory, it will have better performance than the AppleEthernetE1000 driver implemented in user space. It's also more stable for me, since macOS Monterey's AppleEthernetE1000 on i226-V immediately causes a kernel panic. - -Only test on macOS Monterey 12.6.1 with Intel i226-V for days. -It should work on other versions macOS and all igc compliant devices(i225, i226 and others) whose PCI id may not be filled in the IOPCIMatch. (You can fill it out yourself to test.) Use at your own risk. - -## Features -- TCP checksum -- TSO and TSO6 -- Others, such as hardware stripping and stuffing of 802.1q VLAN tags and energy efficient ethernet, have not yet been tested. - -## Known Issues -- Only work in auto-negotiation mode. "Force mode currently not supported." (from `igc_ethtool_set_link_ksettings()` in igc_ethtool.c) - -## Credit -- [AppleIGB](https://github.com/Shaneee/AppleIGB) diff --git a/hackintosh-guide/luchina-efi/EFI-ROG-MAXIMUS-Z790-HERO-INTEL-i7-13700K-RX-6900-XT-WIFI-INTEL-20251027-PUBLIC-main/README.md b/hackintosh-guide/luchina-efi/EFI-ROG-MAXIMUS-Z790-HERO-INTEL-i7-13700K-RX-6900-XT-WIFI-INTEL-20251027-PUBLIC-main/README.md deleted file mode 100755 index 371a138..0000000 --- a/hackintosh-guide/luchina-efi/EFI-ROG-MAXIMUS-Z790-HERO-INTEL-i7-13700K-RX-6900-XT-WIFI-INTEL-20251027-PUBLIC-main/README.md +++ /dev/null @@ -1,61 +0,0 @@ -# Hackintosh, Asus ROG MAXIMUS Z790 HERO, Intel Core i7-13700K, AMD Radeon RX 6900 XT - -Portfolio - -# Basic Information - -**Latest working macOS**: macOS Sequoia (15.7.1) -
-**Current OpenCore**: 1.0.5 -
-**Release date**: 28/10/2025 - -# Hackintosh Specifications -|Item|Description| -|-|:-------:| -|🖥️ Motherboard|Asus ROG Maximus Z790 Hero| -|⚙️ Processador|Intel Core i7-13700K| -|🔩 Memory|2x 32Gb DDR5/4800Mhz [Kingston Fury KF556C36-32]| -|🎮 dGPU|AMD Radeon RX 6900 XT| -|🎮 iGPU|Intel UHD Graphics 770| -|🎧 Audio Codec|Realtek ALC4082 ROG SupremeFX| -|🌐 Ethernet|Intel(R) Ethernet Controller I226-V| -|🛜 Wireless/BT|Intel(R) Wi-Fi 6E AX211 160MHz| -|💾 Storage|WD_BLACK SN850X 1000GB (1000 GB, PCI-E 4.0 x4)| -|💾 Storage|WD_BLACK SN850X 1000GB (1000 GB, PCI-E 4.0 x4)| -|💾 Storage|WD_BLACK SN850X 4000GB (4000 GB, PCI-E 4.0 x4)| - -# Geekbench v6 Score [CPU/⚙️] -✴️ 2.834 Single Core -
-✴️ 17.970 Multi Core - -# Geekbench v6 Score [GPU/🎮] -✅ 111.575 OpenCL -
-✅ 252.251 Metal API - -# Geekbench Ai Score [CPU/⚙️] -✨ 1.707 Single Precision -
-✨ 185 Half Precision -
-✨ 140 Quantized - -# Geekbench Ai Score [GPU/🎮] -🔥 9.203 Single Precision -
-🔥 9.306 Half Precision -
-🔥 2.104 Quantized - -## Hackintosh Creator -- [Gabriel Luchina - Universo Hackintosh](https://luchina.com.br) - -## How to get a copy of EFI -- 🇺🇸 Hire the remote installation service via the email below -- 🇧🇷 Contrate o serviço de instalação remota pelo e-mail abaixo -- 🛠️ [consultoria@universohackintosh.com.br](mailto:consultoria@universohackintosh.com.br) - -## Discord - Universo Hackintosh -- [Access Discord](https://discord.universohackintosh.com.br) diff --git a/hackintosh-guide/troubleshooting/troubleshooting.md b/hackintosh-guide/troubleshooting/troubleshooting.md deleted file mode 100755 index a3388ac..0000000 --- a/hackintosh-guide/troubleshooting/troubleshooting.md +++ /dev/null @@ -1,382 +0,0 @@ -# Solución de Problemas - Troubleshooting - -## 🚨 Kernel Panic (Pantalla con texto vertical) - -### Síntomas -- Pantalla negra con texto blanco -- Texto en vertical -- Se reinicia constantemente -- "You need to restart your computer" - -### Soluciones - -#### 1. Verificar Configuración BIOS -``` -CFG Lock: DISABLE (o usar config.plist) -VT-d: DISABLE -Above 4G Decoding: ENABLE -``` - -#### 2. Agregar Boot-args de Depuración -En `config.plist` → `Boot` → `NVRAM` → `Add` → `boot-args`: -``` --v keepsyms=1 -``` - -#### 3. Habilitar CfgLock Quirks -En `config.plist` → `Kernel` → `Quirks`: -```xml -AppleCpuPmCfgLock - -AppleXcpmCfgLock - -``` - -#### 4. Verificar Kexts -Asegurarse de tener en `EFI/OC/Kexts/`: -- Lilu.kext -- VirtualSMC.kext -- WhateverGreen.kext - ---- - -## 🖥️ Pantalla Negra después del Apple Logo - -### Síntomas -- Apple logo aparece -- Barra de progreso avanza -- Pantalla se queda negra -- No hay señal de video - -### Soluciones - -#### 1. Verificar WhateverGreen -Asegurarse de que `WhateverGreen.kext` está en `EFI/OC/Kexts/` - -#### 2. Agregar Boot-arg para GPU -En `config.plist` → `Boot` → `NVRAM` → `Add` → `boot-args`: -``` --v agdpmod=pikera -``` - -#### 3. Verificar GPU en DeviceProperties -```xml -DeviceProperties - - Add - - PciRoot(0x0)/Pci(0x2,0x0) - - enable-backlight-registers-fix - AQAAAA== - framebuffer-patch-enable - AQAAAA== - - - -``` - -#### 4. Deshabilitar iGPU (si no la usas) -En BIOS, deshabilitar "Integrated Graphics" o setear GPU primaria a "PCIe" - ---- - -## 🔄 Reinicios Constantes (Boot Loop) - -### Síntomas -- Sistema arranca -- Se reinicia automáticamente -- Nunca llega a la pantalla de instalación - -### Soluciones - -#### 1. Deshabilitar XMP -En BIOS: -``` -AI Overclock Tuner → Manual (en lugar de XMP) -``` - -#### 2. Verificar CPUID Data para Raptor Lake -En `config.plist` → `Kernel` → `Emulate`: -```xml -Cpuid1Data -NxcB/V/QwMA= -Cpuid1Mask -//// -``` - -#### 3. Probar Diferente SMBIOS -En `config.plist` → `PlatformInfo` → `Generic`: -```xml -SystemProductName -iMacPro1,1 -``` - -Alternativas: -- `MacPro7,1` -- `iMac20,1` -- `iMac20,2` - ---- - -## 🌐 No Funciona Ethernet - -### Síntomas -- "Cable desconectado" -- No hay conexión de red -- Network Interface no aparece - -### Soluciones - -#### 1. Verificar AppleIGC.kext -```bash -# En Terminal -kextstat | grep AppleIGC -``` - -Si no aparece, verificar: -- `AppleIGC.kext` está en `EFI/OC/Kexts/` -- Está habilitado en `config.plist` - -#### 2. Habilitar Network Stack en BIOS -``` -Advanced → Network Stack Configuration → Network Stack: ENABLE -``` - -#### 3. Verificar Versión de AppleIGC -- Sequoia 15.x: AppleIGC v1.6 -- Sonoma 14.x: AppleIGC v1.4 o v1.5 - ---- - -## 📡 No Funciona Wi-Fi (Intel AX211) - -### Síntomas -- Wi-Fi no aparece en ajustes -- "No hay hardware de Wi-Fi instalado" - -### Soluciones - -#### Opción A: Usar AirportItlwm -```bash -# Verificar kext cargado -kextstat | grep itlwm -``` - -Si no aparece: -1. Verificar `AirportItlwm.kext` está en `EFI/OC/Kexts/` -2. Verificar MaxKernel/MinKernel en config.plist - -#### Opción B: Usar itlwm + Helios -1. Reemplazar `AirportItlwm.kext` con `itlwm.kext` -2. Descargar app Helios -3. Abrir Helios para conectar a redes - -#### Verificar Versiones -- Sequoia 15.2+: Puede tener problemas -- Sonoma 14.x: Compatible -- AirportItlwm v2.3.0 para Sonoma - ---- - -## 🔵 No Funciona Bluetooth - -### Síntomas -- Bluetooth no se puede activar -- No aparecen dispositivos - -### Soluciones - -#### 1. Verificar 3 Kexts de Bluetooth -Asegurarse de tener en `EFI/OC/Kexts/`: -- `IntelBluetoothFirmware.kext` -- `IntelBTPatcher.kext` -- `BlueTool.kext` (opcional, incluido en el anterior) - -#### 2. Verificar Cargados -```bash -kextstat | grep Bluetooth -``` - -#### 3. Agregar Patch si es Necesario -En `config.plist` → `Kernel` → `Quirks`: -```xml -ExtendBTFeatureFlags - -``` - ---- - -## 🔊 No Funciona Audio - -### Síntomas -- No hay sonido -- Altavoz/grabadora no aparece -- Icono de volumen está gris - -### Soluciones - -#### 1. Verificar AppleALC -```bash -kextstat | grep AppleALC -``` - -#### 2. Probar Diferentes Layout IDs -En `config.plist` → `DeviceProperties`: - -| Layout ID | Data (Base64) | Uso | -|-----------|---------------|-----| -| 1 | `AQAAAA==` | Salida estándar | -| 3 | `AwAAAA==` | Speaker + Line Out | -| 7 | `BwAAAA==` | Realtek genérico | -| 11 | `CwAAAA==` | ALC897/1220 | -| 13 | `DQAAAA==` | ALC1220 | -| 28 | `GwAAAA==` | 5.1 Surround | -| 99 | `bwAAAA==` | Built-in + Headphone | - -#### 3. Usar Hackintool para Detectar Layout -1. Abrir Hackintool -2. Ir a Audio -3. Select Audio Codec → Realtek ALC897 -4. Probar layouts con "Test Audio" - ---- - -## ⚡ Power Management No Funciona - -### Síntomas -- CPU siempre a máxima frecuencia -- Altas temperaturas -- No hace speed stepping - -### Soluciones - -#### 1. Verificar SSDT-PLUG -`SSDT-PLUG.aml` debe estar en `EFI/OC/ACPI/` - -#### 2. Generar SSDT-PM -Usar SSDTTime: -```bash -./SSDTTime.sh -# Seleccionar 1 (Basic) -# Seleccionar 1 (PM) -``` - -#### 3. Verificar DummyPowerManagement -En `config.plist` → `Kernel` → `Emulate`: -```xml -DummyPowerManagement - -``` - -Debe ser `false` para habilitar PM. - ---- - -## 🔋 Sleep/Wake No Funciona - -### Síntomas -- No se puede dormir -- Se despierta solo -- Kernel panic al despertar - -### Soluciones - -#### 1. Verificar SSDT-EC -`SSDT-EC.aml` es OBLIGATORIO y debe estar en `EFI/OC/ACPI/` - -#### 2. Deshabilitar Power Nap -En Ajustes del Sistema → Batería → Opciones: -``` -Power Nap: Deshabilitado -``` - -#### 3. Verificar DarkWake -En `config.plist` → `Boot` → `NVRAM` → `Add` → `boot-args`: -``` -darkwake=0 -``` - ---- - -## 🐌 Sistema Lento - -### Síntomas -- Arranque lento -- Apps lentas -- Alto uso de CPU - -### Soluciones - -#### 1. Verificar GPU Acceleration -```bash -# En Terminal -metalinfo -``` - -Debe mostrar "Metal Support: YES" - -#### 2. Verificar Swap -```bash -# En Terminal -sysctl vm.swapusage -``` - -#### 3. Deshabilitar Indexación (si es necesario) -```bash -sudo mdutil -s / -sudo mdutil -d / -``` - ---- - -## 📝 Ver Logs del Sistema - -### Obtener Logs - -#### 1. Log de Arranque -```bash -log show --predicate 'process == "kernel"' --last boot -``` - -#### 2. Log de OpenCore -En el USB EFI, ver `EFI/OC/Logs/` - -#### 3. Reporte del Sistema -``` -Apple menu → Acerca de este Mac → Reporte del Sistema -``` - ---- - -## 🆘 Obtener Ayuda - -### Información Necesaria al Pedir Ayuda - -1. **Hardware Completo** (CPU, GPU, MB, RAM, etc.) -2. **Versión de macOS** -3. **Versión de OpenCore** -4. **config.plist** (adjuntar) -5. **Boot Args** actuales -6. **Kexts** instalados -7. **Screenshot** del problema -8. **Log** de kernel panic (si aplica) - -### Foros Recomendados - -- [r/hackintosh](https://www.reddit.com/r/hackintosh/) -- [TonyMacx86](https://www.tonymacx86.com/) -- [Dortania Discord](https://discord.gg/AbTrsBq) - ---- - -## 📞 Contacto - -Si encuentras un problema no documentado aquí: -1. Revisa [Dortania Troubleshooting](https://dortania.github.io/Troubleshooting/) -2. Busca en foros con tu hardware específico -3. Crea un post con toda la información detallada - ---- - -**Volver a [README.md](../README.md)**