help

# HiveOS NVIDIA GPU autofan v.2.4
Nvidia gpu automatic fan speed script for HiveOS Ubuntu. 

The script has an intellectual adjustment. You need to set the range of the desired temperature. During the work the script will adjust the necessary parameters. After some time after starting the fan speed will be more stable in the specified temperature range.
	
Work on mixed RIGs with AMD and NVIDIA GPU's

>If you're upgrade HiveOS via account on website or by command ```selfupgrade``` not need re-install the script.

>If you are re-install HiveOS on disk - re-install ```autofan.sh``` too(!).

[**About HiveОS**](https://goo.gl/qXNH54)

# Disclaimer
Use and change at your own risk! Not responsible for any damages or issues, changing temperature controls, fan speed, etc. might damage your computer hardwares.

# Install
1. **```cd /home/user```** (go to ```/home/user``` directory on your HiveOS).
>Check current dir by command ```pwd```. For navigation use commands : ```cd ~``` (go to home dir),  ```cd ..``` (level up), ```cd dir``` (move to dir)
2. **```wget -O autofan.sh https://git.io/vhr1n```** (download the script)
>Or download and put autofan.sh via your sftp manager

3.**```chmod +x autofan.sh```** (change permission to 755 for run)

4.**```autofan.sh```** (run the script)


Now follow the on-screen instructions step-by-step:
- setup settings (or leave default)
- run script in GHOST mode (like service)

# Settings
 - ```DELAY``` - time delay for fan control (in seconds)
 - ```MIN_SPEED``` - minimum possible fan speed (in %)
 - ```MIN_TEMP``` - GPU temperature at which the minimum coefficient is applied
 - ```MAX_TEMP``` - GPU temperature at which the maximum coefficient is applied
 - ```MIN_COEF``` - minimum coefficient
 - ```MAX_COEF``` - maximum coefficient
 - ```MINER_STOP``` - stop miner if reaching critical temperature
 - ```CRITICAL_TEMP_MINER_STOP``` - critical temperature
 - ```PL_LIMIT``` - set lower power limit if reaching critical temperature (-5 watt every time)
 - ```CRITICAL_TEMP_PL``` - critical temperature


# Run with keys
The script has the following startup keys:

**-s** 		- start setup settings (terminate by Ctrl+C). Don't need restart the script.

**-su**		- setup settings (can edit ```MIN_COEF``` and ```MAX_COEF```)

**-g** 		- running script in GHOST mode or SCREEN mode (terminate by Ctrl+C)

**-c** 		- checking current script status and current GPU temperature/fan speed, updated every DELAY time (terminate by Ctrl+C)

**-r** 		- running script in SCREEN mode (terminate by Ctrl+C)

**-k** 		- kill script

**-u**		- selfupdate

**-d**		- restore HiveOS OC settings and turn off AUTOFAN (to turn on again run script in GHOST mode)

  Run without any keys has follow steps: 
  - start setup settings
  - checking starup status
  - running script in GHOST mode or SCREEN mode
	
	**Example : ```~# autofan.sh -c```**
	
# Startup at boot
*The script create file ```xinit.user.sh``` (or check availability) and configure to run ```autofan.sh``` at startup.
Also script create ```autofan.conf``` file to store user settings.*

# Examples of temperature and fan speed (default script settings)
- 55 C : 38 %
- 60 C : 48 %
- 65 C : 65 %
- 67 C : 72 %
- 69 C : 80 %
- 72 C : 84 %
- 75 C : 97 %