Skip to content

Latest commit

 

History

History
268 lines (204 loc) · 18.4 KB

README_CN.md

File metadata and controls

268 lines (204 loc) · 18.4 KB
Raw

构建状态 Release Wiki 讨论

English | 中文

目录

电脑配置

TM1701 和 TM1707

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

TM1905 & TM1963

规格 详细信息
电脑型号 小米笔记本电脑Pro 15.6'' (MX250/MX350)
处理器 英特尔 酷睿 i5-10210U / i7-10510U 处理器
内存 8GB/16GB 三星 DDR4 2666MHz
硬盘 英特尔 SSD 660P 系列
集成显卡 英特尔 超高清显卡 620
显示器 LQ156M1JW01 SHP14C3 1920x1080 344x194mm 15.5-inch
声卡 瑞昱 ALC256 (节点: 69/99)
无线网卡 英特尔 Wireless-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 来禁用它以节省电量
  • 英特尔蓝牙 不支持部分蓝牙设备
  • 英特尔无线网卡 性能不佳
    • 推荐使用 macOS Big Sur 或更高版本；macOS 版本低于11的话需要重建缓存重启如果英特尔无线网卡不工作
    • 购买 USB网卡 或者支持的内置网卡
    • 阅读 Frequently Asked Questions 来获取详细信息
  • 瑞昱USB SD读卡器 需要额外操作来工作
  • 其他都工作正常

Clover

  • TM1701 和 TM1707：支持 macOS10.15 ~ macOS14
    • v1.5.9 是最后一个支持 macOS High Sierra & Mojave 的 EFI 版本
  • TM1905 和 TM1963：支持 macOS10.15 ~ macOS14
  • 使用 OpenCore 后需要清理 NVRAM
    • 在 OpenCore 启动界面按下 空格，选中进入 Reset NVRAM
    • 然后重启并使用 Clover
  • r5127 不支持低于 macOS Big Sur 版本上的英特尔 Wi-Fi 因 ForceKextsToLoad 功能尚未实现（仅 v1.4.7 支持旧 macOS 版本的英特尔 Wi-Fi，或者添加 IO80211Family.kext 到 kext 文件夹）

OpenCore

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

安装

识别机型

如果你的机子是 小米笔记本Pro 8代 CPU，记为 KBL（Kaby Lake）机器。（实际为 Kaby Lake Refresh）
如果你的机子是 小米笔记本Pro 10代 CPU，记为 CML（Comet Lake）机器。
下载 EFI release 的时候需要用到这个信息。

首次安装

donot_clone_or_download

get_release

构建

如果要构建最新测试版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 --lang=zh_CN

还有一些进阶用法：

# 构建EFI时使用 Clover 和 OpenCore 引导（1. --BL=CLOVER 仅 Clover 2. --BL=OC 默认，仅 OpenCore 3. --BL=CLOVEROC 同时 Clover 和 OpenCore）
./makefile.sh --BL=CLOVEROC
# 构建EFI时使用 Debug 版 kexts 和 OpenCore
./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
# 构建包含最新 pre-release 驱动和 OpenCore 的测试版EFI（1. --PRE_RELEASE=Kext Pre-release 驱动 2. --PRE_RELEASE=OC Pre-release OpenCore 3. --PRE_RELEASE=KextOC 同时 pre-release 驱动和 OpenCore）
./makefile.sh --PRE_RELEASE=KextOC

更新

  • 如果你的机子是 小米笔记本Pro 8代 CPU，记为 KBL（Kaby Lake）机器。（实际为 Kaby Lake Refresh）
  • 如果你的机子是 小米笔记本Pro 10代 CPU，记为 CML（Comet Lake）机器。
  • 在 release page 里下载最新 EFI release，或从 action page 的 Artifacts 里下载最新测试版 EFI release。
  • 挂载 EFI 分区，首先运行命令 sudo diskutil list 来找到 EFI 分区所在的分区标号，然后运行命令 sudo diskutil mount diskXsX（X 取自你的 EFI 分区标号）
  • 完整替换 BOOT 和 OC(或 CLOVER)文件夹。首先删除他们，然后从 release 包里拷贝新的。

改善体验

  • 使用 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 来把动态显存设为64mb
  • 开启 AppleVTD 通过修改 OEM DMAR 表，参考 How to Fix DMAR Table on macOS | Memory Mapping；经测试每次升级 BIOS 后须重新定制
  • 添加 forceRenderStandby=0 到 config - NVRAM - Add - 7CXXX - boot-args (OpenCore) 或 config - Boot - Arguments (Clover) 如果出现 NVMe Kernel Panic CSTS=0xffffffff
  • 使用 NVMeFix 来开启 NVMe SSDs 的 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（或者更新系统）。

我的设备被 查找我的Mac 锁住了，无法开机，怎么办？

如果是 Clover 用户，在 Clover 开机界面按下 Fn+F11。然后 Clover 会刷新 nvram.plist 并移除锁定信息。
如果是 OC 用户，开机时按 Esc 键来进入引导菜单。然后按下 空格 键并选择 Reset NVRAM。

[Clover] 我开启了 文件保险箱，开机时找不到 macOS 启动项，怎么办？

一般情况下不推荐开启 文件保险箱。你可以在 Clover 开机界面时按下 Fn+F3，然后选择下方小字含有 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，请前往 系统偏好设置 - 声音 并勾选 启动时播放声音。
如果在使用低于 Big Sur 的 macOS 版本，请打开 终端.app 并运行 sudo nvram StartupMute=%00。

更多问题解答请前往 常见问题解答。

更新日志

详细更新日志请看 更新日志中文版。

鸣谢

请前往 参考 来获取更多内容。

支持与讨论

其他项目维护的小米笔记本系列：

tonymacx86.com:

QQ群: