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。

 

历史版本 · 更新说明

 

 

下载地址

  • 版本1.1.1
  • 适用系统>=10.11
0. 本站所有资源解压密码均为 heipg.cn
1. 本站资源收集于网络,仅做学习和交流使用,请于下载后24小时内删除。如果你喜欢我们推荐的软件,请购买正版支持作者。
2. 如有无法下载的链接,联系:admin#heipg.cn,或到QQ群进行反馈,我们将及时进行处理。
3. 本站发布的内容若侵犯到您的权益,请联系站长删除,联系方式:admin#heipg.cn,我们将第一时间配合处理!

黑苹果星球 » USB定制/运行辅助:USBToolbox.kext 1.1.1

发表评论