hackintosh-asus-b760-i7-13700k/04-usb-mapping-windows.md

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