Page MenuHomeFreeBSD
Files F142449784

D39971.id121685.diff
No OneTemporary
Actions

D39971.id121685.diff
View Options

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 8, 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 were 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 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 8, 2023
.Dt SUPERIO 4
.Os
.Sh NAME
@@ -74,11 +74,11 @@
Some of the Super I/O devices have standardized interfaces.
Such devices either use well-known legacy resources or they are advertised
via ACPI or both.
-They can be configured either using ISA bus hints or they are auto-configured by
+They can be either configured using ISA bus hints, or auto-configured by
.Xr acpi 4 .
The
.Nm
-driver is not designed to interact with that kind of devices.
+driver is not designed to interact with that kind of device.
They can be handled by their respective drivers without any knowledge of the
Super I/O specifics.
For instance,
@@ -93,24 +93,23 @@
The driver itself attaches to the ISA bus as all supported controllers are
accessed via LPC I/O ports.
.Pp
-The
.Nm
-driver is unusual as it is both a controller driver for a variety of Super I/O
+is unusual as it is both a controller driver for a variety of Super I/O
controllers and a bus driver for supported devices in those controllers.
.Sh HARDWARE
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:
-
+driver supports a multitude of Super I/O controllers produced by Nuvoton
+(formerly known as Winbond) and ITE.
+Also, these Fintek-produced controllers:
.Bl -bullet -compact
.It
F81803
.It
F81865
.El
-
.Sh SEE ALSO
+.Xr it8613hwm 4 ,
.Xr superio 9
.Sh HISTORY
The

File Metadata

Mime Type
text/plain
Expires
Wed, Jan 21, 2:13 AM (18 h, 56 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
27783240
Default Alt Text
D39971.id121685.diff (5 KB)

Event Timeline