Skip to content

BootCamp Performance Control 0.5.0-rc.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@mksolutionsuniversal mksolutionsuniversal released this 05 Sep 19:26
· 9 commits to main since this release
v0.5.0-rc.1
27511af
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

0.5.0-rc.1 — T2 fan-control family candidate

This is a pre-release. Stable remains 0.4.0.

Highlights

  • Gaming Optimised CPU target is global for SupportedIntelMac: Maximum Processor State 95% / 95%, Boost disabled on AC/DC.
  • Fan control is additive; CPU-only Gaming remains available when the fan backend is unavailable or cannot be safely owned.
  • Dynamic fan topology is discovered from live FNum.
  • Fan writes are enabled only for the verified runtime MMIO + FNum + per-fan FLT4 / Md / Tg capability family.
  • Maximum Safe RPM targets always come from fresh live F{i}Mx.
  • Crash/startup fan recovery and fan-only resume are generalized beyond an exact-model runtime gate.
  • Legacy schema-v1 downgrade recovery remains for the exact two-fan MacBookPro16,1 path.

Physical validation

End-to-end physically validated on:

  • MacBookPro16,1
  • MacBook Pro 16-inch (2019)
  • Apple T2
  • Windows 10 Boot Camp

Validated lifecycle:

  • read-only capability preflight,
  • Maximum Safe RPM apply and read-back,
  • CPU 95 / 95, Boost 0 / 0,
  • normal FANS -> POWER Restore,
  • forced-process termination,
  • automatic startup Apple Auto fan recovery,
  • processor snapshot preservation,
  • fan-only resume without snapshot replacement,
  • final exact processor Restore.

Observed live fan maxima on the reference machine:

  • Fan 0: 5616 RPM
  • Fan 1: 5200 RPM

Other machines are not claimed physically validated merely because they contain Apple T2. Fan-write eligibility depends on the live guarded capability fingerprint.

Safety boundary

  • T1 fpe2 / FS! writes remain disabled.
  • Closed production write surface: discovered F0..F9 Md/Tg only.
  • No arbitrary SMC keys.
  • No minimum-RPM controls.
  • No manual fan-speed slider.
  • No undervolting or CPU MSR writes.
  • No firmware or display-timing modifications.
  • BCPC does not bundle Macs Fan Control, applesmc.sys, or the experimental native BootCampSmc driver.

Compatibility backend

The physically validated environment uses a separately installed:

  • Macs Fan Control 1.5.16 (Build 693)
  • AppleSMC driver file version 1.0.7.0

Close the Macs Fan Control application before BCPC takes fan ownership.

See README.md, docs/FAN-CONTROL.md, docs/HARDWARE-COMPATIBILITY.md, and docs/0.5.0-rc.1-HARDWARE-VALIDATION.md for details.

Assets 4
Loading