Thunderbolt 3 Unblocker 安装与配置指南

Thunderbolt 3 Unblocker 安装与配置指南

1. 项目基础介绍

Thunderbolt 3 Unblocker 是一个开源项目，它提供了一个内核扩展（kernel extension），用于在 macOS 上解锁不支持的 Thunderbolt 3 外设（例如 Razer Core）。该项目的目标是实现与 KhaosT 的 TB3 Enabler 相同的功能，但通过在内存中实时修补 IOThunderboltFamily 来完成。

主要编程语言：C (78.4%)、C++ (17.3%)、Shell (4.3%)

2. 项目使用的关键技术和框架

• 内核扩展开发：项目涉及在操作系统内核级别进行编程，以实现对 Thunderbolt 3 接口驱动程序的实时修补。
• 内存操作：项目使用特定的内存操作技术来修改内核级别的数据结构。
• CMake：用于构建项目，管理编译过程。
• Xcode：macOS 下的集成开发环境，用于编译和调试项目。

3. 安装和配置准备工作

准备工作

• 确保您的操作系统版本兼容（macOS Sierra 10.12.6 至 macOS Monterey 12）。
• 下载并安装最新版本的 Xcode，并确保 Xcode 命令行工具也已安装。
• 安装 Homebrew（如果尚未安装）。

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/rgov/Thunderbolt3Unblocker.git
   cd Thunderbolt3Unblocker
   

2. 初始化子模块：

   git submodule update --init --recursive
   

3. 使用 Homebrew 安装编译所需的依赖：

   brew install cmake
   

4. 打开 Xcode 项目文件：

   open Thunderbolt3Unblocker.xcodeproj
   

5. 在 Xcode 中编译项目。确保代码签名设置正确。

6. 编译完成后，更改内核扩展的文件所有权：

   sudo chown -R root:wheel Thunderbolt3Unblocker.kext
   

7. 加载内核扩展：

   sudo kextload Thunderbolt3Unblocker.kext
   

8. 如果加载失败，重启进入恢复模式并禁用内核扩展的安全限制：

   csrutil enable --without kext
   

9. 如果在加载内核扩展时出现恐慌，可能需要在 NVRAM 中删除相关变量：

   nvram -d t3u-incompatible
   

请注意，操作内核扩展可能会对系统稳定性造成影响，请确保在了解风险的情况下进行操作。在安装和配置过程中，如果遇到任何问题，可以参考项目的 README 文档中的故障排除指南。