Kernel driver smsc47m1 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

smsc47m1.rst:1-86

Super I/O 구성 공간에서 주소를 얻어 두 팬의 RPM·PWM을 제어하고 전체 HWM 블록은 smsc47m192 드라이버에 맡깁니다.

문서 개요

항목값

SourceDocumentation/hwmon/smsc47m1.rst

분량86 source lines

팬2

PWM0~255

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

운영 흐름

장치 ID·주소 확인드라이버 역할 선택분주기 설정RPM·PWM 처리래치 경보 확인

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver smsc47m1

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

4 Supported chips:

6 * SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x,

8 LPC47M15x and LPC47M192

10 Addresses scanned: none, address read from Super I/O config space

12 Prefix: 'smsc47m1'

14 Datasheets:

16 http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf

18 http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf

20 http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf

22 http://www.smsc.com/

24 * SMSC LPC47M292

26 Addresses scanned: none, address read from Super I/O config space

28 Prefix: 'smsc47m2'

30 Datasheet: Not public

32 * SMSC LPC47M997

34 Addresses scanned: none, address read from Super I/O config space

36 Prefix: 'smsc47m1'

38 Datasheet: none

42 Authors:

44 - Mark D. Studebaker <mdsxyz123@yahoo.com>,

45 - With assistance from Bruce Allen <ballen@uwm.edu>, and his

46 fan.c program:

48 - http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/

50 - Gabriele Gorla <gorlik@yahoo.com>,

51 - Jean Delvare <jdelvare@suse.de>

53 Description

54 -----------

56 The Standard Microsystems Corporation (SMSC) 47M1xx Super I/O chips

57 contain monitoring and PWM control circuitry for two fans.

59 The LPC47M15x, LPC47M192 and LPC47M292 chips contain a full 'hardware

60 monitoring block' in addition to the fan monitoring and control. The

61 hardware monitoring block is not supported by this driver, use the

62 smsc47m192 driver for that.

64 No documentation is available for the 47M997, but it has the same device

65 ID as the 47M15x and 47M192 chips and seems to be compatible.

67 Fan rotation speeds are reported in RPM (rotations per minute). An alarm is

68 triggered if the rotation speed has dropped below a programmable limit. Fan

69 readings can be divided by a programmable divider (1, 2, 4 or 8) to give

70 the readings more range or accuracy. Not all RPM values can accurately be

71 represented, so some rounding is done. With a divider of 2, the lowest

72 representable value is around 2600 RPM.

74 PWM values are from 0 to 255.

76 If an alarm triggers, it will remain triggered until the hardware register

77 is read at least once. This means that the cause for the alarm may

78 already have disappeared! Note that in the current implementation, all

79 hardware registers are read whenever any data is read (unless it is less

80 than 1.5 seconds since the last update). This means that you can easily

81 miss once-only alarms.

83 ------------------------------------------------------------------

85 The lm_sensors project gratefully acknowledges the support of

86 Intel in the development of this driver.

3. 한국어 전문 번역

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

SMSC 47M1xx·LPC47M292·LPC47M997

1-52

`smsc47m1` 드라이버는 SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x, LPC47M15x, LPC47M192와 LPC47M997을 접두사 `smsc47m1`로 지원합니다. LPC47M292는 접두사 `smsc47m2`를 사용합니다.

모든 장치는 주소를 자동 검색하지 않고 Super I/O 구성 공간에서 주소를 읽습니다. LPC47B27x·M10x·M112 계열 데이터시트 링크가 제공되지만 LPC47M292 자료는 비공개이고 LPC47M997 자료는 없습니다.

작성자는 Mark D. Studebaker, Gabriele Gorla, Jean Delvare이며 Bruce Allen과 그의 `fan.c` 프로그램이 개발을 도왔습니다.

smsc47m1 지원 제품군

제품군접두사주소데이터시트

LPC47B27x·M112·M10x·M13x·M14x·M15x·M192smsc47m1Super I/O 구성 공간일부 공개

LPC47M292smsc47m2Super I/O 구성 공간비공개

LPC47M997smsc47m1Super I/O 구성 공간없음

제품군별 접두사와 데이터시트 공개 상태입니다.

47M1xx 장치 결합

Super I/O 구성 공간 진입장치 ID와 HWM 주소 판독M292 여부로 smsc47m1·smsc47m2 선택팬 감시·PWM 기능 초기화팬 채널과 경보 생성

Super I/O ID로 제품군을 구분해 맞는 접두사와 팬 기능을 등록합니다.

Kernel driver smsc47m1
======================

Supported chips:

  * SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x,

    LPC47M15x and LPC47M192

    Addresses scanned: none, address read from Super I/O config space

    Prefix: 'smsc47m1'

    Datasheets:

        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf

        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf

        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf

        http://www.smsc.com/

  * SMSC LPC47M292

    Addresses scanned: none, address read from Super I/O config space

    Prefix: 'smsc47m2'

    Datasheet: Not public

  * SMSC LPC47M997

    Addresses scanned: none, address read from Super I/O config space

    Prefix: 'smsc47m1'

    Datasheet: none



Authors:

     - Mark D. Studebaker <mdsxyz123@yahoo.com>,
     - With assistance from Bruce Allen <ballen@uwm.edu>, and his
       fan.c program:

       - http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/

     - Gabriele Gorla <gorlik@yahoo.com>,
     - Jean Delvare <jdelvare@suse.de>

두 팬 감시·PWM와 별도 HWM 블록

53-66

SMSC 47M1xx Super I/O 칩에는 두 팬을 위한 감시 및 PWM 제어 회로가 들어 있습니다.

LPC47M15x, LPC47M192, LPC47M292에는 팬 감시·제어 외에 완전한 하드웨어 모니터링 블록도 있지만 이 드라이버는 그 블록을 지원하지 않습니다. 해당 기능에는 `smsc47m192` 드라이버를 사용해야 합니다.

LPC47M997 자료는 없지만 LPC47M15x·LPC47M192와 장치 ID가 같고 호환되는 것으로 보입니다.

47M1xx 기능 경계

기능·칩지원 드라이버상태

두 팬 감시·PWMsmsc47m1지원

M15x·M192·M292 전체 HWM 블록smsc47m192smsc47m1에서는 미지원

LPC47M997 팬 기능smsc47m1동일 ID 기반 호환 추정

smsc47m1과 smsc47m192 드라이버의 담당 영역을 구분합니다.

드라이버 역할 선택

장치 모델 확인팬 감시·PWM만 필요하면 smsc47m1 선택M15x·M192·M292 전체 HWM 필요 여부 확인전체 HWM에는 smsc47m192 사용LPC47M997은 호환성 검증 후 팬 기능 사용

팬 전용 기능과 전체 모니터링 블록을 구분합니다.

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

The Standard Microsystems Corporation (SMSC) 47M1xx Super I/O chips
contain monitoring and PWM control circuitry for two fans.

The LPC47M15x, LPC47M192 and LPC47M292 chips contain a full 'hardware
monitoring block' in addition to the fan monitoring and control. The
hardware monitoring block is not supported by this driver, use the
smsc47m192 driver for that.

No documentation is available for the 47M997, but it has the same device
ID as the 47M15x and 47M192 chips and seems to be compatible.

팬 분주기·PWM·한 번성 경보

67-86

팬 회전 속도는 RPM으로 보고하며 속도가 설정 가능한 하한 아래로 내려가면 경보가 발생합니다. 분주기는 1, 2, 4, 8이고 측정 범위와 정확도를 조절합니다.

모든 RPM 값을 정확히 표현할 수 없어 반올림이 발생합니다. 분주기 2에서 표현 가능한 최저 속도는 약 2600 RPM입니다. PWM 값 범위는 0~255입니다.

경보가 발생하면 하드웨어 레지스터를 한 번 이상 읽을 때까지 유지되므로 원인이 이미 사라졌을 수 있습니다. 마지막 갱신 후 1.5초 미만인 경우를 제외하면 어떤 데이터를 읽어도 모든 레지스터를 읽는 현재 구현 때문에 한 번만 발생한 경보를 쉽게 놓칠 수 있습니다.

lm_sensors 프로젝트는 이 드라이버 개발을 지원한 Intel에 감사를 표합니다.

smsc47m1 팬 특성

항목값·동작

팬 단위RPM

팬 경보설정 하한 미만

분주기1·2·4·8

분주기 2 최저 표현값약 2600 RPM

PWM0~255

데이터 캐시마지막 갱신 후 1.5초

경보 해제하드웨어 레지스터 판독 시

분주기·PWM 범위·경보 래치 동작입니다.

팬 측정과 경보 처리

팬 분주기와 최저 속도 설정PWM 0~255 적용RPM 측정 및 반올림하한 미만 경보 래치1.5초 갱신 시 레지스터 판독과 경보 해제

캐시 갱신과 읽기 시 경보 해제를 고려해 팬 상태를 수집합니다.

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.

PWM values are from 0 to 255.

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 lm_sensors project gratefully acknowledges the support of
Intel in the development of this driver.