General-EFI-for-OpenCore-Config

通用OpenCore EFI配置文件

概览 / Overview

辅助快速安装黑苹果的模板

Template for Quick installation of Hackintosh

免责声明 / Disclaimer

你的保修将完全失效。如果您有任何疑虑，请在使用我的项目之前先进行一些研究。我对任何损失均不负责，包括但不限于 Kernel Panic、设备无法启动或无法正常工作、硬件损坏或数据丢失、原子弹爆炸、第三次世界大战、SCP 基金会无法避免的 CK 级现实重构等。

Your warranty is now void. Please do some research if you have any concerns before utilizing my project. I am not responsible for any loss, including but not limited to Kernel Panic, device fail to boot or can not function normally, storage damage or data loss, atomic bombing, World War III, The CK-Class Restructuring Scenario that SCP Foundation can not prevent, and so on.

必读参考资料 / Refrence

dortania's OpenCore Install Guide
dortania's OpenCore Post Install Guide
dortania Getting Started with ACPI
dortania opencore multiboot
WhateverGreen Intel HD Manual
Configuration.pdf and Differences.pdf in each OpenCore releases.
daliansky/OC-little
OpenCore 简体中文参考手册 (非官方)

务必阅读上述参考资料

No seriously, PLEASE read those.

需求和依赖 / Requirement

基本需求 / Basic

一台已经安装好 macOS 的机器，用于制作 macOS 安装器和编译本项目（但是Windows PC也可以做到）

A macOS machine (optional): to create the macOS installer and build the EFI. (But windows PC can do the same)

一个容量大于等于 16 GiB 的 U 盘

Flash drive, 16GB or more, for the above purpose.

编辑 plist 文件的工具 PlistEDPlus

PlistEDPlus to edit plist files on Windows.

用于修补和编辑 ACPI 的工具 MaciASL

MaciASL for patching ACPI tables and editing ACPI patches.

在 macOS 下挂载 EFI 分区的工具 MountEFI

MountEFI to quickly mount EFI partitions under macOS.

用于诊断的 IORegistryExplorer

IORegistryExplorer for diagnosis.

仅用于 诊断的 HackinTool，大部分内置的补丁和工具已经过时，不再适用

HackinTool for diagnosis ONLY. Most of the built-in patches are outdated.

可在Windows操作系统环境下简单快捷地定制USB端口的工具 USBToolBox Beta。

USBToolBox Beta a tool that can easily and quickly customize USB port in Windows operating system.

耐心和时间，以及自主学习能力。如果你是第一次进行黑苹果，这尤为重要

Patience and time, as well as autonomous learning ability. especially if this is your first time Hackintosh-ing.

硬件修改 / Hardware Modification

固态硬盘 / SSD

三星 PM981/PM981a/PM991 和镁光 2200S 完全无法使用，务必更换至少一块 SSD 硬盘。

Samusung PM981/PM981a/PM991 and Micron 2200S is not supported AT ALL. Make sure to switch at least one SSD.

无线网卡 / Wireless Card

It is recommended to use Broadcom wireless network card to obtain Better performance and use native functions about「Apple Ecology」(I mean, 100x FASTER!)

建议使用博通无线网卡以获得更好的性能和使用原生的关于「苹果生态」的功能（更好，指速度快 100 倍）

升级或降级BIOS版本 / Update or Downgrade BIOS Version

推荐使用特定版本的 BIOS 固件以获得最佳的使用体验。但是我们通常推荐使用最新版BIOS固件。

A specific version of BIOS firmware is recommended for the best experience. But we usually recommend the latest version of BIOS firmware.

从主板厂商的支持网站上下载BIOS固件。

Download BIOS at Motherboard manufacturer Support Website.

修改BIOS设置 / BIOS Settings

禁用 / Disabled

Fast Boot～快速启动
VT-d(can be enabled if you set DisableIoMapper Quirks to YES)～VT-d（如果DisableIOMapper Quirks设置为YES，则可以启用）
CSM～CSM 兼容性支持模块
Thunderbolt (Temporarily disabled)～雷雳（暂时禁用）
Intel SGX～英特尔SGX
Intel Platform Trust～英特尔平台信任
CFG Lock(MSR 0xE2 write protection)～CFG锁（MSR 0xE2写保护）（必须关闭，如果找不到该选项，则在OpenCore的config-内核-> Quirks下启用与CFG Lock相关选项）
Secure Boot～安全启动
Parallel Port～并口
Serial/COM Port～串行/COM端口
Resizable BAR Support

启用 / Enabled

VT-x～VT-x
UEFI启动模式。请不要使用Legacy（UEFI startup mode. Please don't use Legacy）
硬盘模式改AHCI。不能用IDE和RST RAID。（Hard disk mode changed to AHCI. IDE and RST Raid cannot be used）
Above 4G decoding～大于4G地址空间解码
Hyper-Threading～超线程
Execute Disable Bit～执行禁用位
EHCI/XHCI Hand-off～EHCI / XHCI接手控制
OS type: Windows 8.1/10 UEFI Mode～操作系统类型：Windows 8.1 / 10 UEFI模式
DVMT Pre-Allocated(iGPU Memory): DVMT预分配（iGPU内存）：64MB及以上（64MB and above）
Legacy RTC Device～传统RTC设备

其他信息 / Other Information

OpenCore关于Kernel的Quirks XhciPortLimit 在macOS Big Sur 11.3及更新版本中失效。

OpenCore Quirks XhciPortLimit for Kernel is invalid in macOS Big Sur 11.3 and later.

请在安装 macOS Big Sur 11.3以及更新版本前，定制USB端口。

Please customize the USB Port before installing MacOS Big Sur 11.3 or later.

在安装完 macOS Big Sur 11.3以及更新版本后，请禁用config-Kernel-Quirks-XhciPortLimit 。

After installing macOS Big Sur 11.3 and later, disable config-Kernel-Quirks-XhciPortLimit .

具体详细注意事项和推荐参数内容都通过“#”注释方法写在了config文件内，请自行参考吧。

The detailed notes and recommended parameters are written in the config file through the "#" annotation method, please refer to it.

根据您主板的USB控制器设备ID来看，您可能需要安装额外的 kexts:

XHCI-unsupported.kext

X99系列芯片组XHC控制器，8086:8d31
200系列芯片组XHC控制器，8086:a2af（根据macOS版本而有）
300系列芯片组XHC控制器，8086:a36d或8086:9ded
400系列芯片组XHC控制器，8086:a3af
500系列芯片组XHC控制器，8086:43ed

待补充……

To be added……

笔记本用户 / Laptops Users

HP惠普笔记本用户

HP Laptops Users

Kernel->Quirks->LapicKernelPanic->True

UEFI->Quirks->UnblockFsConnect->True

Dell戴尔笔记本用户

Dell Laptops Users

Kernel->Quirks->CustomSMBIOSGuid->True

PlatformInfo->Quirks->UpdateSMBIOSMode->Custom

鸣谢 / Gratitude

Apple macOS
Acidanthera Team
Dortania‘s OpenCore Install Guide
AMD OS X
OpenIntelWireless
SukkaW

etc......

捐赠 / Donation

捐赠本项目 并不是必需的。但是如果我的项目对你有所帮助，为什么不考虑一下给我买杯咖啡呢？

Donating to this project is OPTIONAL. But feel free to buy me a coffee if you appreciate my works.

维护者 / Maintainer

GitHub @Miracle樱乃. · Twitter @Miracle樱乃. · Telegram Channel @Rabbit House

Miracle-Sakuno/General-EFI-for-OpenCore-Config