xref: /netbsd-src/share/man/man4/lmtemp.4 (revision 519e888126b4f45d8513d75dd61c954151d827cd)
1.\"	$NetBSD: lmtemp.4,v 1.4 2016/01/03 17:28:46 jdc Exp $
2.\"
3.\" Copyright (c) 2005 KIYOHARA Takashi
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Neither the name of the author nor the names of any
12.\"    contributors may be used to endorse or promote products derived
13.\"    from this software without specific prior written permission.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd January 1, 2016
28.Dt LMTEMP 4
29.Os
30.Sh NAME
31.Nm lmtemp
32.Nd National Semiconductor LM75, LM77 and compatible hardware monitors
33.Sh SYNOPSIS
34.Cd "lmtemp0 at iic? addr 0x48 flags 0x0000"
35.Sh DESCRIPTION
36The
37.Nm
38driver provides support for the
39.Tn National Semiconductor
40LM on iicbus series temperature sensors and register compatible chips.
41.Pp
42Each device is specified by the value of the address and flags.
43.Bl -column "Device" "0x48 - 0x4f" "flags" -offset indent
44.It Sy "Device" Ta Sy "addr" Ta Sy "flags"
45.It Li "LM75" Ta "0x48 - 0x4f" Ta "0x0000"
46.It Li "LM75A" Ta "0x48 - 0x4f" Ta "0x0000"
47.It Li "DS75" Ta "0x48 - 0x4f" Ta "0x0001"
48.It Li "LM77" Ta "0x48 - 0x4b" Ta "0x0002"
49.El
50.Sh HARDWARE
51Chips supported by the
52.Nm
53driver include:
54.Bl -column "National Semiconductor LM75" "-55 \(en +125" "Resolution" \
55-offset indent
56.It Sy "Device" Ta Sy "Range" Ta Sy "Resolution"
57.It Li "National Semiconductor LM75" Ta "-55 \(en +125" Ta "0.5 degC"
58.It Li "Texas Instruments LM75A" Ta "-55 \(en +125" Ta "0.5 degC"
59.It Li "Dallas Semiconductor DS75" Ta "-55 \(en +125" Ta "0.0625 degC"
60.It Li "National Semiconductor LM77" Ta "-55 \(en +130" Ta "0.5 degC"
61.El
62.Pp
63The LM75, LM75A, and DS75 have a programmable high temperature limit.
64When this is exceeded, the device asserts an over-temperature output.
65.Pp
66The LM77 has programmable low and high temperature limits.
67Exceeding either of these causes the device to assert an interrupt output.
68It also has a programmable critical high temperature limit, and
69exceeding this causes the device to assert a separate critical alarm
70output.
71.Pp
72The sensor and limit values are made available through the
73.Xr envstat 8
74interface.
75.Sh SEE ALSO
76.Xr envsys 4 ,
77.Xr envstat 8
78.Sh HISTORY
79The
80.Nm
81device appeared in
82.Nx 4.0 .
83.Sh BUGS
84Interrupt support is unimplemented.
85