Skip to content

Latest commit

 

History

History
78 lines (58 loc) · 3.23 KB

README-usbtool.command.md

File metadata and controls

78 lines (58 loc) · 3.23 KB

usbtool.command

USB Tool screenshot

What's this?

A graphical property list editor, usbtool.command exposes only a hard-coded list of the 17 USB ports available on H97N-WIFI. The generated USBPorts.kext is intended to be used in combination with SSDT-USBX in this repository. Creating a dummy EC device is not required with recent versions of macOS.

  • IOUSBHostFamily class AppleUSBHostResources resource-matches on IORTC
  • AppleUSBHostResources handles the host controller power-related device properties in SSDT-USBX
  • USBPorts.kext matches on device XHC to provide a mapping of 15 or fewer ports

After completing the OpenCore config.plist according to README.md and installing macOS, the following procedure will generate a valid USBPorts.kext

Run usbtool.command

  • boot the H97N-WIFI system into macOS
  • run usbtool.command found in the root directory of this repository
  • keep within the 15 port limit by switching off at least 2 ports
  • press the button to generate USBPorts.kext on the desktop

Replace USBPorts.kext in the OpenCore Kexts Directory

  • mount the EFI system partition
  • replace USBPorts.kext in /Volumes/EFI/EFI/OC/Kexts with the version from the desktop

Port Locations

USB 2
Port Location
HS01 USB 3 header
HS02 USB 3 header
HS03 Rear panel USB 3 connector
HS04 Rear panel USB 3 connector
HS05 USB 2 header
HS06 USB 2 header
HS07 Rear panel USB 2 connector
HS08 Rear panel USB 2 connector
HS09 Rear panel USB 3 connector
HS10 Rear panel USB 3 connector
HS11 Mini PCI express


USB 3
Port Location
SSP1 USB 3 header
SSP2 USB 3 header
SSP3 Rear panel USB 3 connector
SSP4 Rear panel USB 3 connector
SSP5 Rear panel USB 3 connector
SSP6 Rear panel USB 3 connector


Rear Panel Layout by grumat
 -------------------------------------------------------------------------
|  ------                                 __--__    __--__     ..     ..  |
| | HS07 |    .-.     .-.                | LAN2 |  | LAN1 |   (Or)   (LI) |
| |======|   (SMA)   (SMA)               | .... |  | .... |    ˜˜     ˜˜  |
| | HS08 |    ˜-˜     ˜-˜     ________    ======    ======     ..     ..  |
|  ------                     \=HDMI=/    ------    ------    (Bk)   (LO) |
|    --     ---------------     ˜˜˜˜     | SS04 |  | SS06 |    ˜˜     ˜˜  |
|  / PS \  | ######### ### |  ________   |======|  |======|  |˜˜˜˜|   ..  |
|  \ /2 /  | ######### ### |  \=HDMI=/   | SS03 |  | SS05 |  |TosL|  (Mi) |
|    --     \-------------/     ˜˜˜˜      ------    ------    ----    ˜˜  |
 -------------------------------------------------------------------------