diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -251,6 +251,7 @@ ismt.4 \ isp.4 \ ispfw.4 \ + ${_it8613hwm.4} \ ${_itwd.4} \ iwi.4 \ iwifw.4 \ @@ -821,6 +822,7 @@ _igc.4= igc.4 _imcsmb.4= imcsmb.4 _io.4= io.4 +_it8613hwm.4= it8613hwm.4 _itwd.4= itwd.4 _kvmclock.4= kvmclock.4 _mgb.4= mgb.4 diff --git a/share/man/man4/it8613hwm.4 b/share/man/man4/it8613hwm.4 new file mode 100644 --- /dev/null +++ b/share/man/man4/it8613hwm.4 @@ -0,0 +1,87 @@ +.\" +.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD +.\" +.\" Copyright (c) 2022 Johannes Totz +.\" +.\" 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 AUTHOR 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 AUTHOR 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. +.\" +.\" $FreeBSD$ +.\" +.Dd May 5, 2023 +.Dt IT8613HWM 4 +.Os +.Sh NAME +.Nm it8613hwm +.Nd device driver for the ITE IT8613E Super I/O hardware monitor +.Sh SYNOPSIS +To compile this driver into the kernel, place the following lines in your +kernel configuration file: +.Bd -ragged -offset indent +.Cd "device superio" +.Cd "device it8613hwm" +.Ed +.Pp +Alternatively, to load the driver as a module at boot time, place the following +line in +.Xr loader.conf 5 : +.Bd -literal -offset indent +it8613hwm_load="YES" +.Ed +.Sh DESCRIPTION +The +.Nm +driver supports reading the temperature sensor and fan speed from the hardware +monitor present in the IT8613E Super I/O chip. +.Pp +There are 3 temperature sensor channels but not all may be connected on the +mainboard. +These are reported through a sysctl node named +.Va dev.it8613hwm.0.temperature%d , +where %d goes from 0 to 2 inclusive. +.Pp +There are also 3 fan speed channels, again not all of those may be connected on +the mainboard, reported in units of RPM via +.Va dev.it8613hwm.0.fan%d . +.Sh EXAMPLES +To get the current values for all temperature sensors and fans: +.Bd -literal -offset indent +$ sysctl dev.it8613hwm +dev.it8613hwm.0.fan2: 1470 +dev.it8613hwm.0.fan1: 648 +dev.it8613hwm.0.fan0: 0 +dev.it8613hwm.0.temperature2: 35C +dev.it8613hwm.0.temperature1: 40C +dev.it8613hwm.0.temperature0: 49C +.Ed +.Pp +As can be seen in this example, there is no fan connected to fan0. +.Sh SEE ALSO +.Xr superio 4 , +.Xr sysctl 8 +.Sh AUTHORS +.An -nosplit +The driver and manual page was written by +.An Johannes Totz Aq Mt jo@bruelltuete.com . +.Sh BUGS +No public datasheet is available for this chip. +The information to write this driver was obtained through trial-and-error and +datasheets for similar (but ultimately different) chips. diff --git a/share/man/man4/superio.4 b/share/man/man4/superio.4 --- a/share/man/man4/superio.4 +++ b/share/man/man4/superio.4 @@ -26,7 +26,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 11, 2019 +.Dd May 5, 2023 .Dt SUPERIO 4 .Os .Sh NAME @@ -101,16 +101,16 @@ The .Nm driver supports a multitude of Super I/O controllers produced by Nuvoton, -formerly known as Winbond, and ITE. As well as some produced by Fintek, namely: - +formerly known as Winbond, and ITE. +As well as some produced by Fintek, namely: .Bl -bullet -compact .It F81803 .It F81865 .El - .Sh SEE ALSO +.Xr it8613hwm 4 , .Xr superio 9 .Sh HISTORY The