327 lines
10 KiB
ReStructuredText
327 lines
10 KiB
ReStructuredText
=====================
|
|
Kernel driver asc7621
|
|
=====================
|
|
|
|
Supported chips:
|
|
|
|
Andigilog aSC7621 and aSC7621a
|
|
|
|
Prefix: 'asc7621'
|
|
|
|
Addresses scanned: I2C 0x2c, 0x2d, 0x2e
|
|
|
|
Datasheet: http://www.fairview5.com/linux/asc7621/asc7621.pdf
|
|
|
|
Author:
|
|
George Joseph
|
|
|
|
Description provided by Dave Pivin @ Andigilog:
|
|
|
|
Andigilog has both the PECI and pre-PECI versions of the Heceta-6, as
|
|
Intel calls them. Heceta-6e has high frequency PWM and Heceta-6p has
|
|
added PECI and a 4th thermal zone. The Andigilog aSC7611 is the
|
|
Heceta-6e part and aSC7621 is the Heceta-6p part. They are both in
|
|
volume production, shipping to Intel and their subs.
|
|
|
|
We have enhanced both parts relative to the governing Intel
|
|
specification. First enhancement is temperature reading resolution. We
|
|
have used registers below 20h for vendor-specific functions in addition
|
|
to those in the Intel-specified vendor range.
|
|
|
|
Our conversion process produces a result that is reported as two bytes.
|
|
The fan speed control uses this finer value to produce a "step-less" fan
|
|
PWM output. These two bytes are "read-locked" to guarantee that once a
|
|
high or low byte is read, the other byte is locked-in until after the
|
|
next read of any register. So to get an atomic reading, read high or low
|
|
byte, then the very next read should be the opposite byte. Our data
|
|
sheet says 10-bits of resolution, although you may find the lower bits
|
|
are active, they are not necessarily reliable or useful externally. We
|
|
chose not to mask them.
|
|
|
|
We employ significant filtering that is user tunable as described in the
|
|
data sheet. Our temperature reports and fan PWM outputs are very smooth
|
|
when compared to the competition, in addition to the higher resolution
|
|
temperature reports. The smoother PWM output does not require user
|
|
intervention.
|
|
|
|
We offer GPIO features on the former VID pins. These are open-drain
|
|
outputs or inputs and may be used as general purpose I/O or as alarm
|
|
outputs that are based on temperature limits. These are in 19h and 1Ah.
|
|
|
|
We offer flexible mapping of temperature readings to thermal zones. Any
|
|
temperature may be mapped to any zone, which has a default assignment
|
|
that follows Intel's specs.
|
|
|
|
Since there is a fan to zone assignment that allows for the "hotter" of
|
|
a set of zones to control the PWM of an individual fan, but there is no
|
|
indication to the user, we have added an indicator that shows which zone
|
|
is currently controlling the PWM for a given fan. This is in register
|
|
00h.
|
|
|
|
Both remote diode temperature readings may be given an offset value such
|
|
that the reported reading as well as the temperature used to determine
|
|
PWM may be offset for system calibration purposes.
|
|
|
|
PECI Extended configuration allows for having more than two domains per
|
|
PECI address and also provides an enabling function for each PECI
|
|
address. One could use our flexible zone assignment to have a zone
|
|
assigned to up to 4 PECI addresses. This is not possible in the default
|
|
Intel configuration. This would be useful in multi-CPU systems with
|
|
individual fans on each that would benefit from individual fan control.
|
|
This is in register 0Eh.
|
|
|
|
The tachometer measurement system is flexible and able to adapt to many
|
|
fan types. We can also support pulse-stretched PWM so that 3-wire fans
|
|
may be used. These characteristics are in registers 04h to 07h.
|
|
|
|
Finally, we have added a tach disable function that turns off the tach
|
|
measurement system for individual tachs in order to save power. That is
|
|
in register 75h.
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
aSC7621 Product Description
|
|
===========================
|
|
|
|
The aSC7621 has a two wire digital interface compatible with SMBus 2.0.
|
|
Using a 10-bit ADC, the aSC7621 measures the temperature of two remote diode
|
|
connected transistors as well as its own die. Support for Platform
|
|
Environmental Control Interface (PECI) is included.
|
|
|
|
Using temperature information from these four zones, an automatic fan speed
|
|
control algorithm is employed to minimize acoustic impact while achieving
|
|
recommended CPU temperature under varying operational loads.
|
|
|
|
To set fan speed, the aSC7621 has three independent pulse width modulation
|
|
(PWM) outputs that are controlled by one, or a combination of three,
|
|
temperature zones. Both high- and low-frequency PWM ranges are supported.
|
|
|
|
The aSC7621 also includes a digital filter that can be invoked to smooth
|
|
temperature readings for better control of fan speed and minimum acoustic
|
|
impact.
|
|
|
|
The aSC7621 has tachometer inputs to measure fan speed on up to four fans.
|
|
Limit and status registers for all measured values are included to alert
|
|
the system host that any measurements are outside of programmed limits
|
|
via status registers.
|
|
|
|
System voltages of VCCP, 2.5V, 3.3V, 5.0V, and 12V motherboard power are
|
|
monitored efficiently with internal scaling resistors.
|
|
|
|
Features
|
|
--------
|
|
|
|
- Supports PECI interface and monitors internal and remote thermal diodes
|
|
- 2-wire, SMBus 2.0 compliant, serial interface
|
|
- 10-bit ADC
|
|
- Monitors VCCP, 2.5V, 3.3V, 5.0V, and 12V motherboard/processor supplies
|
|
- Programmable autonomous fan control based on temperature readings
|
|
- Noise filtering of temperature reading for fan speed control
|
|
- 0.25C digital temperature sensor resolution
|
|
- 3 PWM fan speed control outputs for 2-, 3- or 4-wire fans and up to 4 fan
|
|
tachometer inputs
|
|
- Enhanced measured temperature to Temperature Zone assignment.
|
|
- Provides high and low PWM frequency ranges
|
|
- 3 GPIO pins for custom use
|
|
- 24-Lead QSOP package
|
|
|
|
Configuration Notes
|
|
===================
|
|
|
|
Except where noted below, the sysfs entries created by this driver follow
|
|
the standards defined in "sysfs-interface".
|
|
|
|
temp1_source
|
|
= ===============================================
|
|
0 (default) peci_legacy = 0, Remote 1 Temperature
|
|
peci_legacy = 1, PECI Processor Temperature 0
|
|
1 Remote 1 Temperature
|
|
2 Remote 2 Temperature
|
|
3 Internal Temperature
|
|
4 PECI Processor Temperature 0
|
|
5 PECI Processor Temperature 1
|
|
6 PECI Processor Temperature 2
|
|
7 PECI Processor Temperature 3
|
|
= ===============================================
|
|
|
|
temp2_source
|
|
= ===============================================
|
|
0 (default) Internal Temperature
|
|
1 Remote 1 Temperature
|
|
2 Remote 2 Temperature
|
|
3 Internal Temperature
|
|
4 PECI Processor Temperature 0
|
|
5 PECI Processor Temperature 1
|
|
6 PECI Processor Temperature 2
|
|
7 PECI Processor Temperature 3
|
|
= ===============================================
|
|
|
|
temp3_source
|
|
= ===============================================
|
|
0 (default) Remote 2 Temperature
|
|
1 Remote 1 Temperature
|
|
2 Remote 2 Temperature
|
|
3 Internal Temperature
|
|
4 PECI Processor Temperature 0
|
|
5 PECI Processor Temperature 1
|
|
6 PECI Processor Temperature 2
|
|
7 PECI Processor Temperature 3
|
|
= ===============================================
|
|
|
|
temp4_source
|
|
= ===============================================
|
|
0 (default) peci_legacy = 0, PECI Processor Temperature 0
|
|
peci_legacy = 1, Remote 1 Temperature
|
|
1 Remote 1 Temperature
|
|
2 Remote 2 Temperature
|
|
3 Internal Temperature
|
|
4 PECI Processor Temperature 0
|
|
5 PECI Processor Temperature 1
|
|
6 PECI Processor Temperature 2
|
|
7 PECI Processor Temperature 3
|
|
= ===============================================
|
|
|
|
temp[1-4]_smoothing_enable / temp[1-4]_smoothing_time
|
|
Smooths spikes in temp readings caused by noise.
|
|
Valid values in milliseconds are:
|
|
|
|
* 35000
|
|
* 17600
|
|
* 11800
|
|
* 7000
|
|
* 4400
|
|
* 3000
|
|
* 1600
|
|
* 800
|
|
|
|
temp[1-4]_crit
|
|
When the corresponding zone temperature reaches this value,
|
|
ALL pwm outputs will got to 100%.
|
|
|
|
temp[5-8]_input / temp[5-8]_enable
|
|
The aSC7621 can also read temperatures provided by the processor
|
|
via the PECI bus. Usually these are "core" temps and are relative
|
|
to the point where the automatic thermal control circuit starts
|
|
throttling. This means that these are usually negative numbers.
|
|
|
|
pwm[1-3]_enable
|
|
=============== ========================================================
|
|
0 Fan off.
|
|
1 Fan on manual control.
|
|
2 Fan on automatic control and will run at the minimum pwm
|
|
if the temperature for the zone is below the minimum.
|
|
3 Fan on automatic control but will be off if the
|
|
temperature for the zone is below the minimum.
|
|
4-254 Ignored.
|
|
255 Fan on full.
|
|
=============== ========================================================
|
|
|
|
pwm[1-3]_auto_channels
|
|
Bitmap as described in sysctl-interface with the following
|
|
exceptions...
|
|
|
|
Only the following combination of zones (and their corresponding masks)
|
|
are valid:
|
|
|
|
* 1
|
|
* 2
|
|
* 3
|
|
* 2,3
|
|
* 1,2,3
|
|
* 4
|
|
* 1,2,3,4
|
|
|
|
* Special values:
|
|
|
|
== ======================
|
|
0 Disabled.
|
|
16 Fan on manual control.
|
|
31 Fan on full.
|
|
== ======================
|
|
|
|
|
|
pwm[1-3]_invert
|
|
When set, inverts the meaning of pwm[1-3].
|
|
i.e. when pwm = 0, the fan will be on full and
|
|
when pwm = 255 the fan will be off.
|
|
|
|
pwm[1-3]_freq
|
|
PWM frequency in Hz
|
|
Valid values in Hz are:
|
|
|
|
* 10
|
|
* 15
|
|
* 23
|
|
* 30 (default)
|
|
* 38
|
|
* 47
|
|
* 62
|
|
* 94
|
|
* 23000
|
|
* 24000
|
|
* 25000
|
|
* 26000
|
|
* 27000
|
|
* 28000
|
|
* 29000
|
|
* 30000
|
|
|
|
Setting any other value will be ignored.
|
|
|
|
peci_enable
|
|
Enables or disables PECI
|
|
|
|
peci_avg
|
|
Input filter average time.
|
|
|
|
* 0 0 Sec. (no Smoothing) (default)
|
|
* 1 0.25 Sec.
|
|
* 2 0.5 Sec.
|
|
* 3 1.0 Sec.
|
|
* 4 2.0 Sec.
|
|
* 5 4.0 Sec.
|
|
* 6 8.0 Sec.
|
|
* 7 0.0 Sec.
|
|
|
|
peci_legacy
|
|
= ============================================
|
|
0 Standard Mode (default)
|
|
Remote Diode 1 reading is associated with
|
|
Temperature Zone 1, PECI is associated with
|
|
Zone 4
|
|
|
|
1 Legacy Mode
|
|
PECI is associated with Temperature Zone 1,
|
|
Remote Diode 1 is associated with Zone 4
|
|
= ============================================
|
|
|
|
peci_diode
|
|
Diode filter
|
|
|
|
= ====================
|
|
0 0.25 Sec.
|
|
1 1.1 Sec.
|
|
2 2.4 Sec. (default)
|
|
3 3.4 Sec.
|
|
4 5.0 Sec.
|
|
5 6.8 Sec.
|
|
6 10.2 Sec.
|
|
7 16.4 Sec.
|
|
= ====================
|
|
|
|
peci_4domain
|
|
Four domain enable
|
|
|
|
= ===============================================
|
|
0 1 or 2 Domains for enabled processors (default)
|
|
1 3 or 4 Domains for enabled processors
|
|
= ===============================================
|
|
|
|
peci_domain
|
|
Domain
|
|
|
|
= ==================================================
|
|
0 Processor contains a single domain (0) (default)
|
|
1 Processor contains two domains (0,1)
|
|
= ==================================================
|