383 lines
7.1 KiB
Markdown
Executable File
383 lines
7.1 KiB
Markdown
Executable File
# 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
|
|
<key>AppleCpuPmCfgLock</key>
|
|
<true/>
|
|
<key>AppleXcpmCfgLock</key>
|
|
<true/>
|
|
```
|
|
|
|
#### 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
|
|
<key>DeviceProperties</key>
|
|
<dict>
|
|
<key>Add</key>
|
|
<dict>
|
|
<key>PciRoot(0x0)/Pci(0x2,0x0)</key>
|
|
<dict>
|
|
<key>enable-backlight-registers-fix</key>
|
|
<data>AQAAAA==</data>
|
|
<key>framebuffer-patch-enable</key>
|
|
<data>AQAAAA==</data>
|
|
</dict>
|
|
</dict>
|
|
</dict>
|
|
```
|
|
|
|
#### 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
|
|
<key>Cpuid1Data</key>
|
|
<data>NxcB/V/QwMA=</data>
|
|
<key>Cpuid1Mask</key>
|
|
<data>////</data>
|
|
```
|
|
|
|
#### 3. Probar Diferente SMBIOS
|
|
En `config.plist` → `PlatformInfo` → `Generic`:
|
|
```xml
|
|
<key>SystemProductName</key>
|
|
<string>iMacPro1,1</string>
|
|
```
|
|
|
|
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
|
|
<key>ExtendBTFeatureFlags</key>
|
|
<true/>
|
|
```
|
|
|
|
---
|
|
|
|
## 🔊 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
|
|
<key>DummyPowerManagement</key>
|
|
<false/>
|
|
```
|
|
|
|
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)**
|