Guía · macOS
Mapear puertos USB para macOS desde Windows con USBToolBox
Este procedimiento prepara un mapa específico para tu equipo desde Windows y después lo incorpora a OpenCore. El mapa determina qué puertos utiliza macOS; una EFI o un mapa de otro ordenador no sustituye la identificación de tu hardware.
Por ReinierTutoriales · Publicado el · Contenido revisado el . Fuentes al final de la guía.
Antes de empezar
- Windows 10 u 11 de 64 bits y controladores USB funcionando.
- Acceso físico a los puertos, un dispositivo USB 2 y otro USB 3; si hay USB-C, prueba ambas orientaciones.
- USBToolBox descargado de su proyecto oficial y una copia recuperable de tu EFI antes de modificarla.
1. Identificar los puertos en Windows
Abre Windows.exe de USBToolBox. En C (configuración), revisa los nombres de tipos, los comentarios y la vinculación de puertos compañeros; después vuelve al menú y entra en D (descubrimiento).
Recorre los conectores del equipo con los dispositivos de prueba. Comprueba USB 2 y USB 3, los conectores delanteros y traseros y las dos posiciones de USB-C. Incluye los dispositivos internos que utilices, como Bluetooth. Anota la correspondencia entre número y ubicación física.
2. Seleccionar y generar el mapa
En S, selecciona los puertos que necesitas y respeta el máximo de 15 puertos por controlador. Las personalidades USB 2 y USB 3 de un mismo conector pueden ocupar entradas distintas. Revisa la selección; no basta con contar conectores físicos.
Comprueba los tipos: 0 corresponde a USB 2 Type-A, 3 a USB 3 Type-A y 255 a conexiones internas. USB-C tiene tipos diferentes según su comportamiento al girar el conector: consulta TYPES.md antes de asignarlos.
Añade comentarios que identifiquen cada puerto y pulsa K para generar UTBMap.kext. Conserva el mapa y tus notas junto a la documentación del equipo.
3. Incorporarlo a OpenCore
Trabaja sobre una copia de la EFI que puedas probar y conserva una vía de arranque recuperable. Añade USBToolBox.kext y el UTBMap.kext generado en EFI/OC/Kexts. Actualiza Kernel → Add en config.plist, cargando USBToolBox antes del mapa.
Para este flujo de mapeo previo desde Windows, UTBDefault.kext no se mantiene junto al mapa terminado. Revisa los inyectores o mapas anteriores para evitar que compitan y sigue la documentación de tu configuración al retirarlos.
Revisa XhciPortLimit y los ajustes ACPI relacionados con USB según la guía completa. USBToolBox puede sustituir la función de SSDT-RHUB; no acumules cambios USB sin comprobar qué hace cada uno.
4. Comprobar en macOS
Después de arrancar con la EFI de prueba, comprueba los dispositivos en Información del Sistema → USB. Prueba cada puerto seleccionado, los dispositivos internos y el reposo y despertar. Un arranque correcto por sí solo no valida el mapa.
Si falla un puerto, compara su ubicación física con tus notas de descubrimiento y con el mapa generado. Si la nueva EFI impide arrancar o usar el teclado, vuelve a la copia recuperable antes de continuar.
Resolver problemas
- El mapa no parece aplicarse
- Comprueba las entradas habilitadas de Kernel → Add, sus rutas y el orden de carga. Revisa mapas o inyectores anteriores.
- Falta Bluetooth
- Comprueba que su puerto interno fue identificado e incluido; revisa el tipo de conexión. No asumas que todo fallo de Bluetooth es un problema de mapeo.
- USB-C funciona solo en una posición
- Repite el descubrimiento en ambas orientaciones y contrasta el tipo con TYPES.md.
Fuentes y documentación
La revisión corresponde al contenido enlazado. Consulta también las publicaciones del proyecto para los cambios posteriores.