Contribute
Register

A Beginner's Guide to Creating a Custom USB SSDT

UtterDisbelief

Moderator
Joined
Feb 13, 2012
Messages
4,505
Motherboard
Gigabyte Z390M Gaming
CPU
i5-9600K
Graphics
RX 570
Mac
iMac, Mac mini
Classic Mac
eMac, iBook
Mobile Phone
iOS
I've read but that topic didn't mention about bluetooth. I tried to plug - unplug bluetooth adapter to USB power but it doesn't change

The process for configuring your USB ports for OpenCore is included in the guide linked to.

You didn't mention if you are using an external USB Bluetooth dongle, or an internal wifi/BT PCIe card. However the following should work for both, although some external USB dongles can be tricky.

To cure the problem of BT waking a machine you need to set the port you are using as "Internal". Take a look at this graphic:

Internal.jpg

Your own port numbers will be different, and which port you chose for Bluetooth may also be different, but the procedure applies.

(If you are coding your SSDT manually the section to add is - UsbConnector type = 255.)

If you find that the PC is still waking from sleep straight away, then the problem will not be Bluetooth.

:)
 
Last edited:
Joined
Jun 26, 2020
Messages
7
Motherboard
B460M Steel legend
CPU
i5 10400
Graphics
RX 580
The process for configuring your USB ports for OpenCore is included in the guide linked to.

You didn't mention if you are using an external USB Bluetooth dongle, or an internal wifi/BT PCIe card. However the following should work for both, although some external USB dongles can be tricky.

To cure the problem of BT waking a machine you need to set the port you are using as "Internal". Take a look at this graphic:

Your own port numbers will be different, and which port you chose for Bluetooth may also be different, but the procedure applies.

(If you are coding your SSDT manually the section to add is - UsbConnector type = 255.)

If you find that the PC is still waking from sleep straight away, then the problem will not be Bluetooth.

:)
I'm using Intel 9260 includes Bluetooth adapter (connect through USB Power, Wifi on PCI.E slot).
The problem is I've complied SSDT-UIAC and SSDT-EC-USBX but I afraid it will crash current EFI boot so I have not replaced SSDT-EC-USBX yet because the different was too large (SSDE-EC-USBX I'm using from Opencore guide: https://github.com/dortania/Getting...extra-files/compiled/SSDT-EC-USBX-DESKTOP.aml)

So for now, I've only add one more file is SSDT-UIAC. However it doesn't work although it's Internal, the port I'm using is HS01

1593673189960.png


btw, it's missing XHC on the top as well :(
 

UtterDisbelief

Moderator
Joined
Feb 13, 2012
Messages
4,505
Motherboard
Gigabyte Z390M Gaming
CPU
i5-9600K
Graphics
RX 570
Mac
iMac, Mac mini
Classic Mac
eMac, iBook
Mobile Phone
iOS
I'm using Intel 9260 includes Bluetooth adapter (connect through USB Power, Wifi on PCI.E slot).
The problem is I've complied SSDT-UIAC and SSDT-EC-USBX but I afraid it will crash current EFI boot so I have not replaced SSDT-EC-USBX yet because the different was too large (SSDE-EC-USBX I'm using from Opencore guide: https://github.com/dortania/Getting...extra-files/compiled/SSDT-EC-USBX-DESKTOP.aml)

So for now, I've only add one more file is SSDT-UIAC. However it doesn't work although it's Internal, the port I'm using is HS01

View attachment 478784

btw, it's missing XHC on the top as well :(

Yes, there are certainly problems in this configuration.

Two things would be helpful:

1) A IORegistryExplorer v2.1 export file - *.IOReg so we can see the ports in whatever state.

2) A list of kexts you have in EFI/OC/Kexts and in Drive: Library/Extensions

Something is stopping XHCI from showing so double-check your BIOS setting for XHCI Hand-off.

:)
 
Joined
Jun 26, 2020
Messages
7
Motherboard
B460M Steel legend
CPU
i5 10400
Graphics
RX 580
Yes, there are certainly problems in this configuration.

Two things would be helpful:

1) A IORegistryExplorer v2.1 export file - *.IOReg so we can see the ports in whatever state.

2) A list of kexts you have in EFI/OC/Kexts and in Drive: Library/Extensions

Something is stopping XHCI from showing so double-check your BIOS setting for XHCI Hand-off.

:)
Thanks UtterDisbelief, I've checked my configuration: XHCI Han-off is enable. Here is my IORef and list of kext

1593675848111.png
1593675876856.png

Also, this is my SSDT-UIAC
 

Attachments

UtterDisbelief

Moderator
Joined
Feb 13, 2012
Messages
4,505
Motherboard
Gigabyte Z390M Gaming
CPU
i5-9600K
Graphics
RX 570
Mac
iMac, Mac mini
Classic Mac
eMac, iBook
Mobile Phone
iOS
Thanks UtterDisbelief, I've checked my configuration: XHCI Han-off is enable. Here is my IORef and list of kext

View attachment 478804View attachment 478805
Also, this is my SSDT-UIAC

Okay, great. Thanks for the uploads.

Drive: Library/Extensions is fine. We can forget about that for now.

OC/Kexts - Is where the action is ...

This set-up is confusing Hackintool when it reads the XHC controller. This might be a bug or a pointer to something else. Although I do not think it will make much difference you probably do not require the XHCI-unsupported.kext for your chipset. If that doesn't make a difference then remove USBInjectAll.kext and check again to see what it shows. You should now only get 15-ports.

