OC-Little Translated: ACPI Hotpatch Samples and Guides for OpenCore

---

🧰 Introduction

OC-Little Translated is a collection of ACPI hotpatches, binary renames, and guides for OpenCore, translated from Daliansky's OC-Little. It complements Dortania's OpenCore Guides and covers topics like ACPI basics, device enabling, USB mapping, graphics fixes, and more. While tailored for OpenCore, most SSDTs and techniques are applicable to Clover as well.

📌 Disclaimer

1. 🚫 Not an Installation or Configuration Guide

   This is not a macOS installation nor OC Configuration guide. For setting up OpenCore for macOS usage on a Wintel System, use the OpenCore Install Guide. OC-Little focuses primarily on post-install tuning and hardware enablement.

2. ✅ ACPI-Compliant Methods Only

   This project avoids DSDT patching and other invasive mods. It adheres to the philosophy of a clean, vanilla Hackintosh using only ACPI hotpatching. For more on this philosophy, see this InsanelyMac thread.

🌍 About the Translation

• Translation Process: Uses AI-based tools (DeepL, Google Translate) with manual copyediting for accuracy.
• Restructuring: Organized the repo into logical sections based on issue types, components, and methods.
• Improvements: Rewritten confusing sections (e.g., ACPI, USB Port Mapping), added missing descriptions, and included new content (e.g., USB Port Mapping via ACPI, Chapters 7–14, and the Appendix).
• Accuracy Note: As the translator does not speak Chinese, minor inaccuracies may exist.

🔧 Core Configuration & Patching

📄 ACPI & Devices

• 🧠 ACPI Basics and Guides
• ➕ Adding Missing Devices (SSDTs)
• ➖ Disabling Devices
• 🧩 Populating the MMIO Whitelist
• 🧷 Merging SSDTs into one table

🛠️ System Fixes

• 💻 Fixing CPU Power Management
• 🎮 Fixing Graphics (iGPU/dGPU)
• 🔌 Fixing USB
• 😴 Fixing Sleep & Wake
• 🔄 Fixing System Updates
• 🖱️ Fixing issues with peripherals
• 🧮 Fixing RAM Speed Reporting
• 🔋 CMOS-Related Fixes
• 🛠️ macOS 14.4+ Install Workaround

💻 Laptop-Specific

• 💻 Laptop Patches (Battery, FN keys, etc.)
• 🖥️ Modifying Framebuffer Patch for detecting External Displays

⚙️ Boot & Kexts

• ⚙️ Boot-Args Explained
• 📦 Kext Loading Order Examples
• 📡 Sensor Plugins for Monitoring
• 🧬 Compiling Slimmed-Down Kexts
• 🗂️ BOOT Folder Configuration

🧠 Advanced Configuration

🧩 OpenCore Setup

• 💡 Config Tips & Tricks
• 🎛️ Quirks Explained
• 📋 EFI Upload Checklist
• 🧮 OpenCore Calculators
• 🎨 Featured OpenCanopy Themes
• 🧠 Tips for working with ProperTree

🛠️ OpenCore Auxiliary Tools (OCAT)

• 🔄 Updating OpenCore with OCAT
• 🚫 Switching to NO_ACPI Build
• 🧰 Generating EFIs with OCAT

🍏 macOS Topics

• 💻 Terminal Commands
• 📊 macOS Compatibility Charts
• 💿 Multi-macOS USB Installer
• 💻 macOS Virtualization

🪟 Other OSes

• 🪟 Windows-Specific Fixes
• 🐧 Adding Linux Boot Entries

🧪 Special Topics

• 🧼 Using OCLP on Wintel PCs
• 🧰 Generating EFIs with OpCore Simplify
• 🎧 Creating a custom AppleALC Layout-ID
• 🐛 Debugging with SysReport
• 🔀 Using Clover & OpenCore Together
• 🧃 Utilities & Resources

📈 Repo Stats

🙏 Acknowledgments

• Contributors: Thanks to all contributors for improving this repo. Additional credits are listed in relevant chapters.
• Special Thanks:
  • sascha_77: For Kext Updater, ANYmacOS, and BIOS unbricking assistance.
  • Apfelnico: For introducing ASL/AML basics.
  • Bluebyte: For insightful discussions.
  • Cyberdevs: For the Z170X Gaming 5 Guide and exemplary moderation.
• Daliansky's Original Credits:
  • XianWu: For ACPI component patches.
  • Bat.bat, DalianSky, athlonreg, iStar丶Forever: For proofreading and finalization.
  • Additional Credits: 冬瓜-X1C5th, OC-xlivans, Air 13 IWL-GZ-Big Orange, 子骏oc IWL, 大勇-小新air13-OC-划水小白, xjn819, and Acidanthera for OpenCorePkg.