Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sicreative/VoltageShift
undervoltage Tools for MacOS
https://github.com/sicreative/VoltageShift
Last synced: 11 days ago
JSON representation
undervoltage Tools for MacOS
- Host: GitHub
- URL: https://github.com/sicreative/VoltageShift
- Owner: sicreative
- License: gpl-3.0
- Created: 2017-06-17T20:13:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-12-27T23:24:17.000Z (almost 3 years ago)
- Last Synced: 2024-08-02T11:23:58.093Z (3 months ago)
- Language: Objective-C++
- Size: 264 KB
- Stars: 607
- Watchers: 21
- Forks: 76
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VoltageShift
Undervoltage Tools for MacOS (Haswell and Broadwell)
Change Turbo and Power Limit for most Intel platform Macbook
All source code protected by The GNU General Public License V 3.0
MSR Kext Driver modified from
[AnVMSR](http://www.insanelymac.com/forum/topic/291833-anvmsr-v10-tool-and-driver-to-read-from-or-write-to-cpu-msr-registers/)
by Andy Vandijck Copyright (C) 2013 AnV Software
NOTICE: THIS TOOL IS FOR ADVANCED USERS AND MAY DAMAGE YOUR COMPUTER PERMANENTLY.
This App is not support Apple Silicon.
You can download this software´s binary from:
[VoltageShift](voltageshift_1.25.zip)
Building
--------
[Xcode](https://developer.apple.com/xcode/) is required.
```bash
# Build the kernel extension (kext)
xcodebuild -target VoltageShift
# Change owner
sudo chown -R root:wheel build/Release/VoltageShift.kext
# Build command line tool
xcodebuild -target voltageshift
```
Usage
--------
This program is a command tool that supports Haswell and above CPUs for undervoltage and TDP setting.
Apple locked the OC capability for newer devices or firmware, if the info show "OC_Locked" mean not able to undervolt, however, you can still disable Turbo and set Power Limit to reduce heat, fan noise or battery life.
It uses the 'Intel Overclock Mailbox' for controling the voltage offset,
Undervoltage can reduce heat and sustain Turbo boost longer, provide longer battery performance, although if done too much(mV) it may cause an unstable system.
This program supports macOS 10.12 or above, however you need to switch off the SIP for unsigned kext in Recovery mode:
Push `Cmd`+`R` when booting to Recovery mode, select Terminal at toolbar and enter:
csrutil enable --without kext
After reboot, ensure the kext and the command tool files are in the same directory.
For Big Sur, a diaglog will showed when first launched, tick Grey button redirect to System Preferences>Security & Privacy and allow the kext loaded, reboot take the effective.
You can view your current voltage offset,CPU freqency,power and temperture settings with the following command:
./voltageshift info
You can continue to monitor the CPU frequency, power and temperture by using:
./voltageshift mon
Six types of voltage offsets are dispenible to change, however we only suggest undervolting the CPU and GPU only.
./voltageshift offset
for example reduced CPU -50mv and GPU -30mv
./voltageshift offset -50 -30
If you set too low the system will freeze, please turn OFF completely and turn ON computer to reset back the undervolt to 0mV.
After you test throughfuly the settings and are comfortable with System stability, you can apply the launchd: (require sudo root)
sudo ./voltageshift buildlaunchd
If remain is set to 1, the kext will remain on system
The is the update interval of the tool to check and change, the Default value is 160min, Hibernate (suspend to Disk) will reset the voltage setting, as sleep (suspend to memory) will not change the sleep value, it will scheduled check the setting in peroid, and amend if need. *0 is for applying the setting at bootup only.*
for example:
sudo ./voltageshift buildlaunchd -50 -50 0 0 0 0 0 0 1 50 80 1 160
set system auto apply CPU -50mv and GPU -50mv, close Turbo, and set PL1 to 50, PL2 to 80, run every boot and every 160min and kext remain on system .
sudo ./voltageshift buildlaunchd 0 0 0 0 0 0 0 -1
switch off turbo only, run every boot and every 160min .
sudo ./voltageshift buildlaunchd -20 0 -20 0 0 0 0 -1 -1 -1 0
set system auto apply CPU -20mv and cache -20mv, run only boot .
You can remove the launchd with the following command:
./voltageshift removelaunchd
For load the kext in current directory (remaining kext driver on system)
./voltageshift loadkext
or
sudo kextutil -r ./ -b com.sicreative.VoltageShift
For unload the kext
./voltageshift unloadkext
or
sudo kextunload -b com.sicreative.VoltageShift
For check the kext is loaded
kextstat | grep -v com.apple
should show "com.sicreative.VoltageShift" on return.
#### Caution: Remaining the kext on system may violate system because other program may change the MSR without root (sudo) authorizing.
ChangeLog
---------
Versions 1.25:
1. Support kext remaining on System
Versions 1.24:
1. Support Big Sur and Universial building on Xcode12 (load on Apple Silicon will simply exit )
Version 1.22:
1. Change read of timer from system api instead of MSR for improve of compatibility.
Version 1.21:
1. Updated to support auto set Turbo / Power when startup
2. Default close "offset" for read temp. sensor. (As some system may have issue) [Charlyo]
Version 1.2:
1. Updated to support up to 8 core CPU
2. Updated setting of turbo boost
3. Updated setting of power limited
4. Additional power limited and turbo boost status showed on -info
5. Detect Apple BIOS overclock lock (OC_Locked)
Additional
--------
Use '--damage offset ...' if you want settings lower than 250mv or Overvoltage (>0v).
Manually change the launchd (com.sicreative.VoltageShift.plist under /Library/LaunchDaemons)
by adding new ProgramArguments '--damage' between
'/Library/Application Support/VoltageShift/voltageshift' and 'offsetdaemons'
To read the MSR
./voltageshift read
To set the MSR
./voltageshift write
To set the Power Limted of PL1 (Long Term) and PL2 (Short Term)
./voltageshift power
To set Turbo Enabled (0-no turbo 1-turbo):
./voltageshift turbo <0/1>