AsRock Z490 Extreme4 Hackintosh

华擎 Z490 极限玩家黑苹果 OpenCore 引导配置

Disclaimer / 免责声明

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.

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

Hardware Specifications / 硬件配置

Component	Brank
CPU	Intel i5 10400 (6C-12T)
iGPU	Intel® HD 630 Graphics
DGPU	MSI Radeon RX 6600XT
Lan	Realtek PCIe 2.5GbE
Audio	Realtek ALC1220/S/A
Ram	KLEVV 16 GB DDR4 3600 Mhz
Wifi + Bluetooth	Intel® AX201 BCM94360Z4
NVMe	WD SN550 1TB
PCIE Expansion	GC-TITAN RIDGE ver 1.0
SmBios	iMac 19,2
BootLoader	OpenCore 0.9.0
macOS	supported Monterey to Ventura

Working & Not Working / 可用与不可用的功能

Non-Fuctional / 不工作

There is nothing that doesn't work

没有不工作的

Video and Audio / 音频与视频

Feature	Status	Dependency	Remarks
Full Graphics Accleration (QE/CI) 图形硬件加速	✅	`WhateverGreen.kext`
Automatic Headphone Output Switching 当插入耳机时自动切换音频输出	✅	`AppleALC.kext`

Power, Charge, Sleep and Hibernation / 电源管理、充电、睡眠、休眠

Feature	Status	Dependency	Remarks
CPU Power Management (SpeedShift) CPU 电源管理	✅	`SSDT-Plug`	Use CPUFriend and CPUFriendDataProvider for better power management 使用CPUFriend和CPUFriendDataProvider 获得更好的电源管理
S3 Sleep / Hibernation Mode 3 S3 睡眠 / Mode 3 休眠	✅	`supported`
Hibernation Mode 25 Mode 25 休眠	✅	`sudo pmset hibernatemode 25`	Works on my machine. Report an issue if you have encountered any issue. 测试成功。如果你在休眠时遇到问题，请反馈给我

Input & Output

Feature	Status	Dependency	Remarks
WiFi	✅	`AirportFixup.kext`	Suggest to switch Broadcom based card 推荐更换博通无线网卡
Bluetooth	✅	`BCM 94360Z4`	Suggest to switch Broadcom based card 推荐更换博通无线网卡
USB 2.0, USB 3.0	✅	`USBToolBox.kext and UTBMap.kext`
USB 3.1	✅	`SSDT-TB3 and SSDT-DTGP`	Hotplug fully supported 支持全功能热插拔
USB Power Properties in macOS macOS 的 USB 电源属性	✅	`SSDT-USBX`
Thunderbolt 3 Hotplug 雷电接口热插拔	✅	`SSDT-TB3`	You need to swipe the Thunderbolt 3 expansion card firmware 需要刷写雷电3扩展卡固件

Display, TrackPad and Keyboard / 显示器、触摸板和键盘

Feature	Status	Dependency	Remarks
Display brightness adjustment	✅		To use the software MonitorControl, you need to show support for the DDC/CI protocol 使用软件 MonitorControl调节，需要显示支持DDC/CI协议
HiDPI	✅		Natively enabled on screen 在 4K 屏幕上原生启用

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 / 基本需求

A macOS machine (optional): to create the macOS installer and build the EFI. 一台已经安装好 macOS 的机器，用于制作 macOS 安装器和编译本项目
Flash drive, 12GB or more, for the above purpose. 一个容量大于等于 12 GiB 的 U 盘
ProperTree to edit plist files on Windows. 编辑 plist 文件的工具 ProperTree
MaciASL for patching ACPI tables and editing ACPI patches. 用于修补和编辑 ACPI 的工具 MaciASL
MountEFI to quickly mount EFI partitions under macOS. 在 macOS 下挂载 EFI 分区的工具 MountEFI
IORegistryExplorer for diagnosis. 用于诊断的 IORegistryExplorer
HackinTool for diagnosis ONLY. Most of the built-in patches are outdated. 仅用于 诊断的 HackinTool，大部分内置的补丁和工具已经过时、不再适用
Patience and time, especially if this is your first time Hackintosh-ing. 耐心和时间。如果你是第一次进行黑苹果，这尤为重要

