[src/trunk]: src/share/man/man4 Mention supported chips and their differences.

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

details:   https://anonhg.NetBSD.org/src/rev/7d8df2a2abb9
branches:  trunk
changeset: 342655:7d8df2a2abb9
user:      jdc <jdc%NetBSD.org@localhost>
date:      Sun Jan 03 17:28:46 2016 +0000

description:
Mention supported chips and their differences.
Mention display and setting of chip temperature limits.

diffstat:

 share/man/man4/lmtemp.4 |  47 ++++++++++++++++++++++++++---------------------
 1 files changed, 26 insertions(+), 21 deletions(-)

diffs (79 lines):

diff -r 1c1b989ab234 -r 7d8df2a2abb9 share/man/man4/lmtemp.4
--- a/share/man/man4/lmtemp.4   Sun Jan 03 17:28:33 2016 +0000
+++ b/share/man/man4/lmtemp.4   Sun Jan 03 17:28:46 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: lmtemp.4,v 1.3 2012/10/08 17:56:59 njoly Exp $
+.\"    $NetBSD: lmtemp.4,v 1.4 2016/01/03 17:28:46 jdc Exp $
 .\"
 .\" Copyright (c) 2005 KIYOHARA Takashi
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 4, 2008
+.Dd January 1, 2016
 .Dt LMTEMP 4
 .Os
 .Sh NAME
@@ -37,18 +37,13 @@
 .Nm
 driver provides support for the
 .Tn National Semiconductor
-LM on iicbus series temperatures and register compatible chips to be used
-with the
-.Xr envsys 4
-API.
-The
-.Nm
-supports ranges of the temperature between +125 from -55.
+LM on iicbus series temperature sensors and register compatible chips.
 .Pp
 Each device is specified by the value of the address and flags.
-.Bl -column "Temperature" "0x48 - 0x4f" "flags" -offset indent
-.It Sy "Temperature" Ta Sy "addr" Ta Sy "flags"
+.Bl -column "Device" "0x48 - 0x4f" "flags" -offset indent
+.It Sy "Device" Ta Sy "addr" Ta Sy "flags"
 .It Li "LM75" Ta "0x48 - 0x4f" Ta "0x0000"
+.It Li "LM75A" Ta "0x48 - 0x4f" Ta "0x0000"
 .It Li "DS75" Ta "0x48 - 0x4f" Ta "0x0001"
 .It Li "LM77" Ta "0x48 - 0x4b" Ta "0x0002"
 .El
@@ -56,17 +51,27 @@
 Chips supported by the
 .Nm
 driver include:
-.Bl -item -offset indent
-.It
-.Tn National Semiconductor
-.Em LM75
-.It
-.Tn National Semiconductor
-.Em LM77
-.It
-.Tn Dallas Semiconductor
-.Em DS75
+.Bl -column "National Semiconductor LM75" "-55 \(en +125" "Resolution" \
+-offset indent
+.It Sy "Device" Ta Sy "Range" Ta Sy "Resolution"
+.It Li "National Semiconductor LM75" Ta "-55 \(en +125" Ta "0.5 degC"
+.It Li "Texas Instruments LM75A" Ta "-55 \(en +125" Ta "0.5 degC"
+.It Li "Dallas Semiconductor DS75" Ta "-55 \(en +125" Ta "0.0625 degC"
+.It Li "National Semiconductor LM77" Ta "-55 \(en +130" Ta "0.5 degC"
 .El
+.Pp
+The LM75, LM75A, and DS75 have a programmable high temperature limit.
+When this is exceeded, the device asserts an over-temperature output.
+.Pp
+The LM77 has programmable low and high temperature limits.
+Exceeding either of these causes the device to assert an interrupt output.
+It also has a programmable critical high temperature limit, and
+exceeding this causes the device to assert a separate critical alarm
+output.
+.Pp
+The sensor and limit values are made available through the
+.Xr envstat 8
+interface.
 .Sh SEE ALSO
 .Xr envsys 4 ,
 .Xr envstat 8