XiaoMi-Pro-Hackintosh

English | 中文

配置

TM1701 & TM1707

规格	详细信息
电脑型号	小米笔记本Pro 15.6英寸 (MX150/GTX)
处理器	英特尔酷睿 i5-8250U / i7-8550U 处理器
内存	8GB/16GB 三星 DDR4 2400MHz
硬盘	三星 NVMe 固态硬盘控制器 PM961 / ~~PM981~~
集成显卡	英特尔 UHD 图形620
显示器	BOE NV156FHM-N61 FHD 1920x1080 (15.6 英寸)
声卡	瑞昱 ALC298 (布局ID: 30/99)
无线网卡	英特尔无线 AC 8265
触控板	ETD2303
SD 读卡器	瑞昱 RTS5129 / RTS5250S

TM1905 & TM1963

规格	详细信息
电脑型号	小米笔记本Pro 15.6英寸 (MX250/MX350)
处理器	英特尔酷睿 i5-10210U / i7-10510U 处理器
内存	8GB/16GB 三星 DDR4 2666MHz
硬盘	英特尔 SSD 660P 系列
集成显卡	英特尔 UHD 图形620
显示器	LQ156M1JW01 SHP14C3 1920x1080 344x194mm 15.5英寸
声卡	瑞昱 ALC256 (布局ID: 69/99)
无线网卡	英特尔无线 AC 9462
触控板	ELAN2303
SD 读卡器	瑞昱 RTS5129

当前状态

休眠可能会在CML机器上引发严重的启动问题，查看 #661 和 #694
- 用户应运行 sudo pmset -a hibernatemode 0 来禁用休眠模式，另见 README_CML
HDMI 首次插入时可能无法工作
- 你需要重新插拔，或者合上盖子约五秒钟再重新打开
以太网在macOS10.15+上可能无法工作，查看 #256
在macOS10.15+上，你需要更新无线USB适配器驱动
- 如果你不使用macOS10.15+，仍建议更新上述驱动
独立显卡不工作，因为macOS不支持Optimus技术
- 已使用 SSDT-DDGPU 禁用它以节省电量
指纹传感器不工作
- 已使用 SSDT-USB 禁用它以节省电量
英特尔蓝牙不支持某些蓝牙设备
- 在macOS12+上，英特尔蓝牙支持更多蓝牙4.x设备
- 查看蓝牙解决方案
- 你也可以尝试来自 AppleBluetooth 的 IOBluetoothFixup、IntelBluetoothFamily 和 OpenFirmwareManager；阅读 IntelBluetoothFamily 使用说明
英特尔Wi-Fi性能较低
- 推荐使用macOS Big Sur或更高版本；macOS版本 < 11 如果英特尔Wi-Fi不工作，需要重建kextcache并重启
- 购买USB Wi-Fi适配器或支持的无线网卡
- 阅读常见问题获取更多信息
瑞昱USB SD读卡器在某些配置下可以工作
- 阅读 FAQ 获取更多信息，并添加 RealtekCardReader + RealtekCardReaderFriend
- 或者你可以使用VMware使其工作，参见 2.0 设置SD读卡器
其他一切都运行良好

Clover

TM1701 和 TM1707：支持 macOS10.15 ~ macOS14
- v1.5.9 是最后一个支持 macOS High Sierra 和 Mojave 的 EFI 版本
TM1905 和 TM1963：支持 macOS10.15 ~ macOS14

使用 OpenCore 后应清理 NVRAM
- 在 OpenCore 引导页面按下 空格键，然后选择 重置 NVRAM 选项
- 然后重启并使用 Clover
r5127 版本在 macOS Big Sur 以下版本不支持 Intel Wi-Fi，因为 ForceKextsToLoad 功能不完整（只有 v1.4.7 支持旧版 macOS 上的 Intel Wi-Fi，或者你可以将 IO80211Family.kext 添加到 kext 文件夹中）

OpenCore

TM1701 和 TM1707：支持 macOS10.15 ~ macOS14
- v1.5.9 是最后一个支持 macOS High Sierra 和 Mojave 的 EFI 版本
TM1905 和 TM1963：支持 macOS10.15 ~ macOS14

