69 lines
3.8 KiB
Markdown
69 lines
3.8 KiB
Markdown
# 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*
|