If you plan to use Discord for troubleshooting, v2.1.0 (opens new window) is a bit easier on file size.

To view the inner workings of macOS more easily.IORegistryExplorer.app (opens new window).

You must have 2 separate devices as to ensure no mix ups with personalities.

A USB 2.0 and USB 3.0 device to test with.

See previous section: Checking what renames you need.

Older OSes shouldn't require any USB mapping

Note: This guide will be focusing on OS X 10.11, El Capitan and newer.

This is due to how macOS enumerates ports, trying to map from other OSes makes this difficult.

This section is for those who want to get down into the meats of their hackintosh, to really understand what it's doing and help if there's any issues with USBmap.py and other mapping tools. generally seen on 3.1/2 motherboard headers Type C connector - USB 2.0 and USB 3.0 without Switchįlipping the device does change the ACPI port. Type C connector - USB 2.0 and USB 3.0 with Switchįlipping the device does not change the ACPI port This is what macOS will default all ports to when no map is presentģ.0, 3.1 and 3.2 ports share the same Type Here we're greeted with all the possible USB ports in ACPI: Type

Section 9.14: _UPC (USB Port Capabilities).

Now if you haven't read through this before(which I highly recommend you do, it's a thrilling tale), I'll point you to the meat of the USB situation: And now we get to finally read one of my favorite books before I go to bed each night: The Advanced Configuration and Power Interface (ACPI) Specification! (opens new window) So with the prerequisites out of the way, we can finally get to the meat of this guide.

Finding which ports match with which controller.

Mac not detecting usb controller