mirror of https://github.com/Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
326 lines
10 KiB
326 lines
10 KiB
===================== |
|
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) |
|
= ==================================================
|
|
|