BrcmPatchRAM 开源项目安装与使用指南

BrcmPatchRAM 开源项目安装与使用指南

BrcmPatchRAM 项目地址: https://gitcode.com/gh_mirrors/brc/BrcmPatchRAM

1. 项目目录结构及介绍

BrcmPatchRAM 是一个专为解决 macOS 上 Broadcom 蓝牙设备固件更新问题而设计的驱动程序。此项目的核心在于提供一种机制，在每次启动或唤醒时应用 PatchRAM 更新至 Broadcom 的 RAMUSB 基础设备上，确保其功能与 Windows 系统下的体验一致。

以下是项目的目录概览及其简要说明：

• BrcmBluetoothInjector: 包含用于特定 macOS 版本的蓝牙注入代码。
• kext/Contents: 存放内核扩展的相关内容，包括主驱动程序和可能的固件注入逻辑。
  • 分别有针对不同版本 macOS 的分支或适配文件。
• extra_firmwares, firmwares: 存储额外的和主要的固件文件，这些是驱动程序需要访问以进行固件更新的关键资源。
• gitignore: 版本控制忽略文件列表。
• LICENSE: 许可证文件，表明该项目遵循 GPL-2.0 许可。
• README-{Mac,CN}.md: 提供英文和中文版的项目说明文档。
• BrcmNonPatchRAM-Info.plist, BrcmNonPatchRAM2-Info.plist: 配置信息文件，对于不需要固件更新的设备。
• BrcmPatchRAM.xcodeproj: Xcode 工程文件，用于编译和开发。
• 各种 .sh, .rb, 和 .tool 文件: 提供脚本工具以辅助操作或生成固件数据。

2. 项目启动文件介绍

本项目主要是通过内核扩展(kext)的方式集成进系统中，并非通过传统意义上的“启动文件”来运行。关键的启动环节涉及到以下几个文件或组件：

• BrcmPatchRAM.kext: 主内核扩展文件，负责识别Broadcom蓝牙设备并执行固件更新。
• BrcmFirmwareData.kext 或 BrcmFirmwareRepo.kext: 提供固件数据，前者适合通过引导程序注入，后者更高效但需要安装在特定位置。

在实际操作中，正确地将上述内核扩展添加到系统，并随系统的启动而自动加载，即视为“启动”。

3. 项目的配置文件介绍

主要配置文件

• Info.plist (位于各个.kext内部): 这些文件定义了内核扩展的基本属性，如兼容性声明、所需权限、设备ID匹配规则等。是kext配置的核心，决定了哪些设备会被驱动支持。

• BrcmFirmwareRepo.kext/Contents/Resources内的固件配置: 若存在定制化的固件配置需求，可能需在这里调整以适应特定型号的Broadcom蓝牙设备。

• 可能的外部配置文件: 在使用过程中，用户可能需要自定义配置，比如修改注入的固件版本或调整驱动的行为，但这通常不是本项目直接受控的部分，更多依赖于引导加载器或其他环境配置。

使用时的注意事项

• 根据您的 macOS 版本选择正确的BrcmPatchRAM变体。
• 固件数据的选择和部署应考虑安装位置和注入方式。
• 修改任何配置前，请详细阅读项目文档和相关Markdown文件，以避免系统不稳定。

通过以上步骤，您可以正确配置和利用 BrcmPatchRAM 来优化您的Broadcom蓝牙设备在macOS上的性能和稳定性。记得在进行任何修改之前备份重要的系统数据，以及了解可能对系统稳定性的潜在影响。

BrcmPatchRAM 项目地址: https://gitcode.com/gh_mirrors/brc/BrcmPatchRAM