요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver dme1737
=====================
Supported chips:
* SMSC DME1737 and compatibles (like Asus A8000)
Prefix: 'dme1737'
Addresses scanned: I2C 0x2c, 0x2d, 0x2e
Datasheet: Provided by SMSC upon request and under NDA
* SMSC SCH3112, SCH3114, SCH3116
Prefix: 'sch311x'
Addresses scanned: none, address read from Super-I/O config space
Datasheet: Available on the Internet
* SMSC SCH5027
Prefix: 'sch5027'
Addresses scanned: I2C 0x2c, 0x2d, 0x2e
Datasheet: Provided by SMSC upon request and under NDA
* SMSC SCH5127
Prefix: 'sch5127'
Addresses scanned: none, address read from Super-I/O config space
Datasheet: Provided by SMSC upon request and under NDA
Authors:
Juerg Haefliger <[email protected]>
Module Parameters
-----------------
* force_start: bool
Enables the monitoring of voltage, fan and temp inputs
and PWM output control functions. Using this parameter
shouldn't be required since the BIOS usually takes care
of this.
* probe_all_addr: bool
Include non-standard LPC addresses 0x162e and 0x164e
when probing for ISA devices. This is required for the
following boards:
- VIA EPIA SN18000
Description
-----------
This driver implements support for the hardware monitoring capabilities of the
SMSC DME1737 and Asus A8000 (which are the same), SMSC SCH5027, SCH311x,
and SCH5127 Super-I/O chips. These chips feature monitoring of 3 temp sensors
temp[1-3] (2 remote diodes and 1 internal), 8 voltages in[0-7] (7 external and
1 internal) and up to 6 fan speeds fan[1-6]. Additionally, the chips implement
up to 5 PWM outputs pwm[1-3,5-6] for controlling fan speeds both manually and
automatically.
For the DME1737, A8000 and SCH5027, fan[1-2] and pwm[1-2] are always present.
Fan[3-6] and pwm[3,5-6] are optional features and their availability depends on
the configuration of the chip. The driver will detect which features are
present during initialization and create the sysfs attributes accordingly.
For the SCH311x and SCH5127, fan[1-3] and pwm[1-3] are always present and
fan[4-6] and pwm[5-6] don't exist.
The hardware monitoring features of the DME1737, A8000, and SCH5027 are only
accessible via SMBus, while the SCH311x and SCH5127 only provide access via
the ISA bus. The driver will therefore register itself as an I2C client driver
if it detects a DME1737, A8000, or SCH5027 and as a platform driver if it
detects a SCH311x or SCH5127 chip.
Voltage Monitoring
------------------
The voltage inputs are sampled with 12-bit resolution and have internal
scaling resistors. The values returned by the driver therefore reflect true
millivolts and don't need scaling. The voltage inputs are mapped as follows
(the last column indicates the input ranges):
DME1737, A8000::
in0: +5VTR (+5V standby) 0V - 6.64V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: +5V 0V - 6.64V
in4: +12V 0V - 16V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH311x::
in0: +2.5V 0V - 3.32V
in1: Vccp (processor core) 0V - 2V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: +5V 0V - 6.64V
in4: +12V 0V - 16V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH5027::
in0: +5VTR (+5V standby) 0V - 6.64V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: V2_IN 0V - 1.5V
in4: V1_IN 0V - 1.5V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH5127::
in0: +2.5 0V - 3.32V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: V2_IN 0V - 1.5V
in4: V1_IN 0V - 1.5V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
in7: Vtrip (+1.5V) 0V - 1.99V
Each voltage input has associated min and max limits which trigger an alarm
when crossed.
Temperature Monitoring
----------------------
Temperatures are measured with 12-bit resolution and reported in millidegree
Celsius. The chip also features offsets for all 3 temperature inputs which -
when programmed - get added to the input readings. The chip does all the
scaling by itself and the driver therefore reports true temperatures that don't
need any user-space adjustments. The temperature inputs are mapped as follows
(the last column indicates the input ranges)::
temp1: Remote diode 1 (3904 type) temperature -127C - +127C
temp2: DME1737 internal temperature -127C - +127C
temp3: Remote diode 2 (3904 type) temperature -127C - +127C
Each temperature input has associated min and max limits which trigger an alarm
when crossed. Additionally, each temperature input has a fault attribute that
returns 1 when a faulty diode or an unconnected input is detected and 0
otherwise.
Fan Monitoring
--------------
Fan RPMs are measured with 16-bit resolution. The chip provides inputs for 6
fan tachometers. All 6 inputs have an associated min limit which triggers an
alarm when crossed. Fan inputs 1-4 provide type attributes that need to be set
to the number of pulses per fan revolution that the connected tachometer
generates. Supported values are 1, 2, and 4. Fan inputs 5-6 only support fans
that generate 2 pulses per revolution. Fan inputs 5-6 also provide a max
attribute that needs to be set to the maximum attainable RPM (fan at 100% duty-
cycle) of the input. The chip adjusts the sampling rate based on this value.
PWM Output Control
------------------
This chip features 5 PWM outputs. PWM outputs 1-3 are associated with fan
inputs 1-3 and PWM outputs 5-6 are associated with fan inputs 5-6. PWM outputs
1-3 can be configured to operate either in manual or automatic mode by setting
the appropriate enable attribute accordingly. PWM outputs 5-6 can only operate
in manual mode, their enable attributes are therefore read-only. When set to
manual mode, the fan speed is set by writing the duty-cycle value to the
appropriate PWM attribute. In automatic mode, the PWM attribute returns the
current duty-cycle as set by the fan controller in the chip. All PWM outputs
support the setting of the output frequency via the freq attribute.
In automatic mode, the chip supports the setting of the PWM ramp rate which
defines how fast the PWM output is adjusting to changes of the associated
temperature input. Associating PWM outputs to temperature inputs is done via
temperature zones. The chip features 3 zones whose assignments to temperature
inputs is static and determined during initialization. These assignments can
be retrieved via the zone[1-3]_auto_channels_temp attributes. Each PWM output
is assigned to one (or hottest of multiple) temperature zone(s) through the
pwm[1-3]_auto_channels_zone attributes. Each PWM output has 3 distinct output
duty-cycles: full, low, and min. Full is internally hard-wired to 255 (100%)
and low and min can be programmed via pwm[1-3]_auto_point1_pwm and
pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds of the zones are
programmed via zone[1-3]_auto_point[1-3]_temp and
zone[1-3]_auto_point1_temp_hyst:
=============================== =======================================
pwm[1-3]_auto_point2_pwm full-speed duty-cycle (255, i.e., 100%)
pwm[1-3]_auto_point1_pwm low-speed duty-cycle
pwm[1-3]_auto_pwm_min min-speed duty-cycle
zone[1-3]_auto_point3_temp full-speed temp (all outputs)
zone[1-3]_auto_point2_temp full-speed temp
zone[1-3]_auto_point1_temp low-speed temp
zone[1-3]_auto_point1_temp_hyst min-speed temp
=============================== =======================================
The chip adjusts the output duty-cycle linearly in the range of auto_point1_pwm
to auto_point2_pwm if the temperature of the associated zone is between
auto_point1_temp and auto_point2_temp. If the temperature drops below the
auto_point1_temp_hyst value, the output duty-cycle is set to the auto_pwm_min
value which only supports two values: 0 or auto_point1_pwm. That means that the
fan either turns completely off or keeps spinning with the low-speed
duty-cycle. If any of the temperatures rise above the auto_point3_temp value,
all PWM outputs are set to 100% duty-cycle.
Following is another representation of how the chip sets the output duty-cycle
based on the temperature of the associated thermal zone:
=============== =============== =================
Temperature Duty-Cycle Duty-Cycle
Rising Temp Falling Temp
=============== =============== =================
full-speed full-speed full-speed
- < linearly -
adjusted
duty-cycle >
low-speed low-speed low-speed
- min-speed low-speed
min-speed min-speed min-speed
- min-speed min-speed
=============== =============== =================
Sysfs Attributes
----------------
Following is a list of all sysfs attributes that the driver provides, their
permissions and a short description:
=============================== ======= =======================================
Name Perm Description
=============================== ======= =======================================
cpu0_vid RO CPU core reference voltage in
millivolts.
vrm RW Voltage regulator module version
number.
in[0-7]_input RO Measured voltage in millivolts.
in[0-7]_min RW Low limit for voltage input.
in[0-7]_max RW High limit for voltage input.
in[0-7]_alarm RO Voltage input alarm. Returns 1 if
voltage input is or went outside the
associated min-max range, 0 otherwise.
temp[1-3]_input RO Measured temperature in millidegree
Celsius.
temp[1-3]_min RW Low limit for temp input.
temp[1-3]_max RW High limit for temp input.
temp[1-3]_offset RW Offset for temp input. This value will
be added by the chip to the measured
temperature.
temp[1-3]_alarm RO Alarm for temp input. Returns 1 if temp
input is or went outside the associated
min-max range, 0 otherwise.
temp[1-3]_fault RO Temp input fault. Returns 1 if the chip
detects a faulty thermal diode or an
unconnected temp input, 0 otherwise.
zone[1-3]_auto_channels_temp RO Temperature zone to temperature input
mapping. This attribute is a bitfield
and supports the following values:
- 1: temp1
- 2: temp2
- 4: temp3
zone[1-3]_auto_point1_temp_hyst RW Auto PWM temp point1 hysteresis. The
output of the corresponding PWM is set
to the pwm_auto_min value if the temp
falls below the auto_point1_temp_hyst
value.
zone[1-3]_auto_point[1-3]_temp RW Auto PWM temp points. Auto_point1 is
the low-speed temp, auto_point2 is the
full-speed temp, and auto_point3 is the
temp at which all PWM outputs are set
to full-speed (100% duty-cycle).
fan[1-6]_input RO Measured fan speed in RPM.
fan[1-6]_min RW Low limit for fan input.
fan[1-6]_alarm RO Alarm for fan input. Returns 1 if fan
input is or went below the associated
min value, 0 otherwise.
fan[1-4]_type RW Type of attached fan. Expressed in
number of pulses per revolution that
the fan generates. Supported values are
1, 2, and 4.
fan[5-6]_max RW Max attainable RPM at 100% duty-cycle.
Required for chip to adjust the
sampling rate accordingly.
pmw[1-3,5-6] RO/RW Duty-cycle of PWM output. Supported
values are 0-255 (0%-100%). Only
writeable if the associated PWM is in
manual mode.
pwm[1-3]_enable RW Enable of PWM outputs 1-3. Supported
values are:
- 0: turned off (output @ 100%)
- 1: manual mode
- 2: automatic mode
pwm[5-6]_enable RO Enable of PWM outputs 5-6. Always
returns 1 since these 2 outputs are
hard-wired to manual mode.
pmw[1-3,5-6]_freq RW Frequency of PWM output. Supported
values are in the range 11Hz-30000Hz
(default is 25000Hz).
pmw[1-3]_ramp_rate RW Ramp rate of PWM output. Determines how
fast the PWM duty-cycle will change
when the PWM is in automatic mode.
Expressed in ms per PWM step. Supported
values are in the range 0ms-206ms
(default is 0, which means the duty-
cycle changes instantly).
pwm[1-3]_auto_channels_zone RW PWM output to temperature zone mapping.
This attribute is a bitfield and
supports the following values:
- 1: zone1
- 2: zone2
- 4: zone3
- 6: highest of zone[2-3]
- 7: highest of zone[1-3]
pwm[1-3]_auto_pwm_min RW Auto PWM min pwm. Minimum PWM duty-
cycle. Supported values are 0 or
auto_point1_pwm.
pwm[1-3]_auto_point1_pwm RW Auto PWM pwm point. Auto_point1 is the
low-speed duty-cycle.
pwm[1-3]_auto_point2_pwm RO Auto PWM pwm point. Auto_point2 is the
full-speed duty-cycle which is hard-
wired to 255 (100% duty-cycle).
=============================== ======= =======================================
Chip Differences
----------------
======================= ======= ======= ======= =======
Feature dme1737 sch311x sch5027 sch5127
======================= ======= ======= ======= =======
temp[1-3]_offset yes yes
vid yes
zone3 yes yes yes
zone[1-3]_hyst yes yes
pwm min/off yes yes
fan3 opt yes opt yes
pwm3 opt yes opt yes
fan4 opt opt
fan5 opt opt
pwm5 opt opt
fan6 opt opt
pwm6 opt opt
in7 yes
======================= ======= ======= ======= =======
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 칩과 module parameter
1-57`dme1737` 커널 드라이버는 SMSC DME1737 및 Asus A8000 같은 compatible chip을 prefix `dme1737`로 지원합니다. I2C 주소 `0x2c`, `0x2d`, `0x2e`를 scan하며 datasheet는 SMSC에 요청하면 NDA 아래 제공됩니다.
SMSC SCH3112, SCH3114, SCH3116은 prefix `sch311x`를 사용합니다. 주소를 scan하지 않고 Super-I/O config space에서 읽으며 datasheet는 Internet에서 구할 수 있습니다.
SMSC SCH5027은 prefix `sch5027`이고 I2C `0x2c`, `0x2d`, `0x2e`를 scan합니다. SMSC SCH5127은 prefix `sch5127`이고 scan 없이 Super-I/O config space에서 주소를 읽습니다. 두 datasheet 모두 요청과 NDA가 필요합니다. 저자는 Juerg Haefliger입니다.
`force_start: bool`은 voltage·fan·temperature input monitoring과 PWM output control을 enable합니다. 보통 BIOS가 처리하므로 이 parameter는 필요하지 않아야 합니다.
`probe_all_addr: bool`은 ISA device를 probe할 때 non-standard LPC address `0x162e`, `0x164e`를 포함합니다. VIA EPIA SN18000 board에는 이 설정이 필요합니다.
Prefix, 탐지 주소와 datasheet 조건입니다.
Chip 계열에 맞는 bus와 선택 parameter를 적용합니다.
Kernel driver dme1737
=====================
Supported chips:
* SMSC DME1737 and compatibles (like Asus A8000)
Prefix: 'dme1737'
Addresses scanned: I2C 0x2c, 0x2d, 0x2e
Datasheet: Provided by SMSC upon request and under NDA
* SMSC SCH3112, SCH3114, SCH3116
Prefix: 'sch311x'
Addresses scanned: none, address read from Super-I/O config space
Datasheet: Available on the Internet
* SMSC SCH5027
Prefix: 'sch5027'
Addresses scanned: I2C 0x2c, 0x2d, 0x2e
Datasheet: Provided by SMSC upon request and under NDA
* SMSC SCH5127
Prefix: 'sch5127'
Addresses scanned: none, address read from Super-I/O config space
Datasheet: Provided by SMSC upon request and under NDA
Authors:
Juerg Haefliger <[email protected]>
Module Parameters
-----------------
* force_start: bool
Enables the monitoring of voltage, fan and temp inputs
and PWM output control functions. Using this parameter
shouldn't be required since the BIOS usually takes care
of this.
* probe_all_addr: bool
Include non-standard LPC addresses 0x162e and 0x164e
when probing for ISA devices. This is required for the
following boards:
- VIA EPIA SN18000
Sensor·PWM 수와 bus별 driver 등록
58-83이 드라이버는 동일한 DME1737·Asus A8000, SCH5027, SCH311x, SCH5127 Super-I/O chip의 hardware monitoring 기능을 지원합니다.
이 chip들은 `temp[1-3]` temperature sensor 3개(원격 diode 2개, internal 1개), `in[0-7]` voltage 최대 8개(외부 7개, internal 1개), `fan[1-6]` fan speed 최대 6개를 감시합니다. `pwm[1-3,5-6]` PWM output은 최대 5개이며 fan speed를 manual·automatic으로 제어합니다.
DME1737, A8000, SCH5027에서는 `fan[1-2]`와 `pwm[1-2]`가 항상 존재합니다. `fan[3-6]`과 `pwm[3,5-6]`은 optional이고 chip configuration에 따라 달라집니다. Driver는 초기화 때 실제 feature를 탐지해 해당 sysfs attribute만 생성합니다.
SCH311x와 SCH5127에서는 `fan[1-3]`과 `pwm[1-3]`이 항상 존재하며 `fan[4-6]`과 `pwm[5-6]`은 없습니다.
DME1737, A8000, SCH5027의 monitoring 기능은 SMBus로만 접근하므로 driver가 I2C client driver로 등록됩니다. SCH311x와 SCH5127은 ISA bus만 제공하므로 platform driver로 등록됩니다.
항상 존재하는 channel과 optional channel, 등록 방식입니다.
실제 hardware feature에 맞춰 ABI를 동적으로 노출합니다.
Description
-----------
This driver implements support for the hardware monitoring capabilities of the
SMSC DME1737 and Asus A8000 (which are the same), SMSC SCH5027, SCH311x,
and SCH5127 Super-I/O chips. These chips feature monitoring of 3 temp sensors
temp[1-3] (2 remote diodes and 1 internal), 8 voltages in[0-7] (7 external and
1 internal) and up to 6 fan speeds fan[1-6]. Additionally, the chips implement
up to 5 PWM outputs pwm[1-3,5-6] for controlling fan speeds both manually and
automatically.
For the DME1737, A8000 and SCH5027, fan[1-2] and pwm[1-2] are always present.
Fan[3-6] and pwm[3,5-6] are optional features and their availability depends on
the configuration of the chip. The driver will detect which features are
present during initialization and create the sysfs attributes accordingly.
For the SCH311x and SCH5127, fan[1-3] and pwm[1-3] are always present and
fan[4-6] and pwm[5-6] don't exist.
The hardware monitoring features of the DME1737, A8000, and SCH5027 are only
accessible via SMBus, while the SCH311x and SCH5127 only provide access via
the ISA bus. The driver will therefore register itself as an I2C client driver
if it detects a DME1737, A8000, or SCH5027 and as a platform driver if it
detects a SCH311x or SCH5127 chip.
12-bit voltage mapping과 범위
84-136Voltage input은 12-bit resolution으로 sampling하며 내부 scaling resistor가 있습니다. 따라서 driver가 반환하는 값은 실제 millivolt이고 userspace scaling이 필요하지 않습니다. 각 input에는 min·max limit가 있고 범위를 넘으면 alarm을 trigger합니다.
DME1737·A8000은 `in0=+5VTR`(+5V standby, 0~6.64V), `in1=Vccp`(processor core, 0~3V), `in2=VCC`(internal +3.3V, 0~4.38V), `in3=+5V`(0~6.64V), `in4=+12V`(0~16V), `in5=VTR`(+3.3V standby, 0~4.38V), `in6=Vbat`(+3.0V, 0~4.38V)로 mapping합니다.
SCH311x는 `in0=+2.5V`(0~3.32V), `in1=Vccp`(0~2V)이고 `in2`~`in6`은 DME1737의 VCC, +5V, +12V, VTR, Vbat mapping과 같습니다.
SCH5027은 `in0=+5VTR`(0~6.64V), `in1=Vccp`(0~3V), `in2=VCC`(0~4.38V), `in3=V2_IN`(0~1.5V), `in4=V1_IN`(0~1.5V), `in5=VTR`(0~4.38V), `in6=Vbat`(0~4.38V)입니다.
SCH5127은 `in0=+2.5`(0~3.32V), `in1=Vccp`(0~3V), `in2=VCC`(0~4.38V), `in3=V2_IN`(0~1.5V), `in4=V1_IN`(0~1.5V), `in5=VTR`(0~4.38V), `in6=Vbat`(0~4.38V), 추가 `in7=Vtrip`(+1.5V, 0~1.99V)입니다.
원문의 chip별 channel과 측정 범위를 한 표로 보존합니다.
Hardware scaling 뒤 limit 비교까지 chip 내부와 driver가 처리합니다.
Voltage Monitoring
------------------
The voltage inputs are sampled with 12-bit resolution and have internal
scaling resistors. The values returned by the driver therefore reflect true
millivolts and don't need scaling. The voltage inputs are mapped as follows
(the last column indicates the input ranges):
DME1737, A8000::
in0: +5VTR (+5V standby) 0V - 6.64V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: +5V 0V - 6.64V
in4: +12V 0V - 16V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH311x::
in0: +2.5V 0V - 3.32V
in1: Vccp (processor core) 0V - 2V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: +5V 0V - 6.64V
in4: +12V 0V - 16V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH5027::
in0: +5VTR (+5V standby) 0V - 6.64V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: V2_IN 0V - 1.5V
in4: V1_IN 0V - 1.5V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
SCH5127::
in0: +2.5 0V - 3.32V
in1: Vccp (processor core) 0V - 3V
in2: VCC (internal +3.3V) 0V - 4.38V
in3: V2_IN 0V - 1.5V
in4: V1_IN 0V - 1.5V
in5: VTR (+3.3V standby) 0V - 4.38V
in6: Vbat (+3.0V) 0V - 4.38V
in7: Vtrip (+1.5V) 0V - 1.99V
Each voltage input has associated min and max limits which trigger an alarm
when crossed.
Temperature mapping·offset·fault
137-156Temperature는 12-bit resolution으로 측정하고 millidegree Celsius로 보고합니다. 세 input 모두 offset을 지원하며, 값을 programming하면 chip이 측정값에 더합니다. Scaling도 chip이 수행하므로 userspace 보정이 필요 없는 실제 temperature를 driver가 보고합니다.
`temp1`은 Remote diode 1(3904 type), `temp2`는 DME1737 internal temperature, `temp3`은 Remote diode 2(3904 type)이며 모두 범위가 -127C~+127C입니다.
각 temperature input에는 min·max limit와 alarm이 있습니다. `fault` attribute는 faulty diode 또는 연결되지 않은 input을 탐지하면 1, 그렇지 않으면 0을 반환합니다.
세 12-bit sensor와 fault 의미입니다.
측정·offset·limit·diode 상태를 함께 처리합니다.
Temperature Monitoring
----------------------
Temperatures are measured with 12-bit resolution and reported in millidegree
Celsius. The chip also features offsets for all 3 temperature inputs which -
when programmed - get added to the input readings. The chip does all the
scaling by itself and the driver therefore reports true temperatures that don't
need any user-space adjustments. The temperature inputs are mapped as follows
(the last column indicates the input ranges)::
temp1: Remote diode 1 (3904 type) temperature -127C - +127C
temp2: DME1737 internal temperature -127C - +127C
temp3: Remote diode 2 (3904 type) temperature -127C - +127C
Each temperature input has associated min and max limits which trigger an alarm
when crossed. Additionally, each temperature input has a fault attribute that
returns 1 when a faulty diode or an unconnected input is detected and 0
otherwise.
16-bit fan tachometer 설정
157-169Fan RPM은 16-bit resolution으로 측정하며 chip에는 fan tachometer input이 6개 있습니다. 여섯 input 모두 min limit를 가지고 이보다 낮아지면 alarm을 trigger합니다.
Fan input 1~4의 `type` attribute에는 연결된 tachometer가 fan revolution당 생성하는 pulse 수를 설정해야 합니다. 지원값은 1, 2, 4입니다.
Fan input 5~6은 revolution당 2 pulse를 생성하는 fan만 지원합니다. 또한 fan이 100% duty-cycle일 때 도달 가능한 maximum RPM을 `max` attribute에 설정해야 하며 chip은 이 값에 따라 sampling rate를 조정합니다.
Input group별 pulse와 calibration 요구사항입니다.
Pulse 특성과 최대 RPM을 반영해 sampling rate를 정합니다.
Fan Monitoring
--------------
Fan RPMs are measured with 16-bit resolution. The chip provides inputs for 6
fan tachometers. All 6 inputs have an associated min limit which triggers an
alarm when crossed. Fan inputs 1-4 provide type attributes that need to be set
to the number of pulses per fan revolution that the connected tachometer
generates. Supported values are 1, 2, and 4. Fan inputs 5-6 only support fans
that generate 2 pulses per revolution. Fan inputs 5-6 also provide a max
attribute that needs to be set to the maximum attainable RPM (fan at 100% duty-
cycle) of the input. The chip adjusts the sampling rate based on this value.
Manual·automatic PWM과 temperature zone 곡선
170-236Chip에는 PWM output이 5개 있습니다. PWM 1~3은 fan input 1~3, PWM 5~6은 fan input 5~6과 연결됩니다. PWM 1~3은 enable attribute로 manual 또는 automatic mode를 선택할 수 있고, PWM 5~6은 manual mode만 가능해 enable attribute가 read-only입니다.
Manual mode에서는 해당 PWM attribute에 duty-cycle을 써서 fan speed를 설정합니다. Automatic mode에서는 PWM attribute가 chip fan controller가 정한 현재 duty-cycle을 반환합니다. 모든 output은 `freq` attribute로 output frequency를 설정할 수 있습니다.
Automatic mode의 PWM ramp rate는 연결 temperature input의 변화에 PWM output이 얼마나 빨리 조정되는지를 정의합니다. PWM과 temperature input 연결은 zone으로 구성합니다. 세 zone의 temperature input assignment는 초기화 때 정적으로 결정되고 `zone[1-3]_auto_channels_temp`에서 읽을 수 있습니다.
각 PWM output은 `pwm[1-3]_auto_channels_zone`으로 하나 또는 여러 zone 중 가장 뜨거운 zone에 연결됩니다. Duty-cycle은 full, low, min 세 단계입니다. Full은 255(100%)로 고정되고 low는 `pwm[1-3]_auto_point1_pwm`, min은 `pwm[1-3]_auto_pwm_min`으로 설정합니다.
Zone thermal threshold는 `zone[1-3]_auto_point[1-3]_temp`와 `zone[1-3]_auto_point1_temp_hyst`로 programming합니다. `auto_point2_pwm`은 255 full-speed, `auto_point1_pwm`은 low-speed, `auto_pwm_min`은 min-speed입니다. Temperature point3은 모든 output full-speed, point2는 full-speed, point1은 low-speed, point1 hysteresis는 min-speed threshold입니다.
Zone temperature가 `auto_point1_temp`와 `auto_point2_temp` 사이이면 output duty-cycle을 `auto_point1_pwm`에서 `auto_point2_pwm`까지 선형 조정합니다. Temperature가 `auto_point1_temp_hyst` 아래로 내려가면 output을 `auto_pwm_min`으로 설정합니다.
`auto_pwm_min`은 0 또는 `auto_point1_pwm` 두 값만 지원하므로 fan은 완전히 꺼지거나 low-speed duty-cycle로 계속 돕니다. 어떤 temperature든 `auto_point3_temp`보다 높아지면 모든 PWM output이 100% duty-cycle이 됩니다.
상승 시 min-speed 아래에서는 min, min~low 구간에서는 min, low point에서는 low, low~full 구간에서는 선형 증가, full point 이상에서는 full입니다. 하강 시 low와 min 사이에서도 low를 유지하다 hysteresis min-speed 아래에서 min으로 내려가므로 진동을 줄입니다.
Duty-cycle과 temperature threshold의 역할입니다.
원문의 hysteresis 표를 구조화한 동일 동작입니다.
Zone 선택부터 fail-safe full-speed까지의 순서입니다.
PWM Output Control
------------------
This chip features 5 PWM outputs. PWM outputs 1-3 are associated with fan
inputs 1-3 and PWM outputs 5-6 are associated with fan inputs 5-6. PWM outputs
1-3 can be configured to operate either in manual or automatic mode by setting
the appropriate enable attribute accordingly. PWM outputs 5-6 can only operate
in manual mode, their enable attributes are therefore read-only. When set to
manual mode, the fan speed is set by writing the duty-cycle value to the
appropriate PWM attribute. In automatic mode, the PWM attribute returns the
current duty-cycle as set by the fan controller in the chip. All PWM outputs
support the setting of the output frequency via the freq attribute.
In automatic mode, the chip supports the setting of the PWM ramp rate which
defines how fast the PWM output is adjusting to changes of the associated
temperature input. Associating PWM outputs to temperature inputs is done via
temperature zones. The chip features 3 zones whose assignments to temperature
inputs is static and determined during initialization. These assignments can
be retrieved via the zone[1-3]_auto_channels_temp attributes. Each PWM output
is assigned to one (or hottest of multiple) temperature zone(s) through the
pwm[1-3]_auto_channels_zone attributes. Each PWM output has 3 distinct output
duty-cycles: full, low, and min. Full is internally hard-wired to 255 (100%)
and low and min can be programmed via pwm[1-3]_auto_point1_pwm and
pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds of the zones are
programmed via zone[1-3]_auto_point[1-3]_temp and
zone[1-3]_auto_point1_temp_hyst:
=============================== =======================================
pwm[1-3]_auto_point2_pwm full-speed duty-cycle (255, i.e., 100%)
pwm[1-3]_auto_point1_pwm low-speed duty-cycle
pwm[1-3]_auto_pwm_min min-speed duty-cycle
zone[1-3]_auto_point3_temp full-speed temp (all outputs)
zone[1-3]_auto_point2_temp full-speed temp
zone[1-3]_auto_point1_temp low-speed temp
zone[1-3]_auto_point1_temp_hyst min-speed temp
=============================== =======================================
The chip adjusts the output duty-cycle linearly in the range of auto_point1_pwm
to auto_point2_pwm if the temperature of the associated zone is between
auto_point1_temp and auto_point2_temp. If the temperature drops below the
auto_point1_temp_hyst value, the output duty-cycle is set to the auto_pwm_min
value which only supports two values: 0 or auto_point1_pwm. That means that the
fan either turns completely off or keeps spinning with the low-speed
duty-cycle. If any of the temperatures rise above the auto_point3_temp value,
all PWM outputs are set to 100% duty-cycle.
Following is another representation of how the chip sets the output duty-cycle
based on the temperature of the associated thermal zone:
=============== =============== =================
Temperature Duty-Cycle Duty-Cycle
Rising Temp Falling Temp
=============== =============== =================
full-speed full-speed full-speed
- < linearly -
adjusted
duty-cycle >
low-speed low-speed low-speed
- min-speed low-speed
min-speed min-speed min-speed
- min-speed min-speed
=============== =============== =================
CPU·voltage·temperature·zone sysfs ABI
237-289Driver의 sysfs attribute와 권한은 다음과 같습니다. `cpu0_vid`는 millivolt 단위 CPU core reference voltage를 read-only로 제공하고, `vrm`은 voltage regulator module version number를 read-write로 제공합니다.
`in[0-7]_input`은 measured millivolt, `in[0-7]_min`·`max`는 low·high limit입니다. `in[0-7]_alarm`은 현재 또는 과거에 min-max range 밖으로 나갔으면 1, 아니면 0입니다.
`temp[1-3]_input`은 measured millidegree Celsius, `min`·`max`는 limit, `offset`은 chip이 measured temperature에 더할 값입니다. `alarm`은 현재 또는 과거 range 밖이면 1이고, `fault`는 faulty thermal diode 또는 unconnected input이면 1입니다.
`zone[1-3]_auto_channels_temp`는 zone과 temperature input mapping을 나타내는 read-only bitfield입니다. 값 1은 `temp1`, 2는 `temp2`, 4는 `temp3`입니다.
`zone[1-3]_auto_point1_temp_hyst`는 automatic PWM point1 hysteresis입니다. Temperature가 이 값 아래로 내려가면 대응 PWM output을 `pwm_auto_min`으로 설정합니다. `zone[1-3]_auto_point[1-3]_temp`에서 point1은 low-speed, point2는 full-speed, point3은 모든 PWM output을 100%로 만드는 temperature입니다.
측정값, limit, sticky 상태와 mapping bitfield입니다.
Measured value와 limit·fault를 함께 읽습니다.
Sysfs Attributes
----------------
Following is a list of all sysfs attributes that the driver provides, their
permissions and a short description:
=============================== ======= =======================================
Name Perm Description
=============================== ======= =======================================
cpu0_vid RO CPU core reference voltage in
millivolts.
vrm RW Voltage regulator module version
number.
in[0-7]_input RO Measured voltage in millivolts.
in[0-7]_min RW Low limit for voltage input.
in[0-7]_max RW High limit for voltage input.
in[0-7]_alarm RO Voltage input alarm. Returns 1 if
voltage input is or went outside the
associated min-max range, 0 otherwise.
temp[1-3]_input RO Measured temperature in millidegree
Celsius.
temp[1-3]_min RW Low limit for temp input.
temp[1-3]_max RW High limit for temp input.
temp[1-3]_offset RW Offset for temp input. This value will
be added by the chip to the measured
temperature.
temp[1-3]_alarm RO Alarm for temp input. Returns 1 if temp
input is or went outside the associated
min-max range, 0 otherwise.
temp[1-3]_fault RO Temp input fault. Returns 1 if the chip
detects a faulty thermal diode or an
unconnected temp input, 0 otherwise.
zone[1-3]_auto_channels_temp RO Temperature zone to temperature input
mapping. This attribute is a bitfield
and supports the following values:
- 1: temp1
- 2: temp2
- 4: temp3
zone[1-3]_auto_point1_temp_hyst RW Auto PWM temp point1 hysteresis. The
output of the corresponding PWM is set
to the pwm_auto_min value if the temp
falls below the auto_point1_temp_hyst
value.
zone[1-3]_auto_point[1-3]_temp RW Auto PWM temp points. Auto_point1 is
the low-speed temp, auto_point2 is the
full-speed temp, and auto_point3 is the
temp at which all PWM outputs are set
to full-speed (100% duty-cycle).
Fan·PWM sysfs ABI
290-344`fan[1-6]_input`은 measured RPM, `fan[1-6]_min`은 low limit, `fan[1-6]_alarm`은 현재 또는 과거 min 아래로 내려갔으면 1입니다. `fan[1-4]_type`은 revolution당 pulse 수이며 지원값은 1, 2, 4입니다. `fan[5-6]_max`는 100% duty-cycle maximum RPM으로 chip sampling rate 조정에 필요합니다.
원문 sysfs 표는 duty-cycle attribute를 `pmw[1-3,5-6]`으로 표기합니다. 이 원문 표기를 그대로 보존합니다. 값은 0~255(0~100%)이고 manual mode일 때만 write할 수 있습니다.
`pwm[1-3]_enable`은 0이면 turned off이지만 output은 100%, 1은 manual, 2는 automatic mode입니다. `pwm[5-6]_enable`은 두 output이 manual mode로 hard-wire되어 있어 항상 1을 반환하는 read-only attribute입니다.
원문 표기의 `pmw[1-3,5-6]_freq`는 11Hz~30000Hz이고 기본값은 25000Hz입니다. `pmw[1-3]_ramp_rate`는 automatic mode의 PWM step당 millisecond이며 0~206ms, 기본 0은 duty-cycle을 즉시 바꾼다는 뜻입니다.
`pwm[1-3]_auto_channels_zone`은 mapping bitfield입니다. 1=zone1, 2=zone2, 4=zone3, 6=zone2·3 중 highest, 7=zone1~3 중 highest입니다.
`pwm[1-3]_auto_pwm_min`은 0 또는 `auto_point1_pwm`인 minimum duty-cycle입니다. `pwm[1-3]_auto_point1_pwm`은 low-speed duty-cycle, read-only `pwm[1-3]_auto_point2_pwm`은 255로 hard-wire된 full-speed duty-cycle입니다.
원문 이름과 mode·범위를 그대로 보존합니다.
Mode와 zone mapping에 맞춰 write 가능 여부를 판단합니다.
fan[1-6]_input RO Measured fan speed in RPM.
fan[1-6]_min RW Low limit for fan input.
fan[1-6]_alarm RO Alarm for fan input. Returns 1 if fan
input is or went below the associated
min value, 0 otherwise.
fan[1-4]_type RW Type of attached fan. Expressed in
number of pulses per revolution that
the fan generates. Supported values are
1, 2, and 4.
fan[5-6]_max RW Max attainable RPM at 100% duty-cycle.
Required for chip to adjust the
sampling rate accordingly.
pmw[1-3,5-6] RO/RW Duty-cycle of PWM output. Supported
values are 0-255 (0%-100%). Only
writeable if the associated PWM is in
manual mode.
pwm[1-3]_enable RW Enable of PWM outputs 1-3. Supported
values are:
- 0: turned off (output @ 100%)
- 1: manual mode
- 2: automatic mode
pwm[5-6]_enable RO Enable of PWM outputs 5-6. Always
returns 1 since these 2 outputs are
hard-wired to manual mode.
pmw[1-3,5-6]_freq RW Frequency of PWM output. Supported
values are in the range 11Hz-30000Hz
(default is 25000Hz).
pmw[1-3]_ramp_rate RW Ramp rate of PWM output. Determines how
fast the PWM duty-cycle will change
when the PWM is in automatic mode.
Expressed in ms per PWM step. Supported
values are in the range 0ms-206ms
(default is 0, which means the duty-
cycle changes instantly).
pwm[1-3]_auto_channels_zone RW PWM output to temperature zone mapping.
This attribute is a bitfield and
supports the following values:
- 1: zone1
- 2: zone2
- 4: zone3
- 6: highest of zone[2-3]
- 7: highest of zone[1-3]
pwm[1-3]_auto_pwm_min RW Auto PWM min pwm. Minimum PWM duty-
cycle. Supported values are 0 or
auto_point1_pwm.
pwm[1-3]_auto_point1_pwm RW Auto PWM pwm point. Auto_point1 is the
low-speed duty-cycle.
pwm[1-3]_auto_point2_pwm RO Auto PWM pwm point. Auto_point2 is the
full-speed duty-cycle which is hard-
wired to 255 (100% duty-cycle).
=============================== ======= =======================================
DME1737·SCH 계열 feature 차이
345-364Chip별 feature 차이는 표와 같습니다. Blank cell은 해당 feature가 없음을 뜻하고 `opt`는 chip configuration에 따라 optional임을 뜻합니다.
`temp[1-3]_offset`, `zone[1-3]_hyst`, PWM min/off는 DME1737과 SCH311x에만 있습니다. `vid`는 DME1737에만 있습니다. `zone3`은 DME1737, SCH311x, SCH5027에 있습니다.
`fan3`·`pwm3`은 DME1737과 SCH5027에서 optional, SCH311x와 SCH5127에서 항상 지원됩니다. `fan4`~`fan6`과 `pwm5`~`pwm6`은 DME1737·SCH5027에서 optional이고 SCH311x·SCH5127에는 없습니다. `in7`은 SCH5127에만 있습니다.
원문 feature matrix를 동일하게 구조화했습니다.
Chip matrix와 실제 configuration을 함께 적용합니다.
Chip Differences
----------------
======================= ======= ======= ======= =======
Feature dme1737 sch311x sch5027 sch5127
======================= ======= ======= ======= =======
temp[1-3]_offset yes yes
vid yes
zone3 yes yes yes
zone[1-3]_hyst yes yes
pwm min/off yes yes
fan3 opt yes opt yes
pwm3 opt yes opt yes
fan4 opt opt
fan5 opt opt
pwm5 opt opt
fan6 opt opt
pwm6 opt opt
in7 yes
======================= ======= ======= ======= =======
요약·해설
dme1737.rst:1-364SMSC Super-I/O 계열의 chip별 sensor mapping과 SMBus·ISA 등록, automatic PWM curve, 전체 sysfs ABI 차이를 설명합니다.
원문 분량과 최대 monitoring channel입니다.
Chip 탐지부터 automatic fan control까지의 경로입니다.