TOC, coretemp/applesmc directions, Macbook support, Solus
I added a table of contents for easy navigation, added the directions you provided me on figuring out if my system has applesmc/coretemp installed, I added my Macbook to tested devices, and I added Solus to supported operating systems.
This commit is contained in:
parent
f1bdb616cd
commit
7297a18e1a
1 changed files with 63 additions and 35 deletions
86
README.md
86
README.md
|
@ -1,8 +1,6 @@
|
||||||
mbpfan
|
mbpfan
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Introduction
|
|
||||||
---------------------
|
|
||||||
This is an enhanced version of [Allan McRae mbpfan](http://allanmcrae.com/2010/05/simple-macbook-pro-fan-daemon/)
|
This is an enhanced version of [Allan McRae mbpfan](http://allanmcrae.com/2010/05/simple-macbook-pro-fan-daemon/)
|
||||||
|
|
||||||
mbpfan is a daemon that uses input from coretemp module and sets the fan speed using the applesmc module.
|
mbpfan is a daemon that uses input from coretemp module and sets the fan speed using the applesmc module.
|
||||||
|
@ -15,9 +13,24 @@ This enhanced version assumes any number of processors and fans (max. 10).
|
||||||
* Verbose mode for both syslog and stdout
|
* Verbose mode for both syslog and stdout
|
||||||
* Users can configure it using the file /etc/mbpfan.conf
|
* Users can configure it using the file /etc/mbpfan.conf
|
||||||
|
|
||||||
|
**Table Of Contents**
|
||||||
|
|
||||||
|
- [Supported GNU/Linux Distributions](#supported-gnulinux-distributions)
|
||||||
|
- [Tested Macbook Models](#tested-macbook-models)
|
||||||
|
- [Tested iMac/Mac Mini Models](#tested-imacmac-mini-models)
|
||||||
|
- [Requirements](#requirements)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Arch Linux](#arch-linux)
|
||||||
|
- [Ubuntu](#ubuntu)
|
||||||
|
- [Gentoo](#gentoo)
|
||||||
|
- [Generic Install Instructions (All Other Operating Systems)](#generic-install-instructions-all-other-operating-systems)
|
||||||
|
- [Run Instructions](#run-instructions)
|
||||||
|
- [Starting at boot](#starting-at-boot)
|
||||||
|
- [Usage](#usage)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
|
## Supported GNU/Linux Distributions
|
||||||
|
|
||||||
Supported GNU/Linux Distributions
|
|
||||||
---------------------------------
|
|
||||||
We provide scripts to to load mbpfan daemon at system boot for many distros.
|
We provide scripts to to load mbpfan daemon at system boot for many distros.
|
||||||
Please note that the support is provided by volunteers. mbpfan needs tests and bug reports.
|
Please note that the support is provided by volunteers. mbpfan needs tests and bug reports.
|
||||||
|
|
||||||
|
@ -32,12 +45,14 @@ Supported distributions:
|
||||||
- Gentoo
|
- Gentoo
|
||||||
- Alpine
|
- Alpine
|
||||||
- Trisquel
|
- Trisquel
|
||||||
|
- Solus
|
||||||
|
|
||||||
|
## Tested Macbook Models
|
||||||
|
|
||||||
Tested MacBook Models
|
|
||||||
---------------------
|
|
||||||
This section reports those models where mbpfan was tested successfully. It does not necessarily mean that the daemon does not work on non-listed models.
|
This section reports those models where mbpfan was tested successfully. It does not necessarily mean that the daemon does not work on non-listed models.
|
||||||
|
|
||||||
- MacBook Pro 12,1 13" (Intel i5 - Linux 4.20)
|
- MacBook Pro 12,1 13" (Intel i5 - Linux 4.20)
|
||||||
|
- MacBook Pro 11,4 15" (Intel i7 - Linux 4.9.41)
|
||||||
- MacBook Pro 11,1 13" (Intel i5 - Linux 3.14, Linux 3.15)
|
- MacBook Pro 11,1 13" (Intel i5 - Linux 3.14, Linux 3.15)
|
||||||
- MacBook Pro 9,2 13" (Intel i5/i7 - Linux 3.10)
|
- MacBook Pro 9,2 13" (Intel i5/i7 - Linux 3.10)
|
||||||
- MacBook Pro 8,2 15" (Intel i7 - Linux 3.6.2)
|
- MacBook Pro 8,2 15" (Intel i7 - Linux 3.6.2)
|
||||||
|
@ -51,8 +66,8 @@ This section reports those models where mbpfan was tested successfully. It does
|
||||||
- MacBook Air 7,2 13" (Intel Core Duo - Linux 4.10)
|
- MacBook Air 7,2 13" (Intel Core Duo - Linux 4.10)
|
||||||
- MacBook 1,1 (Intel Core Duo - Linux 3.16)
|
- MacBook 1,1 (Intel Core Duo - Linux 3.16)
|
||||||
|
|
||||||
Tested iMac/Mac Mini Models
|
## Tested iMac/Mac Mini Models
|
||||||
------------------
|
|
||||||
This section reports the iMac/Mac-mini models where mbpfan was tested successfully.
|
This section reports the iMac/Mac-mini models where mbpfan was tested successfully.
|
||||||
|
|
||||||
- iMac Retina 16.2 21.5" (Intel i5 - Linux 4.4.0 Ubuntu 16.04)
|
- iMac Retina 16.2 21.5" (Intel i5 - Linux 4.4.0 Ubuntu 16.04)
|
||||||
|
@ -62,10 +77,24 @@ This section reports the iMac/Mac-mini models where mbpfan was tested successful
|
||||||
- Mac Mini 5,3 (Core i7 2.0 - Linux 4.4.0 elementary/Ubuntu)
|
- Mac Mini 5,3 (Core i7 2.0 - Linux 4.4.0 elementary/Ubuntu)
|
||||||
- Mac Mini 6,1 (Core i7 2.3 - Linux 4.7.3-4-ck Archlinux)
|
- Mac Mini 6,1 (Core i7 2.3 - Linux 4.7.3-4-ck Archlinux)
|
||||||
|
|
||||||
Warning
|
## Requirements
|
||||||
-------
|
|
||||||
Be sure to load the kernel modules **applesmc** and **coretemp**.
|
Be sure to load the kernel modules **applesmc** and **coretemp**.
|
||||||
These modules are often automatically loaded when booting up GNU/Linux on a MacBook. If that is not the case, you should make sure to load them at system startup. This is _usually_ achieved by inserting the following two lines in the file `/etc/modules`
|
|
||||||
|
These modules are often automatically loaded when booting up GNU/Linux on a MacBook. If that is not the case, you should make sure to load them at system startup.
|
||||||
|
|
||||||
|
**How do I know if applesmc and coretemp are loaded?**
|
||||||
|
|
||||||
|
In most distributions, you can run the following command:
|
||||||
|
|
||||||
|
`lsmod | grep coretemp && lsmod | grep applesmc`
|
||||||
|
|
||||||
|
If you see `coretemp` and `applesmc` listed, you are all set.
|
||||||
|
|
||||||
|
**If you do not see `coretemp` and `applesmc` listed, you must load them.**
|
||||||
|
|
||||||
|
This is _usually_ achieved by inserting the following two lines in the file `/etc/modules`
|
||||||
|
|
||||||
```
|
```
|
||||||
coretemp
|
coretemp
|
||||||
applesmc
|
applesmc
|
||||||
|
@ -73,29 +102,29 @@ applesmc
|
||||||
|
|
||||||
Please check the relevant documentation of your GNU/Linux distribution.
|
Please check the relevant documentation of your GNU/Linux distribution.
|
||||||
|
|
||||||
Arch Linux
|
## Installation
|
||||||
---------
|
|
||||||
|
### Arch Linux
|
||||||
|
|
||||||
See [mbpfan-git at AUR](https://aur.archlinux.org/packages/mbpfan-git/).
|
See [mbpfan-git at AUR](https://aur.archlinux.org/packages/mbpfan-git/).
|
||||||
Otherwise, please refer to the Generic Instructions.
|
Otherwise, please refer to the Generic Instructions.
|
||||||
|
|
||||||
|
|
||||||
Ubuntu
|
### Ubuntu
|
||||||
------
|
|
||||||
|
|
||||||
Install the ```build-essential``` package.
|
Install the ```build-essential``` package.
|
||||||
Then, refer to the Generic Install Instructions.
|
Then, refer to the Generic Install Instructions.
|
||||||
|
|
||||||
Otherwise, a step-by-step [tutorial for beginners is available on my website](https://ineed.coffee/3838/a-beginners-mbpfan-tutorial-for-ubuntu/).
|
Otherwise, a step-by-step [tutorial for beginners is available on my website](https://ineed.coffee/3838/a-beginners-mbpfan-tutorial-for-ubuntu/).
|
||||||
|
|
||||||
Gentoo
|
### Gentoo
|
||||||
------
|
|
||||||
|
|
||||||
Install the ```mbpfan``` package with:
|
Install the ```mbpfan``` package with:
|
||||||
|
|
||||||
sudo emerge -av app-laptop/mbpfan
|
sudo emerge -av app-laptop/mbpfan
|
||||||
|
|
||||||
Generic Install Instructions
|
### Generic Install Instructions (All Other Operating Systems)
|
||||||
-------------------------
|
|
||||||
Compile with
|
Compile with
|
||||||
|
|
||||||
make
|
make
|
||||||
|
@ -125,8 +154,8 @@ or
|
||||||
sudo make tests
|
sudo make tests
|
||||||
|
|
||||||
|
|
||||||
Run Instructions
|
## Run Instructions
|
||||||
----------------
|
|
||||||
If not installed, run with
|
If not installed, run with
|
||||||
|
|
||||||
sudo bin/mbpfan
|
sudo bin/mbpfan
|
||||||
|
@ -140,8 +169,8 @@ If installed and using the init file, run with (Ubuntu example)
|
||||||
sudo service mbpfan start
|
sudo service mbpfan start
|
||||||
|
|
||||||
|
|
||||||
Starting at boot
|
## Starting at boot
|
||||||
----------------
|
|
||||||
**Ubuntu**
|
**Ubuntu**
|
||||||
|
|
||||||
For systemd based init systems (Ubuntu 16.04+), the file mbpfan.service
|
For systemd based init systems (Ubuntu 16.04+), the file mbpfan.service
|
||||||
|
@ -197,8 +226,7 @@ To start the service automatically at boot, also execute the following:
|
||||||
sudo systemctl enable mbpfan.service
|
sudo systemctl enable mbpfan.service
|
||||||
|
|
||||||
|
|
||||||
Usage
|
## Usage
|
||||||
-------
|
|
||||||
|
|
||||||
Usage: ./mbpfan OPTION(S)
|
Usage: ./mbpfan OPTION(S)
|
||||||
|
|
||||||
|
@ -208,13 +236,13 @@ Usage
|
||||||
-v Be (a lot) verbose
|
-v Be (a lot) verbose
|
||||||
|
|
||||||
|
|
||||||
License
|
## License
|
||||||
---------------------
|
|
||||||
GNU General Public License version 3
|
GNU General Public License version 3
|
||||||
|
|
||||||
|
|
||||||
Based On
|
**This Project Is Based On:**
|
||||||
---------------------
|
|
||||||
* http://allanmcrae.com/2010/05/simple-macbook-pro-fan-daemon/
|
* http://allanmcrae.com/2010/05/simple-macbook-pro-fan-daemon/
|
||||||
* http://allanmcrae.com/2011/08/mbp-fan-daemon-update/
|
* http://allanmcrae.com/2011/08/mbp-fan-daemon-update/
|
||||||
* https://launchpad.net/macfanctld
|
* https://launchpad.net/macfanctld
|
||||||
|
|
Loading…
Reference in a new issue