# 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)**