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 14、Sequoia 15、Tahoe 26 和 GoldenGate 27 恢复 Broadcom Wi-Fi。

安装

OpenCore 只需添加一个 SimpleBCM.kext。macOS 27 的 Wi-Fi 认证和隔空投送组件已内置,无需安装系统文件或重建内核集合。

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

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

需要 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