At present you have 20-ports configured and this is not recommended. The whole point of configuring USB is to keep within the 15-limit. Yes, some people disagree. I'll leave that for now.

You are using the iMacPro1,1 system definition so perhaps try a more reliable one, just for testing purposes, such as - iMac14,2 . (Disconnect from wireless first to avoid Apple servers being confused while you test). It is known to be more easy-going, but may reduce performance vey slightly. At least it is worth testing for this problem.

Currently the Bluetooth adapter is buried too deep in "hubs" to be controllable. This may also be due to the IntelBluetoothInjector.kext and IntelBluetoothFirmware.kext and may not be easily resolved. In which case it might be better to use a USB BT adapter.

:)
 
Joined
Jun 26, 2020
Messages
7
Motherboard
B460M Steel legend
CPU
i5 10400
Graphics
RX 580
Okay, great. Thanks for the uploads.

Drive: Library/Extensions is fine. We can forget about that for now.

OC/Kexts - Is where the action is ...

This set-up is confusing Hackintool when it reads the XHC controller. This might be a bug or a pointer to something else. Although I do not think it will make much difference you probably do not require the XHCI-unsupported.kext for your chipset. If that doesn't make a difference then remove USBInjectAll.kext and check again to see what it shows. You should now only get 15-ports.

At present you have 20-ports configured and this is not recommended. The whole point of configuring USB is to keep within the 15-limit. Yes, some people disagree. I'll leave that for now.

You are using the iMacPro1,1 system definition so perhaps try a more reliable one, just for testing purposes, such as - iMac14,2 . (Disconnect from wireless first to avoid Apple servers being confused while you test). It is known to be more easy-going, but may reduce performance vey slightly. At least it is worth testing for this problem.

Currently the Bluetooth adapter is buried too deep in "hubs" to be controllable. This may also be due to the IntelBluetoothInjector.kext and IntelBluetoothFirmware.kext and may not be easily resolved. In which case it might be better to use a USB BT adapter.

:)
Thanks for the advice.
I updated to iMac19,1 but it didn't resolve much.
I'm trying to create USB boot, avoid doing directly from my hard drive EFI (I installed hackintosh on an individual ssd) but keep notifying this error no matter how I reload it

1593690822604.png


Step I did to Format USB by disk Utility:
- Erase & select Mac OS Extended (Journaled)
- Create EFI folder, copy exist EFI from hard drive to USB EFI
- Boot to USB EFI, caught above error
 
Last edited:

UtterDisbelief

Moderator
Joined
Feb 13, 2012
Messages
4,505
Motherboard
Gigabyte Z390M Gaming
CPU
i5-9600K
Graphics
RX 570
Mac
iMac, Mac mini
Classic Mac
eMac, iBook
Mobile Phone
iOS
Thanks for the advice.
I updated to iMac19,1 but it didn't resolve much.
I'm trying to create USB boot, avoid doing directly from my hard drive EFI (I installed hackintosh on an individual ssd) but keep notifying this error no matter how I reload it

View attachment 478840

Step I did to Format USB by disk Utility:
- Erase & select Mac OS Extended (Journaled)
- Create EFI folder, copy exist EFI from hard drive to USB EFI
- Boot to USB EFI, caught above error

iMac19,1 is not the same as iMac14,2.

You need to create a boot USB using UniBeast :thumbup:
 
Joined
Jun 26, 2020
Messages
7
Motherboard
B460M Steel legend
CPU
i5 10400
Graphics
RX 580
I changed to iMac14,2 but it still wake up right after sleeping, maybe it really need to map USB
I don't have EFI, kexts for clover boot :(
 
Joined
May 12, 2020
Messages
55
Motherboard
Gigabyte P67A-UD3P-B3
CPU
i72600K
Graphics
GTX770
No necessarily. You can still create an SSDT but you would need to do it the "old" way. This involves manually creating an SSDT template, something Hackintool now does behind the scenes, by filling-in the gaps using Sherlock Holmes-like deduction to figure out the port numbers.

For the same reason the latest High Sierra PLRPs don't work, Mojave has had Security Updates too and 10.14.6+ has no new PLRPs either, so be aware.

Remember the Renesas chipset will still work but is unconfigurable if GenericUSBXHCI.kext doesn't latch on to it. Hackintool can be hit and miss in recognising these third-party USB solutions. However, the ports do not figure in our 15-limit so if they work you can use them, but be aware they may be unreliable without drivers.
I'm trying 'the old way' but I don't have "a set of HS**@ labels followed by numbers" in IORegistry.

And my USB 3.0 isn't seen in OSX System Report or in IORegistry. Where I'm confused is this:

Is this guide for situations where USB 3 ports are seen in system details but don't work properly (and that's what we're fixing) or is it a guide for when there is no evidence of USB 3.0 ports in any system information - and it's fixing that? Or both?

Basically do my USB 3.0 ports have to be seen before they can be 'fixed' - or is the 'fixing' making them seen in system properties?

My USB 3.0 work at 5gb in OSX 10.8.5 but in HS there's no evidence of USB 3 ports in any system info....

I'm actually wondering about installling HS on a separate drive, WITHOUT security updates, so that I can use the 'new' method with Hackintool and then use the SSDT for the 'other drive' with the HS with updates on it. Would that be easier?
 

Attachments

Last edited:
Top