2 .\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 .\" Copyright (c) 2019 Andriy Gapon <avg@FreeBSD.org>
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .Nd Super I/O controller and bus driver
36 To compile this driver into the kernel,
37 place the following line in your
38 kernel configuration file:
39 .Bd -ragged -offset indent
43 Alternatively, to load the driver as a
44 module at boot time, place the following line in
46 .Bd -literal -offset indent
50 Super I/O is an I/O controller that combines various low-bandwidth devices
51 that can be functionally unrelated otherwise.
52 A typical Super I/O can contain devices such as
55 a floppy disk controller
61 a PS/2 mouse and keyboard controller
63 a hardware monitoring controller
67 a controller for general purpose input-output
72 driver provides support for devices residing in the Super I/O controller
73 that can only be accessed or discovered using the controller's interface.
74 Some of the Super I/O devices have standardized interfaces.
75 Such devices either use well-known legacy resources or they are advertised
77 They can be configured either using ISA bus hints or they are auto-configured by
81 driver is not designed to interact with that kind of devices.
82 They can be handled by their respective drivers without any knowledge of the
86 provides access to the floppy disk controller.
88 There are other Super I/O devices that do not have any standardized interface.
89 Drivers for those devices can be written using facilities of the
93 The driver itself attaches to the ISA bus as all supported controllers are
94 accessed via LPC I/O ports.
98 driver is unusual as it is both a controller driver for a variety of Super I/O
99 controllers and a bus driver for supported devices in those controllers.
103 driver supports a multitude of Super I/O controllers produced by Nuvoton,
104 formerly known as Winbond, and ITE.
110 driver was written by
111 .An Andriy Gapon Aq Mt avg@FreeBSD.org .