Kernel driver nct6683 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

nct6683.rst:1-72

최대 32개 공유 온도·전압 센서와 16개 팬 센서를 지원하며, 비공개 Intel 레지스터 배치 때문에 쓰기를 차단합니다.

문서 개요

항목값

SourceDocumentation/hwmon/nct6683.rst

분량72 source lines

공유 센서최대 32

팬 센서최대 16

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

운영 흐름

ISA 주소 검색펌웨어 확인센서 읽기쓰기 제한 적용호환성 확인

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver nct6683

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

4 Supported chips:

6 * Nuvoton NCT6683D/NCT6686D/NCT6687D

8 Prefix: 'nct6683'

10 Addresses scanned: ISA address retrieved from Super I/O registers

12 Datasheet: Available from Nuvoton upon request

14 Authors:

16 Guenter Roeck <linux@roeck-us.net>

18 Description

19 -----------

21 This driver implements support for the Nuvoton NCT6683D eSIO chip.

23 The chips implement up to shared 32 temperature and voltage sensors.

24 It supports up to 16 fan rotation sensors and up to 8 fan control engines.

26 Temperatures are measured in degrees Celsius. Measurement resolution is

27 0.5 degrees C.

29 Voltage sensors (also known as IN sensors) report their values in millivolts.

31 Fan rotation speeds are reported in RPM (rotations per minute).

33 Usage Note

34 ----------

36 Limit register locations on Intel boards with EC firmware version 1.0

37 build date 04/03/13 do not match the register locations in the Nuvoton

38 datasheet. Nuvoton confirms that Intel uses a special firmware version

39 with different register addresses. The specification describing the Intel

40 firmware is held under NDA by Nuvoton and Intel and not available

41 to the public.

43 Some of the register locations can be reverse engineered; others are too

44 well hidden. Given this, writing any values from the operating system is

45 considered too risky with this firmware and has been disabled. All limits

46 must all be written from the BIOS.

48 The driver has only been tested with the Intel firmware, and by default

49 only instantiates on Intel boards. To enable it on non-Intel boards,

50 set the 'force' module parameter to 1.

52 Tested Boards and Firmware Versions

53 -----------------------------------

55 The driver has been reported to work with the following boards and

56 firmware versions.

58 =============================== ===============================================

59 Board Firmware version

60 =============================== ===============================================

61 Intel DH87RL NCT6683D EC firmware version 1.0 build 04/03/13

62 Intel DH87MC NCT6683D EC firmware version 1.0 build 04/03/13

63 Intel DB85FL NCT6683D EC firmware version 1.0 build 04/03/13

64 AMD BC-250 NCT6686D EC firmware version 1.0 build 07/28/21

65 ASRock X570 NCT6683D EC firmware version 1.0 build 06/28/19

66 ASRock X670E NCT6686D EC firmware version 1.0 build 05/19/22

67 ASRock B650 Steel Legend WiFi NCT6686D EC firmware version 1.0 build 11/09/23

68 ASRock Z590 Taichi NCT6686D EC firmware version 1.0 build 01/25/21

69 MSI B550 NCT6687D EC firmware version 1.0 build 05/07/20

70 MSI X670-P NCT6687D EC firmware version 0.0 build 09/27/22

71 MSI X870E NCT6687D EC firmware version 0.0 build 11/13/24

72 =============================== ===============================================

3. 한국어 전문 번역

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

NCT6683 계열 eSIO 센서 구성

1-32

이 문서는 Guenter Roeck이 작성한 `nct6683` 드라이버 설명입니다. Nuvoton NCT6683D·NCT6686D·NCT6687D를 지원하며 Super I/O 레지스터에서 ISA 주소를 얻습니다. 데이터시트는 Nuvoton에 요청해야 합니다.

드라이버는 NCT6683D eSIO 칩을 지원합니다. 칩은 온도와 전압이 공유하는 센서를 최대 32개, 팬 회전 센서를 최대 16개, 팬 제어 엔진을 최대 8개 구현합니다.

온도는 섭씨로 보고되며 해상도는 0.5°C입니다. 전압 IN 센서는 밀리볼트, 팬 회전 속도는 RPM 단위로 보고됩니다.

NCT6683 계열 센서 용량

기능최대 수단위·비고

온도·전압 공유 센서32온도 0.5°C, 전압 mV

팬 회전 센서16RPM

팬 제어 엔진8eSIO 제어

주소ISASuper I/O 레지스터에서 검색

공유 센서와 팬 감시·제어 수를 정리합니다.

NCT6683 센서 공개

Super I/O에서 ISA 주소 검색NCT6683 계열 식별활성 센서 목록 읽기온도·전압·RPM 변환hwmon 채널 공개

ISA 주소 검색부터 측정값 공개까지의 흐름입니다.

Kernel driver nct6683
=====================

Supported chips:

  * Nuvoton NCT6683D/NCT6686D/NCT6687D

    Prefix: 'nct6683'

    Addresses scanned: ISA address retrieved from Super I/O registers

    Datasheet: Available from Nuvoton upon request

Authors:

        Guenter Roeck <linux@roeck-us.net>

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

