Kernel driver NCT6775

NCT6775 드라이버가 지원하는 Super I/O 계열

이 드라이버는 기존 W83627EHF 드라이버의 NCT6775F·NCT6776F 지원을 대체합니다. ISA 주소는 각 Super I/O 레지스터에서 얻습니다.

지원 접두사는 `nct6106`, `nct6775`, `nct6776`, `nct6779`, `nct6791`, `nct6792`, `nct6793`, `nct6795`, `nct6796`, `nct6799`입니다. 각 접두사는 원문에 열거된 Nuvoton 칩 묶음과 대응합니다.

NCT6102D·NCT6104D·NCT6106D 데이터시트는 Nuvoton 웹사이트에서 구할 수 있고, 나머지 제품군 데이터시트는 Nuvoton에 요청해야 합니다.

Kernel driver NCT6775
=====================

.. note::

    This driver supersedes the NCT6775F and NCT6776F support in the W83627EHF
    driver.

Supported chips:

  * Nuvoton NCT6102D/NCT6104D/NCT6106D

    Prefix: 'nct6106'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from the Nuvoton web site

  * Nuvoton NCT5572D/NCT6771F/NCT6772F/NCT6775F/W83677HG-I

    Prefix: 'nct6775'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT5573D/NCT5577D/NCT6776D/NCT6776F

    Prefix: 'nct6776'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT5532D/NCT6779D

    Prefix: 'nct6779'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6791D

    Prefix: 'nct6791'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6792D

    Prefix: 'nct6792'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6793D

    Prefix: 'nct6793'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6795D

    Prefix: 'nct6795'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6796D

    Prefix: 'nct6796'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

  * Nuvoton NCT6796D-S/NCT6799D-R

    Prefix: 'nct6799'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

온도·팬·전압 센서와 Thermal Cruise

Guenter Roeck이 작성한 이 드라이버는 NCT6775F·NCT6776F·NCT6779D 및 호환 Super I/O 칩을 지원합니다.

칩은 최대 25개 온도 소스를 지원합니다. 이 중 최대 6개는 직접 센서 입력이고 나머지는 PECI·PCH·SMBUS 같은 특수 소스입니다. 칩에 따라 2~6개 소스를 최소·최대·임계 온도와 비교하며 드라이버는 최대 10개 온도를 사용자에게 보고합니다. 설정된 소스는 `tempX_label`에 표시됩니다.

온도 해상도는 소스와 구성에 따라 1°C 또는 0.5°C입니다. 온도가 상한을 넘으면 경보가 켜지고 히스테리시스 값 아래로 내려갈 때까지 유지됩니다. 온도 경보는 칩 종류에 따라 `temp1`부터 `temp6`까지만 지원됩니다.

팬 회전 센서는 4~5개, 아날로그 전압 센서는 8~15개이며 VID 하나, 비프 경보, 자동 및 수동 팬 제어를 제공합니다. 팬 속도가 프로그램된 하한 아래로 내려가면 경보가 발생합니다. NCT6775F만 1~128의 팬 분주기를 지원하며 드라이버가 무효 판독 시 분주기를 높이고 낮은 판독 시 줄여 자동 최적화합니다.

전압은 mV로 보고되고 최소·최대 한계 위반 시 경보가 발생합니다. Thermal Cruise는 측정 온도를 미리 정한 범위에 유지하도록 fan1~fan5를 느리게 또는 빠르게 조정합니다.

Authors:

        Guenter Roeck <linux@roeck-us.net>

Description
-----------

This driver implements support for the Nuvoton NCT6775F, NCT6776F, and NCT6779D
and compatible super I/O chips.

The chips support up to 25 temperature monitoring sources. Up to 6 of those are
direct temperature sensor inputs, the others are special sources such as PECI,
PCH, and SMBUS. Depending on the chip type, 2 to 6 of the temperature sources
can be monitored and compared against minimum, maximum, and critical
temperatures. The driver reports up to 10 of the temperatures to the user.
There are 4 to 5 fan rotation speed sensors, 8 to 15 analog voltage sensors,
one VID, alarms with beep warnings (control unimplemented), and some automatic
fan regulation strategies (plus manual fan control mode).

The temperature sensor sources on all chips are configurable. The configured
source for each of the temperature sensors is provided in tempX_label.

Temperatures are measured in degrees Celsius and measurement resolution is
either 1 degC or 0.5 degC, depending on the temperature source and
configuration. An alarm is triggered when the temperature gets higher than
the high limit; it stays on until the temperature falls below the hysteresis
value. Alarms are only supported for temp1 to temp6, depending on the chip type.

Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
triggered if the rotation speed has dropped below a programmable limit. On
NCT6775F, fan readings can be divided by a programmable divider (1, 2, 4, 8,
16, 32, 64 or 128) to give the readings more range or accuracy; the other chips
do not have a fan speed divider. The driver sets the most suitable fan divisor
itself; specifically, it increases the divider value each time a fan speed
reading returns an invalid value, and it reduces it if the fan speed reading
is lower than optimal. Some fans might not be present because they share pins
with other functions.

