GUIDE How to Enable Thunderbolt 3 Hotplug on macOS

[EliteMacx86]

The way is going to be to wait for the Guide to OC, because I'm not really able to get the PR files. I do not have advanced knowledge in IT and, therefore, I must be confusing some process.

Thank you for your patience and help!

 

[atanvarno]

How to Enable ThunderBolt 3 Hotplug

1. Download the SSDT from this guide. The files are attached below this post.
2. Open the SSDT
3. Simply replace RP05 with RP21 which is our ACPI path.

Can you explain how was this .aml file created? It seems created with specific hw in mind and I'm not sure it's generally applicable.
It refers to Slot-4 Alpine Ridge card which can't be valid for every hardware out there.

I have ASRock Z490 Phantom Gaming ITX/TB3, which has onboard TB3 port controlled by JHL7540 Thunderbolt 3 [Titan Ridge 2C 2018]. Here's entire TB3-related output from Hackintool:

DEBUG   VID  DID  SVID SDID ASPM   Vendor Name                    Device Name                                        Class Name           SubClass Name        IOReg Name      IOReg IOName    Device Path
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
41:00.0 8086 15E7 007F 0000 Disabl Intel Corporation              JHL7540 Thunderbolt 3 Bridge [Titan Ridge 2C 2018] Bridge               PCI bridge           P21@1B,4/UPSB@0 pci-bridge      PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)
42:00.0 8086 15E7 0000 0000 L1     Intel Corporation              JHL7540 Thunderbolt 3 Bridge [Titan Ridge 2C 2018] Bridge               PCI bridge           4/UPSB@0/DSB0@0 pci-bridge      PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)/Pci(0x0,0x0)
42:01.0 8086 15E7 0000 0000 L1     Intel Corporation              JHL7540 Thunderbolt 3 Bridge [Titan Ridge 2C 2018] Bridge               PCI bridge           4/UPSB@0/DSB1@1 pci-bridge      PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)/Pci(0x1,0x0)
42:02.0 8086 15E7 0000 0000 L1     Intel Corporation              JHL7540 Thunderbolt 3 Bridge [Titan Ridge 2C 2018] Bridge               PCI bridge           4/UPSB@0/DSB2@2 pci-bridge      PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)/Pci(0x2,0x0)
44:00.0 8086 15E8 8086 0000 L1     Intel Corporation              JHL7540 Thunderbolt 3 NHI [Titan Ridge 2C 2018]    Generic system perip System peripheral    0/DSB0@0/NHI0@0 pci8086,15e8    PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)/Pci(0x0,0x0)/Pci(0x0,0x0)
43:00.0 8086 15E9 8086 0000 L1     Intel Corporation              JHL7540 Thunderbolt 3 USB Controller [Titan Ridge  Serial bus controlle USB controller       0/DSB2@2/XHC5@0 pci8086,15e9    PciRoot(0x0)/Pci(0x1B,0x4)/Pci(0x0,0x0)/Pci(0x2,0x0)/Pci(0x0,0x0)

I would like to adjust your .aml file but I can't find any guidelines how to do so.

 

[berga]

In my motherboard Asus Prime Z370-A it was only possible with the settings:
• Set Thunderbolt Boot Support to Enabled.
• Set Thunderbolt Usb Support to Enabled.

If I put Disable, the Mac OS doesn't recognize the functions of my Apple Thunderbolt Display, such as camera, sound and extra USBs.

Out of curiosity, I was able to enable everything. Thanks!!!

 

[EliteMacx86]

Can you explain how was this .aml file created? It seems created with specific hw in mind and I'm not sure it's generally applicable.

The .aml is created by MaciASL.

I would like to adjust your .aml file but I can't find any guidelines how to do so.

Read here:

GUIDE - How to Enable Thunderbolt 3 Hotplug on macOS

How to Enable Thunderbolt 3 Hotplug on macOS [Clover/OpenCore] An EliteMacx86 Exclusive Guide - This guide covers the implementation of Thunderbolt™ 3 Hotplug on macOS for single and multiple Thunderbolt 3 Cards. Overview An EliteMacx86 Exclusive Guide - In our previous post, we covered a...

www.elitemacx86.com

 

[EliteMacx86]

In my motherboard Asus Prime Z370-A it was only possible with the settings:
• Set Thunderbolt Boot Support to Enabled.
• Set Thunderbolt Usb Support to Enabled.

If I put Disable, the Mac OS doesn't recognize the functions of my Apple Thunderbolt Display, such as camera, sound and extra USBs.

Out of curiosity, I was able to enable everything. Thanks!!!

So, you can enable the TB with above two settings only?
Can you provide a BIOS screenshot for the TB page?

 

[atanvarno]

I know about MaciASL, I am using it.

I read all 14 pages in this thread and nowhere is explained how is the content inside the .aml file created. There are so many devices, DSB1-6 etc. How did you create all of that - copied from somewhere, picked from DSDT of specific machine, manually typed-in..?

I want to learn how, not just copy/paste few values and hope for the best.

 

[EliteMacx86]

I know about MaciASL, I am using it.

I read all 14 pages in this thread and nowhere is explained how is the content inside the .aml file created. There are so many devices, DSB1-6 etc. How did you create all of that - copied from somewhere, picked from DSDT of specific machine, manually typed-in..?

I want to learn how, not just copy/paste few values and hope for the best.

Probably, you should read the guide. The sample TB SSDT is from KGP.

 

[berga]

So, you can enable the TB with above two settings only?
Can you provide a BIOS screenshot for the TB page?

 

[EliteMacx86]

Thanks for providing the info. More updates coming soon.

 

[Ferz]

Hello! I Have Big Sur 11.0.1 Final and OpenCore 0.6.3.
1. I've added SSDT-PLUG.aml and custom for Z370 (_SB_.PCI0.RP21 slot 4 path) SSDT-Z370-TB3HP.aml to folder OC/ACPI
2. After that I've added TbtForcePower.efi (to folder OC/Drivers)
3. put strings in config.plist for thunderbolt works (UEFI->Drivers->TbtForcePower.efi), (ACPI->Add->Two AML files).

If I add ThunderboltReset.kext to Kexts folder and add string in Kernel->Add, my Mac don't startup,
without it - after 2 minutes SSD TB disk Samsung X5 autoejects and doesn't work. what I can to do with this? Thanks