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:
Doug Beney 2017-08-10 15:46:56 -04:00 committed by GitHub
parent f1bdb616cd
commit 7297a18e1a

View file

@ -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