This driver implements support for the Nuvoton NCT6683D eSIO chip.

The chips implement up to shared 32 temperature and voltage sensors.
It supports up to 16 fan rotation sensors and up to 8 fan control engines.

Temperatures are measured in degrees Celsius. Measurement resolution is
0.5 degrees C.

Voltage sensors (also known as IN sensors) report their values in millivolts.

Fan rotation speeds are reported in RPM (rotations per minute).

Intel 특수 EC 펌웨어의 쓰기 금지

33-51

Intel 보드의 EC firmware version 1.0, build date 04/03/13에서는 한계 레지스터 위치가 Nuvoton 데이터시트와 일치하지 않습니다. Nuvoton은 Intel이 다른 레지스터 주소를 쓰는 특수 펌웨어를 사용한다고 확인했습니다.

해당 Intel 펌웨어 사양은 Nuvoton과 Intel의 NDA 아래 있어 공개되지 않습니다. 일부 주소는 역공학할 수 있지만 나머지는 찾기 어렵기 때문에 운영체제가 값을 쓰는 것은 위험하다고 판단되어 비활성화됐습니다. 모든 한계값은 BIOS가 기록해야 합니다.

드라이버는 Intel 펌웨어에서만 시험됐고 기본적으로 Intel 보드에서만 인스턴스화됩니다. 비 Intel 보드에서는 `force=1` 모듈 매개변수를 설정해야 합니다.

Intel EC 펌웨어 제약

항목정책

영향 펌웨어NCT6683D EC 1.0 build 04/03/13

레지스터 배치공개 데이터시트와 다름

OS 한계값 쓰기위험하므로 비활성화

한계값 설정 주체BIOS

비 Intel 보드force=1 필요

비공개 레지스터 배치 때문에 쓰기 동작을 제한합니다.

안전한 로딩 판단

보드 제조사 확인EC 펌웨어 버전 확인Intel 특수 주소 여부 판단한계값 쓰기 금지 유지필요할 때만 force=1 사용

보드와 펌웨어를 확인해 쓰기 위험을 피합니다.

Usage Note
----------

Limit register locations on Intel boards with EC firmware version 1.0
build date 04/03/13 do not match the register locations in the Nuvoton
datasheet. Nuvoton confirms that Intel uses a special firmware version
with different register addresses. The specification describing the Intel
firmware is held under NDA by Nuvoton and Intel and not available
to the public.

Some of the register locations can be reverse engineered; others are too
well hidden. Given this, writing any values from the operating system is
considered too risky with this firmware and has been disabled. All limits
must all be written from the BIOS.

The driver has only been tested with the Intel firmware, and by default
only instantiates on Intel boards. To enable it on non-Intel boards,
set the 'force' module parameter to 1.

시험된 보드와 펌웨어

52-72

보고된 동작 보드는 Intel DH87RL·DH87MC·DB85FL, AMD BC-250, ASRock X570·X670E·B650 Steel Legend WiFi·Z590 Taichi, MSI B550·X670-P·X870E입니다.

각 보드에는 NCT6683D·NCT6686D·NCT6687D EC 펌웨어와 고유 빌드 날짜가 대응합니다. 원문의 보드 및 펌웨어 표를 그대로 보존합니다.

NCT6683 시험 보드

보드군칩·펌웨어

Intel DH87RL/DH87MC/DB85FLNCT6683D EC 1.0, 04/03/13

AMD BC-250NCT6686D EC 1.0, 07/28/21

ASRock X570NCT6683D EC 1.0, 06/28/19

ASRock X670E/B650/Z590NCT6686D EC 1.0

MSI B550/X670-P/X870ENCT6687D EC 1.0 또는 0.0

보고된 보드와 EC 펌웨어 계열입니다.

호환성 확인

보드 모델 읽기NCT668xD 변형 확인EC 버전·빌드 날짜 확인시험 목록과 대조보수적 읽기 전용 정책 적용

보드명과 EC 빌드를 시험 목록에 대조합니다.

Tested Boards and Firmware Versions
-----------------------------------

The driver has been reported to work with the following boards and
firmware versions.

===============================        ===============================================
Board                                Firmware version
===============================        ===============================================
Intel DH87RL                        NCT6683D EC firmware version 1.0 build 04/03/13
Intel DH87MC                        NCT6683D EC firmware version 1.0 build 04/03/13
Intel DB85FL                        NCT6683D EC firmware version 1.0 build 04/03/13
AMD BC-250                        NCT6686D EC firmware version 1.0 build 07/28/21
ASRock X570                        NCT6683D EC firmware version 1.0 build 06/28/19
ASRock X670E                        NCT6686D EC firmware version 1.0 build 05/19/22
ASRock B650 Steel Legend WiFi        NCT6686D EC firmware version 1.0 build 11/09/23
ASRock Z590 Taichi                NCT6686D EC firmware version 1.0 build 01/25/21
MSI B550                        NCT6687D EC firmware version 1.0 build 05/07/20
MSI X670-P                        NCT6687D EC firmware version 0.0 build 09/27/22
MSI X870E                        NCT6687D EC firmware version 0.0 build 11/13/24
===============================        ===============================================