OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

OC-Little： 适用于 OpenCore 的 ACPI 热补丁示例和指南

TABLE of CONTENTS

目录

PREFACE / 前言

• Disclaimer / 免责声明
• About OC Little Translated / 关于 OC Little 翻译
• About the translation / 关于本翻译

MAIN / 主要内容

• ACPI Basics and Guides / ACPI 基础知识和指南
• Adding Virtual Devices and enabling Features with SSDTs / 使用 SSDT 添加虚拟设备并启用特性
• Disabling Devices / 禁用设备
• USB Port Mapping / USB 端口映射
• Fixing Sleep and Wake Issues / 修复睡眠和唤醒问题
• Laptop-specific Patches / 笔记本电脑特定的补丁
• CMOS-related Fixes / CMOS 相关修复
• BOOT Folder / BOOT 文件夹
• Quirks / 怪癖
• Board-ID Skip and VMM Spoof / 跳过 Board-ID 以及 VMM 欺骗
• Kext Loading Sequence Examples / Kext 加载顺序示例
• Graphics (integrated/discrete) / 图形显示（集成/独立）
• MMIO Whitelist / MMIO 白名单
• Fixing Peripherals / 修复外设
• Fixing falsely reported RAM speed / 修复错误报告的内存速度
• Using OpenCore Legacy Patcher on Wintel systems / 在 Wintel 系统上使用 OpenCore 传统补丁程序

APPENDIX / 附录

• macOS 14.4 install workaround / macOS 14.4 安装变通方案
• Updating OpenCore / 更新 OpenCore
• Fixing issues with System Update Notifications / 修复系统更新通知问题
• Config Tips & Tricks / 配置技巧与窍门
• Compatibility Charts / 兼容性图表
• Generating EFIs with OCAT / 使用 OCAT 生成 EFI
• Create/modify a Layout-ID for AppleALC / 为 AppleALC 创建/修改布局标识
• Windows-related Guides / Windows 相关指南
• Enabling Linux Boot Entries / 启用 Linux 引导条目
• Boot Arguments Explained / 启动参数详解
• OpenCore Calculators / OpenCore 计算器
• Compiling slimmed-down variants of Kexts / 编译经过精简的 Kexts 变种
• Debugging / 调试
• OpenCore EFI Upload Checklist / OpenCore EFI 上传检查表
• Combining all SSDTs into one file (SSDT-ALL) / 将所有 SSDT 合并为一个文件 (SSDT-ALL)
• Switching to NO_ACPI build of OpenCore / 切换到 OpenCore 的 NO_ACPI 构建
• Using Clover alongside OpenCore / 在使用 OpenCore 的同时使用 Clover
• Utilities and Resource / 实用工具和资源
• Featured OpenCanopy Themes / OpenCanopy 特色主题
• macOS Virtulization / macOS 虚拟化
• Terminal Commands / 终端命令

---

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.

   OC-Little Translated 并不是让你的系统启动并运行 macOS 的安装指南--请使用 Dortania 出色的 OpenCore Install Guide！相反，它是一个补充资源，提供与 hackintosh 系统相关的各种问题的指南和修复方法，以及关于它们如何工作的解释和背景。它定期更新，以反映 hackintosh 社区的最新发现和发展。

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

   本软件仓库中提供的资料旨在帮助用户在不破坏 ACPI 兼容性的情况下，创建一个正常运行 macOS 的工作系统！因此，OC-Little Translated 不支持不符合这一前提的方法，例如修补DSDT，因为这不是一个获得 “真正原版 Hackintosh”体验的合适措施。事实上，情况恰恰相反，在此讨论。

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.

基于 OC-Little by Daliansky 翻译自中文的用于 OpenCore 启动管理器的指南、ACPI 热补丁和二进制重命名合集。

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:

除翻译的原始指南外，该 repo 还包含 OpenCore 软件包和 Dortania 的 OpenCore 指南所提供的补充指南。它涵盖了与 hackintosh 相关的各种主题，包括：

• ACPI basics

  ACPI 基础知识

• Enabling devices and features

  启用设备和特性

• Fixing sleep/wake and other power-related issues

  修复睡眠/唤醒和其他电源相关问题

• Guides for Mapping USB Ports

  USB 端口映射指南

• Fixing Laptop-specific issues

  修复笔记本电脑特定问题

• Fixing graphics-related issues

  修复图形显示相关问题

• Config-related tips

  配置相关的提示

• Guides for using OpenCore Legacy Patcher on Wintel Systems

  在 Wintel 系统上使用 OpenCore Legacy Patcher 的指南

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.

查看目录，了解更多信息。虽然主要针对 OpenCore 用户，但所有 SSDT 和大多数指南/技术也适用于 Clover。

About the translation

关于翻译

• AI-based translation using deepL, google translator as well as manual copyediting.

  使用 deepL 和谷歌翻译进行人工智能翻译，并进行人工校对。

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

  重写了全部容易被混淆/被误导的部分（例如 ACPI 和 USB 端口映射）。

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

  添加新内容（通过 ACPI 进行 USB 端口映射、第 7 章至第 14 章，以及全部 “附录 ”部分）

Note

注意

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

由于我不会中文，翻译可能不是 100% 准确。

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.

如果您希望对本 repo 中提供的信息做出贡献，以改进/扩展它们，请创建一个问题，并附上有意义的标题，在问题中链接到相应章节/小节，并描述您希望添加、更改、更正或扩展的内容。

5T33Z0's 5H0UT 0UT5

来自 5T33Z0 的声音

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

  感谢 ** 贡献者们** 对 repo 的改进和扩展。来自 github 之外的其他贡献者的功劳列在软件仓库的相应部分。

• sascha_77 for Kext Updater, ANYmacOS and helping me to unbrick my Lenovo T530 BIOS!

  感谢 sascha_77 改进了 Kext Updater、ANYmacOS 以及帮我解决联想 T530 BIOS 的故障！

• Apfelnico for introducing me to ASL/AML Basics

  感谢 Apfelnico 向我说明 ASL/AML 的基础知识

• Bluebyte for having good conversations

  与 Bluebyte 进行了有意义的交谈

• Cyberdevs from insanelymac for his Z170X Gaming 5 Guide and for being a prime example of a Moderator who treats others with respect!

  感谢来自 insanelymac 的 Cyberdevs，感谢他的 Z170X Gaming 5 指南 以及作为版主，他是尊重他人的典范！

Daliansky's original Credits

Daliansky 的原始感谢名单

• Special credit to:

  特别感谢：

  • @XianWu write these ACPI component patches that useable to OpenCore

  编写可用于 OpenCore 的 ACPI 组件修补程序

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