Skip to content
Fix a certain USB wakeup issue on OSX
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
USBWakeFixup.xcodeproj Initial commit Sep 10, 2019
USBWakeFixup Initial commit Sep 10, 2019 Updated readme to point to alternative method Sep 22, 2019
SSDT-USBW.dsl Updated SSDT to be conditional for OSX only (#4) Sep 22, 2019


On systems without a working Embedded Controller, waking up from a USB device might not wake up the display. A second key-press or mouse click is required to wake up the display. This extension is a workaround for that issue by creating a fake ACPI device with the right wakeup params.

Shared GPE

If multiple devices share a single GPE, then they will ALL cause display wakeup with this workaround installed. This is an unfortunate side-effect. If you have a Ethernet controller with WoL enabled and it happens to be the same GPE as your USB controller, then WoL will now wake the display.


Check here for a more detailed technical writeup on how this works. You should only use this if injecting acpi-wake-type on XHCI does not work due to the Intel PCH bug. Please see this issue for more information.


  1. Build and install SSDT-USBW.dsl into your bootloader DSDT injection. You may need to modify it to point to your XHC device.
  2. Install the kext.
You can’t perform that action at this time.