Merge pull request #139 from alexwickstrom/patch-1

Format README.md for smc-command
This commit is contained in:
Hendrik Holtmann
2022-12-03 17:22:43 +01:00
committed by GitHub

View File

@ -1,8 +1,8 @@
Warning Warning
------- -------
This tool will allow you to write values to the SMC which could irreversably damage your This tool will allow you to write values to the SMC which could irreversably damage your
computer. Manipulating the fans could cause overheating and permanent damange. USE THIS computer. Manipulating the fans could cause overheating and permanent damange.
PROGRAM AT YOUR OWN RISK! *USE THIS PROGRAM AT YOUR OWN RISK!*
Background Background
---------- ----------
@ -20,9 +20,12 @@ by running the fans at a low speed like 3500 RPM, which you can barely hear.
Usage Usage
------ ------
# smc -h `smc -h`
```bash
Apple System Management Control (SMC) tool 0.01 Apple System Management Control (SMC) tool 0.01
Usage: Usage:
./smc [options] ./smc [options]
-f : fan info decoded -f : fan info decoded
@ -32,44 +35,49 @@ Usage:
-r : read the value of a key -r : read the value of a key
-w <value> : write the specified value to a key -w <value> : write the specified value to a key
-v : version -v : version
```
Fan control Fan control
----------- -----------
To decode: To decode:
# smc -f `smc -f`
To manually query and control: To manually query and control:
FNum - tells you how many fans are in the system `FNum` - tells you how many fans are in the system
To read data from each fan: To read data from each fan:
F0Ac - Fan current speed ```F0Ac - Fan current speed
F0Mn - Fan minimum speed F0Mn - Fan minimum speed
F0Mx - Fan maximum speed F0Mx - Fan maximum speed
F0Sf - Fan safe speed F0Sf - Fan safe speed
F0Tg - Fan target speed F0Tg - Fan target speed
FS! - See if fans are in automatic or forced mode FS! - See if fans are in automatic or forced mode
```
[Replace 0 with fan #. In the MacBook Pro there two fans so this applies for 0 (left) [Replace `0` with fan #. In the MacBook Pro there two fans so this applies for `0` (left)
and 1 (right).] and `1` (right).]
To set a fan to a specific speed: To set a fan to a specific speed:
FS! - Sets "force mode" to fan. Bit 0 (right to left) is fan 0, bit 1
is fan 1, etc `FS!` Sets "force mode" to fan.
F0Tg - Sets target speed, make sure you fp78 encode it (left shift by 2) - Bit 0 (right to left) is fan 0, bit 1 is fan 1, etc.
`F0Tg` - Sets target speed, make sure you fp78 encode it (left shift by 2)
For example, to force both fans to 3500 RPM: For example, to force both fans to 3500 RPM:
# python -c "print hex(3500 << 2)" `python -c "print hex(3500 << 2)"`
0x36b0 0x36b0
# smc -k "FS! " -w 0003
# smc -k F0Tg -w 36b0 `smc -k "FS! " -w 0003`
# smc -k F1Tg -w 36b0 `smc -k F0Tg -w 36b0`
`smc -k F1Tg -w 36b0`
..to force fan 0 to 4000 RPM and leave fan 1 in automatic mode: ..to force fan 0 to 4000 RPM and leave fan 1 in automatic mode:
# smc -k "FS! " -w 0001 `smc -k "FS! " -w 0001`
# smc -k F0Tg -w 3e80 `smc -k F0Tg -w 3e80`
..to return both fans to automatic mode: ..to return both fans to automatic mode:
# smc -k "FS! " -w 0000 `smc -k "FS! " -w 0000`
Temperature sensors Temperature sensors
------------------- -------------------