Contribute
Register

Stork's Thunderball II Build: ASUS ProArt Z490 Creator (Thunderbolt 3) - i5-10400 - AMD RX 580

Joined
Oct 7, 2011
Messages
140
Motherboard
ASUS ProArt Z490 Creator 10G
CPU
i7-10700K
Graphics
Integrated Graphics Processor
USB Mapping Guide

As noted in the latest OpenCore Release (0.6.7) there is a potential issue with Big Sur 11.3 where a boot loop can happen when "XhciPortLimit" is set to "True" (You will likely have this set to true if you haven't made a USB map yet). There is no way to know if the issue will affect this board but it makes sense to have a USB map ready so we can disable this Kernel Quirk and be more future-proofed.

We now know that as of Big Sur 11.3 USB will be completely broken on this board when using USBInjectAll, so it's important to create a map before you update, if you are doing a fresh install of Big Sur I'd advice to start with a version older than 11.3 and update after you have a working usbmap.
Update: The only working ports are HS in the rear type-C ports.

1. Choosing 15 Ports:

Here are all ports on our motherboard:

View attachment 511825
The maximum number of ports for any single controller is 15 so we need to decide which ports from the XHC controller we want to keep out of the potential 26 :crazy:. Our USB3 ports are actually two separate ports: USB2(HS) and USB3(SS). There are 3 ports we can ignore as they are not used by the macOS at all: HS12 (LED Controller), USR1 & USR2.

Now we need to make a list of all the HS and SS ports we want to keep, I recommend writing it down in note form. Here is what I went with as an example: HS01, HS02, HS03, HS04, HS07, HS09, HS10, HS11, SS01, SS02, SS03, SS04, SS07, SS09, SS10.

I removed ports 5 & 6 completely since they are the slowest. I also removed the HS capability from the Type-C ports on the back since only iOS devices use it for syncing, which I will do with my Front Panel type-c connector instead.


2. System Preparation:

ALWAYS HAVE A USB RECOVERY BOOT HANDY!! If you miss some of these files you may not be able to boot.

Files:

OC Config
  • Set Kernel/Quirks/XhciPortLimit to True
  • Make sure your config includes all the files we've added.
Restart Computer


3. Creating the map in USBMap:

Open USBMap.command and click "D" to discover ports. You should see a list of 30 items (26 + 4), if not then you may have missed something from the System Preparation section. Click "Q" to return to the main menu.

Now click "P" to Edit & Create USBMap.kext. I like to start by clicking "N" to remove all ports from the selection.
Then we're going to enter a comma separated list of all the ports we want to keep. e.g. "1,2,3".
We should now see Populated: XHC: 15, AppleUSBXHCITR: 4 at the bottom of this list.

View attachment 511826

OK, we have a list of 15 ports, great! But don't break out the champagne, yet. Now we need to figure what the correct connector type is for each port, I am only going to cover the ports that are actually on this board (we don't have USB2 external ports).

"3" - USB3 Type-A
"9" - USB Type-C
"10" - USB Type-C where ACPI port changes if you flip the connector (Our internal USB3.1 header does this).
"255" - Internal (for Bluetooth only)

As you may have noticed from your USBMap list, all ports are set to type "3" which is USB 3 Type-A
Lets start by correctly setting our internal Bluetooth (port 9 / HS11) to "255"
T:11:255

Now lets add the Type C ports using type 9, like so:
T:13,14:9

Remember to set the Thunderbolt ports to Type C too:
T:27,28,29,30:9

Finally we need to deal with the Front USB3.1 header, set this to type 10:
T:7,23:10


4. Finishing up:

Now that you have a list of 15 XHC ports and 4 Thunderbolt ports with the correct connector type set we can generate our kext.

1. Click "K" Build USBMap.kext, which will create a USBMap.kext file in the "Results" folder of USBMap.
2. Copy "USBMap.kext" to OC/Kexts
3. Remove: USBInjectAll-400series-Dren.kext
4. Set Kernel/Quirks/XhciPortLimit to False (V Important)
5. Update config to reflect these changes.

Restart

5. Confirming it Works:

System profiler:
View attachment 511827

USBMap after applying the new map we created