Voltage sensors (also known as IN sensors) report their values in millivolts.
An alarm is triggered if the voltage has crossed a programmable minimum
or maximum limit.

The driver supports automatic fan control mode known as Thermal Cruise.
In this mode, the chip attempts to keep the measured temperature in a
predefined temperature range. If the temperature goes out of range, fan
is driven slower/faster to reach the predefined range again.

The mode works for fan1-fan5.

PWM 모드와 보조 온도 제어

`pwm[1-7]`은 0의 최저 속도부터 255의 최대 속도까지 PWM 듀티 또는 DC 팬 속도 값을 저장합니다.

`pwm[1-7]_enable`은 0 비활성화 및 최대 속도, 1 수동, 2 Thermal Cruise, 3 Fan Speed Cruise, 4 NCT6775F 전용 Smart Fan III, 5 Smart Fan IV 모드를 선택합니다. 원문 수동 모드 설명의 `pwm[0-5]` 표기는 그대로 보존합니다.

`pwm[1-7]_mode`는 0 DC 출력과 1 PWM 출력을 선택합니다. `temp_sel`은 기본 온도 센서 인덱스, `weight_temp_sel`은 보조 온도 센서 인덱스이며 0이면 보조 제어를 끕니다.

보조 온도 제어는 `weight_duty_step`, `weight_temp_step`, `weight_temp_step_base`, `weight_temp_step_tol`로 듀티 증가량, 온도 단계, 시작 온도, 허용 오차를 정합니다. 기준 온도를 넘을 때마다 온도 단계에 따라 PWM에 듀티 단계를 더합니다.

sysfs attributes
----------------

pwm[1-7]
    - this file stores PWM duty cycle or DC value (fan speed) in range:

           0 (lowest speed) to 255 (full)

pwm[1-7]_enable
    - this file controls mode of fan/temperature control:

        * 0 Fan control disabled (fans set to maximum speed)
        * 1 Manual mode, write to pwm[0-5] any value 0-255
        * 2 "Thermal Cruise" mode
        * 3 "Fan Speed Cruise" mode
        * 4 "Smart Fan III" mode (NCT6775F only)
        * 5 "Smart Fan IV" mode

pwm[1-7]_mode
    - controls if output is PWM or DC level

        * 0 DC output
        * 1 PWM output

Common fan control attributes
-----------------------------

pwm[1-7]_temp_sel
                        Temperature source. Value is temperature sensor index.
                        For example, select '1' for temp1_input.

pwm[1-7]_weight_temp_sel
                        Secondary temperature source. Value is temperature
                        sensor index. For example, select '1' for temp1_input.
                        Set to 0 to disable secondary temperature control.

If secondary temperature functionality is enabled, it is controlled with the
following attributes.

pwm[1-7]_weight_duty_step
                        Duty step size.

pwm[1-7]_weight_temp_step
                        Temperature step size. With each step over
                        temp_step_base, the value of weight_duty_step is added
                        to the current pwm value.

pwm[1-7]_weight_temp_step_base
                        Temperature at which secondary temperature control kicks
                        in.

pwm[1-7]_weight_temp_step_tol
                        Temperature step tolerance.

Thermal Cruise와 Speed Cruise

Thermal Cruise 모드 2에서는 `target_temp`와 `temp_tolerance`가 목표 온도 구간을 정합니다. 목표 온도 단위는 밀리섭씨이고 범위는 0~127000입니다. 온도가 구간 안에 있으면 팬 속도를 바꾸지 않습니다.

온도가 구간보다 높으면 팬을 빠르게, 낮으면 느리게 합니다. `pwm_start`는 범위 위에서 팬을 시작하는 1~255 값, `pwm_floor`는 범위 아래의 최저 0~255 값이며 0이면 팬 정지를 기대합니다.

`step_up_time`, `step_down_time`, `stop_time`은 각각 속도를 올리기 전, 내리기 전, 팬을 끄기 전의 밀리초 지연입니다.

Speed Cruise 모드 3은 팬 속도를 일정하게 유지하려고 하며 `fan[1-7]_target`과 `_tolerance`로 목표 RPM과 허용 오차를 정합니다. 원문은 이 기능을 시험하지 않았으므로 사용자가 위험을 감수해야 한다고 경고합니다.

Thermal Cruise mode (2)
-----------------------

