
1401适用于 macOS 的 NullMoth NVIDIA 驱动程序,适用于 macOS 15 Sequoia(Intel Mac 和 OpenCore PC)上 NVIDIA GeForce 显卡的 Metal 驱动程序。它是开源的;内核扩展、Metal 插件和着色器转换器都包含在此代码库中。用于安装它的 1401 应用程序,Windows版本是一个独立的项目,不在本文章中。
支持的显卡为图灵架构及更新的型号:GTX 16、RTX 20、30、40 和 50、TITAN RTX、Quadro RTX 以及 T 系列显卡。大部分测试是在 RTX 5060 上进行的,因此其他显卡可能存在尚未发现的问题。
显卡支持列表
| amily | Examples covered by the device table | Physical validation in this release |
|---|---|---|
| Turing | GTX 1650/1660, RTX 20, TITAN RTX, Quadro T1000/T2000/RTX, NVIDIA T400/T600/T1000, T500/T550/T600/T1200 laptop | Pending |
| Ampere | RTX 30, RTX A workstation and laptop cards | Pending |
| Ada | RTX 40, supported RTX workstation and laptop cards | Pending |
| Blackwell | RTX 50 and supported RTX PRO cards | RTX 5060 automated; RTX 5070/5080 reported working |
如果您的电脑还没有使用 OpenCore 启动 macOS,请先按照OpenCore 安装指南进行设置 ,然后再安装驱动程序。
| 类 | 信息 |
|---|---|
| macOS | 15.5 Sequoia 或更高版本(已测试 15.7.x 和 15.8.1),或 26 Tahoe,x86_64 |
| GPU | NVIDIA Turing 及更高版本;基于 RTX 5060 开发 |
| 金属 | Metal 3:参数缓冲区层级 2、光线追踪、网格着色器、MPS、MetalFX 路径 |
| 还 | OpenGL(通过 Apple 的 GL-on-Metal)、OpenCL、Core Image、Core ML |
Metal app ─► NVMTLDriver.bundle ─► translator (Apple AIR → SPIR-V) ─► NVK (Mesa Vulkan + NAK compiler) ─► kexts ─► GPU
| 成分 | 磁盘上的路径 | 来源 |
|---|---|---|
| Metal 驱动程序插件 | /Library/GPUBundles/NVMTLDriver.bundle |
plugin/ |
| 着色器转换器 | 插件内部(libnvmtl_translate.dylib) |
translator/(LGPL-3.0,基于 metal2vulkan) |
| Vulkan 后端 (NVK) | /Library/GPUBundles/nvmtl/ |
nvk/nvk-macos.patch在梅萨17ca6174 |
| 内核扩展 | /Library/Extensions/NVRM, NVAccel, NVRMFB, NVRMAGDC |
kexts/ |
| GPU固件(GSP) | /Library/NullMoth/nvfw/nvidia/615.78.08 |
NVIDIA,未修改 |
内核端在 macOS 下运行 NVIDIA 自家的开源 GPU 内核模块 (r610)。NVRMFB 是显示帧缓冲区,NVAccel 是 WindowServer 合成所用的加速器,NVRMAGDC 是显示策略垫片。
1401-Mac-<version>.dmg下载最新版本,打开并运行1401(驱动程序包已包含在磁盘映像中,无需下载其他内容)。按照步骤操作。受支持的设置必须使用已验证或明确选择的 OpenCore 分区。该应用程序会查找启动 Mac 的 OpenCore(位于EFI/OCEFIEFI/BOOT或 FAT32 分区上),在进行任何更改之前都会显示出来,备份配置,安装驱动程序,并将 1401:移除 NVIDIA 驱动程序添加到 OpenCore 启动选择器中。选择该选项会在下次启动时移除驱动程序,并将 Mac 恢复到安装前的状态,包括 OpenCore 配置,然后自动重启。该应用程序还会映射您的 USB 端口,并且如果驱动程序导致 Mac 崩溃,它会提示您生成崩溃报告并自行上传(它不会自动发送任何报告)。
如果出现问题,请打开 1401 > 崩溃报告 > 将日志发送至 NullMoth。它会上传 1401 的运行情况、驱动程序状态、崩溃报告和 OpenCore 的启动日志(已移除名称、序列号和地址),并生成一个报告 ID,您可以将其添加到您的问题或 Discord 中。
在应用程序运行期间以及之后每次重启后,请保持启动 OpenCore 的 U 盘或硬盘连接:应用程序会修改其中的配置。OpenCore 绝不会将文件复制到您的内部硬盘。首次启动时,驱动程序会在“PCI 配置结束”处暂停最多一分钟,以便 GPU 启动。
内核扩展程序会安装到/Library/Extensions辅助内核集合中并从中加载——不要从其他途径注入它们EFI/OC/Kexts。OpenCore 只需要设置 SIP 和启动参数。
NVRAM → Add → 7C436110-AB2A-4BBB-A880-FE41995C9F82
| 参数 | 值 | 为什么 |
|---|---|---|
csr-active-config |
<430A0000>(数据) |
测试值:未签名内核扩展,以及所需的根补丁 |
boot-args |
nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_way=0x1 amfi=0x80 ipc_control_port_options=0 |
帧缓冲区 + 加速器,4 个显示头;AMFI 参数允许 WindowServer 加载驱动程序包 |
用于故障排除的可选启动参数:
| 启动参数 | 影响 |
|---|---|
-nvrmnoflip |
保持复制路径上的合成帧:NVRM 从不启用零拷贝扫描输出(debug.nvaccel_iop_flip),因此显示器读取的是已完成的副本,而不是 GPU 可能仍在绘制的表面。请先在光标移动时桌面闪烁或撕裂的情况下尝试此操作。 |
-nvrmnogo |
驱动程序处于空闲状态,而nvrmctl go <pass>不是启动 GPU 本身。 |
-nvrmnobootscreen |
请勿拍摄启动画面。 |
-nvrmnopm |
关闭系统睡眠支持:NVRM 将不再参与电源树进程,就像之前参与电源树进程一样。Mac 进入睡眠状态后,唤醒时将不再使用 GPU。 |
NVRAM → Delete同时添加你设置的每个键,以便每次启动时都会重写这些值。
| 参数 | 值 | 为什么 |
|---|---|---|
UEFI → Quirks → ResizeGpuBars |
保持现有价值 | 强制调整大小可能会导致固件在选择器之前停止运行;-1保留固件大小 |
Booter → Quirks → ResizeAppleGpuBars |
保持现有价值 | 大型固件 BAR 可能会阻止 PCI 配置;0安装程序应使用较小的 BAR 设置。 |
Kernel → Block |
com.apple.iokit.IONDRVSupport, 战略Exclude |
否则,固件帧缓冲区将从 NVRMFB 获取显示索引 0。 |
Misc → Security → SecureBootModel |
Disabled |
Apple 安全启动拒绝 Apple 未签名的内核扩展 (kext)。 |
macOS安装程序使用IONDRVSupport(未排除在外) ResizeAppleGpuBars 0:ResizeGpuBars -1它在固件帧缓冲区上运行。Mac 应用程序在安装或更新驱动程序时会保留您现有的 BAR 设置,驱动程序会在 macOS 启动后自行设置 BAR,因此请勿从其他人的开发板上复制 BAR 值。
此外还需要:
- BIOS: 4G 以上解码开启(该卡映射 4GB 以上的内存),CSM 关闭。
- SMBIOS:一款运行 macOS 15 并配备独立 GPU 的 Mac 机型(已测试:
iMacPro1,1,1401 使用的是该机型)。 - 移除此显卡的所有
nv_disable=1WhateverGreen NVIDIA 补丁。agdpmod=pikera - 如果安装了 WhateverGreen(适用于 Intel 或 AMD GPU),请将其添加
gfxrst=4到启动参数中。否则,当 NVIDIA 显示器启动时,WhateverGreen 的启动屏幕副本可能会读取已释放的内存,导致 Mac 系统崩溃。 DevicePropertiesNVIDIA显卡不需要这些配件。
重启后进行验证:
kmutil showloaded --list-only | grep nullmoth
system_profiler SPDisplaysDataType | head -20
第一行显示 4 行;第二行显示您的 GeForce with Metal:受支持。
驱动程序不会访问其他磁盘。OpenCore 的选择器会同时启动 Windows(ScanPolicy包括 NTFS 文件系统)和 Linux(OpenLinuxBoot.efi在 中UEFI → Drivers)LauncherOption = Full。
更新日志 · 历史版本
下载地址
解压密码:imacos.top


评论0