View attachment 511848

Congrats, now you have a fully working USBmap :headbang:


Final Thoughts:

I have always used a different app to make USB maps (Hackintool), the GUI is a lot cleaner and easier to understand. The reason I made this guide with USBmap was because the Thunderbolt ports will not show up in Hackintool without removing the TB3 Hot swap SSDT. Creating a map in Hackintool will essentially omit the entire Thunderbolt controller in a kind of "ignored" state, this means the rear USB3 type C will still work but won't be listed in system profiler. I wish I knew more to know where the line between cosmetics and functionality lie between the two methods but based on all my research I am confident this is the best approach.

---

More to come, feel free to leave suggestions on how I can improve it. Apologies for grammar / formatting.

References: https://dortania.github.io/OpenCore-Post-Install/usb/#macos-and-the-15-port-limit

EDIT: The front USB 3.1 Header changes ACPI port (HS07/SS07) depending which way you plug it in.
Set HS07 and SS07 to type 10 instead of 9.

EDIT: Noted that rear usb type c ports still work at HS speeds without a usbmap (useful for recovery).
In Step 3 I am not getting "Populated: XHC: 15, AppleUSBXHCITR: 4" at the bottom of the list after entering my 15 ports. Instead I am getting "Populated: XHC: 15, pci8086,15ec: 4". (See attached screenshot). Is there something I am doing incorrectly?
 

Attachments

  • Edit USB 2.png
    Edit USB 2.png
    373.9 KB · Views: 24
Last edited:
Joined
Oct 11, 2012
Messages
123
Motherboard
Asus ProART Z490-Creator 10G
CPU
i9-10900K
Graphics
RX 5700 XT
Mac
  1. Mac Pro
Classic Mac
  1. PowerBook
Mobile Phone
  1. iOS
In Step 3 I am not getting "Populated: XHC: 15, AppleUSBXHCITR: 4" at the bottom of the list after entering my 15 ports. Instead I am getting "Populated: XHC: 15, pci8086,15ec: 4". (See attached screenshot). Is there something I am doing incorrectly?
This is fine, I assume this is happening because you are not using the Thunderbolt Hot Swap SSDT that @Stork provided. You'll have to redo the map if you decided to use his SSDT later. I need to update the guide since he provided an updated thunderbolt guide.

Otherwise your map is looking perfect!
 
Joined
Oct 11, 2012
Messages
123
Motherboard
Asus ProART Z490-Creator 10G
CPU
i9-10900K
Graphics
RX 5700 XT
Mac
  1. Mac Pro
Classic Mac
  1. PowerBook
Mobile Phone
  1. iOS
it is a display. I have a two apple displays and want to use it on my new motherboard. I read that @CaseySJ has flashed the z390 and z490 motherboards he uses ... I hope he sees this post :) He knows the answer for sure)
Nobody has flashed this board yet as far as I'm aware. It is generally not recommended to use thunderbolt displays with hackinosh, very random success rates. CaseyJ has provided extensive info on this if you search his threads.

Please let us know if you decide to flash the MB and how it went.
 
Joined
Aug 14, 2021
Messages
5
Motherboard
Asus ProArt Z490 Creator
CPU
i9-10900K
Graphics
RX 6800 XT
Nobody has flashed this board yet as far as I'm aware. It is generally not recommended to use thunderbolt displays with hackinosh, very random success rates. CaseyJ has provided extensive info on this if you search his threads.

Please let us know if you decide to flash the MB and how it went.
Yesterday I flashed this board, but Apple Thunderbolt not working yet... I see Thunderbolt Bus and Port 1, Port 2, but "not connected", if device not connected. After reboot, and, when display connected, I see something different. Maybe my EFI is not configured. If somebody share config, I'll try with another EFI.
I was take this:
Asus ThunderboltEX-3 TR (Titan Ridge) ASUS-ThunderboltEX-3-TR-NVM56-MOD1-CaseySJ.bin .
 
Joined
Aug 14, 2021
Messages
5
Motherboard
Asus ProArt Z490 Creator
CPU
i9-10900K
Graphics
RX 6800 XT
So, I won. BIOS settings + ROM flashing saved my life.
Now my Apple TB display have a picture in macOS after bootscreen.
 
