Kernel driver nct7904 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

nct7904.rst:1-67

활성 센서만 노출하고 BIOS가 구성한 SmartFan과 수동 PWM을 전환하며 미지원 기능을 명확히 구분합니다.

문서 개요

항목값

SourceDocumentation/hwmon/nct7904.rst

분량67 source lines

전압 센서최대 20

팬 입력최대 12

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

운영 흐름

I2C 검색활성 센서 확인측정값 공개PWM 모드 전환제한사항 적용

장치 등록부터 측정·제어까지의 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver nct7904

2 =====================

4 Supported chip:

6 * Nuvoton NCT7904D

8 Prefix: nct7904

10 Addresses: I2C 0x2d, 0x2e

12 Datasheet: Publicly available at Nuvoton website

14 http://www.nuvoton.com/

16 Author: Vadim V. Vlasov <[email protected]>

19 Description

20 -----------

22 The NCT7904D is a hardware monitor supporting up to 20 voltage sensors,

23 internal temperature sensor, Intel PECI and AMD SB-TSI CPU temperature

24 interface, up to 12 fan tachometer inputs, up to 4 fan control channels

25 with SmartFan.

28 Sysfs entries

29 -------------

31 Currently, the driver supports only the following features:

33 ======================= =======================================================

34 in[1-20]_input Input voltage measurements (mV)

36 fan[1-12]_input Fan tachometer measurements (rpm)

38 temp1_input Local temperature (1/1000 degree,

39 0.125 degree resolution)

41 temp[2-9]_input CPU temperatures (1/1000 degree,

42 0.125 degree resolution)

44 pwm[1-4]_enable R/W, 1/2 for manual or SmartFan mode

45 Setting SmartFan mode is supported only if it has been

46 previously configured by BIOS (or configuration EEPROM)

48 pwm[1-4] R/O in SmartFan mode, R/W in manual control mode

49 ======================= =======================================================

51 The driver checks sensor control registers and does not export the sensors

52 that are not enabled. Anyway, a sensor that is enabled may actually be not

53 connected and thus provide zero readings.

56 Limitations

57 -----------

59 The following features are not supported in current version:

61 - SmartFan control

62 - Watchdog

63 - GPIO

64 - external temperature sensors

65 - SMI

66 - min/max values

67 - many other...

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

NCT7904D 대용량 하드웨어 모니터

1-26

이 문서는 Vadim V. Vlasov가 작성한 `nct7904` 드라이버 설명입니다. Nuvoton NCT7904D를 지원하며 I2C 주소는 `0x2d`, `0x2e`입니다. 데이터시트는 Nuvoton 웹사이트에 공개되어 있습니다.

NCT7904D는 전압 센서 최대 20개, 내부 온도 센서, Intel PECI와 AMD SB-TSI CPU 온도 인터페이스, 팬 타코미터 입력 최대 12개, SmartFan 팬 제어 채널 최대 4개를 지원합니다.

NCT7904D 용량

기능최대 수·방식

전압 센서20

로컬 온도내부 센서 1

CPU 온도Intel PECI, AMD SB-TSI

팬 타코미터12

팬 제어SmartFan 4채널

I2C 주소0x2d, 0x2e

전압·온도·팬 감시와 제어 채널입니다.

NCT7904 센서 구성

I2C 주소 검색NCT7904D 식별센서 제어 레지스터 확인활성 채널만 등록hwmon 속성 공개

활성화된 전압·온도·팬 채널을 등록합니다.

Kernel driver nct7904
=====================

Supported chip:

  * Nuvoton NCT7904D

    Prefix: nct7904

    Addresses: I2C 0x2d, 0x2e

    Datasheet: Publicly available at Nuvoton website

        http://www.nuvoton.com/

Author: Vadim V. Vlasov <[email protected]>


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

The NCT7904D is a hardware monitor supporting up to 20 voltage sensors,
internal temperature sensor, Intel PECI and AMD SB-TSI CPU temperature
interface, up to 12 fan tachometer inputs, up to 4 fan control channels
with SmartFan.

전압·팬·온도·PWM sysfs

27-53

현재 드라이버는 `in[1-20]_input` 전압 mV, `fan[1-12]_input` 팬 RPM, `temp1_input` 로컬 온도, `temp[2-9]_input` CPU 온도를 제공합니다. 온도 단위는 1/1000°C이고 해상도는 0.125°C입니다.

`pwm[1-4]_enable`은 읽기·쓰기가 가능하며 1은 수동, 2는 SmartFan 모드입니다. SmartFan은 BIOS 또는 구성 EEPROM이 미리 설정한 경우에만 선택할 수 있습니다. `pwm[1-4]`는 SmartFan 모드에서 읽기 전용, 수동 모드에서 읽기·쓰기입니다.

드라이버는 센서 제어 레지스터를 검사해 비활성 센서를 내보내지 않습니다. 활성 센서라도 실제로 연결되지 않았다면 0을 보고할 수 있습니다.

NCT7904 sysfs

속성의미·권한

in[1-20]_input입력 전압 mV

fan[1-12]_input팬 타코미터 RPM

temp1_input로컬 온도, 0.125°C 해상도

temp[2-9]_inputCPU 온도, PECI/SB-TSI

pwm[1-4]_enableRW, 1 수동·2 SmartFan

pwm[1-4]SmartFan RO, 수동 RW

지원 채널과 모드별 PWM 권한입니다.

PWM 모드 적용

활성 팬 채널 확인BIOS·EEPROM SmartFan 구성 확인enable 1 또는 2 선택모드별 pwm 권한 적용RPM과 온도 감시

BIOS 구성 여부에 따라 SmartFan 진입을 제한합니다.


Sysfs entries
-------------

Currently, the driver supports only the following features:

======================= =======================================================
in[1-20]_input                Input voltage measurements (mV)

fan[1-12]_input                Fan tachometer measurements (rpm)

temp1_input                Local temperature (1/1000 degree,
                        0.125 degree resolution)

temp[2-9]_input                CPU temperatures (1/1000 degree,
                        0.125 degree resolution)

pwm[1-4]_enable                R/W, 1/2 for manual or SmartFan mode
                        Setting SmartFan mode is supported only if it has been
                        previously configured by BIOS (or configuration EEPROM)

pwm[1-4]                R/O in SmartFan mode, R/W in manual control mode
======================= =======================================================

The driver checks sensor control registers and does not export the sensors
that are not enabled. Anyway, a sensor that is enabled may actually be not
connected and thus provide zero readings.

현재 지원하지 않는 기능

54-67

현재 버전은 SmartFan 제어 자체, watchdog, GPIO, 외부 온도 센서, SMI, 최소·최대값 및 기타 여러 기능을 지원하지 않습니다. 앞 구간의 SmartFan 모드 선택은 BIOS나 EEPROM에서 이미 구성된 동작을 전환하는 범위로 이해해야 합니다.

NCT7904 제한사항

미지원 기능상태

SmartFan control미지원

Watchdog미지원

GPIO미지원

외부 온도 센서미지원

SMI미지원

min/max 값미지원

기타 기능다수 미지원

드라이버가 아직 구현하지 않은 기능입니다.

지원 범위 판단

요청 기능 식별현재 sysfs 목록 대조제한사항 확인미지원 쓰기 차단지원 측정값만 사용

노출 속성과 미지원 기능을 구분합니다.



Limitations
-----------

The following features are not supported in current version:

 - SmartFan control
 - Watchdog
 - GPIO
 - external temperature sensors
 - SMI
 - min/max values
 - many other...