Contribute
Register

The New Beginner's Guide to USB Port Configuration

Joined
Mar 24, 2014
Messages
120
Motherboard
Aorus Xtreme Z390
CPU
i9-9900K
Graphics
Vega VII
Mobile Phone
  1. Other
@SuDoDmz are you using OpenCore or Clover bootloader with the X58 system?
'twas a painful experience, but I switched to OC, a while back (Ibelive with the introduction of 0.5.8)
 

Edhawk

Moderator
Joined
Aug 2, 2013
Messages
2,799
Motherboard
Gigabyte Z97X-UD5H
CPU
i7-4790K
Graphics
HD 4600 / RX 580
Mac
  1. iMac
  2. MacBook Air
  3. MacBook Pro
Mobile Phone
  1. iOS
I have attached a plist containing ACPI rename patches for USB devices, formatted for OpenCore.

Hope this is what you are looking for.
 

Attachments

  • USB-renames.plist.zip
    674 bytes · Views: 8

Edhawk

Moderator
Joined
Aug 2, 2013
Messages
2,799
Motherboard
Gigabyte Z97X-UD5H
CPU
i7-4790K
Graphics
HD 4600 / RX 580
Mac
  1. iMac
  2. MacBook Air
  3. MacBook Pro
Mobile Phone
  1. iOS
Here is another plist, containing ACPI rename patches for other devices found on Gigabyte motherboards.
 

Attachments

  • Rename-patches-2.plist.zip
    1.1 KB · Views: 5
Joined
Mar 24, 2014
Messages
120
Motherboard
Aorus Xtreme Z390
CPU
i9-9900K
Graphics
Vega VII
Mobile Phone
  1. Other
I have attached a plist containing ACPI rename patches for USB devices, formatted for OpenCore.

Hope this is what you are looking for.

Actually it's not, kind of you, nonetheless. I want to create a kext mapping my USB ports (and functions/types), but can't determine, which is which, due to the tools being made for more modern systems (I believe). I've got EH01 and EH02 controllers in both, ioreg and hackintool, which show no signs of activity in hackintool (which shows my ports right) and some activity in ioreg (where my ports are wrong). I've got ports on the addresses fd100000 to fd600000 for EH01 (and fa100000-fa600000 for EH02) in ioreg, but NONE of said addresses in hackintool and instead ports named HP and PR starting from 11 ending at 18 for EH01 and 21-28 for EH02. Furthermore I know that my front ports have to be the UHC1 controller, however ioreg shows mounting points on fd100000 and fd200000 and hackintool shows nothing at all. And then there's my AIC on PEX2 in ioreg with addresses from 00100000 to 00800000 (again showing signs of activity and again absolutely nothing in hackintool). And now that I've developed considerable distrust towards ioreg I don't know how to determine my ports to create a suitable kext mapping my USB Ports. Furthermore I have a Titan Ridge AIC, where it's crucial for me to make sure its USB 2.0 capabilities don't go missing (shouldn't pose much of a problem, once I know how to populate it's controller, which seems to have just that port), because my Cinema Display apparently depends on it.

EDIT: I believe I already have every necessary rename in my custom DSDT (didn't look much over it, since it was created way back at 10.6 and worked since).

EDIT2: I'm still on Catalina, if that matters (due to some microscopic setting I'm apparently missing in the configuration, so I thought I start to eradicate the bugs beginning with my USB ports).
 
Last edited:

Edhawk

Moderator
Joined
Aug 2, 2013
Messages
2,799
Motherboard
Gigabyte Z97X-UD5H
CPU
i7-4790K
Graphics
HD 4600 / RX 580
Mac
  1. iMac
  2. MacBook Air
  3. MacBook Pro
Mobile Phone
  1. iOS
OpenCore doesn't like it when you use a patched DSDT.aml, well the Developers of OpenCore don't!

They prefer you to use custom SSDT's that contain the various patches, so the system is as Vanilla as possible when using another OS.

The USB issues may be because USBInjectAll.kext, which I assume you are using, doesn't include the USB devices from your old X58 system. I think the first series of Intel USB controller to be added to the USBInjectAll.kext was the 8-series (Haswell) controller.

There are a few Clover to OpenCore conversion options that can help with the USB ports, depending on whether you used them in Clover or not.

USB:
  • FixOwnership: UEFI -> Quirk -> ReleaseUsbOwnership
  • ClockID: DeviceProperties -> Add -> PciRoot... -> AAPL,clock-id
  • HighCurrent: DeviceProperties -> Add -> PciRoot... -> AAPL, HighCurrent
    • Irrelevant for OS X 10.11 and newer
    • Newer variant is either PowerProperties defined in IOUSBHostFamily.kext -> AppleUSBHostPlatformProperties or added with a USBX SSDT for Skylake SMBIOS and newer
