USB定制/运行辅助：USBToolbox.kext 1.2.0 Pre-release-黑苹果

概述

USBToolbox 是一套黑苹果使用的 USB 映射定制工具，它能使 USB 映射变得简单。除了 USBToolbox 定制工具外，还包括这个同名 Kext，它旨在使 USB 映射的常见操作更容易。它支持 El Capitan 及更高版本，但目前只有 Catalina 及更高版本经过测试。

功能特点

连接到控制器实例或父设备，允许更多方式匹配
忽略 ACPI 中的端口定义以强制 macOS 手动枚举所有端口
绕过一些 Ryzen 主板和 400 系列 Intel 主板上的 ACPI
可替代 SSDT-RHUB.aml，这个 SSDT 主要用于微星和华硕 B460M 系列在 macOS 中无法正确识别 USB 的主板
覆盖基于 SMBIOS 和控制器名称所附加的任何内置的 Apple USB 映射，也无需在 ACPI 补丁中重命名控制器
不需要在 USB 映射中指定型号标识符（如果连接到 PCI 设备）
与现有 USB 映射非常兼容（端口格式相同）
不会对任何端口映射进行硬编码，与 USBInjectAll 不同
「注意」这个 Kext 不会修改 macOS 端口上限限制

启动参数和设备属性

USBToolBox 支持使用启动参数、设备属性或在映射中进行配置。可以在 PCI 设备或 AppleUSBHostController 实例上设置属性。
除非以下另有说明，否则设备属性可以是任何类型（即 Data | Number | String），并且只检查是否存在而不检查类型。
-utboff（设备属性 utb-off）：完全禁用 USBToolBox
-utbacpioff (设备属性 utb-acpi-off)：禁止从 ACPI 层面移除 RHUB（损坏的 ACPI 移除）
-utbappleoff（设备属性 utb-apple-off）：禁用现有 port 和 port-count 移除
-utbmapoff（设备属性 utb-map-off）：禁用自定义映射（测试时有用）
utbwait=N（设备属性 utb-wait，类型 Number）：用于 waitForMatchingService 的自定义延迟，以秒为单位。取 1 到 180 之间的整数（含）。

UTBDefault.kext 是一个无内核 Kext，用于将 USBToolBox 连接到所有的 PCIe USB 控制器。这是专为在映射之前使用而设计的，因此可以在定制 USB 映射时使所有 USB 端口正常工作（假设前提是不存在端口限制）。但是，如果你选择从从 Windows，使用 USBToolBox 定制工具进行操作，则 UTBDefault.kext 是不需要的，将其删除即可。一个简略的全新 USB 映射定制流程如下：

将 USBToolBox.kext 和 UTBDefault.kext 添加到您的 /EFI/OC/Kexts/ 文件夹中，添加到 config.plist 并启用（排序靠后，无需靠前）
使用 USBToolBox 工具进行端口映射定制，这一步可在 Windows 或 macOS 中完成，推荐前者
删除 UTBDefault.kext 并将新创建的 UTBMap.kext（或 USBMap.kext）添加到 /EFI/OC/Kexts/ ，添加到 config.plist 并启用
重新启动即可，定制完成