使用 Clover 后应清理 NVRAM
- 在 OpenCore 引导页面按下 空格键，然后选择 重置 NVRAM 选项
主题有限
一些人在升级到 Windows 11 时遇到问题，请参阅 #665
推荐阅读：安全性和 FileVault | OpenCore 安装后和 OpenCore 配置，特别是 UEFI 安全启动 部分

安装

识别你的型号

如果你使用的是搭载 8 代 CPU 的小米笔记本 Pro，那么它是一台 KBL（Kaby Lake）机型。（实际上是 Kaby Lake Refresh）如果你使用的是搭载 10 代 CPU 的小米笔记本 Pro，那么它是一台 CML（Comet Lake）机型。在下载 EFI 发布版时你需要这些信息。

首次安装

请参考以下安装教程
- 小米笔记本 Pro High Sierra 10.13.6
- 小米笔记本 Pro macOS Catalina 安装指南 || 英文版
或视频教程
- 小米笔记本 PRO 黑苹果安装指南 !!!
- 2020 年西班牙语黑苹果指南 || 在小米笔记本 Pro 上安装 macOS Catalina
完整的 EFI 包可在 releases 页面获取。
请不要克隆或下载主分支用于日常使用。

构建

通过在终端中运行以下命令来构建最新的测试版 EFI：

sh -c "$(curl -fsSL https://raw.githubusercontent.com/daliansky/XiaoMi-Pro-Hackintosh/main/makefile.sh)"

或在终端中运行以下命令：

git clone --depth=1 https://github.com/daliansky/XiaoMi-Pro-Hackintosh.git
cd XiaoMi-Pro-Hackintosh
./makefile.sh

一些高级用法如下：

# 构建带有 Clover 和 OpenCore 引导程序的 EFI（1. --BL=CLOVER 仅 Clover 2. --BL=OC 默认，仅 OpenCore 3. --BL=CLOVEROC Clover 和 OpenCore 都有）
./makefile.sh --BL=CLOVEROC
# 构建带有调试版本 kexts 和 OpenCore 的 EFI
./makefile.sh --DEBUG_KEXTOC
# 忽略脚本运行时的错误
./makefile.sh --IGNORE_ERR
# 捆绑中文版文档（1. --LANG=en_US 默认 2. --LANG=zh_CN 中文文档）
./makefile.sh --LANG=zh_CN
# 为 10 代和 8 代同时生成 EFI 发布版（1. --MODEL=CML 仅 10 代 2. --MODEL=KBL 默认，仅 8 代 3. --MODEL=CMLKBL 10 代和 8 代都有）
./makefile.sh --MODEL=CMLKBL
# 在构建阶段保留工作文件
./makefile.sh --NO_CLEAN_UP
# 使用 GitHub API
./makefile.sh --GH_API
# 使用预发布版 kexts 和 OpenCore 构建最新的测试版 EFI（1. --PRE_RELEASE=Kext 预发布 kexts 2. --PRE_RELEASE=OC 预发布 OpenCore 3. --PRE_RELEASE=KextOC 预发布 kexts 和 OpenCore）
./makefile.sh --PRE_RELEASE=KextOC

升级

如果你使用的是搭载 8 代 CPU 的小米笔记本 Pro，那么它是一台 KBL（Kaby Lake）机型。（实际上是 Kaby Lake Refresh）
如果你使用的是搭载 10 代 CPU 的小米笔记本 Pro，那么它是一台 CML（Comet Lake）机型。

从发布页面下载最新的 EFI 发布版，或从 action 页面的 artifacts 中下载测试版 EFI 发布版。
通过先运行 sudo diskutil list 找到你的 EFI 分区标识符，然后运行 sudo diskutil mount diskXsX（X 从你的 EFI 分区标识符中提取）来挂载 EFI 分区
需要完全替换 BOOT 和 OC（或 CLOVER）文件夹。删除这两个文件夹，并从发布包中复制它们。

改进

