USB定制/运行辅助：USBToolbox.kext 1.1.1

概述

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 之间的整数（含）。

如何使用

需要搭配 USB 映射定制工具 使用。此 Kext 包含两个文件：主文件 USBToolBox.kext 和辅助 UTBDefault.kext 。

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 并启用
• 重新启动即可，定制完成

「注」使用 USBToolBox 一套工具完整详细的 USB 映射定制请参考：Windows下定制黑苹果USB接口详细攻略

转换现有映射

• 转换已有的 USB 映射文件比较容易，使用 PlistEdit Pro 等工具打开 Kext 内部的 Plist 问，然后对每个 IOKit Personality 更改以下内容：
• 修改 CFBundleIdentifier 为 com.dhinakg.USBToolBox.kext
• 修改 IOClass 为 USBToolBox
• 修改IOMatchCategory 为 USBToolBox
• 将名为 OSBundleLibraries 的 dictionary 添加到根项目（Root item）。它应该包含 com.dhinakg.USBToolBox.kext，值为 1.0.0。

历史版本 · 更新说明