hackintosh-b760-13700k/hackintosh-guide/troubleshooting/troubleshooting.md

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:

<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

<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:

<key>Cpuid1Data</key>
<data>NxcB/V/QwMA=</data>
<key>Cpuid1Mask</key>
<data>////</data>

3. Probar Diferente SMBIOS

En config.plist → PlatformInfo → Generic:

<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

# 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

# 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

kextstat | grep Bluetooth

3. Agregar Patch si es Necesario

En config.plist → Kernel → Quirks:

<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

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:

./SSDTTime.sh
# Seleccionar 1 (Basic)
# Seleccionar 1 (PM)

3. Verificar DummyPowerManagement

En config.plist → Kernel → Emulate:

<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

# En Terminal
metalinfo

Debe mostrar "Metal Support: YES"

2. Verificar Swap

# En Terminal
sysctl vm.swapusage

3. Deshabilitar Indexación (si es necesario)

sudo mdutil -s /
sudo mdutil -d /

---

📝 Ver Logs del Sistema

Obtener Logs

1. Log de Arranque

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
• TonyMacx86
• Dortania Discord

---

📞 Contacto

Si encuentras un problema no documentado aquí:

1. Revisa Dortania Troubleshooting
2. Busca en foros con tu hardware específico
3. Crea un post con toda la información detallada

---

Volver a README.md