Joined
Oct 11, 2012
Messages
123
Motherboard
Asus ProART Z490-Creator 10G
CPU
i9-10900K
Graphics
RX 5700 XT
Mac
  1. Mac Pro
Classic Mac
  1. PowerBook
Mobile Phone
  1. iOS
So, I won. BIOS settings + ROM flashing saved my life.
Now my Apple TB display have a picture in Macos after bootscreen.
Nice. Can you see BIOS menu and OpenCore Boot menu? Please provide some details of how you flashed it; e.g., where the chip is located.
 
Joined
Aug 14, 2021
Messages
5
Motherboard
Asus ProArt Z490 Creator
CPU
i9-10900K
Graphics
RX 6800 XT
Nice. Can you see BIOS menu and OpenCore Boot menu? Please provide some details of how you flashed it; e.g., where the chip is located.
The chip is as it is in Gigabyte Z490 Vision D which you can see on back side, near the TB3 ports.
I have a friend who is engineer for notebook motherboard repair, and he helped me to flash this chip.
OpenCore config is not something unusual, and, if you have bootable macOS and Thunderbolt hot-plug, you have all needing for work Thunderbolt bus.
In the BIOS I followed @CaseySJ instructions in his last micro-guide OpenCore 0.7.2
I Enabled VT-d, and I enabled SR-IOV. (maybe it was not a necessary)
I enabled iGPU. (It was disabled.)
Wndows 10 support on "Enable". not "Enable + RPD3"
Boot support "Enable". (In Gigabyte I used Boot once)
Numeric parameters in Thunderbolt options without changes.
 
Joined
Oct 7, 2011
Messages
140
Motherboard
ASUS ProArt Z490 Creator 10G
CPU
i7-10700K
Graphics
Integrated Graphics Processor
This is fine, I assume this is happening because you are not using the Thunderbolt Hot Swap SSDT that @Stork provided. You'll have to redo the map if you decided to use his SSDT later. I need to update the guide since he provided an updated thunderbolt guide.

Otherwise your map is looking perfect!
Thanks @ctek

Not sure if I am missing the post with the hot swap SSDT. I took the SSDT file from the original post when I built my system in July. I also checked Post #198 as mentioned in the original post June 27 update, but it only refers to Ethernet fix.
 
Joined
May 28, 2012
Messages
56
Motherboard
ASUS ProArt Z490-Creator
CPU
i9-10900
Graphics
RX 5700 XT
Mac
  1. iMac
  2. MacBook Pro
Mobile Phone
  1. iOS
Just upgraded my hack to this board and an i9 10900 from my older Z170 WS/i7 6700K (running Catalina).

I haven't used OpenCore before (was on Clover prior) so that was all new for me.
Updated BIOS to latest on site available yesterday. I got Big Sur 11.5.2 running (started with 11.2.3 then USBMapped and upgraded following mapping instructions from @ctek - thanks!) - Ethernet and Thunderbolt both working (waited until the upgrade to 11.5.2 to do that).

Thanks to everyone in this thread (@Stork, etc.). I wouldn't have got there with just the Dortania guide alone for sure.
 
Joined
Oct 11, 2012
Messages
123
Motherboard
Asus ProART Z490-Creator 10G
CPU
i9-10900K
Graphics
RX 5700 XT
Mac
  1. Mac Pro
Classic Mac
  1. PowerBook
Mobile Phone
  1. iOS
Thanks @ctek

Not sure if I am missing the post with the hot swap SSDT. I took the SSDT file from the original post when I built my system in July. I also checked Post #198 as mentioned in the original post June 27 update, but it only refers to Ethernet fix.
Sorry for the late reply, been busy with work. I’m a bit lost as to why this is happening, although it shouldn’t cause any problems. Could you tell us your Thunderbolt settings in BIOS?

The reason I mentioned about the hot swap SSDT is that is renamed the TB controller which would make a lot of sense. But, if you have that SSDT enabled, then it should look the same as mine unless something happened in a bios update. I’ll look into it more when I have time but it shouldn’t cause any problems.
 
Top