
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 应用
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 启动。
连接到现有的 OpenCore 设置
内核扩展程序会安装到/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。
更新日志 · 历史版本
- 在 2.9 上登录后立即失去 GPU 的进程(透明 Dock、图标丢失、循环崩溃的锁屏、启动时崩溃的应用程序):GPU 可以在驱动程序的写入对它可见之前读取一个小命令,并停止进程的通道。- 在 2.9 上登录后立即失去 GPU 的进程(透明 Dock、图标丢失、循环崩溃的锁屏、启动时崩溃的应用程序):GPU 可以在驱动程序的写入对它可见之前读取一个小命令,并停止进程的通道。无法加载备选结果重试- 在 2.9 上登录后立即失去 GPU 的进程(透明 Dock、图标丢失、循环崩溃的锁屏、启动时崩溃的应用程序):GPU 可以在驱动程序的写入对它可见之前读取一个小命令,并停止进程的通道。 GPU 不再缓存这些命令写入的内存。GPU 不再缓存这些命令写入的内存。无法加载备选结果重试GPU 不再缓存这些命令写入的内存。
- 系统设置 > 打开时显示挂起几秒钟 (#567):每次调用时都会运行着色器文本搜索;
- 系统设置 > 打开时显示挂起几秒钟 (#567):每次调用时都会运行着色器文本搜索;无法加载备选结果重试
- 系统设置 > 打开时显示挂起几秒钟 (#567):每次调用时都会运行着色器文本搜索;它的答案被保留。它的答案被保留。无法加载备选结果重试它的答案被保留。
- 使用旧 SDK 构建的应用程序在 NVIDIA 设备上启动时崩溃(Canon CaptureOnTouch #571、OpenCore Configurator #545):正确读取被告知的系统版本(“10.16”),并且被拒绝的设备不再使应用程序崩溃。
- 使用旧 SDK 构建的应用程序在 NVIDIA 设备上启动时崩溃(Canon CaptureOnTouch #571、OpenCore Configurator #545):正确读取被告知的系统版本(“10.16”),并且被拒绝的设备不再使应用程序崩溃。无法加载备选结果重试
- 使用旧 SDK 构建的应用程序在 NVIDIA 设备上启动时崩溃(Canon CaptureOnTouch #571、OpenCore Configurator #545):正确读取被告知的系统版本(“10.16”),并且被拒绝的设备不再使应用程序崩溃。
- 相机预览保持黑色(Photo Booth #568):默认情况下,4:2:2 视频纹理处于打开状态,与 Apple 的驱动程序一样(“NVMTL_YUV422=0”将其关闭),并且保留每帧着色器扫描而不是重复扫描。
- 相机预览保持黑色(Photo Booth #568):默认情况下,4:2:2 视频纹理处于打开状态,与 Apple 的驱动程序一样(“NVMTL_YUV422=0”将其关闭),并且保留每帧着色器扫描而不是重复扫描。无法加载备选结果重试
- 相机预览保持黑色(Photo Booth #568):默认情况下,4:2:2 视频纹理处于打开状态,与 Apple 的驱动程序一样(“NVMTL_YUV422=0”将其关闭),并且保留每帧着色器扫描而不是重复扫描。
- 播放视频时 WindowServer 在内核中花费时间 (#566):每次提交都会标记一次表面,而不是每次传递每个纹理一次。- 播放视频时 WindowServer 在内核中花费时间 (#566):每次提交都会标记一次表面,而不是每次传递每个纹理一次。无法加载备选结果重试- 播放视频时 WindowServer 在内核中花费时间 (#566):每次提交都会标记一次表面,而不是每次传递每个纹理一次。
- 挂起的关闭或重新启动:未返回的 GPU 使用情况读数会停止每秒一次的采样器。
- 挂起的关闭或重新启动:未返回的 GPU 使用情况读数会停止每秒一次的采样器。无法加载备选结果重试
- 挂起的关闭或重新启动:未返回的 GPU 使用情况读数会停止每秒一次的采样器。
- 缓冲区永远不会复制到多样本图像中;
- 缓冲区永远不会复制到多样本图像中;无法加载备选结果重试
- 缓冲区永远不会复制到多样本图像中;请求被拒绝并在日志中命名。请求被拒绝并在日志中命名。无法加载备选结果重试请求被拒绝并在日志中命名。
- 显示器在重新启动后显示为 1920x1080 电视,在冷启动之前会丢失其自身的分辨率:显示器扫描的内存不再取决于显示器发送的第一个标识。
- 显示器在重新启动后显示为 1920x1080 电视,在冷启动之前会丢失其自身的分辨率:显示器扫描的内存不再取决于显示器发送的第一个标识。无法加载备选结果重试
- 显示器在重新启动后显示为 1920x1080 电视,在冷启动之前会丢失其自身的分辨率:显示器扫描的内存不再取决于显示器发送的第一个标识。
- 卸载程序还会删除混合笔记本电脑面板驱动程序。
- 卸载程序还会删除混合笔记本电脑面板驱动程序。无法加载备选结果重试
- 卸载程序还会删除混合笔记本电脑面板驱动程序。
- ### 实验性:较旧的 macOS 版本
- 适用于 macOS 14 Sonoma 至 Mac OS X 10.7 Lion 的驱动程序套件,每个版本一个,每个版本都针对该版本进行编译,并与该版本自己的内核链接器链接。- 适用于 macOS 14 Sonoma 至 Mac OS X 10.7 Lion 的驱动程序套件,每个版本一个,每个版本都针对该版本进行编译,并与该版本自己的内核链接器链接。无法加载备选结果重试- 适用于 macOS 14 Sonoma 至 Mac OS X 10.7 Lion 的驱动程序套件,每个版本一个,每个版本都针对该版本进行编译,并与该版本自己的内核链接器链接。没有在卡上运行过。没有在卡上运行过。无法加载备选结果重试没有在卡上运行过。
- 每个套件中的“install-legacy.sh”都会检查该套件,将其与正在运行的系统进行测试链接,并在更改任何内容之前准备好 GPU 固件。- 每个套件中的“install-legacy.sh”都会检查该套件,将其与正在运行的系统进行测试链接,并在更改任何内容之前准备好 GPU 固件。无法加载备选结果重试- 每个套件中的“install-legacy.sh”都会检查该套件,将其与正在运行的系统进行测试链接,并在更改任何内容之前准备好 GPU 固件。显示驱动程序在“nvfb=1”时启动;显示驱动程序在“nvfb=1”时启动;无法加载备选结果重试显示驱动程序在“nvfb=1”时启动;加速器保持关闭状态,直到添加“nvaccel=1”。加速器保持关闭状态,直到添加“nvaccel=1”。无法加载备选结果重试加速器保持关闭状态,直到添加“nvaccel=1”。
- 20261101
- - Launchpad 和 Chrome 图标不再是黑色的。- Launchpad 和 Chrome 图标不再是黑色的。无法加载备选结果重试- Launchpad 和 Chrome 图标不再是黑色的。 2.6.5 改变了从没有明确用途的 IOSurface 制作的纹理的设置方式,并且着色器对它们的写入无处可去(PR #461,感谢 Geek)。2.6.5 改变了从没有明确用途的 IOSurface 制作的纹理的设置方式,并且着色器对它们的写入无处可去(PR #461,感谢 Geek)。无法加载备选结果重试2.6.5 改变了从没有明确用途的 IOSurface 制作的纹理的设置方式,并且着色器对它们的写入无处可去(PR #461,感谢 Geek)。
- 打开杜比全景声混音器时,Logic Pro 不再崩溃。
- 打开杜比全景声混音器时,Logic Pro 不再崩溃。无法加载备选结果重试
- 打开杜比全景声混音器时,Logic Pro 不再崩溃。上传到 GPU 的纹理后面没有图像;上传到 GPU 的纹理后面没有图像;无法加载备选结果重试上传到 GPU 的纹理后面没有图像;现在复制被拒绝,并且日志命名了纹理,以便可以找到原因。现在复制被拒绝,并且日志命名了纹理,以便可以找到原因。无法加载备选结果重试现在复制被拒绝,并且日志命名了纹理,以便可以找到原因。
- QQ:头像保持其颜色(清晰的完成较晚可能会擦除新上传的内容,PR #458,感谢 Geek)和 SVG 工具栏图标绘制(着色器翻译器使用空的内联汇编语句拒绝 ANGLE 着色器,PR #457,感谢 GeekAudio)。
- QQ:头像保持其颜色(清晰的完成较晚可能会擦除新上传的内容,PR #458,感谢 Geek)和 SVG 工具栏图标绘制(着色器翻译器使用空的内联汇编语句拒绝 ANGLE 着色器,PR #457,感谢 GeekAudio)。无法加载备选结果重试
- QQ:头像保持其颜色(清晰的完成较晚可能会擦除新上传的内容,PR #458,感谢 Geek)和 SVG 工具栏图标绘制(着色器翻译器使用空的内联汇编语句拒绝 ANGLE 着色器,PR #457,感谢 GeekAudio)。
- Hades 菜单文本绘制:着色器翻译器通过分支合并保持指针读取(PR #466,感谢 mickys)。
- Hades 菜单文本绘制:着色器翻译器通过分支合并保持指针读取(PR #466,感谢 mickys)。无法加载备选结果重试
- Hades 菜单文本绘制:着色器翻译器通过分支合并保持指针读取(PR #466,感谢 mickys)。
- 要求光栅化速率图坐标的游戏(例如《Darkest Dungeon II》)获取其着色器:驱动程序报告它没有速率图,翻译器将这些坐标原样传递(PR #469,感谢 mickys 和 Geek)。- 要求光栅化速率图坐标的游戏(例如《Darkest Dungeon II》)获取其着色器:驱动程序报告它没有速率图,翻译器将这些坐标原样传递(PR #469,感谢 mickys 和 Geek)。无法加载备选结果重试- 要求光栅化速率图坐标的游戏(例如《Darkest Dungeon II》)获取其着色器:驱动程序报告它没有速率图,翻译器将这些坐标原样传递(PR #469,感谢 mickys 和 Geek)。
- 失败的缓冲区到纹理复制在日志中命名其格式、大小和区域(PR #465,感谢 mickys)。
- 失败的缓冲区到纹理复制在日志中命名其格式、大小和区域(PR #465,感谢 mickys)。无法加载备选结果重试
- 失败的缓冲区到纹理复制在日志中命名其格式、大小和区域(PR #465,感谢 mickys)。
- 安装程序会在 boot-args 没有 AMFI 参数时进行注释。
- 安装程序会在 boot-args 没有 AMFI 参数时进行注释。无法加载备选结果重试
- 安装程序会在 boot-args 没有 AMFI 参数时进行注释。如果没有,WindowServer 会拒绝 Metal 驱动程序,并且桌面上不会出现 Metal 设备。如果没有,WindowServer 会拒绝 Metal 驱动程序,并且桌面上不会出现 Metal 设备。无法加载备选结果重试如果没有,WindowServer 会拒绝 Metal 驱动程序,并且桌面上不会出现 Metal 设备。
- 集成 GPU 驱动屏幕的 Tahoe PC 不再停在带有光标的黑屏上:GPU macOS 不再加速,不算显示桌面,因此 WindowServer 启动。
- 集成 GPU 驱动屏幕的 Tahoe PC 不再停在带有光标的黑屏上:GPU macOS 不再加速,不算显示桌面,因此 WindowServer 启动。无法加载备选结果重试
- 集成 GPU 驱动屏幕的 Tahoe PC 不再停在带有光标的黑屏上:GPU macOS 不再加速,不算显示桌面,因此 WindowServer 启动。
- macOS Sequoia 15.0 至 15.4 可以重新安装驱动程序。
- macOS Sequoia 15.0 至 15.4 可以重新安装驱动程序。无法加载备选结果重试
- macOS Sequoia 15.0 至 15.4 可以重新安装驱动程序。 2.6.2 到 2.6.5 中的 Vulkan 库被标记为需要 15.5,但其中没有任何内容。2.6.2 到 2.6.5 中的 Vulkan 库被标记为需要 15.5,但其中没有任何内容。无法加载备选结果重试2.6.2 到 2.6.5 中的 Vulkan 库被标记为需要 15.5,但其中没有任何内容。
- 安全性:驱动程序包已签名,Mac 应用程序仅使用有效的 NullMoth 签名安装驱动程序更新。- 安全性:驱动程序包已签名,Mac 应用程序仅使用有效的 NullMoth 签名安装驱动程序更新。无法加载备选结果重试- 安全性:驱动程序包已签名,Mac 应用程序仅使用有效的 NullMoth 签名安装驱动程序更新。安装程序回滚不再重用其他帐户可能放置在 /Users/Shared 中的固件文件夹。安装程序回滚不再重用其他帐户可能放置在 /Users/Shared 中的固件文件夹。无法加载备选结果重试安装程序回滚不再重用其他帐户可能放置在 /Users/Shared 中的固件文件夹。
下载地址
解压密码:imacos.top
资源下载注册登录升级VIP会员,尊享全站资源下载特权
评论0