If the temperature is in the range defined by:

pwm[1-7]_target_temp
                        Target temperature, unit millidegree Celsius
                        (range 0 - 127000)

pwm[1-7]_temp_tolerance
                        Target temperature tolerance, unit millidegree Celsius

There are no changes to fan speed. Once the temperature leaves the interval, fan
speed increases (if temperature is higher that desired) or decreases (if
temperature is lower than desired), using the following limits and time
intervals.

pwm[1-7]_start
                        fan pwm start value (range 1 - 255), to start fan
                        when the temperature is above defined range.

pwm[1-7]_floor
                        lowest fan pwm (range 0 - 255) if temperature is below
                        the defined range. If set to 0, the fan is expected to
                        stop if the temperature is below the defined range.

pwm[1-7]_step_up_time
                        milliseconds before fan speed is increased

pwm[1-7]_step_down_time
                        milliseconds before fan speed is decreased

pwm[1-7]_stop_time
                        how many milliseconds must elapse to switch
                        corresponding fan off (when the temperature was below
                        defined range).

Speed Cruise mode (3)
---------------------

This modes tries to keep the fan speed constant.

fan[1-7]_target
                        Target fan speed

fan[1-7]_tolerance
                        Target speed tolerance


Untested; use at your own risk.

Smart Fan IV 다중 기울기 곡선

Smart Fan IV 모드 5는 여러 기울기로 팬 속도를 제어합니다. 온도가 오르면 칩은 현재 기울기에 따라 DC 또는 PWM 출력을 계산합니다.

칩 종류에 따라 데이터 점은 최대 7개입니다. 뒤의 점일수록 더 높은 온도와 더 높은 PWM 값을 설정해야 온도 상승에 따라 팬 속도가 커집니다. 마지막 점은 팬을 최대 속도로 돌려야 하는 임계 온도 모드입니다.

`auto_point[1-7]_pwm`은 대응 온도 범위에서 쓸 PWM 값, `auto_point[1-7]_temp`는 그 PWM을 활성화하는 온도입니다. `temp_tolerance`, `crit_temp_tolerance`, `step_up_time`, `step_down_time`은 일반·임계 온도 허용 오차와 가감속 지연을 정합니다.

Smart Fan IV mode (5)
---------------------

This mode offers multiple slopes to control the fan speed. The slopes can be
controlled by setting the pwm and temperature attributes. When the temperature
rises, the chip will calculate the DC/PWM output based on the current slope.
There are up to seven data points depending on the chip type. Subsequent data
points should be set to higher temperatures and higher pwm values to achieve
higher fan speeds with increasing temperature. The last data point reflects
critical temperature mode, in which the fans should run at full speed.

pwm[1-7]_auto_point[1-7]_pwm
                        pwm value to be set if temperature reaches matching
                        temperature range.

pwm[1-7]_auto_point[1-7]_temp
                        Temperature over which the matching pwm is enabled.

pwm[1-7]_temp_tolerance
                        Temperature tolerance, unit millidegree Celsius

pwm[1-7]_crit_temp_tolerance
                        Temperature tolerance for critical temperature,
                        unit millidegree Celsius

pwm[1-7]_step_up_time
                        milliseconds before fan speed is increased

pwm[1-7]_step_down_time
                        milliseconds before fan speed is decreased

ASUS CPUTIN과 NCT6799 식별 주의

여러 ASUS NCT6776F 보드에서 CPUTIN은 연결되지 않아 부동하거나 비표준 온도 장치에 연결된 것으로 보입니다. 따라서 값이 비정상적으로 높거나 실제 온도가 오를 때 보고값이 내려갈 수도 있어 유효한 온도로 사용할 수 없습니다.

ASUS 보드에서는 CPUTIN을 무시하고 PECI 0 또는 TSI 0에서 보고되는 CPU 온도를 사용해야 합니다.

NCT6796D-S와 NCT6799D-R은 매우 유사하고 `chip_id`로 서로 다른 버전임을 나타냅니다. 드라이버는 두 칩을 같은 방식으로 처리합니다.

Usage Notes
-----------

On various ASUS boards with NCT6776F, it appears that CPUTIN is not really
connected to anything and floats, or that it is connected to some non-standard
temperature measurement device. As a result, the temperature reported on CPUTIN
will not reflect a usable value. It often reports unreasonably high
temperatures, and in some cases the reported temperature declines if the actual
temperature increases (similar to the raw PECI temperature value - see PECI
specification for details). CPUTIN should therefore be ignored on ASUS
boards. The CPU temperature on ASUS boards is reported from PECI 0 or TSI 0.

NCT6796D-S and NCT6799D-R chips are very similar and their chip_id indicates
they are different versions. This driver treats them the same way.