Xbox 360控制器驱动使用指南

一、入门指南：准备与安装

验证设备兼容性

确认你的Mac系统版本和控制器类型是否支持：

控制器类型	支持连接方式	系统兼容性	注意事项
Xbox 360 有线	USB直连	macOS 10.10及以下	即插即用
Xbox 360 无线	无线接收器	macOS 10.10及以下	10.11+版本可能导致内核崩溃
Xbox One	USB连接	需安装驱动	2016年8月后生产的支持蓝牙
Xbox自适应控制器	蓝牙/USB	需固件更新	有线模式需驱动支持

⚠️ 重要提示：Big Sur及Apple Silicon设备暂不支持本驱动

准备开发环境

1. 安装Xcode 6.4或更早版本
2. 安装命令行工具：xcode-select --install
3. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/36/360Controller

执行标准安装

1. 下载最新发布版驱动包
2. 运行安装程序并按指引操作
3. 在系统偏好设置中允许"System software from developer 'Drew Mills'"
4. 重启电脑完成安装

图：Xbox 360控制器图标，用于系统偏好设置面板

验证安装结果

1. 打开系统偏好设置 > Xbox 360 Controllers
2. 连接控制器后查看设备状态
3. 测试按钮和摇杆功能是否正常响应

二、进阶技巧：配置与定制

手动编译安装驱动

1. 进入项目目录：cd 360Controller
2. 禁用驱动签名要求：

   sudo nvram boot-args="kext-dev-mode=1"
   sudo kextcache -m /System/Library/Caches/com.apple.kext.caches/Startup/Extensions.mkext /System/Library/Extensions
   

3. 编译驱动：xcodebuild -project 360Controller.xcodeproj -scheme 360Controller -configuration Release
4. 安装驱动：

   sudo cp -R build/Release/360Controller.kext /Library/Extensions/
   sudo chown -R root:wheel /Library/Extensions/360Controller.kext
   sudo kextutil /Library/Extensions/360Controller.kext
   

添加第三方控制器支持

1. 获取设备ID：
   • 打开关于本机 > 系统报告 > USB
   • 找到目标控制器，记录"厂商ID"和"产品ID"
2. 编辑配置文件：360Controller/360Controller/Info.plist
3. 添加设备信息：

   <key>Device Product ID</key>
   <integer>0x1234</integer>
   <key>Device Vendor ID</key>
   <integer>0x5678</integer>
   

4. 重新编译并安装驱动

高级调试技巧

• 查看驱动日志：

  log stream --predicate 'process == "kernel" AND subsystem == "com.tattiebogle.Xbox360Driver"'
  

• 测试力反馈功能：

  cd Feedback360
  ./testrumble
  

三、问题解决：常见问题与解答

Q&A：常见问题解决

Q: 连接无线控制器后系统重启怎么办？
A: 安装0.16.5及更早版本驱动，或在电脑休眠前手动禁用驱动。

Q: 偏好设置面板无响应如何处理？
A: 检查驱动加载状态：kextstat | grep 360Controller，重建内核缓存：sudo kextcache -system-prelinked-kernel

Q: 游戏中控制器无响应怎么解决？
A: 1. 尝试"模拟Xbox 360控制器"模式；2. 验证游戏是否支持HID设备；3. 检查控制器配置映射

Q: 如何彻底卸载驱动？
A: 打开系统偏好设置 > Xbox 360 Controllers > 高级 > 卸载，然后重启电脑

驱动状态检查工具

• 检查驱动状态：kextutil -tn /Library/Extensions/360Controller.kext
• 重建驱动缓存：sudo kextcache -system-caches

附录：项目资源说明

核心目录功能

• 360Controller/：驱动核心代码
• Pref360Control/：系统偏好设置面板
• Feedback360/：力反馈效果实现
• Install360Controller/：安装包构建脚本

许可证信息

本项目基于GNU Public License许可，详细条款见项目根目录下的Licence.txt文件。