1.\" $NetBSD: lm.4,v 1.38 2022/12/16 00:02:28 msaitoh Exp $ 2.\" 3.\" Copyright (c) 2000 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Bill Squier. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd December 15, 2022 31.Dt LM 4 32.Os 33.Sh NAME 34.Nm lm 35.Nd National Semiconductor LM78, LM79 and compatible hardware monitors 36.Sh SYNOPSIS 37.Cd "lm0 at isa? port 0x280 flags 0x00" 38.Cd "lm1 at isa? port 0x290 flags 0x00" 39.Cd "lm2 at isa? port 0x310 flags 0x00" 40.Cd "lm3 at isa? port 0xa00 flags 0x00" 41.Cd "lm0 at pnpbios0 index ? flags 0x00" 42.Cd "lm0 at iic? addr 0x2e flags 0x00" 43.Cd "lm* at wbsio?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for the National Semiconductor 48LM series hardware monitors and register compatible chips to be used with 49the 50.Xr envsys 4 51API. 52.Pp 53The original LM78 hardware monitor supports 11 sensors: 54.Bl -column "Sensor" "Units" "Typical" -offset indent 55.It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use" 56.It Li "IN0" Ta "uV DC" Ta "Core voltage" 57.It Li "IN1" Ta "uV DC" Ta "unknown" 58.It Li "IN2" Ta "uV DC" Ta "+3.3V" 59.It Li "IN3" Ta "uV DC" Ta "+5V" 60.It Li "IN4" Ta "uV DC" Ta "+12V" 61.It Li "IN5" Ta "uV DC" Ta "-12V" 62.It Li "IN6" Ta "uV DC" Ta "-5V" 63.It Li "Temp" Ta "uK" Ta "Motherboard Temperature" 64.It Li "Fan0" Ta "RPM" Ta "Fan" 65.It Li "Fan1" Ta "RPM" Ta "Chassis Fan" 66.It Li "Fan2" Ta "RPM" Ta "Fan" 67.El 68For other devices, sensors' names and numbers will be different. 69.Pp 70Due to hardware limitations, fresh sensor data is only available every 712 seconds. 72.Sh HARDWARE 73Chips supported by the 74.Nm 75driver include: 76.Bl -item -offset indent 77.It 78National Semiconductor 79.Em LM78 , 80.Em LM78-J , 81.Em LM79 , 82and 83.Em LM81 . 84.It 85Nuvoton 86.Em NCT5104D , 87.Em NCT6775F , 88.Em NCT6776F , 89.Em NCT6102D , 90.Em NCT6104D , 91.Em NCT6106D , 92.Em NCT6779D 93and 94.Em NCT679[12356789]D . 95.It 96Winbond 97.Em W83627HF* , 98.Em W83627THF* , 99.Em W83627EHF* , 100.Em W83627DHG* , 101.Em W83637HF* , 102.Em W83697HF* , 103.Em W83781D , 104.Em W83782D* , 105.Em W83783S* , 106.Em W83791D* , 107.Em W83791SD , 108and 109.Em W83792D . 110.It 111ASUS 112.Em AS99127F . 113.El 114.Pp 115For most of the Winbond chips (identified with a * above), the 116.Em flags 117configuration option can be specified to select the type of temperature 118sensor: 119.Bl -column "flags" "Sensor Type" -offset indent 120.It Sy "flags" Ta Sy "Sensor Type" 121.It Li "0" Ta "Thermistor diode (Power-On default)" 122.It Li "1" Ta "Pentium-II diode" 123.It Li "2" Ta "2N3904 Bipolar" 124.It Li "4" Ta "Thermistor diode" 125.El 126.Sh SEE ALSO 127.Xr envsys 4 , 128.Xr wbsio 4 , 129.Xr envstat 8 130.Sh HISTORY 131The 132.Nm 133device appeared in 134.Nx 1.5 . 135.Sh CAVEATS 136Some vendors connect these chips to non-standard thermal diodes and 137resistors. 138This will result in bogus sensor values. 139.Sh BUGS 140Interrupt support is unimplemented. 141.Pp 142There are currently no known pnpbios IDs assigned to LM chips. 143