DeviceProperties: (For Fake ID's)

device_type: EHCI
  • device-id
  • AAPL,current-available
  • AAPL,current-extra
  • AAPL,current-available
  • AAPL,current-extra
  • AAPL,current-in-sleep
  • built-in
device_type: XHCI
  • device-id
  • AAPL,current-available
  • AAPL,current-extra
  • AAPL,current-available
  • AAPL,current-in-sleep
  • built-in

USB Port Limit Patches:
  • Kernel -> Quirks -> XhciPortLimit -> YES
These were all taken from this conversion guide - https://github.com/dortania/OpenCore-Install-Guide/blob/master/clover-conversion/Clover-config.md, which you have probably already seen and read.
 

Edhawk

Moderator
Joined
Aug 2, 2013
Messages
2,799
Motherboard
Gigabyte Z97X-UD5H
CPU
i7-4790K
Graphics
HD 4600 / RX 580
Mac
  1. iMac
  2. MacBook Air
  3. MacBook Pro
Mobile Phone
  1. iOS
Post a copy of your current OpenCore EFI, so we can see what you are using to boot macOS Catalina. We may be able to offer some insight.

Remember to redact/delete your Serial Number from your config.plist before you post a copy here.
 
Joined
Mar 24, 2014
Messages
120
Motherboard
Aorus Xtreme Z390
CPU
i9-9900K
Graphics
Vega VII
Mobile Phone
  1. Other
Quite the contrary: I don't inject anything at all :) I'm trying to keep the changes to the DSDT/SSDTs, seeing as they're more robust and I can obviously reuse them every time ;) As for the conversion: I really didn't bother much with a guide, I just kicked everything installed with clover from the system (that includes the rc-scripts) and started from scratch and tried and tried and tried, till it worked :D
But nonetheless here's my OC folder (lo and behold :lol:)
 

Attachments

  • OC.zip
    10.8 MB · Views: 7
Joined
Aug 18, 2011
Messages
458
Motherboard
ASUS Z390-I Gaming
CPU
i5-9600K
Graphics
RX 580
Mac
  1. iMac
  2. MacBook Pro
Mobile Phone
  1. iOS
Hope this is the correct thread to post this to...

This is in regard to my X97X-Gaming7 motherboard Hackintosh.

I changed, some months ago, the model type from iMac15,1 to iMac16,1, so I wouldn't have any problems updating to Monterey 12.x. Currently I'm on OC 0.7.7 on this Hack as well. The updates to Monterey went fine, until a couple of weeks ago I noticed that one of my front panel USB ports wasn't working. I had done a USB mapping years ago under Catalina and I thought it was successful. At least the system was stable, and sleep worked etc.

So I did a little digging. My Hackintool USB showed that 30+ USB ports seemed enabled. So mapping wasn't working. I then noticed that in the USBMaps.kext, Contents/Info.plist, that there was a model key with a value of 15,1. I tried changing it to 16,1 and rebooted. No change USB mapping still failed.

I follow the Dortania USB automapping : https://dortania.github.io/OpenCore-Post-Install/usb/intel-mapping/intel.html procedure.

I downloaded the latest USBMap tools and selected the USB ports I knew I wanted ( from injecting years ago )activated and created a new USBMap.kext from the tool. This new USBMap.kext Info.plist looks like it has many more keys than the old one, and the model key has a value of 16,1, which seems correct. I installed the new USBMap.kext in the EFI of the boot SSD and restarted.

The mapping looks a lot better in the Hackintool utility but it has these 4 references to USBPorts EH01 and EH02, which I think are wrong. The USBMap.command tool shows ONLY the 15 USB ports I have mapped.

How do I remove the references to the EH01 and EH02 USB ports? Or is it okay as is? Is there a patch that Opencore is not applying automatically, or am I applying a patch that should NOT be there. Here's what the Hackintool USB tab looks like:

Hackintool-USB-EH01-EH02.jpg
 

Edhawk

Moderator
Joined
Aug 2, 2013
Messages
2,799
Motherboard
Gigabyte Z97X-UD5H
CPU
i7-4790K
Graphics
HD 4600 / RX 580
Mac
  1. iMac
  2. MacBook Air
  3. MacBook Pro
Mobile Phone
  1. iOS
To remove the EH01 and EH02 hubs you need to use an SSDT.

SSDT-EHCx_OFF.aml, which I have attached below.

Remember to add the correct ACPI entry for the new SSDT to your config.plist.
 

Attachments

  • SSDT-EHCx_OFF.aml.zip
    820 bytes · Views: 7
Joined
Aug 18, 2011
Messages
458
Motherboard
ASUS Z390-I Gaming
CPU
i5-9600K
Graphics
RX 580
Mac
  1. iMac
  2. MacBook Pro
Mobile Phone
  1. iOS
Remember to add the correct ACPI entry for the new SSDT to your config.plist.


Understood.

But FIRST don't I have to stop the rename of the EHC ports to EH01 and EH02, before using the SSDT-EHCx_OFF.aml ?

Or can I leave the rename as is?
 
Top