OC-Little: ACPI Hotpatch Samples and Guides for OpenCore
TABLE of CONTENTS
PREFACE
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
- BOOT Folder
- Quirks
- Board-ID Skip and VMM Spoof
- Kext Loading Sequence Examples
- Graphics (integrated/discrete)
- MMIO Whitelist
- Fixing Peripherals
- Fixing falsely reported RAM speed
- Using OpenCore Legacy Patcher on Wintel systems
APPENDIX
- Updating OpenCore
- Fixing issues with System Update Notifications
- Config Tips & Tricks
- Compatibility Charts
- Generating EFIs with OCAT
- Create/modify a Layout-ID for AppleALC
- Windows-related Guides
- 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)
- Switching to NO_ACPI build of OpenCore
- Using Clover alongside OpenCore
- Utilities and Resource
- Featured OpenCanopy Themes
- Terminal Commands
DISCLAIMER
- 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.
- 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 here.
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
andUSB 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 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!
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