Thunderbolt 3 不支持外设启用工具安装与配置指南

最新推荐文章于 2025-05-02 13:20:40 发布

史姿若Muriel

最新推荐文章于 2025-05-02 13:20:40 发布

阅读量585

点赞数 22

本文链接：https://blog.csdn.net/gitblog_01073/article/details/147265793

版权

Thunderbolt 3 不支持外设启用工具安装与配置指南

tb3-enabler Enable Thunderbolt 3 for unsupported peripherals on macOS 项目地址: https://gitcode.com/gh_mirrors/tb/tb3-enabler

1. 项目基础介绍

本项目名为 tb3-enabler，旨在为 macOS 系统启用对某些不被官方支持但实际可用的 Thunderbolt 3 外设的支持。该工具通过修改系统内核扩展（kext）来实现这一功能。项目主要使用 Python 编程语言进行开发。

2. 关键技术和框架

本项目主要利用了 macOS 系统的内核扩展机制，通过 Python 脚本对特定的系统内核扩展 IOThunderboltFamily 进行修改。这种修改是通过动态地覆盖内核扩展的二进制代码实现的，不需要对系统内核本身进行改动。

3. 安装和配置准备工作

在开始安装和配置之前，请确保您满足以下条件：

您的电脑运行的是 macOS 系统。
您有管理员权限来进行系统级的操作。
您已经安装了 Python，本项目支持 Python 3 环境。

安装步骤

以下步骤将指导您安装和配置 tb3-enabler：

禁用系统完整性保护
由于项目需要对系统级的文件进行修改，您需要禁用 System Integrity Protection (SIP)。重启电脑，并在启动时按住 Command + R 进入 Recovery 模式，然后打开终端并执行以下命令：
```
csrutil disable
```
完成后重启电脑。
克隆项目到本地
打开终端，使用 git 命令将项目克隆到本地：
```
cd ~
git clone https://github.com/KhaosT/tb3-enabler.git
cd tb3-enabler
```

备份原文件
在进行任何修改之前，请确保备份原始的内核扩展文件。在终端中执行以下命令：

sudo cp /System/Library/Extensions/IOThunderboltFamily.kext/Contents/MacOS/IOThunderboltFamily /System/Library/Extensions/IOThunderboltFamily.kext/Contents/MacOS/IOThunderboltFamily.backup

应用补丁
在终端中执行以下命令来应用补丁：
```
sudo ./tb3-enabler.py apply
```
如果脚本提示补丁应用成功，则继续下一步。
清除内核扩展缓存
在终端中执行以下命令来清除内核扩展缓存：
```
sudo kextcache -validate /System/Library/Extensions
sudo kextcache -system-cache
```
重启电脑
完成上述步骤后，重启电脑以使更改生效。
检查状态
重启后，再次打开终端并执行以下命令来检查补丁状态：
```
./tb3-enabler.py status
```
如果状态显示补丁已成功应用，那么您的电脑应该已经可以识别原本不被支持的 Thunderbolt 3 外设了。