使用 Hackintool 注入 EDID (AAPL00,override-no-connect)
在 config.plist 中将 #enable-backlight-smoother 改为 enable-backlight-smoother，以平滑调节面板亮度
使用 xzhih 的 one-key-hidpi 来提高系统 UI 质量
- 支持 1424x802 HiDPI 分辨率
- TM1701: 在 macOS > 10.13.6 上，要启用更高的 HiDPI 分辨率（不能超过 1520x855），需要使用 DVMT_and_0xE2_fix 将 DVMT 设置为 64mb
根据如何在 macOS 上修复 DMAR 表 | 内存映射修补 OEM DMAR 表以启用 AppleVTD；用户需要在每次 BIOS 更新后更新修补
如果出现 NVMe 内核崩溃 CSTS=0xffffffff，在 config - NVRAM - Add - 7CXXX - boot-args（OpenCore）或 config - Boot - Arguments（Clover）中添加 forceRenderStandby=0
使用 NVMeFix 在 NVMe SSD 上启用 APST
TM1701 和 TM1707: 使用 ALCPlugFix 修复重新插入后不工作的插孔
TM1701: 使用 DVMT_and_0xE2_fix 启用 4K 外接显示器和更"原生"的电源管理
TM1905 和 TM1963: 如果 macOS 版本为 13.4，将 enable-backlight-registers-fix 改为 enable-backlight-registers-alternative-fix

常见问题

我无法使用触控板点击拖动或右键。

从 VoodooI2C v2.4.1 开始，点击下压动作被模拟为力度触控，导致点击下压拖动和右键手势失效。您可以在 系统偏好设置 - 触控板 中关闭 用力点按，我建议在 系统偏好设置 - 辅助功能 - 鼠标与触控板 - 触控板选项 中启用 三指拖移。

更新过程中屏幕变黑且无响应。

如果屏幕黑屏五分钟且设备无响应，请强制重启笔记本（长按电源键），然后选择 Boot macOS Install from ~ 项。

卡在苹果标志或无法启动。

建议重置 NVRAM。对于 Clover 用户，在 Clover 引导页面时按 Fn+F11。对于 OC 用户，在 OpenCore 引导页面时按 空格 键并选择 Reset NVRAM。如果不起作用，可以尝试在 config.plist 中将 SecureBootModel 设置为 Disabled。

系统偏好设置中没有 OEM 更新。

对于 OC 用户，在 macOS11+ 上，SecureBootModel 必须设置为 Default 才能从系统偏好设置获取 OEM 更新。但是，某些机器在 SecureBootModel = Default 时无法启动。在这种情况下，请前往 App Store 搜索 Monterey（或更新的 macOS）。

我的设备被 `Find My Mac` 锁定且无法启动，现在该怎么办？

对于 Clover 用户，在 Clover 引导页面时按 Fn+F11。然后 Clover 将刷新 nvram.plist，锁定信息应该被移除。对于 OC 用户，在启动时按 Esc 进入引导菜单。然后按 空格 键并选择 Reset NVRAM。

[Clover] 我开启了 `FileVault`，在 Clover 引导页面找不到 macOS 分区，如何解决？

不建议开启 FileVault。您可以在 Clover 引导页面按 Fn+F3 并选择带有 FileVault 的图标。然后您可以进入系统并关闭 FileVault。

[OC] 如何跳过引导菜单并自动进入系统？

首先，在 macOS 中打开 系统偏好设置 - 启动磁盘。选择目标系统。然后，打开 /EFI/OC/config.plist，关闭 ShowPicker。当您想切换操作系统时，在启动时按 Esc 调出引导菜单。

[OC] 如何不将 OpenCore 设为默认引导加载程序？

打开 config.plist 并将 LauncherOption 的值从 Full 改为 System。

[OC] 如何启用启动提示音？（TM1701 和 TM1707）

在 config.plist - UEFI - Drivers 中启用 AudioDxe.efi。在 config.plist - UEFI - Audio 中启用 AudioSupport。如果您使用的是 macOS Big Sur，请前往 系统偏好设置 - 声音 并开启 启动时播放声音。对于 macOS 版本 < Big Sur，打开 终端.app 并运行 sudo nvram StartupMute=%00。