Skip to content
YBronstPublic
forked from laobamac/SimpleBCM

About

Restore Broadcom Wi-Fi on macOS Tahoe with standalone OpenCore drivers

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

SimpleBCM

Version macOS Architecture OpenCore

简体中文 · English

SimpleBCM 通过 OpenCore 注入恢复 macOS Sonoma、Sequoia 和 Tahoe 的 Broadcom Wi-Fi 支持。同一个 Kext 使用各系统原生 IOSkywalkFamily,无需修改系统卷。

安装

  1. 将 SimpleBCM.kext 放入 EFI/OC/Kexts,替换旧版本。
  2. 禁用 IOSkywalkFamily、IO80211FamilyLegacy、AirPortBrcmNIC 的独立 Add 项。
  3. 合入包内 config.fragment.plist,用 ocvalidate 检查后重启。

删除或禁用已有的 com.apple.iokit.IOSkywalkFamily 的 Kernel → Block 规则,保持系统原生 IOSkywalkFamily 和 IO80211Family 启用。

支持 macOS Sonoma 14、Sequoia 15 和 Tahoe 26,不限制系统小版本。使用 MinKernel=23.0.0、MaxKernel=25.99.99。

需要 AirportBrcmFixup 时,按 Extra/config.AirportBrcmFixup.fragment.plist 添加 Lilu、AirportBrcmFixup 和 AirPortBrcmNIC_Injector。

启动参数

sbcmdelay=X:服务启动后延迟 X 毫秒加载内嵌驱动,如 sbcmdelay=10000 为 10 秒。支持三套系统,不设置或设为 0 时不延迟。载荷准备和注册仍在早期完成。

以下功能默认关闭,仅在 macOS Tahoe(Darwin 25)生效,可分别启用:

参数 功能
-sbcmawdlcc 启用 AWDL 信道共存修正
-sbcmdma 启用 Tahoe DMA 优化

在 OpenCore 的 NVRAM → Add → 7C436110-AB2A-4BBB-A880-FE41995C9F82 → boot-args 中追加所需参数,保留原有参数并用空格分隔;重启后生效。移除对应参数并重启即可关闭。两项互不依赖,Debug 和 Release 的默认行为相同;Sonoma、Sequoia 不应用这两项修改。-simplebcmoff 仍可禁用整个驱动。

调试

使用 DEBUG 包,在解压目录运行:

./Extra/bcmprobe
./Extra/bcmprobe --scan
python3 Extra/collect.py

构建

需要完整 Xcode 和 Intel Mac。ABI 参考数据随源码提供,CI 使用 GitHub 托管的 macos-26-intel。详见构建与 CI。

python3 Tools/bootstrap.py
python3 Tools/build.py build --configuration Debug
python3 Tools/build.py build --configuration Release
python3 Tools/build.py analyze --configuration Release
python3 Tools/build.py package --configuration Debug
python3 Tools/build.py package --configuration Release

Xcode 工程:SimpleBCM.xcodeproj。产物目录:dist。

实现说明 · 第三方许可

About

Restore Broadcom Wi-Fi on macOS Tahoe with standalone OpenCore drivers

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages