• Become a Premium Member for $25/year with no ads to improve your community experience. Upgrade to Pro Account for faster response and no wait times!

  • We regret to inform you that our server had an unexpected catastrophic failure and we lost the recent backups as well. The last healthy backups was restored of February 24, 2025. Members who have already registered, please consider a reregistration. Once re-registered, the memberships will be restored for those who have purchased a membership. We'll continue to monitor and send emails to assist you to have you onboard. Any inconvenience is highly regretted. Thank you for your continued support and participations.

    Sincerely, EliteMacx86

GUIDE How to Fix USB issue on Ryzen based APU Laptops

EliteMacx86

Administrator
Staff member
Joined
Jul 22, 2018
Messages
8,389
Motherboard
Supermicro X11SPA-T
CPU
Intel Xeon W-3275 28 Core
Graphics
2xAMD RX 580 8GB
OS X/macOS
13.x
Bootloader
  1. OpenCore (UEFI)
Mac
  1. Mac mini
  2. MacBook Pro
Mobile Phone
  1. Android
  2. iOS

How to Fix USB issue on Ryzen based APU Laptops​

This guide describes how to fix USB issue on Ryzen based APU Laptops. By following this guide, you would be able to install macOS without having the USB issues on macOS Ryzen based Laptops.

Overview

With the release of NootedRed, it is now possible to install macOS on Ryzen based APU Laptops. While it is possible to install macOS with the graphics acceleration, there is a known problem with the USB ports. As macOS installer requires a functional USB port, the installer fails to boot causing a halt at an early stage. This is due to the multiple USB controllers found on Ryzen platforms.

While this shouldn't be a problem for users who have mapped the USB ports with native method, this becomes a problem for users who have not mapped their ports yet.

STEP 1: Add Required Kext

The very first step is to install the required kext in order to have the working USB ports. To install the required kext, follow the steps below:

1. Download GenericUSBXHCI.
2. Extract the kext.
3. Mount your ESP.
4. Depending on your bootloader,

Clover:
1. If you're using Clover, copy itlwm.kext to EFI/Clover/Kext/Others directory.

OpenCore
1. If you're using OpenCore, copy itlwm.kext to the EFI/OC/kexts directory.
2. Open your config.plist and add itlwm.kext entry in the Kernel>Add section of your config.plist:

5. Save your config.plist.

NOTES:
Your kext list and entries may differ as each system is different and will have different requirements.
This step is required for the installation and you must the USB ports thereafter.

STEP 2: Boot using the new Configuration

Once you're done with the above steps, you'll need to boot with the updated configuration. Simply restart your system. It is recommended to reset NVRAM twice at least.

STEP 3: Map USB Ports

If adding GenericUSBXHCI does not make the USB Port working, then you'll have to map the USB ports. This step is also required even after if you have got the ports working with the STEP 1. To map the USB ports, refer to the guide linked below:

 
Last edited:
Commented when guide was still WIP but kindly make sure that Ryzen XHCI Fix is loaded before USB Toolbox Map and USB Toolbox kext.

Also you might have to disable USB Toolbox and USB Toolbox Map to boot into installer.

Alternate fix is to disable one of the xhci controllers using Smokeless UMAF.

You can also force macos to boot without using any fix by plugging in usb device into every port. Might take a few seconds but it boots.
 
  • Like
Reactions: EliteMacx86

Latest posts

Forum statistics

Threads
1,935
Messages
17,954
Members
27,705
Latest member
zerockr