Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FAND(8) 		     System Manager's Manual			 FAND(8)

NAME
     fand -- daemon to control PWM (Pulse Width Modulation) cooling fans

SYNOPSIS
     fand [options...] temperature_sensor pwm_device
     fand [-s] [options...] temperature_sensor pwm_device

DESCRIPTION
     The fand daemon can be used to control a cooling fan connected to a pwmc(4)
     pwm_device  based	on  the  system  temperature  retrived	from a sysctl(3)
     temperature_sensor PWM parameters.

     temperature_sensor should be the name of the sysctl variable used	to  read
     the  system  temperature.	 pwm_device should be the name of the PWM device
     that controls the system fan. If an unqualified name is provided,	/dev/pwm
     is automatically prepended.

     When  called  with the -s option, fand will print the current status of the
     temperature sensor and the PWM state and exit. This can be useful when  de-
     termining the required temperature multiplier and other options.

     The options are as follows:

     -d duty	     The  duty	cycle  (in nanoseconds or percentage) of the PWM
		     channel for the default (low) temperature	threshold.  Duty
		     is the portion of the period during which the signal is as-
		     serted.

     -D duty	     The  duty	cycle  (in nanoseconds or percentage) of the PWM
		     channel for the high temperature  threshold.  Duty  is  the
		     portion of the period during which the signal is asserted.

     -f 	     Run  fand in the foreground. Also enables more verbose out-
		     put.

     -i seconds      The temperature polling interval, in seconds (Default: 60)

     -I 	     Invert PWM signal polarity

     -K 	     Converts the temperature sensor reading from degrees Kelvin

     -m multiplier   Multiplier applied to reading from temperature sensor  (De-
		     fault: 1.0)

     -o temperature  Temperature to deactivate fan, in A<degree>C (Default: 50)

     -p period	     The  period  in  nanoseconds of the PWM channel for the de-
		     fault (low) temperature threshold (Default: 0)

     -P period	     The period in nanoseconds of the PWM channel for  the  high
		     temperature threshold (Default: 0)

     -r path	     The PID file path (Default: /var/run/fand.pid)

     -s 	     Show current temperature and PWM status, then exit.

     -t temperature  Default  (low) temperature to enable the fan, in A<degree>C
		     (Default: 50)

     -T temperature  High temperature threshold,  in  A<degree>C  (Default:  not
		     set)

     -v 	     Print program version and exit

EXAMPLES
     *	 Using	the "hw.temp.CPU" sensor and the pwmc1.0 controller, run the fan
	 at half duty cycle when the temperature reaches 45C  and  run	at  full
	 when  the  temperature rises above 60C. Disable the fan if the tempera-
	 ture falls below 35C. When reading from the sensor, assume value is  in
	 tenth degrees Kelvin.

	 fand -t 45 -p 50000 -d "50%" -T 60 -o 35 -K -m 0.1 hw.temp.CPU pwmc1.0

SEE ALSO
     sysctl(8), pwm(8)

AUTHORS
     The  fand	utility  and  this  manual  page  were	written by Corey Hinshaw
     <corey@electrickite.org>.

fand 0.2.3			February 10, 2022			 FAND(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fand&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help