sync README with upstream version
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
This commit is contained in:
70
README
70
README
@@ -2,6 +2,10 @@ Kernel driver it87
|
||||
==================
|
||||
|
||||
Supported chips:
|
||||
* IT8603E/IT8623E
|
||||
Prefix: 'it8603'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
Datasheet: Not publicly available
|
||||
* IT8705F
|
||||
Prefix: 'it87'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
@@ -30,6 +34,14 @@ Supported chips:
|
||||
Prefix: 'it8728'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
Datasheet: Not publicly available
|
||||
* IT8771E
|
||||
Prefix: 'it8771'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
Datasheet: Not publicly available
|
||||
* IT8772E
|
||||
Prefix: 'it8772'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
Datasheet: Not publicly available
|
||||
* IT8781F
|
||||
Prefix: 'it8781'
|
||||
Addresses scanned: from Super I/O config space (8 I/O ports)
|
||||
@@ -53,7 +65,7 @@ Supported chips:
|
||||
|
||||
Authors:
|
||||
Christophe Gauthron
|
||||
Jean Delvare <khali@linux-fr.org>
|
||||
Jean Delvare <jdelvare@suse.de>
|
||||
|
||||
|
||||
Module Parameters
|
||||
@@ -79,7 +91,7 @@ Module Parameters
|
||||
Hardware Interfaces
|
||||
-------------------
|
||||
|
||||
All the chips suported by this driver are LPC Super-I/O chips, accessed
|
||||
All the chips supported by this driver are LPC Super-I/O chips, accessed
|
||||
through the LPC bus (ISA-like I/O ports). The IT8712F additionally has an
|
||||
SMBus interface to the hardware monitoring functions. This driver no
|
||||
longer supports this interface though, as it is slower and less reliable
|
||||
@@ -90,9 +102,9 @@ motherboard models.
|
||||
Description
|
||||
-----------
|
||||
|
||||
This driver implements support for the IT8603E, IT8623E, IT8705F,
|
||||
IT8712F, IT8716F, IT8718F, IT8720F, IT8721F, IT8726F, IT8728F, IT8758E,
|
||||
IT8771E, IT8772E, IT8781F, IT8782F, IT8783E/F, and SiS950 chips.
|
||||
This driver implements support for the IT8603E, IT8623E, IT8705F, IT8712F,
|
||||
IT8716F, IT8718F, IT8720F, IT8721F, IT8726F, IT8728F, IT8758E, IT8771E,
|
||||
IT8772E, IT8781F, IT8782F, IT8783E/F, IT8786E, and SiS950 chips.
|
||||
|
||||
These chips are 'Super I/O chips', supporting floppy disks, infrared ports,
|
||||
joysticks and other miscellaneous stuff. For hardware monitoring, they
|
||||
@@ -112,22 +124,26 @@ the driver won't notice and report changes in the VID value. The two
|
||||
upper VID bits share their pins with voltage inputs (in5 and in6) so you
|
||||
can't have both on a given board.
|
||||
|
||||
The IT8716F, IT8718F, IT8720F, IT8721F/IT8758E, IT8783E/F, and later IT8712F
|
||||
revisions have support for 2 additional fans. The additional fans are supported
|
||||
by the driver.
|
||||
The IT8716F, IT8718F, IT8720F, IT8721F/IT8758E and later IT8712F revisions
|
||||
have support for 2 additional fans. The additional fans are supported by the
|
||||
driver.
|
||||
|
||||
The IT8716F, IT8718F, IT8720F and IT8721F/IT8758E, IT8783E/F, and late IT8712F
|
||||
and IT8705F also have optional 16-bit tachometer counters for fans 1 to 3. This
|
||||
is better (no more fan clock divider mess) but not compatible with the older
|
||||
chips and revisions. The 16-bit tachometer mode is enabled by the driver when
|
||||
one of the above chips is detected.
|
||||
The IT8716F, IT8718F, IT8720F, IT8721F/IT8758E, IT8781F, IT8782F, IT8783E/F,
|
||||
and late IT8712F and IT8705F also have optional 16-bit tachometer counters
|
||||
for fans 1 to 3. This is better (no more fan clock divider mess) but not
|
||||
compatible with the older chips and revisions. The 16-bit tachometer mode
|
||||
is enabled by the driver when one of the above chips is detected.
|
||||
|
||||
The IT8726F is just bit enhanced IT8716F with additional hardware
|
||||
for AMD power sequencing. Therefore the chip will appear as IT8716F
|
||||
to userspace applications.
|
||||
|
||||
The IT8728F is considered compatible with the IT8721F, until a datasheet
|
||||
becomes available (hopefully.)
|
||||
The IT8728F, IT8771E, and IT8772E are considered compatible with the IT8721F,
|
||||
until a datasheet becomes available (hopefully.)
|
||||
|
||||
The IT8603E/IT8623E is a custom design, hardware monitoring part is similar to
|
||||
IT8728F. It only supports 16-bit fan mode, the full speed mode of the
|
||||
fan is not supported (value 0 of pwmX_enable).
|
||||
|
||||
Temperatures are measured in degrees Celsius. An alarm is triggered once
|
||||
when the Overtemperature Shutdown limit is crossed.
|
||||
@@ -145,12 +161,16 @@ alarm is triggered if the voltage has crossed a programmable minimum or
|
||||
maximum limit. Note that minimum in this case always means 'closest to
|
||||
zero'; this is important for negative voltage measurements. All voltage
|
||||
inputs can measure voltages between 0 and 4.08 volts, with a resolution of
|
||||
0.016 volt (except IT8721F/IT8758E and IT8728F: 0.012 volt.) The battery
|
||||
voltage in8 does not have limit registers.
|
||||
0.016 volt (except IT8603E, IT8721F/IT8758E and IT8728F: 0.012 volt.) The
|
||||
battery voltage in8 does not have limit registers.
|
||||
|
||||
On the IT8721F/IT8758E/IT8783E/F, some voltage inputs are internal and scaled
|
||||
inside the chip (in7, in8 and optionally in3). The driver handles this
|
||||
transparently so user-space doesn't have to care.
|
||||
On the IT8603E, IT8721F/IT8758E, IT8781F, IT8782F, and IT8783E/F, some
|
||||
voltage inputs are internal and scaled inside the chip:
|
||||
* in3 (optional)
|
||||
* in7 (optional for IT8781F, IT8782F, and IT8783E/F)
|
||||
* in8 (always)
|
||||
* in9 (relevant for IT8603E only)
|
||||
The driver handles this transparently so user-space doesn't have to care.
|
||||
|
||||
The VID lines (IT8712F/IT8716F/IT8718F/IT8720F) encode the core voltage value:
|
||||
the voltage level your processor should work with. This is hardcoded by
|
||||
@@ -216,3 +236,13 @@ doesn't use CPU cycles.
|
||||
Trip points must be set properly before switching to automatic fan speed
|
||||
control mode. The driver will perform basic integrity checks before
|
||||
actually switching to automatic control mode.
|
||||
|
||||
|
||||
Temperature offset attributes
|
||||
-----------------------------
|
||||
|
||||
The driver supports temp[1-3]_offset sysfs attributes to adjust the reported
|
||||
temperature for thermal diodes or diode-connected thermal transistors.
|
||||
If a temperature sensor is configured for thermistors, the attribute values
|
||||
are ignored. If the thermal sensor type is Intel PECI, the temperature offset
|
||||
must be programmed to the critical CPU temperature.
|
||||
|
Reference in New Issue
Block a user