← Documents Documentation/hwmon/sis5595.rst GitHub 원문 ↗

Linux 6.18.37 · Hardware Monitoring

Kernel driver sis5595

SiS5595 사우스브리지의 온도·팬·전압 센서, 리비전 식별, 래치 경보를 설명합니다.

Source pathDocumentation/hwmon/sis5595.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

sis5595.rst:1-123

동일 PCI ID의 비호환 칩을 블랙리스트로 거르고 SiS5595의 센서와 1.5초 갱신·읽기 해제 경보를 처리합니다.

문서 개요
항목값
SourceDocumentation/hwmon/sis5595.rst
분량123 source lines
센서온도 0~1·팬 2·전압 4~5
갱신1.5초

원문 분량과 핵심 장치 구성을 정리합니다.

운영 흐름
PCI ID·리비전 검사블랙리스트 제외I/O 주소 확인센서 판독래치 경보 처리

장치 식별부터 센서 확인까지의 핵심 순서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 Kernel driver sis5595
2 =====================
3
4 Supported chips:
5
6 * Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
7
8 Prefix: 'sis5595'
9
10 Addresses scanned: ISA in PCI-space encoded address
11
12 Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
13
14
15
16 Authors:
17
18 - Kyösti Mälkki <kmalkki@cc.hut.fi>,
19 - Mark D. Studebaker <mdsxyz123@yahoo.com>,
20 - Aurelien Jarno <aurelien@aurel32.net> 2.6 port
21
22 SiS southbridge has a LM78-like chip integrated on the same IC.
23 This driver is a customized copy of lm78.c
24
25 Supports following revisions:
26
27 =============== =============== ==============
28 Version PCI ID PCI Revision
29 =============== =============== ==============
30 1 1039/0008 AF or less
31 2 1039/0008 B0 or greater
32 =============== =============== ==============
33
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.
37
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 =================== =============== ================
52
53
54 Module Parameters
55 -----------------
56
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.
63
64 Example: 'modprobe sis5595 force_addr=0x290'
65 ======================= =====================================================
66
67
68 Description
69 -----------
70
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.
74
75 The SiS5595 implements zero or one temperature sensor, two fan speed
76 sensors, four or five voltage sensors, and alarms.
77
78 On the first version of the chip, there are four voltage sensors and one
79 temperature sensor.
80
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.
85
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.
90
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.
97
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.
104
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.
109
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.
116
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.
119
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.
124

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로 이 칩들을 식별해 적재를 거부합니다.

SiS5595 지원·블랙리스트
종류칩·버전PCI ID리비전·블랙리스트 ID
지원버전 11039/0008AF 이하
지원버전 21039/0008B0 이상
미지원54000080540
미지원55000080550
미지원551300085511
미지원558100085597
미지원558200085597
미지원559700085597
미지원63000080630
미지원64500080645
미지원73000080730
미지원73500080735

지원 리비전과 동일 0008 ID를 가진 비호환 칩을 구분합니다.

SiS 장치 판별
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 <kmalkki@cc.hut.fi>,
      - Mark D. Studebaker <mdsxyz123@yahoo.com>,
      - Aurelien Jarno <aurelien@aurel32.net> 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`입니다.

sis5595 force_addr
항목내용
형식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-118

SiS5595 사우스브리지는 하드웨어 모니터와 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초입니다. 더 자주 읽어도 해롭지는 않지만 이전 값을 반환합니다.

SiS5595 측정 특성
종류채널·범위해상도·분주기경보
온도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초그보다 빠른 읽기는 이전 값읽을 때 래치 해제 가능

센서 수, 범위, 해상도, 경보 조건을 정리합니다.

SiS5595 데이터·경보 갱신
마지막 갱신 시각 확인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.