요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Kernel driver sis5595
2
=====================
4
Supported chips:
6
* Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
8
Prefix: 'sis5595'
10
Addresses scanned: ISA in PCI-space encoded address
12
Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
16
Authors:
18
- Kyösti Mälkki <[email protected]>,
19
- Mark D. Studebaker <[email protected]>,
20
- Aurelien Jarno <[email protected]> 2.6 port
22
SiS southbridge has a LM78-like chip integrated on the same IC.
23
This driver is a customized copy of lm78.c
25
Supports following revisions:
27
=============== =============== ==============
28
Version PCI ID PCI Revision
29
=============== =============== ==============
30
1 1039/0008 AF or less
31
2 1039/0008 B0 or greater
32
=============== =============== ==============
34
Note: these chips contain a 0008 device which is incompatible with the
35
5595. We recognize these by the presence of the listed
36
"blacklist" PCI ID and refuse to load.
38
=================== =============== ================
39
NOT SUPPORTED PCI ID BLACKLIST PCI ID
40
=================== =============== ================
41
540 0008 0540
42
550 0008 0550
43
5513 0008 5511
44
5581 0008 5597
45
5582 0008 5597
46
5597 0008 5597
47
630 0008 0630
48
645 0008 0645
49
730 0008 0730
50
735 0008 0735
51
=================== =============== ================
54
Module Parameters
55
-----------------
57
======================= =====================================================
58
force_addr=0xaddr Set the I/O base address. Useful for boards
59
that don't set the address in the BIOS. Does not do a
60
PCI force; the device must still be present in lspci.
61
Don't use this unless the driver complains that the
62
base address is not set.
64
Example: 'modprobe sis5595 force_addr=0x290'
65
======================= =====================================================
68
Description
69
-----------
71
The SiS5595 southbridge has integrated hardware monitor functions. It also
72
has an I2C bus, but this driver only supports the hardware monitor. For the
73
I2C bus driver see i2c-sis5595.
75
The SiS5595 implements zero or one temperature sensor, two fan speed
76
sensors, four or five voltage sensors, and alarms.
78
On the first version of the chip, there are four voltage sensors and one
79
temperature sensor.
81
On the second version of the chip, the temperature sensor (temp) and the
82
fifth voltage sensor (in4) share a pin which is configurable, but not
83
through the driver. Sorry. The driver senses the configuration of the pin,
84
which was hopefully set by the BIOS.
86
Temperatures are measured in degrees Celsius. An alarm is triggered once
87
when the max is crossed; it is also triggered when it drops below the min
88
value. Measurements are guaranteed between -55 and +125 degrees, with a
89
resolution of 1 degree.
91
Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
92
triggered if the rotation speed has dropped below a programmable limit. Fan
93
readings can be divided by a programmable divider (1, 2, 4 or 8) to give
94
the readings more range or accuracy. Not all RPM values can accurately be
95
represented, so some rounding is done. With a divider of 2, the lowest
96
representable value is around 2600 RPM.
98
Voltage sensors (also known as IN sensors) report their values in volts. An
99
alarm is triggered if the voltage has crossed a programmable minimum or
100
maximum limit. Note that minimum in this case always means 'closest to
101
zero'; this is important for negative voltage measurements. All voltage
102
inputs can measure voltages between 0 and 4.08 volts, with a resolution of
103
0.016 volt.
105
In addition to the alarms described above, there is a BTI alarm, which gets
106
triggered when an external chip has crossed its limits. Usually, this is
107
connected to some LM75-like chip; if at least one crosses its limits, this
108
bit gets set.
110
If an alarm triggers, it will remain triggered until the hardware register
111
is read at least once. This means that the cause for the alarm may already
112
have disappeared! Note that in the current implementation, all hardware
113
registers are read whenever any data is read (unless it is less than 1.5
114
seconds since the last update). This means that you can easily miss
115
once-only alarms.
117
The SiS5595 only updates its values each 1.5 seconds; reading it more often
118
will do no harm, but will return 'old' values.
120
Problems
121
--------
122
Some chips refuse to be enabled. We don't know why.
123
The driver will recognize this and print a message in dmesg.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
SiS5595 리비전과 비호환 PCI 블랙리스트
1-53`sis5595` 드라이버는 Silicon Integrated Systems의 SiS5595 사우스브리지 하드웨어 모니터를 지원합니다. 접두사는 `sis5595`이고 ISA I/O 주소는 PCI 공간에 인코딩된 값을 통해 찾습니다. 데이터시트는 SiS 웹사이트에 공개되어 있습니다.
작성자는 Kyösti Mälkki, Mark D. Studebaker이며 Aurelien Jarno가 2.6 커널 포팅을 담당했습니다. SiS 사우스브리지에는 LM78과 유사한 모니터가 같은 IC에 통합되어 있어 이 드라이버는 `lm78.c`를 장치에 맞게 복사·수정한 것입니다.
지원되는 두 리비전은 모두 PCI ID `1039/0008`을 사용합니다. 버전 1은 PCI 리비전 AF 이하, 버전 2는 B0 이상입니다.
여러 다른 SiS 칩에도 장치 ID `0008`이 있지만 SiS5595와 호환되지 않습니다. 드라이버는 함께 존재하는 블랙리스트 PCI ID로 이 칩들을 식별해 적재를 거부합니다.
종류칩·버전PCI ID리비전·블랙리스트 ID
지원버전 11039/0008AF 이하
지원버전 21039/0008B0 이상
미지원54000080540
미지원55000080550
미지원551300085511
미지원558100085597
미지원558200085597
미지원559700085597
미지원63000080630
미지원64500080645
미지원73000080730
미지원73500080735
지원 리비전과 동일 0008 ID를 가진 비호환 칩을 구분합니다.
PCI 공급자·장치 ID 1039/0008 확인→PCI 리비전 AF 이하 또는 B0 이상 분류→블랙리스트 PCI ID 존재 여부 검사→비호환 칩이면 적재 거부→호환 SiS5595이면 하드웨어 모니터 초기화
0008 장치 ID만 보지 않고 리비전과 블랙리스트 장치를 함께 확인합니다.
Kernel driver sis5595
=====================
Supported chips:
* Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
Prefix: 'sis5595'
Addresses scanned: ISA in PCI-space encoded address
Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
Authors:
- Kyösti Mälkki <[email protected]>,
- Mark D. Studebaker <[email protected]>,
- Aurelien Jarno <[email protected]> 2.6 port
SiS southbridge has a LM78-like chip integrated on the same IC.
This driver is a customized copy of lm78.c
Supports following revisions:
=============== =============== ==============
Version PCI ID PCI Revision
=============== =============== ==============
1 1039/0008 AF or less
2 1039/0008 B0 or greater
=============== =============== ==============
Note: these chips contain a 0008 device which is incompatible with the
5595. We recognize these by the presence of the listed
"blacklist" PCI ID and refuse to load.
=================== =============== ================
NOT SUPPORTED PCI ID BLACKLIST PCI ID
=================== =============== ================
540 0008 0540
550 0008 0550
5513 0008 5511
5581 0008 5597
5582 0008 5597
5597 0008 5597
630 0008 0630
645 0008 0645
730 0008 0730
735 0008 0735
=================== =============== ================
force_addr 모듈 매개변수
54-67`force_addr=0xaddr`는 I/O 기준 주소를 강제로 지정합니다. BIOS가 주소를 설정하지 않은 보드에서만 유용하며 PCI 장치 자체를 강제로 만드는 기능은 아닙니다. 따라서 장치는 여전히 `lspci`에 나타나야 합니다.
드라이버가 기준 주소가 설정되지 않았다고 알릴 때만 이 옵션을 사용해야 합니다. 예시는 `modprobe sis5595 force_addr=0x290`입니다.
항목내용
형식force_addr=0xaddr
용도BIOS가 I/O 기준 주소를 설정하지 않은 보드
전제PCI 장치가 lspci에 존재
제한PCI force가 아님
예modprobe sis5595 force_addr=0x290
강제 주소의 사용 조건과 한계를 정리합니다.
lspci에서 SiS 장치 존재 확인→일반 모듈 적재 시도→기준 주소 미설정 메시지 확인→실제 I/O 주소 검증→force_addr로 다시 적재
정상 탐지를 먼저 시도한 뒤 기준 주소 누락에만 적용합니다.
Module Parameters
-----------------
======================= =====================================================
force_addr=0xaddr Set the I/O base address. Useful for boards
that don't set the address in the BIOS. Does not do a
PCI force; the device must still be present in lspci.
Don't use this unless the driver complains that the
base address is not set.
Example: 'modprobe sis5595 force_addr=0x290'
======================= =====================================================
온도·팬·전압 센서와 래치 경보
68-118SiS5595 사우스브리지는 하드웨어 모니터와 I2C 버스를 모두 통합하지만 이 드라이버는 모니터만 지원합니다. I2C 버스에는 `i2c-sis5595` 드라이버를 사용합니다.
장치는 온도 센서 0개 또는 1개, 팬 속도 센서 2개, 전압 센서 4개 또는 5개와 경보를 구현합니다. 버전 1은 전압 센서 4개와 온도 센서 1개입니다. 버전 2는 온도 `temp`와 다섯 번째 전압 `in4`가 한 핀을 공유하며, 드라이버에서 설정할 수는 없고 BIOS 설정을 감지합니다.
온도는 섭씨로 측정합니다. 최대값을 넘거나 최소값 아래로 내려가면 경보가 한 번 트리거됩니다. 보장 범위는 -55~+125°C이고 해상도는 1°C입니다.
팬 속도는 RPM으로 보고됩니다. 속도가 설정 하한 아래로 내려가면 경보가 발생합니다. 분주기는 1, 2, 4, 8이며 범위와 정밀도를 조절합니다. 모든 RPM을 정확히 나타낼 수 없어 반올림이 발생하고 분주기 2에서 표현 가능한 최저값은 약 2600 RPM입니다.
전압 입력은 볼트 단위이며 설정 최소·최대 한계를 넘으면 경보가 발생합니다. 음전압에서도 최소는 항상 0에 가장 가까운 값을 뜻합니다. 모든 입력의 측정 범위는 0~4.08 V, 해상도는 0.016 V입니다.
BTI 경보는 보통 LM75 계열 외부 칩이 한계를 넘었을 때 설정됩니다. 경보는 하드웨어 레지스터를 한 번 이상 읽을 때까지 유지되므로 원인이 이미 사라졌을 수 있습니다. 구현상 마지막 갱신 후 1.5초가 지나면 어떤 데이터를 읽더라도 모든 레지스터를 읽어 한 번만 발생한 경보를 놓칠 수 있습니다.
SiS5595 자체 값 갱신 주기는 1.5초입니다. 더 자주 읽어도 해롭지는 않지만 이전 값을 반환합니다.
종류채널·범위해상도·분주기경보
온도0 또는 1개, -55~+125°C1°Cmin 아래·max 위
팬2개, RPM분주기 1·2·4·8설정 최저 속도 미만
전압4 또는 5개, 0~4.08 V0.016 V설정 min·max 이탈
BTI외부 LM75 계열-외부 칩 한계 초과
갱신1.5초그보다 빠른 읽기는 이전 값읽을 때 래치 해제 가능
센서 수, 범위, 해상도, 경보 조건을 정리합니다.
마지막 갱신 시각 확인→1.5초 미만이면 캐시 값 반환→1.5초 이상이면 모든 센서·경보 레지스터 판독→판독으로 래치 경보 해제→현재 값과 포착된 경보를 사용자 공간에 제공
1.5초 캐시와 읽기 시 해제되는 경보 래치를 고려합니다.
Description
-----------
The SiS5595 southbridge has integrated hardware monitor functions. It also
has an I2C bus, but this driver only supports the hardware monitor. For the
I2C bus driver see i2c-sis5595.
The SiS5595 implements zero or one temperature sensor, two fan speed
sensors, four or five voltage sensors, and alarms.
On the first version of the chip, there are four voltage sensors and one
temperature sensor.
On the second version of the chip, the temperature sensor (temp) and the
fifth voltage sensor (in4) share a pin which is configurable, but not
through the driver. Sorry. The driver senses the configuration of the pin,
which was hopefully set by the BIOS.
Temperatures are measured in degrees Celsius. An alarm is triggered once
when the max is crossed; it is also triggered when it drops below the min
value. Measurements are guaranteed between -55 and +125 degrees, with a
resolution of 1 degree.
Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
triggered if the rotation speed has dropped below a programmable limit. Fan
readings can be divided by a programmable divider (1, 2, 4 or 8) to give
the readings more range or accuracy. Not all RPM values can accurately be
represented, so some rounding is done. With a divider of 2, the lowest
representable value is around 2600 RPM.
Voltage sensors (also known as IN sensors) report their values in volts. An
alarm is triggered if the voltage has crossed a programmable minimum or
maximum limit. Note that minimum in this case always means 'closest to
zero'; this is important for negative voltage measurements. All voltage
inputs can measure voltages between 0 and 4.08 volts, with a resolution of
0.016 volt.
In addition to the alarms described above, there is a BTI alarm, which gets
triggered when an external chip has crossed its limits. Usually, this is
connected to some LM75-like chip; if at least one crosses its limits, this
bit gets set.
If an alarm triggers, it will remain triggered until the hardware register
is read at least once. This means that the cause for the alarm may already
have disappeared! Note that in the current implementation, all hardware
registers are read whenever any data is read (unless it is less than 1.5
seconds since the last update). This means that you can easily miss
once-only alarms.
The SiS5595 only updates its values each 1.5 seconds; reading it more often
will do no harm, but will return 'old' values.활성화 거부 칩
119-123일부 칩은 활성화를 거부하며 원인은 알려져 있지 않습니다. 드라이버가 이 상태를 감지하면 `dmesg`에 메시지를 출력합니다.
문제드라이버 동작확인 위치
일부 칩 활성화 거부실패 감지 후 메시지 출력dmesg
활성화 실패 시 확인할 진단 정보입니다.
sis5595 모듈 적재→칩 활성화 시도→실패 상태 감지→dmesg 메시지 확인→주소·호환성과 알려진 문제 구분
드라이버 메시지를 통해 알려진 칩 활성화 문제를 구분합니다.
Problems
--------
Some chips refuse to be enabled. We don't know why.
The driver will recognize this and print a message in dmesg.
요약·해설
sis5595.rst:1-123동일 PCI ID의 비호환 칩을 블랙리스트로 거르고 SiS5595의 센서와 1.5초 갱신·읽기 해제 경보를 처리합니다.
원문 분량과 핵심 장치 구성을 정리합니다.
장치 식별부터 센서 확인까지의 핵심 순서입니다.