요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Kernel driver w83627hf
2
======================
4
Supported chips:
5
* Winbond W83627HF (ISA accesses ONLY)
6
Prefix: 'w83627hf'
7
Addresses scanned: ISA address retrieved from Super I/O registers
8
* Winbond W83627THF
9
Prefix: 'w83627thf'
10
Addresses scanned: ISA address retrieved from Super I/O registers
11
* Winbond W83697HF
12
Prefix: 'w83697hf'
13
Addresses scanned: ISA address retrieved from Super I/O registers
14
* Winbond W83637HF
15
Prefix: 'w83637hf'
16
Addresses scanned: ISA address retrieved from Super I/O registers
17
* Winbond W83687THF
18
Prefix: 'w83687thf'
19
Addresses scanned: ISA address retrieved from Super I/O registers
20
Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
22
Authors:
23
Frodo Looijaard <frodol@dds.nl>,
24
Philip Edelbrock <phil@netroedge.com>,
25
Mark Studebaker <mdsxyz123@yahoo.com>,
26
Bernhard C. Schrenk <clemy@clemy.org>
28
Module Parameters
29
-----------------
31
* force_i2c: int
32
Initialize the I2C address of the sensors
33
* init: int
34
(default is 1)
35
Use 'init=0' to bypass initializing the chip.
36
Try this if your computer crashes when you load the module.
38
Description
39
-----------
41
This driver implements support for ISA accesses *only* for
42
the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips.
43
We will refer to them collectively as Winbond chips.
45
This driver supports ISA accesses, which should be more reliable
46
than i2c accesses. Also, for Tyan boards which contain both a
47
Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
48
using this driver will avoid i2c address conflicts and complex
49
initialization that were required in the w83781d driver.
51
If you really want i2c accesses for these Super I/O chips,
52
use the w83781d driver. However this is not the preferred method
53
now that this ISA driver has been developed.
55
The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
56
same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
57
VID reading. However the two chips have the identical 128 pin package. So,
58
it is possible or even likely for a w83627thf to have the VID signals routed
59
to these pins despite their not being labeled for that purpose. Therefore,
60
the w83627thf driver interprets these as VID. If the VID on your board
61
doesn't work, first see doc/vid in the lm_sensors package[1]. If that still
62
doesn't help, you may just ignore the bogus VID reading with no harm done.
64
For further information on this driver see the w83781d driver documentation.
66
[1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid
68
Forcing the address
69
-------------------
71
The driver used to have a module parameter named force_addr, which could
72
be used to force the base I/O address of the hardware monitoring block.
73
This was meant as a workaround for mainboards with a broken BIOS. This
74
module parameter is gone for technical reasons. If you need this feature,
75
you can obtain the same result by using the isaset tool (part of
76
lm-sensors) before loading the driver:
78
# Enter the Super I/O config space::
80
isaset -y -f 0x2e 0x87
81
isaset -y -f 0x2e 0x87
83
# Select the hwmon logical device::
85
isaset -y 0x2e 0x2f 0x07 0x0b
87
# Set the base I/O address (to 0x290 in this example)::
89
isaset -y 0x2e 0x2f 0x60 0x02
90
isaset -y 0x2e 0x2f 0x61 0x90
92
# Exit the Super-I/O config space::
94
isaset -y -f 0x2e 0xaa
96
The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
97
0x4e/0x4f is also possible.
99
Voltage pin mapping
100
-------------------
102
Here is a summary of the voltage pin mapping for the W83627THF. This
103
can be useful to convert data provided by board manufacturers into
104
working libsensors configuration statements:
107
- W83627THF
110
======== =============== =============== ===============
111
Pin Name Register Sysfs attribute
112
======== =============== =============== ===============
113
100 CPUVCORE 20h in0
114
99 VIN0 21h in1
115
98 VIN1 22h in2
116
97 VIN2 24h in4
117
114 AVCC 23h in3
118
61 5VSB 50h (bank 5) in7
119
74 VBAT 51h (bank 5) in8
120
======== =============== =============== ===============
122
For other supported devices, you'll have to take the hard path and
123
look up the information in the datasheet yourself (and then add it
124
to this document please.)
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 칩과 초기화 옵션
1-37이 드라이버는 ISA 접근 전용 Winbond W83627HF, W83627THF, W83697HF, W83637HF, W83687THF를 지원합니다. 접두사는 각각 `w83627hf`, `w83627thf`, `w83697hf`, `w83637hf`, `w83687thf`이며 ISA 주소는 Super-I/O 레지스터에서 가져옵니다.
W83687THF 데이터시트는 Winbond에 요청할 수 있습니다. 작성자는 Frodo Looijaard, Philip Edelbrock, Mark Studebaker, Bernhard C. Schrenk입니다.
정수형 `force_i2c`는 센서의 I2C 주소를 초기화합니다. 정수형 `init`의 기본값은 1입니다. 모듈을 적재할 때 컴퓨터가 충돌하면 `init=0`으로 칩 초기화를 건너뛰어 볼 수 있습니다.
항목값설명
지원 칩W83627HF/THF, W83697HF, W83637HF, W83687THFISA 접근 전용
접두사`w83627hf` 등 칩별 이름Super-I/O 주소 사용
`force_i2c`정수센서 I2C 주소 초기화
`init`기본 1칩 초기화
`init=0`초기화 생략모듈 적재 충돌 시 시도
지원 칩의 접두사와 초기화 매개변수를 정리합니다.
Super-I/O에서 ISA 주소 읽기→칩 종류와 접두사 판별→필요하면 `force_i2c` 적용→충돌 이력이 있으면 `init=0` 고려→hwmon 센서 등록
안전한 초기화 옵션을 적용해 ISA 센서를 등록합니다.
Kernel driver w83627hf
======================
Supported chips:
* Winbond W83627HF (ISA accesses ONLY)
Prefix: 'w83627hf'
Addresses scanned: ISA address retrieved from Super I/O registers
* Winbond W83627THF
Prefix: 'w83627thf'
Addresses scanned: ISA address retrieved from Super I/O registers
* Winbond W83697HF
Prefix: 'w83697hf'
Addresses scanned: ISA address retrieved from Super I/O registers
* Winbond W83637HF
Prefix: 'w83637hf'
Addresses scanned: ISA address retrieved from Super I/O registers
* Winbond W83687THF
Prefix: 'w83687thf'
Addresses scanned: ISA address retrieved from Super I/O registers
Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
Authors:
Frodo Looijaard <frodol@dds.nl>,
Philip Edelbrock <phil@netroedge.com>,
Mark Studebaker <mdsxyz123@yahoo.com>,
Bernhard C. Schrenk <clemy@clemy.org>
Module Parameters
-----------------
* force_i2c: int
Initialize the I2C address of the sensors
* init: int
(default is 1)
Use 'init=0' to bypass initializing the chip.
Try this if your computer crashes when you load the module.
ISA 접근과 기준 주소 강제 설정
38-98이 드라이버는 W83627HF, W83627THF, W83697HF, W83637HF Super-I/O의 ISA 접근만 지원하며 문서에서는 이를 통칭해 Winbond 칩이라고 부릅니다.
ISA 접근은 I2C보다 신뢰성이 높습니다. Super-I/O와 I2C 전용 Winbond 칩, 흔히 W83782D가 함께 있는 Tyan 보드에서도 I2C 주소 충돌과 `w83781d` 드라이버에 필요했던 복잡한 초기화를 피할 수 있습니다. I2C 접근이 꼭 필요하면 `w83781d`를 사용할 수 있지만 권장 방식은 아닙니다.
W83627HF는 핀 110~106을 VID0~VID4로 사용하고 W83627THF는 같은 핀을 GPIO[0:4]로 사용합니다. THF는 공식적으로 VID를 지원하지 않지만 두 칩의 128핀 패키지가 같아 보드에서 VID 신호가 연결됐을 가능성이 있으므로 드라이버는 VID로 해석합니다. 동작하지 않으면 lm_sensors의 `doc/vid`를 확인하고 그래도 안 되면 잘못된 VID 값을 무시해도 됩니다.
이전의 `force_addr` 모듈 매개변수는 기술적 이유로 제거됐습니다. 고장 난 BIOS 때문에 hwmon 기준 I/O 주소를 강제해야 한다면 드라이버를 적재하기 전에 lm-sensors의 `isaset`을 사용합니다.
원문 예시는 Super-I/O 구성 공간 `0x2e/0x2f`에 진입하고 논리 장치 `0x0b`를 선택해 기준 주소를 `0x290`으로 설정한 다음 구성 공간에서 빠져나옵니다. 구성 포트는 `0x4e/0x4f`일 수도 있습니다.
단계명령/값의미
구성 진입 1`isaset -y -f 0x2e 0x87`unlock 첫 기록
구성 진입 2`isaset -y -f 0x2e 0x87`unlock 두 번째 기록
논리 장치 선택`isaset -y 0x2e 0x2f 0x07 0x0b`hwmon 장치
주소 상위 바이트`isaset -y 0x2e 0x2f 0x60 0x02``0x290`의 상위값
주소 하위 바이트`isaset -y 0x2e 0x2f 0x61 0x90``0x290`의 하위값
구성 종료`isaset -y -f 0x2e 0xaa`Super-I/O 잠금
원문의 isaset 절차를 단계별 명령과 함께 보존했습니다.
BIOS 주소 설정 문제 확인→드라이버 적재 전 Super-I/O 구성 진입→hwmon 논리 장치 선택→기준 주소 상·하위 바이트 기록→구성 종료 후 드라이버 적재
제거된 force_addr 대신 isaset을 적용하는 순서입니다.
Description
-----------
This driver implements support for ISA accesses *only* for
the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips.
We will refer to them collectively as Winbond chips.
This driver supports ISA accesses, which should be more reliable
than i2c accesses. Also, for Tyan boards which contain both a
Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
using this driver will avoid i2c address conflicts and complex
initialization that were required in the w83781d driver.
If you really want i2c accesses for these Super I/O chips,
use the w83781d driver. However this is not the preferred method
now that this ISA driver has been developed.
The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
VID reading. However the two chips have the identical 128 pin package. So,
it is possible or even likely for a w83627thf to have the VID signals routed
to these pins despite their not being labeled for that purpose. Therefore,
the w83627thf driver interprets these as VID. If the VID on your board
doesn't work, first see doc/vid in the lm_sensors package[1]. If that still
doesn't help, you may just ignore the bogus VID reading with no harm done.
For further information on this driver see the w83781d driver documentation.
[1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid
Forcing the address
-------------------
The driver used to have a module parameter named force_addr, which could
be used to force the base I/O address of the hardware monitoring block.
This was meant as a workaround for mainboards with a broken BIOS. This
module parameter is gone for technical reasons. If you need this feature,
you can obtain the same result by using the isaset tool (part of
lm-sensors) before loading the driver:
# Enter the Super I/O config space::
isaset -y -f 0x2e 0x87
isaset -y -f 0x2e 0x87
# Select the hwmon logical device::
isaset -y 0x2e 0x2f 0x07 0x0b
# Set the base I/O address (to 0x290 in this example)::
isaset -y 0x2e 0x2f 0x60 0x02
isaset -y 0x2e 0x2f 0x61 0x90
# Exit the Super-I/O config space::
isaset -y -f 0x2e 0xaa
The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
0x4e/0x4f is also possible.
W83627THF 전압 핀 매핑
99-124W83627THF의 전압 핀 매핑은 보드 제조사가 제공한 회로 정보를 실제 libsensors 설정으로 바꾸는 데 유용합니다.
핀 100 CPUVCORE는 레지스터 `20h`와 `in0`, 핀 99 VIN0은 `21h`와 `in1`, 핀 98 VIN1은 `22h`와 `in2`, 핀 97 VIN2는 `24h`와 `in4`에 대응합니다.
핀 114 AVCC는 `23h`와 `in3`, 핀 61 5VSB는 뱅크 5의 `50h`와 `in7`, 핀 74 VBAT는 뱅크 5의 `51h`와 `in8`에 대응합니다. 다른 지원 장치는 데이터시트를 직접 확인해야 하며 확인한 정보는 이 문서에 추가하는 것이 권장됩니다.
핀이름레지스터sysfs
100CPUVCORE`20h``in0`
99VIN0`21h``in1`
98VIN1`22h``in2`
97VIN2`24h``in4`
114AVCC`23h``in3`
615VSB`50h` (bank 5)`in7`
74VBAT`51h` (bank 5)`in8`
원문의 핀·이름·레지스터·sysfs 표를 그대로 구조화했습니다.
보드 제조사 핀 이름 확인→W83627THF 핀 번호 대조→레지스터와 뱅크 확인→대응 `inN` sysfs 채널 선택→libsensors 라벨·배율 설정 작성
회로 핀 정보를 libsensors 채널로 옮깁니다.
Voltage pin mapping
-------------------
Here is a summary of the voltage pin mapping for the W83627THF. This
can be useful to convert data provided by board manufacturers into
working libsensors configuration statements:
- W83627THF
======== =============== =============== ===============
Pin Name Register Sysfs attribute
======== =============== =============== ===============
100 CPUVCORE 20h in0
99 VIN0 21h in1
98 VIN1 22h in2
97 VIN2 24h in4
114 AVCC 23h in3
61 5VSB 50h (bank 5) in7
74 VBAT 51h (bank 5) in8
======== =============== =============== ===============
For other supported devices, you'll have to take the hard path and
look up the information in the datasheet yourself (and then add it
to this document please.)
요약·해설
w83627hf.rst:1-124w83627hf 드라이버는 안정적인 ISA 접근을 사용하고 필요하면 isaset으로 hwmon 기준 주소를 설정하며 THF 핀을 sysfs 전압 채널로 연결합니다.
원문 분량과 핵심 기능을 요약합니다.
장치 초기화부터 측정·상태 제공까지의 순서입니다.