Contribute
Register

The New Beginner's Guide to USB Port Configuration

Are you booting Linux on this system? If not, then you should remove the OpenLinuxBoot.efi from the /EFI/OC/Drivers folder in your setup.

Your config and OC folder are set to boot to the OC GUI, not the OC Picker List. Are you sure you are using the correct EFI when booting? You don't have another EFI on another drive, which may be used?

I have changed the EFI attached below, so it boots to the Acidanthera OC GUI, so you can tell when you are using the correct EFI. Just add your Serial etc, and see how this revised EFI boots.
I have set (the machine is set to boot) not using the Acidanthera OC GUI rather Flavours-Collor OC Gui. Both GUI's have the same boot stall/reboot problem. There is a Separate NVME Drive with Windows 11 pro which obviously has a EFI but I am choosing the Ventura disc each time for testing. I did not remove the Acidanthera Golden Gate Image files in Resources as the pointer in the ConfigPlist is pointing to the Flavours folder/files.

Here is the original screen-print of the configplist I just sent you with pointer:
Flavours Pointer.JPG

Is this incorrect? Based on the Guide instructions below:
Misc -> Boot -> PickerVariant: Flavours-Collor
Now in our config.plist, we have 4 things we need to fix:

  • Misc -> Boot -> PickerMode: External
  • Misc -> Boot -> PickerAttributes: 17
    • This enables mouse/trackpad support as well as .VolumeIcon.icns reading from the drive, allows for macOS installer icons to appear in the picker
  • Misc -> Boot -> PickerVariant: Acidanthera\GoldenGate
    • Applicable variables:
      • Auto — Automatically select one set of icons based on DefaultBackground colour.
      • Acidanthera\Syrah — Normal icon set.
      • Acidanthera\GoldenGate — Nouveau icon set.
      • Acidanthera\Chardonnay — Vintage icon set.
  • UEFI -> Drivers and add OpenCanopy.efi
Once all this is saved, you can reboot and be greeted with a true Mac-like GUI

I had plans to give the owner Triple boot at a later date ie Linux. So I added the OpenLinuxBoot.efi for this purpose and it was not present (in the Big Sur EFI) when the machine was Big Sur with 0.7.5 with the same boot stall/reboot issue.

With the switched Type C out of the USBPort kext the ports work properly showing 10GB/sec when I attach my removeable m.2 NVME test drive formatted to Exfat to the EFI chenges to send to you and showing the slower 3.1 gen 1 speed when I plugin my combo 2.0/3.1 test hub.
 
You might be advised to disable the Type-C ports in your USBPorts.kext until you are sure they are set correctly.

If you have a port that is Type-c without a switch (10) there should be another companion port set the same. Not the USB2 virtual port, but another physical Type-c connector, that shows when the type-c device is flipped 180°.
Retesting does not show the companion ports. This would also exceed the magic 15 anyway.
 
Logic says that the port is a Type-c+sw (9), not a Type-c without switch (10), if no companion port is showing. But that only works if you are using the XhciPortLimit quirk. If you are testing a port while using the current USBPorts.kext, with a specific number of ports enabled, then logic goes out the window.

You can temporarily disable and add a few ports in the USBPorts.kext, if you need the ability to test ports you are unsure about, while remaining within the 15 port limit.

But to be honest this should all have been ironed out while you were booting macOS Catalina, with the XhciPortLimit quirk enabled. You have jumped forward to a newer OS, while still having USB issues you need to resolve. This makes it harder to discover what is happening with your USB ports.
 
But to be honest this should all have been ironed out while you were booting macOS Catalina, with the XhciPortLimit quirk enabled. You have jumped forward to a newer OS, while still having USB issues you need to resolve. This makes it harder to discover what is happening with your USB ports.
Sorry about the delay in responding back:
I determined I had a small error in port kext in that the internal 20Pin goes to a one-port cable even though there are two physical ports with companions. HS07/SS07 (the port being delivered to the front panel of the SFF case this build is in) and HS08/SS08 not being used, as it is not being delivered, as there is no 2nd USB A port to deliver it to.

