Update for changes in sensor limit handling

This commit is contained in:
pgoyette 2010-03-01 03:15:16 +00:00
parent 7e73c12204
commit 1843b8571b

View File

@ -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 @@ dbCool environmental monitor chips to be used with the
.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 @@ Not all of the following sensors are supported on all chips.
.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 @@ and
.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 @@ value, the fan controller will turn off the fan.
(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 @@ The
.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 @@ dbcool0 {
}
}
.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 @@ device appeared in
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.