[src/trunk]: src/share/man/man4 Update for changes in sensor limit handling

[pgoyette <pgoyette%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/d6043227b163
branches:  trunk
changeset: 752546:d6043227b163
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Mon Mar 01 03:15:16 2010 +0000

description:
Update for changes in sensor limit handling

diffstat:

 share/man/man4/dbcool.4 |  62 ++++++++++++++++--------------------------------
 1 files changed, 21 insertions(+), 41 deletions(-)

diffs (129 lines):

diff -r ae722ab7e1cd -r d6043227b163 share/man/man4/dbcool.4
--- a/share/man/man4/dbcool.4   Mon Mar 01 03:14:49 2010 +0000
+++ b/share/man/man4/dbcool.4   Mon Mar 01 03:15:16 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dbcool.4,v 1.6 2010/02/25 17:08:01 wiz Exp $
+.\"    $NetBSD: dbcool.4,v 1.7 2010/03/01 03:15:16 pgoyette Exp $
 .\"
 .\" Copyright (c) 2008 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 5, 2008
+.Dd February 26, 2010
 .Dt DBCOOL 4
 .Os
 .Sh NAME
@@ -55,7 +55,7 @@
 .Xr envsys 4
 API.
 .Pp
-These chips support up to fourteen sensors.
+These chips support up to fifteen sensors.
 Not all of the following sensors are supported on all chips.
 .Bl -column "Sensor" "Units" "Typical" -offset indent
 .It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use"
@@ -78,17 +78,13 @@
 .It Li "VID" Ta "(none)" Ta "CPU VID code (selected chips only)"
 .El
 .Pp
-Each temperature and voltage sensor has a
-programmable high- and low-limit; fan sensors have only a low-limit.
-The user can set the threshold values using
-.Xr sysctl 8
-.Bd -literal -offset indent
-hw.dbcool0.l_temp.low_lim = 35         degrees C
-hw.dbcool0.l_temp.hi_lim = 75          degrees C
-hw.dbcool0.fan1.low_lim = 300          RPM
-hw.dbcool0.Vcc.low_lim = 2250          milliVolts
-hw.dbcool0.Vcc.hi_lim = 2750           milliVolts
-.Ed
+Each temperature and voltage sensor has programmable hardware
+high- and low-limits; fan sensors have only a low-limit.
+These limits can be set using the
+.Xr envstat 8
+utility.
+Due to hardware limitations, the minimum permissible value for the fan
+speed low-limits is 83 RPM.
 .Pp
 Temperature sensors also have
 .Em Tmin ,
@@ -98,19 +94,12 @@
 .Em Ttherm
 .Xr sysctl 8
 variables; these values are used by the fan speed controllers.
-.Pp
-All
-.Xr sysctl 8
-variables associated with temperature sensors are in units of degC, since
-this is the unit which is programmed into the device registers.
-Limit values for voltage sensors are in millivolts.
-The low limit value for fan sensors is measured in RPM; due to
-the manner in which fan speed is measured, the lowest possible
-value for a fan limit is 83 RPM.
+Their values are in units of degC, since this is the unit which is
+programmed into the device registers.
 .Pp
 All members of the dbCool family support Pulse-Width Modulated (PWM)
 fan speed control based on temperature thresholds - the fan will spin up
-when one or more thermal sensors exceeds its configured
+when its associated thermal sensor(s) exceeds its configured
 .Em Tmin
 value.
 The fan will go faster as the temperature rises, and will slow down
@@ -159,7 +148,7 @@
 (On the ADM1030, the
 value for
 .Em Thyst
-is fixed at 5 degrees C.)
+is fixed at 5 degC.)
 .Pp
 Valid values for the
 .Em behavior
@@ -215,12 +204,12 @@
 .Xr envstat 8
 utility can be used to determine the sensors supported:
 .Bd -literal -offset indent
-            Current  CritMax  CritMin  CritCap     Unit
- l_temp:     44.250                                degC
-r1_temp:     41.250                                degC
+            Current  CritMax  WarnMax  WarnMin  CritMin Unit
+ l_temp:     44.250                                     degC
+r1_temp:     41.250                                     degC
 r2_temp:        N/A
-   Vccp:      0.002                                   V
-    Vcc:      3.351                                   V
+   Vccp:      0.002                                     V
+    Vcc:      3.351                                     V
    fan1:        N/A
    fan2:        N/A
    fan3:        N/A
@@ -244,15 +233,6 @@
         }
 }
 .Ed
-.Pp
-Alternatively, set the following commands in
-.Pa /etc/sysctl.conf
-to perform limit checking in the hardware:
-.Bd -literal -offset indent
-hw.dbcool0.r1_temp.hi_lim = 65
-hw.dbcool0.Vcc.low_lim = 3200000
-hw.dbcool0.Vcc.hi_lim = 3500000
-.Ed
 .Sh SEE ALSO
 .Xr envsys 4 ,
 .Xr iic 4 ,
@@ -268,8 +248,8 @@
 Although the sensor limit registers can be programmed, there is currently
 no use of the dbCool chips' ability to generate an SMBus interrupt when the
 limits are exceeded.
-Limit checking is only performed when the sensor values are polled
-and refreshed.
+Limit checking and event generation are done in software, and are performed
+only when the sensor values are polled and refreshed.
 .Pp
 The ADT7466 chip, although officially a member of the dbCool family, is
 programmed quite differently.