OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

TABLE of CONTENTS

PREFACE

• DISCLAIMER
• About OC-Little Translated
• About the translation

MAIN

• ACPI basics and guides
• Adding/Enabling Devices and Features with SSDTs
• Disabling Devices
• Fixing Graphics (integrated/discrete)
• Fixing USB
• Fixing Sleep and Wake Issues
• Fixing issues with peripherals
• Laptop-specific Patches
• CMOS-related Fixes
• BOOT Folder
• Kext Loading Sequence Examples
• MMIO Whitelist
• Fixing falsely reported RAM speed

SPECIAL

• Using OpenCore-Patcher on Wintel machines
• Board-ID Skip and VMM Spoof
• Utilities and Resource

APPENDIX

Config-related

• Config Tips & Tricks
• Boot Arguments Explained
• Quirks
• EFI Upload Checklist

Guides for OpenCore Auxiliary Tools (OCAT)

• Updating OpenCore
• OpenCore Calculators
• Switching to NO_ACPI build of OpenCore
• Generating EFIs with OCAT

macOS-related

• Terminal Commands
• Compatibility Charts
• Fixing issues with System Update Notifications
• macOS 14.4 install workaround
• Creating a multi macOS USB Installer

Other OSes

• Windows-related Guides
• Enabling Linux Boot Entries
• macOS Virtulization

Miscellaneous

• Featured OpenCanopy Themes
• Create/modify a Layout-ID for AppleALC
• Compiling slimmed-down variants of Kexts
• Debugging with SysReport
• Combining all SSDTs into one file (SSDT-ALL)
• Using Clover alongside OpenCore

---

DISCLAIMER

1. OC-Little Translated is not an installation guide for getting your system up and running with macOS – use Dortania's excellent OpenCore Install Guide for that! Instead, it's a supplementary resource that offers guides and fixes for various issues related to hackintosh systems, along with explanations and context about how they work. It is regularly updated to reflect the latest discoveries and developments of the hackintosh community.
2. The material presented in this repo is designed to empower users to create a proper working system running macOS without breaking ACPI-compliancy! Therefore, OC-Little Translated does not support methods which do not hold up to this premise – such as patching the DSDT – since it's not an appropriate measure to get the "Real Vanilla Hackintosh" experience. In fact, it's quite the opposite, as discussed on insanelymac.

ABOUT

Collection of guides, ACPI Hotpatches and Binary Renames for use with the OpenCore Boot Manager based on OC-Little by Daliansky translated from Chinese.

Besides the original translated guides, this repo contains additional guides complementary to the ones provided by the OpenCore Package and Dortania's OpenCore Guides. It covers a wide range of hackintosh-related topics, including:

• ACPI basics
• Enabling devices and features
• Fixing sleep/wake and other power-related issues
• Guides for Mapping USB Ports
• Fixing Laptop-specific issues
• Fixing graphics-related issues
• Config-related tips
• Guides for using OpenCore Legacy Patcher on Wintel Systems

Check the table of contents for more. Although aimed primarily at OpenCore users, all of the SSDTs and most of the guides/techniques are applicable to Clover as well.

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, Chapters 7 to 14 as well as the whole "Appendix" section)

Note

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

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 al the contributors for improving and expanding the repo! Additional credits for contributors outside of the github realm are listed in the respective chapters/sections.
• 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!

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