Hardware Modification / 硬件修改

Wireless Card / 无线网卡

Although OEM Intel AX200 is now supported by itlwm, but it is still recommended to use Broadcom Wireless card for BETTER (I mean, 100x FASTER!) performance.

虽然 Intel AX201 已经可被 itlwm 驱动，但是仍建议使用博通无线网卡以获得更好的性能（更好，指速度快 100 倍）和更好的兼容性（itlwm.kext 不支持连接 WPA/3 Enterprise、Airportitlwm.kext 不支持连接隐藏 SSID）。

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

No specific requirement

没有特定要求

BIOS Settings / 修改 BIOS 设置

To be supplemented

待补充

Other Information / 其它信息

How to build EFI / 如何编译本 EFI

There is no prebuilt version of EFI avaliable YET, and it is only able to build under macOS. Use a virtual machine or action-tmate if you have to.

本 EFI 暂时不提供 预编译版本，并且编译必须在 macOS 下进行。如有必要，请使用虚拟机、或通过 action-tmate 将 GitHub Action 作为 macOS VPS 使用。

Use following command to build the EFI.

使用下述指令编译 EFI：

git clone https://github.com/TokiharaSay/AsRock-Z490-Extreme4-Hackintosh
cd AsRock-Z490-Extreme4-Hackintosh
chmod +x **/*.sh
./build.sh

Find generated EFI under Output folder. Find OpenCore config at Output/EFI/OC/config_sample.plist and fill in your own SMBIOS (Follow the guide, use model iMac 19,2) then rename config_sample.plist to config.plist.

你可以在 Output 目录下找到生成的 EFI。OpenCore 配置文件路径为 Output/EFI/OC/config_sample.plist，你需要自行生成 SMBIOS 信息（遵循这篇教程的步骤，使用机型 iMac 19,2）并填入配置文件中，然后将 config_sample.plist 重命名为 config.plist。

Use following command to update and rebuild the EFI from upstream.

使用下述指令从上游更新和重新编译 EFI：

cd AsRock-Z490-Extreme4-Hackintosh
git pull --rebase
chmod +x **/*.sh
./build.sh

Everytime you rebuilt the EFI you have to fill in the SMBIOS again. So keep your SMBIOS info saved in a safe place!

每次重新编译 EFI 后你都需要重新填入一次 SMBIOS 信息，所以务必将你的 SMBIOS 信息保存在一个安全的位置！

Directories Structure / 项目目录结构

.
├── ACPI
│   ├── OEM_DSDT # The original DSDT dissembled from OEM BIOS
│   └── SSDT
│       ├── DSL # SSDT source dsl files
│       └── build_acpi.sh # dsl files build script
├── Audio
├── Config
│   └── config_sample.plist # Sample config.plist
├── Kexts
│   ├── Local # Kexts files where there is no way to be downloaded
│   │   ├── USBToolBox.kext
│   │   ├── UTBMap.kext
│   │   └── CPUFriendDataProvider.kext
│   └── download_kexts.sh # Use the script to download the rest of the kexts
├── LICENSE
├── OpenCore
│   ├── OldSample.plist # The curent version of OpenCore sample. Used to diff the configuration when update OpenCore to a newer version 
│   └── oc.sh # Script uesd to download OpenCorePkg and construct EFI folder
├── README.md # The file you are currently reading
└── build.sh # Overall build script, will call all the scripts mentioned above.

Donation / 捐赠

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

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

Maintainer / 维护者

AsRock Z490 Extreme4 © TokiharaSay, Released under the GPL-3.0 License.
Authored and maintained by TokiharaSaywith help from contributors (list）.

Blog · GitHub @TokiharaSay · Twitter @TokiharaSay

TokiharaSay/AsRock-Z490-Extreme4-Hackintosh