OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

ABOUT

Compendium of Guides, ACPI Hotpatches and Binary Renames for use with the OpenCore Boot Manager based on OC-Little by Daliansky translated from Chinese. All Binary Renames, ACPI Hotpatches (using OCLT as OEMID) remain untouched except where indicated.

This repo provides additional ACPI hotpatches and guides complementary to the ones provided by the OpenCore Package and Dortania's OpenCore Install Guide. It covers all angles of modern hackintoshing. From adding and enabling devices and features, fixing USB and Sleep issues, laptop-specific fixes, GPU optimizations and more (check the TOC for details). Although aimed primarily at OpenCore users, all of the SSDTs and most of the guides/techniques are applicable to Clover as well.

DISCLAIMER

The methods and techniques presented in this repo are based on utilizing the official OpenCore release and its features alongside Kexts, SSDTs, Device Properties and other tools to enable/disable devices and features in macOS to get a proper working system which is ACPI conform!

OC-Little Translated does not consider patching the DSDT an appropriate measure to get the "Real Vanilla Hackintosh" experience. In fact, it's quite the opposite, as explained here:

MaLd0n's implications that you need a custom DSDT to add and remove (well, remove yes, but disabling is good enough in virtually all cases) devices is incorrect. Aside from those claims, most device rename changes (probably also things you considered „missing“) are also not needed, as they are performed by Lilu and its plug-ins. This approach is a lot safer than previous ACPI renames as dumb find-replace patches can yield false positives, the kext approach cannot.

Therefore, OC-Little Translated does not support nor promote patching DSDTs (and the shady business practices behind it), as well as pre-patched ISOs and unofficial modified forks of OpenCore that prevent injecting ACPI tables into Windows, just because the guy running his "Real Vanilla Hackintosh" forum doesn't know how to write proper ACPI tables that don't cause a Blue Screen of Death!

TABLE of CONTENTS

MAIN

• ACPI Basics and Guides
• Adding Virtual Devices and enabling Features with SSDTs
• Disabling Devices
• USB Port Mapping
• Fixing Sleep and Wake Issues
• Laptop-specific Patches
• CMOS-related Fixes
• PCI BAR Size (OC 0.7.5+)
• Quirks
• Board-ID Skip and VMM Spoof
• Kext Loading Sequence Examples
• Graphics (integrated/discrete)

APPENDIX

• Updating OpenCore
• Config Tips & Tricks
• Compatibility Charts
• Desktop EFIs
• Create/modify a Layout-ID for AppleALC
• Adding Windows to the boot menu GUI
• Enabling Linux Boot Entries
• Boot Arguments Explained
• OpenCore Calculators
• Compiling slimmed-down variants of Kexts
• Debugging
• OpenCore EFI Upload Checklist
• Combining all SSDTs into one file (SSDT-ALL)
• Utilities and Resource
• Terminal Commands

CONTRIBUTIONS

If you would like to contribute to the information provided in this repo in order to improve/expand it, feel free to create an issue with a meaningful title, link to the chapter/section and describe what you like to add, change, correct or expand upon.

5T33Z0's 5H0UT 0UT5

• Thanks to the contributors for improving and expanding the repo. Additional credits for contributors outside of the github realm are listed in the respective sections of the repo.
• sascha_77 for Kext Updater, ANYmacOS and helping me to unbrick my Lenovo T530 BIOS!
• Apfelnico for introducing me to ASL/AML Basics
• Bluebyte for having good conversations
• Cyberdevs from insanelymac for his Z170X Gaming 5 Guide and for being a prime example of a Moderator who treats others with respect!