OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

ABOUT

Compendium of ACPI Hotpatches and Binary Renames for use with the OpenCore Bootloader based on OC-Little by Daliansky translated from Chinese. All Binary Renames, ACPI Hotpatches (containing OCLTin the table header) 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 can be apllied using the Clover Bootloader as well.

About the translation (click to reveal content)

About the translation

• AI-based translation using deepL, google translator as well as manual copyediting.
• Restructured the repository into more plausible (sub-)sections and categories based on types of issues, components, methods, etc.
• Restructured Texts for better readability and comprehensibility
• Rewrote whole sections which were confusing/misleading (ACPI and USB Port Mapping for example)
• Added missing descriptions
• Added further explanations where necessary
• Added new content (USB Port Mapping via ACPI to Chapter 3, Chapters 7 to 10 and the whole Appendix section)

NOTE: Due to the fact that I don't speak Chinese the translation might not be 100% accurate.

TABLE of CONTENTS

MAIN

• ACPI Basics and Guides
• Adding Fake 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

APPENDIX

• Updating OpenCore
• Config Tips & Tricks
• SMBIOS Compatibility
• Desktop EFIs
• Adding Windows to the boot menu GUI
• Enabling Linux Boot Entries
• Boot Arguments Explained
• OpenCore Calculators
• Utilities and Resource

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 Baio1977 for his contributions to improve and expand this 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
• insanelymac.com for being a really nice community with kind mods

Daliansky's original Credits

• Special credit to:
  • @XianWu write these ACPI component patches that useable to OpenCore
  • @Bat.bat, @DalianSky, @athlonreg, @iStar丶Forever their proofreading and finalization.
• Credits and thanks to：
  • @冬瓜-X1C5th
  • @OC-xlivans
  • @Air 13 IWL-GZ-Big Orange (OC perfect)
  • @子骏oc IWL
  • @大勇-小新air13-OC-划水小白
  • @xjn819
  • Acidanthera for maintaining OpenCorePkg