From 8355a1f8a66c5eeb09d080424eba65d25933959c Mon Sep 17 00:00:00 2001 From: hrx114514x Date: Sat, 8 Aug 2026 00:00:35 +0800 Subject: [PATCH] Document validation boundary and open hardware reports --- .github/ISSUE_TEMPLATE/bug-report.yml | 67 +++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 5 + .../ISSUE_TEMPLATE/hardware-validation.yml | 94 +++++++++++++++++++ CONTRIBUTING.md | 6 +- README.md | 14 ++- README_CN.md | 14 ++- RELEASE_NOTES_1.7.0.md | 5 + docs/DEVELOPMENT.en.md | 4 +- docs/DEVELOPMENT.zh-CN.md | 4 +- docs/INSTALL.en.md | 5 +- docs/INSTALL.zh-CN.md | 5 +- 11 files changed, 208 insertions(+), 15 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/bug-report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/hardware-validation.yml diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml new file mode 100644 index 0000000..7ac54d1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug-report.yml @@ -0,0 +1,67 @@ +name: Bug report / 问题报告 +description: Report a reproducible PC711Probe problem / 报告可复现的 PC711Probe 问题 +title: "[Bug] " +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + Do not upload complete EFI folders, serial numbers, SMBIOS data, NVRAM dumps, credentials, or Apple proprietary binaries. + + 不要上传完整 EFI、序列号、SMBIOS 数据、NVRAM 转储、凭据或 Apple 专有二进制。 + - type: input + id: hardware + attributes: + label: SSD and PCI identity / SSD 与 PCI 身份 + description: Model, capacity, firmware, vendor/device/class/revision, and subsystem IDs / 型号、容量、固件、Vendor/Device/Class/Revision 和 Subsystem ID + validations: + required: true + - type: input + id: platform + attributes: + label: Platform / 平台 + description: CPU and motherboard or computer model / CPU 与主板或整机型号 + validations: + required: true + - type: input + id: software + attributes: + label: Software versions / 软件版本 + description: macOS version/build/Darwin plus OpenCore, Lilu, PC711Probe, and NVMeFix status / macOS 版本/Build/Darwin、OpenCore、Lilu、PC711Probe 以及 NVMeFix 状态 + validations: + required: true + - type: dropdown + id: stage + attributes: + label: Failure stage / 失败阶段 + options: + - Recovery + - macOS Installer + - Installed-system boot / 已安装系统启动 + - Normal I/O / 正常读写 + - Sleep or wake / 睡眠或唤醒 + - Shutdown or reboot / 关机或重启 + - Other / 其他 + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: Reproduction steps / 复现步骤 + validations: + required: true + - type: textarea + id: evidence + attributes: + label: Sanitized panic or logs / 脱敏后的 panic 或日志 + validations: + required: true + - type: checkboxes + id: confirmations + attributes: + label: Confirmation / 确认 + options: + - label: The PC711 is not hidden by AML/SSDT or spoofed PCI properties. / PC711 没有被 AML/SSDT 或伪造 PCI 属性隐藏。 + required: true + - label: I removed private information from all attachments. / 我已从所有附件中删除隐私信息。 + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..fc45307 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: true +contact_links: + - name: Installation guide / 安装指南 + url: https://github.com/hrx114514x/PC711Probe/blob/main/docs/INSTALL.en.md + about: Read the installation and rollback guide before testing / 测试前请阅读安装与回滚指南 diff --git a/.github/ISSUE_TEMPLATE/hardware-validation.yml b/.github/ISSUE_TEMPLATE/hardware-validation.yml new file mode 100644 index 0000000..392269a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/hardware-validation.yml @@ -0,0 +1,94 @@ +name: Hardware validation / 硬件验证 +description: Report a success or failure on a PC711 or another 1C5C:174A device / 报告 PC711 或其他 1C5C:174A 设备的成功或失败结果 +title: "[Hardware] " +labels: ["hardware validation"] +body: + - type: markdown + attributes: + value: | + Thank you for contributing an independent hardware sample. Remove serial numbers, SMBIOS data, credentials, and other private information before uploading logs. + + 感谢提供独立硬件样本。上传日志前请删除序列号、SMBIOS 数据、凭据及其他隐私信息。 + - type: dropdown + id: result + attributes: + label: Result / 结果 + options: + - Success / 成功 + - Partial success / 部分成功 + - Kernel panic or timeout / KP 或超时 + - Not detected / 未识别 + validations: + required: true + - type: input + id: drive + attributes: + label: SSD model, capacity, and firmware / SSD 型号、容量和固件 + placeholder: SKHynix_HFS512GDE9X084N, 512 GB, 41010C22 + validations: + required: true + - type: input + id: pci + attributes: + label: PCI identity / PCI 身份 + description: Vendor, device, class, revision, subsystem vendor and device / Vendor、Device、Class、Revision、Subsystem Vendor 和 Device + placeholder: 1C5C:174A, class 01:08:02, revision ..., subsystem ... + validations: + required: true + - type: input + id: platform + attributes: + label: Platform / 平台 + description: CPU and motherboard, laptop, or desktop model / CPU 与主板、笔记本或整机型号 + validations: + required: true + - type: input + id: macos + attributes: + label: macOS / macOS 版本 + placeholder: macOS 15.7.9, build 24G830, Darwin 24.6.0 + validations: + required: true + - type: input + id: bootloader + attributes: + label: OpenCore, Lilu, and PC711Probe versions / OpenCore、Lilu 和 PC711Probe 版本 + validations: + required: true + - type: dropdown + id: nvmefix + attributes: + label: NVMeFix status / NVMeFix 状态 + options: + - Not loaded / 未加载 + - Loaded / 已加载 + - Unknown / 不确定 + validations: + required: true + - type: checkboxes + id: boot_stages + attributes: + label: Working boot stages / 可正常启动的阶段 + options: + - label: Recovery + - label: macOS Installer + - label: Installed system / 已安装系统 + - type: textarea + id: testing + attributes: + label: Sleep, reboot, and I/O testing / 睡眠、重启和 I/O 测试 + description: Include counts, workload, hashes, and any error observed / 请写明次数、负载、哈希与任何错误 + - type: textarea + id: evidence + attributes: + label: Sanitized evidence / 脱敏证据 + description: Attach relevant panic excerpts, logs, screenshots, or IORegistry output / 附上相关 panic 摘要、日志、截图或 IORegistry 输出 + - type: checkboxes + id: confirmations + attributes: + label: Confirmation / 确认 + options: + - label: I removed serial numbers, SMBIOS data, credentials, and other private information. / 我已删除序列号、SMBIOS 数据、凭据及其他隐私信息。 + required: true + - label: I tested with a rollback-capable EFI and understand that unvalidated hardware may fail. / 我使用了可回滚 EFI，并了解未验证硬件可能失败。 + required: true diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0742653..0a2ff43 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,9 +7,13 @@ Issues and pull requests are welcome, but this project deals with storage initia When reporting hardware results, include / 报告硬件结果时请提供： - exact macOS version, build, and Darwin version / macOS 版本、Build 与 Darwin 版本； -- PCI vendor/device/class and the public model/firmware string / PCI 身份及公开型号、固件； +- SSD model, capacity, and firmware / SSD 型号、容量与固件； +- PCI vendor/device/class/revision and subsystem vendor/device / PCI Vendor、Device、Class、Revision 与 Subsystem 身份； +- CPU and motherboard or computer model / CPU 与主板或整机型号； - OpenCore, Lilu, and PC711Probe versions / OpenCore、Lilu、PC711Probe 版本； - whether NVMeFix or an SSDT hide rule was active / 是否启用 NVMeFix 或隐藏设备的 SSDT； +- separate Recovery, Installer, and installed-system results / Recovery、Installer 与已安装系统的分项结果； +- sleep/wake count and any storage workload used / 睡眠唤醒次数与已执行的存储负载； - a sanitized panic excerpt or success criteria / 脱敏后的 panic 摘要或成功标准。 Do not publish serial numbers, complete EFI folders, SMBIOS data, NVRAM dumps, credentials, or Apple proprietary binaries. diff --git a/README.md b/README.md index 829e51a..b61e67a 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,9 @@ An automatic Lilu compatibility plugin that fixes an `IONVMeFamily` Identify-tim > **New finding: PC711 works natively on macOS 26.** The same physical PC711 was identified by Apple `IONVMeFamily` on macOS 26.5.1 (25F80 / Darwin 25.5.0), with working I/O and sleep/wake. Neither PC711Probe nor NVMeFix was required. PC711Probe does not load on macOS 26. +> [!IMPORTANT] +> PC711Probe must match the controller before NVMe Identify makes the model string available. It therefore matches PCI `1C5C:174A` with NVMe class `01:08:02`, an identity also reported by SK hynix Gold P31 and BC711 devices. Only `SKHynix_HFS512GDE9X084N` with firmware `41010C22` has been hardware-validated. All other `1C5C:174A` devices remain untested and should be tried only with a rollback-capable EFI and a current data backup. + > [!NOTE] > ## ❤️ Support PC711Probe > @@ -15,7 +18,7 @@ An automatic Lilu compatibility plugin that fixes an `IONVMeFamily` Identify-tim ## Verified result -PC711Probe 1.7.0 has booted the same physical PC711 across macOS 11–15. macOS 11–14 were verified in Recovery, while macOS 15.6.1 completed a full installation and booted from the PC711. The former Identify/command timeout panic after roughly 75 seconds did not recur. +PC711Probe 1.7.0 has booted the same physical PC711 across macOS 11–15. macOS 11–14 were verified in Recovery, while macOS 15.6.1 completed a full installation and booted from the PC711. The installed system was later updated to macOS 15.7.9 and passed the extended storage, sleep/wake, and reboot test described below. The former Identify/command timeout panic after roughly 75 seconds did not recur. ![PC711 running macOS 15.6.1 with TRIM, PCIe link details, and measured disk performance](docs/images/macos15-installed-performance.png) @@ -26,6 +29,7 @@ PC711Probe 1.7.0 has booted the same physical PC711 across macOS 11–15. macOS | Firmware | `41010C22` | | Recovery boot verified | macOS 11.6 (20G165), 12.5.1 (21G83), 13.4.1 (22F82), 14.6.1 (23G93) | | Full installation verified | macOS 15.6.1, build 24G90, Darwin 24.6.0 | +| Extended validation | macOS 15.7.9, build 24G830: 96 GiB sequential write/read/hash, dual 8 GiB parallel I/O, 20,000 small files, 3 sleep/wake cycles, 3 reboots, and APFS verification | | macOS 15 link/status | PCIe 3.0 x4, 8.0 GT/s, TRIM: Yes, S.M.A.R.T.: Verified | | macOS 15 measured result | 2766.1 MB/s write, 3005.9 MB/s read (Blackmagic Disk Speed Test) | | Native OS | macOS 26.5.1, build 25F80, Darwin 25.5.0 | @@ -33,12 +37,12 @@ PC711Probe 1.7.0 has booted the same physical PC711 across macOS 11–15. macOS ## Automatic matching -Version 1.7.0 requires no activation argument. Once enabled in OpenCore, it automatically patches only controllers matching: +Version 1.7.0 requires no activation argument. Once enabled in OpenCore, it automatically patches controllers matching: - PCI Vendor/Device: `1C5C:174A`; and - NVMe class: `01:08:02`. -The PC711 model string is not available until the first Identify succeeds, so the plugin uses its known PCI controller identity before that command. Different capacities and OEM model strings do not affect matching. NVMe controllers with other PCI IDs retain Apple's original behavior. +The PC711 model string is not available until the first Identify succeeds, so the plugin uses the PCI controller identity before that command. This makes different capacities and OEM model strings possible, but it also means the plugin cannot distinguish the validated PC711 from untested P31 or BC711 devices that expose the same identity. NVMe controllers with other PCI IDs retain Apple's original behavior. The declared automatic range is Darwin 20–24 (macOS 11–15). The plugin does not load on Darwin 25/macOS 26, where the tested PC711 works natively. @@ -84,7 +88,9 @@ Output: `build/Debug/PC711Probe.kext` ## Current validation boundary -Recovery boot is verified on macOS 11–14. A complete macOS 15.6.1 installation, normal system boot, namespace/partition publication, PCIe 3.0 x4 link, reported TRIM support, S.M.A.R.T. status, and a 2766.1/3005.9 MB/s write/read benchmark are verified on the tested PC711. Sleep/wake on macOS 11–15, long-duration stress, other firmware revisions, and other platforms remain outside the current validation boundary. Keep a rollback EFI and data backup for the first test. +Recovery boot is verified on macOS 11–14. A complete macOS 15.6.1 installation, normal system boot, namespace/partition publication, PCIe 3.0 x4 link, reported TRIM support, S.M.A.R.T. status, and a 2766.1/3005.9 MB/s write/read benchmark are verified on the tested PC711. On macOS 15.7.9, the same drive also passed 96 GiB of sequential write/read/two-pass SHA-256 validation, dual 8 GiB parallel I/O, 20,000 small-file operations, three sleep/wake cycles, three reboots, and APFS verification without a panic, NVMe timeout, I/O error, media loss, or hash mismatch. + +These results cover one physical `SKHynix_HFS512GDE9X084N`, firmware `41010C22`, on one AMD platform. Other PC711 capacities and firmware revisions, Intel platforms, and other `1C5C:174A` products remain untested. Keep a rollback EFI and data backup for the first test, and submit independent results through [GitHub Issues](https://github.com/hrx114514x/PC711Probe/issues). ## License diff --git a/README_CN.md b/README_CN.md index 2b09060..104b4b3 100644 --- a/README_CN.md +++ b/README_CN.md @@ -6,6 +6,9 @@ > **新发现：PC711 在 macOS 26 已经原生免驱。** 同一块实机 PC711 在 macOS 26.5.1（25F80 / Darwin 25.5.0）中可由 Apple `IONVMeFamily` 正常完成识别、读写和睡眠唤醒，不需要 PC711Probe 或 NVMeFix。PC711Probe 不在 macOS 26 加载。 +> [!IMPORTANT] +> PC711Probe 必须在 NVMe Identify 取得型号字符串之前匹配控制器，因此实际匹配 PCI `1C5C:174A` 与 NVMe class `01:08:02`。SK hynix Gold P31 和 BC711 也有使用这一 PCI 身份的记录。目前只实机验证了固件 `41010C22` 的 `SKHynix_HFS512GDE9X084N`；其他 `1C5C:174A` 设备均属未验证范围，首次测试必须使用可回滚 EFI 并备份数据。 + > [!NOTE] > ## ❤️ 支持 PC711Probe > @@ -15,7 +18,7 @@ ## 已验证结果 -PC711Probe 1.7.0 已让同一块实机 PC711 在 macOS 11–15 全部成功启动：macOS 11–14 完成 Recovery 验证，macOS 15.6.1 完成完整安装并从 PC711 进入系统。原先约 75 秒后的 Identify/命令超时 KP 不再出现。 +PC711Probe 1.7.0 已让同一块实机 PC711 在 macOS 11–15 全部成功启动：macOS 11–14 完成 Recovery 验证，macOS 15.6.1 完成完整安装并从 PC711 进入系统。安装后的系统升级到 macOS 15.7.9 后，又通过了下述存储压力、睡眠唤醒与重启测试。原先约 75 秒后的 Identify/命令超时 KP 不再出现。 ![PC711 运行 macOS 15.6.1，并显示 TRIM、PCIe 链路和实测磁盘性能](docs/images/macos15-installed-performance.png) @@ -26,6 +29,7 @@ PC711Probe 1.7.0 已让同一块实机 PC711 在 macOS 11–15 全部成功启 | 固件 | `41010C22` | | Recovery 启动验证 | macOS 11.6（20G165）、12.5.1（21G83）、13.4.1（22F82）、14.6.1（23G93） | | 完整安装验证 | macOS 15.6.1，Build 24G90，Darwin 24.6.0 | +| 扩展验证 | macOS 15.7.9，Build 24G830：96 GiB 顺序写入/读取/哈希、双路 8 GiB 并行 I/O、2 万个小文件、3 次睡眠唤醒、3 次重启和 APFS 校验 | | macOS 15 链路/状态 | PCIe 3.0 x4、8.0 GT/s、TRIM：是、S.M.A.R.T.：已验证 | | macOS 15 实测成绩 | 写入 2766.1 MB/s、读取 3005.9 MB/s（Blackmagic Disk Speed Test） | | 原生系统 | macOS 26.5.1，Build 25F80，Darwin 25.5.0 | @@ -33,12 +37,12 @@ PC711Probe 1.7.0 已让同一块实机 PC711 在 macOS 11–15 全部成功启 ## 自动匹配范围 -1.7.0 不需要任何启用参数。Kext 加入 OpenCore 后自动运行，只对以下控制器应用补丁： +1.7.0 不需要任何启用参数。Kext 加入 OpenCore 后自动运行，对以下控制器应用补丁： - PCI Vendor/Device：`1C5C:174A`； - NVMe class：`01:08:02`。 -PC711 的型号字符串必须等第一次 Identify 成功后才能读取，因此插件使用其已知 PCI 控制器 ID 进行预先匹配；不同容量和 OEM 型号不依赖字符串判断。其他 PCI ID 的 NVMe 保持 Apple 原始行为。 +PC711 的型号字符串必须等第一次 Identify 成功后才能读取，因此插件使用 PCI 控制器身份进行预先匹配。这使不同容量和 OEM 型号成为可能，但也意味着插件无法区分已验证的 PC711 与使用同一 PCI 身份的未验证 P31/BC711。其他 PCI ID 的 NVMe 保持 Apple 原始行为。 插件声明的自动运行范围为 Darwin 20–24（macOS 11–15）。Darwin 25/macOS 26 不加载插件，实测 PC711 在该系统已原生免驱。 @@ -84,7 +88,9 @@ cd PC711Probe ## 当前验证边界 -macOS 11–14 Recovery 已通过启动验证；macOS 15.6.1 已完成完整安装、正常进入系统、namespace/分区发布、PCIe 3.0 x4 链路、TRIM 支持与 S.M.A.R.T. 状态确认，并实测写入 2766.1 MB/s、读取 3005.9 MB/s。macOS 11–15 的睡眠唤醒、长时间压力测试、其他固件版本和其他平台仍不在当前验证范围内。首次使用请保留回滚 EFI 和数据备份。 +macOS 11–14 Recovery 已通过启动验证；macOS 15.6.1 已完成完整安装、正常进入系统、namespace/分区发布、PCIe 3.0 x4 链路、TRIM 支持与 S.M.A.R.T. 状态确认，并实测写入 2766.1 MB/s、读取 3005.9 MB/s。在 macOS 15.7.9 中，同一块硬盘又通过了 96 GiB 顺序写入/读取/两次 SHA-256 校验、双路 8 GiB 并行 I/O、2 万个小文件、3 次睡眠唤醒、3 次重启和 APFS 校验，未发现 KP、NVMe 超时、I/O 错误、掉盘或哈希不一致。 + +上述结果只覆盖一块 `SKHynix_HFS512GDE9X084N`、固件 `41010C22` 和一个 AMD 平台。其他 PC711 容量/固件、Intel 平台及其他 `1C5C:174A` 产品仍未验证。首次使用请保留回滚 EFI 和数据备份，并通过 [GitHub Issues](https://github.com/hrx114514x/PC711Probe/issues) 提交独立测试结果。 ## 许可 diff --git a/RELEASE_NOTES_1.7.0.md b/RELEASE_NOTES_1.7.0.md index 73a81f8..7d2c17c 100644 --- a/RELEASE_NOTES_1.7.0.md +++ b/RELEASE_NOTES_1.7.0.md @@ -10,10 +10,15 @@ Complete macOS 11–15 PC711 compatibility update. / 完整覆盖 macOS 11–15 - Retains the later macOS 14–15 interrupt-source route as a fallback. / 保留 macOS 14–15 的中断源兼容路由作为后备。 - Does not load on macOS 26, where the tested PC711 works natively. / macOS 26 不加载本插件，实测 PC711 已原生免驱。 +## Matching boundary / 匹配边界 + +The patch runs before NVMe Identify and therefore matches PCI `1C5C:174A` plus NVMe class `01:08:02`, not the later model string. This PCI identity is also reported by SK hynix Gold P31 and BC711 devices. Only `SKHynix_HFS512GDE9X084N`, firmware `41010C22`, has been hardware-validated; every other `1C5C:174A` device remains untested. / 补丁在 NVMe Identify 之前运行，因此匹配 PCI `1C5C:174A` 与 NVMe class `01:08:02`，而不是稍后才能读取的型号字符串。SK hynix Gold P31 和 BC711 也有使用该 PCI 身份的记录。目前只实机验证了固件 `41010C22` 的 `SKHynix_HFS512GDE9X084N`；其他 `1C5C:174A` 设备均未验证。 + ## Hardware results / 实机结果 - macOS 11.6, 12.5.1, 13.4.1, and 14.6.1 Recovery: booted successfully. / Recovery 启动成功。 - macOS 15.6.1: completed installation, passed the second-stage `macOS Installer` boot, and entered the installed system from the PC711. / 完成安装、通过第二阶段 `macOS Installer` 启动，并从 PC711 进入系统。 +- macOS 15.7.9 post-release validation: three 32 GiB write/read/two-pass SHA-256 rounds, dual 8 GiB parallel I/O, 20,000 small files, three sleep/wake cycles, three reboots, and APFS verification all passed. / macOS 15.7.9 发布后验证：3 轮 32 GiB 写入/读取/两次 SHA-256 校验、双路 8 GiB 并行 I/O、2 万个小文件、3 次睡眠唤醒、3 次重启和 APFS 校验均通过。 - Installed-system status: PCIe x4 at 8.0 GT/s, TRIM Yes, S.M.A.R.T. Verified. / 安装后状态：PCIe x4、8.0 GT/s、TRIM 是、S.M.A.R.T. 已验证。 - Blackmagic Disk Speed Test: 2766.1 MB/s write and 3005.9 MB/s read. / 实测写入 2766.1 MB/s、读取 3005.9 MB/s。 diff --git a/docs/DEVELOPMENT.en.md b/docs/DEVELOPMENT.en.md index 16aa77e..1dbae29 100644 --- a/docs/DEVELOPMENT.en.md +++ b/docs/DEVELOPMENT.en.md @@ -59,4 +59,6 @@ No existing PC711 partition was erased or modified during validation, and the re The combined patch removes the timeout across the tested macOS 11–15 Recovery and Installer paths. macOS 15.6.1 completed installation and booted from the PC711 with normal storage publication and near-interface-limit sequential performance. -Other builds, firmware revisions, platforms, long-duration stress, and macOS 11–15 sleep/wake remain untested. PC711Probe is therefore a narrowly scoped, hardware-verified compatibility patch rather than a generic PC711 driver. +Post-release testing on macOS 15.7.9 added three 32 GiB write/read/two-pass SHA-256 rounds, dual 8 GiB parallel I/O, 20,000 small-file operations, three sleep/wake cycles, three reboots, and APFS verification. All completed without a panic, NVMe timeout, I/O error, media loss, or hash mismatch. + +Other PC711 capacities and firmware revisions, Intel platforms, and other products exposing `1C5C:174A` remain untested. PC711Probe is therefore a narrowly scoped, hardware-verified compatibility patch rather than a generic NVMe driver. diff --git a/docs/DEVELOPMENT.zh-CN.md b/docs/DEVELOPMENT.zh-CN.md index a941cfa..3ffe351 100644 --- a/docs/DEVELOPMENT.zh-CN.md +++ b/docs/DEVELOPMENT.zh-CN.md @@ -59,4 +59,6 @@ Identify、队列、namespace 和存储 I/O 仍由 Apple `IONVMeFamily` 完成 已证明该组合补丁可覆盖实测的 macOS 11–15 Recovery 与 Installer 路径。macOS 15.6.1 已完整安装并从 PC711 进入系统，存储发布正常，顺序性能接近接口上限。 -其他 build、固件或平台、长时间压力测试，以及 macOS 11–15 的睡眠唤醒尚未覆盖。因此它是一个经过硬件验证的窄范围兼容补丁，不是通用 PC711 驱动。 +发布后又在 macOS 15.7.9 完成了 3 轮 32 GiB 写入/读取/两次 SHA-256 校验、双路 8 GiB 并行 I/O、2 万个小文件、3 次睡眠唤醒、3 次重启和 APFS 校验，未出现 KP、NVMe 超时、I/O 错误、掉盘或哈希不一致。 + +其他 PC711 容量/固件、Intel 平台以及其他使用 `1C5C:174A` 的产品尚未验证。因此它是一个经过硬件验证的窄范围兼容补丁，不是通用 NVMe 驱动。 diff --git a/docs/INSTALL.en.md b/docs/INSTALL.en.md index f025bda..b8badfb 100644 --- a/docs/INSTALL.en.md +++ b/docs/INSTALL.en.md @@ -8,6 +8,7 @@ English | [简体中文](INSTALL.zh-CN.md) - Use an independent USB EFI for the first test and retain another bootable EFI. - Ensure Lilu is installed and ordered before PC711Probe. - macOS 26 drives the PC711 natively and does not need this plugin. +- PC711Probe matches PCI `1C5C:174A` with NVMe class `01:08:02` before Identify. Gold P31 and BC711 devices may expose the same identity, but only `SKHynix_HFS512GDE9X084N` with firmware `41010C22` has been validated. ## OpenCore configuration @@ -22,12 +23,12 @@ English | [简体中文](INSTALL.zh-CN.md) | MinKernel | `20.0.0` | | MaxKernel | `24.99.99` | -3. Do not add an activation argument; version 1.7.0 automatically matches the `1C5C:174A` PC711. +3. Do not add an activation argument; version 1.7.0 automatically matches `1C5C:174A` with NVMe class `01:08:02`. 4. Disable AML/SSDT code that hides the PC711 through `_STA=0` or spoofed class/vendor/device values. 5. Temporarily disable NVMeFix for the first test so results are not mixed. 6. Validate the configuration with the `ocvalidate` matching the OpenCore version. -> The tested PC711 has booted macOS 11–14 Recovery and completed a macOS 15.6.1 installation. Other firmware revisions and platforms still require a rollback-capable first test. +> The tested PC711 has booted macOS 11–14 Recovery, completed a macOS 15.6.1 installation, and passed extended I/O, sleep/wake, and reboot validation on macOS 15.7.9. Other drives, firmware revisions, and platforms still require a rollback-capable first test. ## First boot diff --git a/docs/INSTALL.zh-CN.md b/docs/INSTALL.zh-CN.md index 0e05fbe..547a681 100644 --- a/docs/INSTALL.zh-CN.md +++ b/docs/INSTALL.zh-CN.md @@ -8,6 +8,7 @@ - 首次验证使用独立 USB EFI，并保留另一个可启动 EFI。 - 确保 Lilu 已安装且排在 PC711Probe 前面。 - macOS 26 已可原生驱动 PC711，不需要加载本插件。 +- PC711Probe 会在 Identify 前匹配 PCI `1C5C:174A` 与 NVMe class `01:08:02`。Gold P31 和 BC711 也可能使用这一身份，但目前只验证了固件 `41010C22` 的 `SKHynix_HFS512GDE9X084N`。 ## OpenCore 配置 @@ -22,12 +23,12 @@ | MinKernel | `20.0.0` | | MaxKernel | `24.99.99` | -3. 不要添加启用参数；1.7.0 会自动匹配 `1C5C:174A` PC711。 +3. 不要添加启用参数；1.7.0 会自动匹配 `1C5C:174A` 与 NVMe class `01:08:02`。 4. 停用隐藏 PC711 的 AML/SSDT，包括 `_STA=0` 或伪造 class/vendor/device 的规则。 5. 首次验证时暂时停用 NVMeFix，避免混淆结果。 6. 使用与 OpenCore 版本匹配的 `ocvalidate` 检查配置。 -> 实测 PC711 已成功启动 macOS 11–14 Recovery，并完成 macOS 15.6.1 安装；其他固件版本和平台首次使用时仍需保留可回滚方案。 +> 实测 PC711 已成功启动 macOS 11–14 Recovery，完成 macOS 15.6.1 安装，并在 macOS 15.7.9 通过扩展 I/O、睡眠唤醒和重启验证；其他硬盘、固件版本和平台首次使用时仍需保留可回滚方案。 ## 首次启动