lm(4) and it(4) drivers for hardware sensors used in many motherboards. Ported
[dragonfly.git] / share / man / man4 / lm.4
bloba353ce5fb32d49cf196a823fbe660df6227c477f
1 .\" $OpenBSD: lm.4,v 1.16 2007/05/26 22:38:55 cnst Exp $
2 .\" $NetBSD: lm.4,v 1.11 2001/09/22 01:22:49 wiz Exp $
3 .\" $DragonFly: src/share/man/man4/lm.4,v 1.1 2007/10/02 13:37:38 hasso Exp $
4 .\"
5 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
6 .\" All rights reserved.
7 .\"
8 .\" This code is derived from software contributed to The NetBSD Foundation
9 .\" by Bill Squier.
10 .\"
11 .\" Redistribution and use in source and binary forms, with or without
12 .\" modification, are permitted provided that the following conditions
13 .\" are met:
14 .\" 1. Redistributions of source code must retain the above copyright
15 .\"    notice, this list of conditions and the following disclaimer.
16 .\" 2. Redistributions in binary form must reproduce the above copyright
17 .\"    notice, this list of conditions and the following disclaimer in the
18 .\"    documentation and/or other materials provided with the distribution.
19 .\" 3. All advertising materials mentioning features or use of this software
20 .\"    must display the following acknowledgement:
21 .\"        This product includes software developed by the NetBSD
22 .\"        Foundation, Inc. and its contributors.
23 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
24 .\"    contributors may be used to endorse or promote products derived
25 .\"    from this software without specific prior written permission.
26 .\"
27 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
28 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
29 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
30 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
31 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 .\" POSSIBILITY OF SUCH DAMAGE.
38 .\"
39 .Dd 19 August 2007
40 .Dt LM 4
41 .Os
42 .Sh NAME
43 .Nm lm
44 .Nd NatSemi LM78/79/81 and Winbond Super I/O Hardware Monitor
45 .Sh SYNOPSIS
46 .Cd "device isa"
47 .Cd "device lm"
48 .Pp
50 .Pa /boot/device.hints :
51 .Cd hint.lm.0.at="isa"
52 .Cd hint.lm.0.port="0x290"
53 .Cd hint.lm.1.at="isa"
54 .Cd hint.lm.1.port="0x280"
55 .Cd hint.lm.2.at="isa"
56 .Cd hint.lm.2.port="0x310"
57 .Sh DESCRIPTION
58 The
59 .Nm
60 driver provides support for the
61 .Tn National Semiconductor
62 LM 78/79/81 and
63 .Tn Winbond
64 Super I/O
65 hardware monitors,
66 and registers compatible chips under the
67 .Va HW_SENSORS
68 .Xr sysctl 3
69 tree.
70 .Sh HARDWARE
71 Chips supported by the
72 .Nm
73 driver include:
74 .Pp
75 .Bl -dash -offset indent -compact
76 .It
77 National Semiconductor LM78 and LM78-J
78 .It
79 National Semiconductor LM79
80 .It
81 National Semiconductor LM81
82 .It
83 Winbond W83627HF, W83627THF, W83637HF and W83697HF
84 .It
85 Winbond W83627DHG and W83627EHF
86 .It
87 Winbond W83781D, W83782D and W83783S
88 .It
89 Winbond W83791D, W83791SD and W83792D
90 .It
91 ASUS AS99127F
92 .El
93 .Sh SEE ALSO
94 .Xr systat 1 ,
95 .Xr sysctl 3 ,
96 .Xr sensorsd 8 ,
97 .Xr sysctl 8
98 .Sh HISTORY
99 The
101 driver first appeared in
102 .Nx 1.5 ;
104 support was added in
105 .Ox 3.4 ;
107 support was added in
108 .Fx 7.XXX .
109 .Sh AUTHORS
110 .An -nosplit
113 driver was written by
114 .An Bill Squier
115 and ported to
116 .Ox 3.4
118 .An Alexander Yurchenko Aq grange@openbsd.org .
119 The driver was largely rewritten for
120 .Ox 3.9
122 .An Mark Kettenis Aq kettenis@openbsd.org .
123 The driver was then ported to
126 .An Constantine A. Murenin Aq cnst@FreeBSD.org 
127 as a part of a Google Summer of Code 2007 project.
128 .Sh CAVEATS
129 Some vendors connect these chips to non-standard thermal diodes and
130 resistors.
131 This will result in bogus sensor values.
132 .Sh BUGS
133 Interrupt support is unimplemented.
135 There are currently no known pnpbios IDs assigned to LM chips.
137 This driver attaches to the Winbond W83791SD chip even though that
138 chip does not have any sensors.