[src/uebayasi-xip]: src/share/man/man4 New wbsio(4) driver for Winbond Super ...

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

details:   https://anonhg.NetBSD.org/src/rev/322f20e8285e
branches:  uebayasi-xip
changeset: 751582:322f20e8285e
user:      cnst <cnst%NetBSD.org@localhost>
date:      Sun Feb 21 05:16:30 2010 +0000

description:
New wbsio(4) driver for Winbond Super I/O attachment of lm(4) on any port.

    http://mail-index.netbsd.org/tech-kern/2010/02/17/msg007338.html

Reviewed by <pgoyette>, <tech-kern>.

diffstat:

 share/man/man4/lm.4    |  130 +++++++++++++++++++++++++++++++++++++++++++++++++
 share/man/man4/wbsio.4 |   58 +++++++++++++++++++++
 2 files changed, 188 insertions(+), 0 deletions(-)

diffs (196 lines):

diff -r 740ef2074ba2 -r 322f20e8285e share/man/man4/lm.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/lm.4       Sun Feb 21 05:16:30 2010 +0000
@@ -0,0 +1,130 @@
+.\"    $NetBSD: lm.4,v 1.32.2.2 2010/02/21 05:16:30 cnst Exp $
+.\"
+.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Bill Squier.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd February 16, 2010
+.Dt LM 4
+.Os
+.Sh NAME
+.Nm lm
+.Nd National Semiconductor LM78, LM79 and compatible hardware monitors
+.Sh SYNOPSIS
+.Cd "lm0 at isa? port 0x280 flags 0x00"
+.Cd "lm1 at isa? port 0x290 flags 0x00"
+.Cd "lm2 at isa? port 0x310 flags 0x00"
+.Cd "lm3 at isa? port 0xa00 flags 0x00"
+.Cd "lm0 at pnpbios0 index ? flags 0x00"
+.Cd "lm0 at iic? addr 0x2e flags 0x00"
+.Cd "lm* at wbsio?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the
+.Tn National Semiconductor
+LM series hardware monitors and register compatible chips to be used with
+the
+.Xr envsys 4
+API.
+.Pp
+Most supported devices possess 11 sensors:
+.Bl -column "Sensor" "Units" "Typical" -offset indent
+.It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use"
+.It Li "IN0" Ta "uV DC" Ta "Core voltage"
+.It Li "IN1" Ta "uV DC" Ta "unknown"
+.It Li "IN2" Ta "uV DC" Ta "+3.3V"
+.It Li "IN3" Ta "uV DC" Ta "+5V"
+.It Li "IN4" Ta "uV DC" Ta "+12V"
+.It Li "IN5" Ta "uV DC" Ta "-12V"
+.It Li "IN6" Ta "uV DC" Ta "-5V"
+.It Li "Temp" Ta "uK" Ta "Motherboard Temperature"
+.It Li "Fan0" Ta "RPM" Ta "Fan"
+.It Li "Fan1" Ta "RPM" Ta "Chassis Fan"
+.It Li "Fan2" Ta "RPM" Ta "Fan"
+.El
+for some devices (most Winbond devices) sensor names and numbers will be
+different.
+.Pp
+Due to hardware limitations, fresh sensor data is only available every
+2 seconds.
+.Sh HARDWARE
+Chips supported by the
+.Nm
+driver include:
+.Pp
+.Bl -item -offset indent
+.It
+.Tn National Semiconductor
+.Em LM78 ,
+.Em LM78-J ,
+.Em LM79
+and
+.Em LM81 .
+.It
+.Tn Winbond
+.Em W83627HF* ,
+.Em W83627THF* ,
+.Em W83627EHF* ,
+.Em W83627DHG* ,
+.Em W83637HF* ,
+.Em W83697HF* ,
+.Em W83781D ,
+.Em W83782D* ,
+.Em W83783S* ,
+.Em W83791D* ,
+.Em W83791SD
+and
+.Em W83792D .
+.It
+.Tn ASUS
+.Em AS99127F .
+.El
+.Pp
+For most of the Winbond chips (identified with a * above), the
+.Em flags
+configuration option can be specified to select the type of temperature
+sensor:
+.Bl -column "flags" "Sensor Type" -offset indent
+.It Sy "flags" Ta Sy "Sensor Type"
+.It Li "0" Ta "Thermistor diode (Power-On default)"
+.It Li "1" Ta "Pentium-II diode"
+.It Li "2" Ta "2N3904 Bipolar"
+.It Li "4" Ta "Thermistor diode"
+.El
+.Sh SEE ALSO
+.Xr envsys 4 ,
+.Xr wbsio 4 ,
+.Xr envstat 8
+.Sh HISTORY
+The
+.Nm
+device appeared in
+.Nx 1.5 .
+.Sh BUGS
+Interrupt support is unimplemented.
+.Pp
+There are currently no known pnpbios IDs assigned to LM chips.
diff -r 740ef2074ba2 -r 322f20e8285e share/man/man4/wbsio.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/wbsio.4    Sun Feb 21 05:16:30 2010 +0000
@@ -0,0 +1,58 @@
+.\"    $NetBSD: wbsio.4,v 1.1.2.2 2010/02/21 05:16:30 cnst Exp $
+.\"    $OpenBSD: wbsio.4,v 1.2 2008/02/17 16:48:47 jmc Exp $
+.\"
+.\" Copyright (c) 2008 Mark Kettenis <kettenis%openbsd.org@localhost>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd February 16, 2010
+.Dt WBSIO 4
+.Os
+.Sh NAME
+.Nm wbsio
+.Nd Winbond LPC Super I/O
+.Sh SYNOPSIS
+.Cd "wbsio* at isa? port 0x2e"
+.Cd "wbsio* at isa? port 0x4e"
+.Cd "lm* at wbsio?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the Winbond LPC Super I/O ICs.
+Only the hardware monitoring function is currently supported.
+.Pp
+Support for the hardware monitor function is provided through the
+.Xr lm 4
+driver.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr isa 4 ,
+.Xr lm 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 4.3 .
+.Nx
+support was added in
+.Nx 6.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Mark Kettenis Aq kettenis%openbsd.org@localhost .
+It was adapted to
+.Nx
+by
+.An Constantine A. Murenin Aq cnst%NetBSD.org@localhost .