Here are the USBtoolBox screens from windows:
PHOTO1.png

initial opening screen
PHOTO2  3.jpg

port discovery window:
PHOTO4 5 6.jpg

FINAL PORT MAP WINDOW WITH COMPANIONS TURNED OFF AND LOCATION NAMING.
Attached is a spreadsheet with port numbering and what is now blocked and kept. Also, the created port kext, from the toolbox, the required ToolBox kext that must go in EFI with port Kext for the windows created Kext to work, and finally here is the Hackintool window for the corrected Kext that the machine is now using. I rechecked drive speeds using a 2.1/3.1 combo hub and an M.2 NVME external SSD drive to get the 10GB speed tests.
Looking at the Console crash logs, the initial crashing is caused by Photoshop Elements 2022 and Istat Menus. I do not believe they are ready for Primetime Ventura IMO, since the crashing cannot be circumvented without removing both programs, I think the owner can live with one to three auto restarts before the desktop log-in.
Screenshot 2022-11-04 at 10.31.09 AM.png
e to 3 auto
 

Attachments

  • EDHAWK 10_4_22.zip
    156.2 KB · Views: 17
SS03, if it is served from a Type-A connector should be set with connector Type USB3 (3) not Type-C. It should match with the connector type used for HS03, as both are served from the same USB port.

All USB3 Type-A ports should be set as USB3, never Type-C.
 
Good catch,
I changed my spread-sheet, to 3, but not the original Hackintool Kext modification made a year ago for Big Sur that I attempted to correct, each time, as we conversed, I still missed the last fix, when I dumped SS08 and added HS07 back in its place. (ie HS07/SS07 is now blocked.) I WILL CORRECT it next time I go to the owner's house, as I think it is better to do it in person rather than through remote access.
HS04/SS04 is a true Type C port without a switch.
SS03 ERROR.JPG

BTW, the 9 on the right of 3 (the port type) 3.1 gen 2 Type A REAR, is the running port count to 15 in the unblocked port column of my spreadsheet to the magic 15. PORT 19 IS (9 OF 15) not a type 9 port.
CURRENT HACKINTOOL KEXT ERROR.JPG
 
Last edited:
I am on Catalina 10.15.7 / OC 0.8.5 and I followed the guide step by step. I deleted the unnecessary Ports and created my own USBPorts.kext.

The problem is, that it seems, that the USBPorts.kext is not loaded. I can see in IORegExporer all the USB2 Ports, and only one USB3 Port. It looks like the system is using the first 15 Ports, and not what I selected.

Z490 - Gigabyte Aorus Pro AX

1668093801469.png



IORegExplorer:
1668093883592.png


Exported USBPorts.kext with Hackintool:

1668094255293.png


Attached is also my EFI Folder. What I am doing wrong?
 

Attachments

  • EFI.tgz.zip
    50.4 MB · Views: 26
I am on Catalina 10.15.7 / OC 0.8.5 and I followed the guide step by step. I deleted the unnecessary Ports and created my own USBPorts.kext.

The problem is, that it seems, that the USBPorts.kext is not loaded. I can see in IORegExporer all the USB2 Ports, and only one USB3 Port. It looks like the system is using the first 15 Ports, and not what I selected.

Z490 - Gigabyte Aorus Pro AX

View attachment 557988


IORegExplorer:
View attachment 557989

Exported USBPorts.kext with Hackintool:

View attachment 557991

Attached is also my EFI Folder. What I am doing wrong?
you have set all your USB ports to internal.....??
 
I did not change this. That was like this by default when I use HackinTool
yes :)

use the drop down option to change them

may need to re enable the quirk and reboot

hit the broom icon and then the refresh button

pop back in your usb2 and usb3 device in each port etc etc

next time, just upload your EFI as a zip
 
Back
Top