OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

PREFACE

DISCLAIMER
About OC Little Translated
About the translation

MAIN

APPENDIX

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 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 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