黑苹果NVMe提升兼容性驱动：NVMeFix.kext 1.0.0

NVMeFix是Apple NVMe存储驱动程序IONVMeFamily的一组修补程序。其目标是改善与非Apple SSD的兼容性。它可以在Mac和黑苹果计算机上使用。该Kext实现了以下功能：

• 自主电源状态转换以减少控制器的空闲功耗。
• 主机驱动器功率状态管理。

如果有足够的信息提交给Bugtracker，则可以解决与第三方SSD的其他不兼容问题。但是，某些问题不能仅通过内核端驱动程序来解决。例如，MacBookPro 11,1 EFI包含旧版本的NVMHCI DXE驱动程序，当从启用完整磁盘加密的休眠状态恢复时，该驱动程序会挂起。

安装

• NVMeFix.kext需要 Lilu 1.4.1 和 macOS 10.14 及以上版本；
• 可能可以与低于 10.14 的 macOS 兼容，但未经过测试；
• 可以安装到 System / Library / Extensions（简称S/L/E目录），也可以由 Clover/OpenCore EFI Bootloader 注入。

功能配置

• -nvmefdbg 开启debug日志（仅debug版本）
• -nvmeoff 关闭该驱动程序
• 当开启APST时，某些SSD工作不正常。NVMeFix会尝试检测主板和SSD组合的问题并加以解决；
• 引导程序通过 IODeviceTree：/EFI/platform OEMProduct，OEMVendor和OEMBoard检测并注入；
• APST表条目指定发生过渡的最小空闲等待时间，最大可接受延迟为100000微秒，并且可以通过父PCI设备的低端8字节属性ps-max-latency-us来覆盖（例如IOService：/ AppleACPIPlatformExpert / PCI0 @ 0 / AppleACPIPCI / RP06 @ 1C，5 / IOPP/ SSD0 @ 0）；
• 如果设置为0，则将完全禁用APST。

问题诊断信息说明

• 注：IOKit 信息：“ Couldn't alloc class "NVMeFix" ” 不是错误；
• release 版本日志仅显示高级错误信息；
• debug 版会另外记录使用的电源状态，详细的错误消息，并尝试从控制器获取APST状态和表；
• APST启用状态将posted到 IONVMeController IORegistry 条目 apst 键值；
• 如果主动电源管理初始化成功，将使用IOPowerManagement dictionary 在 IOPower IORegistry plane中创建一个 NVMePMProxy 条目；
• 使用smartmontools可以获得关于控制器支持的功率状态的信息。例如，在以下输出中，控制器报告5个状态，其中前三个高功率状态将由NVMeFix用于主动电源管理，后两个状态可用于APST，具体取决于ps-max-latency-us。