Module Name: src
Committed By: pgoyette
Date: Mon Mar 1 03:15:16 UTC 2010
Modified Files:
src/share/man/man4: dbcool.4
Log Message:
Update for changes in sensor limit handling
To generate a diff of this commit:
cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/dbcool.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/dbcool.4
diff -u src/share/man/man4/dbcool.4:1.6 src/share/man/man4/dbcool.4:1.7
--- src/share/man/man4/dbcool.4:1.6 Thu Feb 25 17:08:01 2010
+++ src/share/man/man4/dbcool.4 Mon Mar 1 03:15:16 2010
@@ -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.
