Kernel driver lm25066 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

lm25066.rst:1-139

션트 저항을 반영해 입력·출력 전압, 입력 전류·전력, 온도와 경보를 제공하고 최고 전력 이력을 관리합니다.

문서 개요

항목값

SourceDocumentation/hwmon/lm25066.rst

분량139 source lines

코어PMBus

지원 칩5종

원문 분량과 핵심 인터페이스입니다.

동작 흐름

칩 유형 선택션트 저항 설정PMBus 등록전력 이력 감시

장치 연결부터 hwmon 사용까지의 핵심 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver lm25066

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

4 Supported chips:

6 * TI LM25056

8 Prefix: 'lm25056'

10 Addresses scanned: -

12 Datasheets:

14 https://www.ti.com/lit/gpn/lm25056

16 https://www.ti.com/lit/gpn/lm25056a

18 * National Semiconductor LM25066

20 Prefix: 'lm25066'

22 Addresses scanned: -

24 Datasheets:

26 http://www.national.com/pf/LM/LM25066.html

28 http://www.national.com/pf/LM/LM25066A.html

30 * National Semiconductor LM5064

32 Prefix: 'lm5064'

34 Addresses scanned: -

36 Datasheet:

38 http://www.national.com/pf/LM/LM5064.html

40 * National Semiconductor LM5066

42 Prefix: 'lm5066'

44 Addresses scanned: -

46 Datasheet:

48 http://www.national.com/pf/LM/LM5066.html

50 * Texas Instruments LM5066I

52 Prefix: 'lm5066i'

54 Addresses scanned: -

56 Datasheet:

58 https://www.ti.com/product/LM5066I

61 Author: Guenter Roeck <linux@roeck-us.net>

64 Description

65 -----------

67 This driver supports hardware monitoring for National Semiconductor / TI LM25056,

68 LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,

69 Control, and Protection ICs.

71 The driver is a client driver to the core PMBus driver. Please see

72 Documentation/hwmon/pmbus.rst for details on PMBus client drivers.

75 Usage Notes

76 -----------

78 This driver does not auto-detect devices. You will have to instantiate the

79 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for

80 details.

82 The shunt (sense) resistor value can be configured by a device tree property;

83 see Documentation/devicetree/bindings/hwmon/pmbus/ti,lm25066.yaml for details.

85 Platform data support

86 ---------------------

88 The driver supports standard PMBus driver platform data.

91 Sysfs entries

92 -------------

94 The following attributes are supported. Limits are read-write; all other

95 attributes are read-only.

97 ======================= =======================================================

98 in1_label "vin"

99 in1_input Measured input voltage.

100 in1_average Average measured input voltage.

101 in1_min Minimum input voltage.

102 in1_max Maximum input voltage.

103 in1_min_alarm Input voltage low alarm.

104 in1_max_alarm Input voltage high alarm.

105

106 in2_label "vmon"

107 in2_input Measured voltage on VAUX pin

108 in2_min Minimum VAUX voltage (LM25056 only).

109 in2_max Maximum VAUX voltage (LM25056 only).

110 in2_min_alarm VAUX voltage low alarm (LM25056 only).

111 in2_max_alarm VAUX voltage high alarm (LM25056 only).

112

113 in3_label "vout1"

114 Not supported on LM25056.

115 in3_input Measured output voltage.

116 in3_average Average measured output voltage.

117 in3_min Minimum output voltage.

118 in3_min_alarm Output voltage low alarm.

119

120 curr1_label "iin"

121 curr1_input Measured input current.

122 curr1_average Average measured input current.

123 curr1_max Maximum input current.

124 curr1_max_alarm Input current high alarm.

125

126 power1_label "pin"

127 power1_input Measured input power.

128 power1_average Average measured input power.

129 power1_max Maximum input power limit.

130 power1_alarm Input power alarm

131 power1_input_highest Historical maximum power.

132 power1_reset_history Write any value to reset maximum power history.

133

134 temp1_input Measured temperature.

135 temp1_max Maximum temperature.

136 temp1_crit Critical high temperature.

137 temp1_max_alarm Chip temperature high alarm.

138 temp1_crit_alarm Chip temperature critical high alarm.

139 ======================= =======================================================

140

3. 한국어 전문 번역

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

지원 전력 관리 IC 계열

1-63

이 드라이버는 TI LM25056과 LM5066I, National Semiconductor LM25066·LM5064·LM5066을 지원합니다. 각 칩의 접두사는 `lm25056`, `lm25066`, `lm5064`, `lm5066`, `lm5066i`이며 주소 자동 검색은 하지 않습니다.

문서는 각 제조사의 데이터시트 링크를 보존하며 작성자는 Guenter Roeck입니다. LM25056과 LM25066은 A 변형 자료도 함께 제시됩니다.

LM25066 계열

제조사칩접두사

TILM25056lm25056

National SemiconductorLM25066lm25066

National SemiconductorLM5064lm5064

National SemiconductorLM5066lm5066

TILM5066Ilm5066i

지원 칩과 드라이버 접두사를 대응시킵니다.

장치 유형 선택

회로도에서 부품명 확인대응 접두사 선택I2C 버스와 주소 확인명시적으로 장치 등록

보드에 실장된 부품명으로 클라이언트 유형을 정합니다.

Kernel driver lm25066
=====================

Supported chips:

  * TI LM25056

    Prefix: 'lm25056'

    Addresses scanned: -

    Datasheets:

        https://www.ti.com/lit/gpn/lm25056

        https://www.ti.com/lit/gpn/lm25056a

  * National Semiconductor LM25066

    Prefix: 'lm25066'

    Addresses scanned: -

    Datasheets:

        http://www.national.com/pf/LM/LM25066.html

        http://www.national.com/pf/LM/LM25066A.html

  * National Semiconductor LM5064

    Prefix: 'lm5064'

    Addresses scanned: -

    Datasheet:

        http://www.national.com/pf/LM/LM5064.html

  * National Semiconductor LM5066

    Prefix: 'lm5066'

    Addresses scanned: -

    Datasheet:

        http://www.national.com/pf/LM/LM5066.html

  * Texas Instruments LM5066I

    Prefix: 'lm5066i'

    Addresses scanned: -

        Datasheet:

    https://www.ti.com/product/LM5066I


Author: Guenter Roeck <linux@roeck-us.net>

PMBus 코어와 션트 저항 구성

64-90

LM25056, LM25066, LM5064, LM5066 및 LM5066I는 전력 관리·감시·제어·보호 IC이며, 이 드라이버는 PMBus 코어 드라이버의 클라이언트입니다. PMBus 클라이언트의 자세한 동작은 `Documentation/hwmon/pmbus.rst`를 참조합니다.

장치는 자동 감지되지 않으므로 명시적으로 생성해야 합니다. 등록 방법은 `Documentation/i2c/instantiating-devices.rst`에 설명되어 있습니다.

전류 계산에 쓰이는 션트 감지 저항값은 장치 트리 속성으로 설정할 수 있고 바인딩은 `Documentation/devicetree/bindings/hwmon/pmbus/ti,lm25066.yaml`에 있습니다. 표준 PMBus 드라이버 플랫폼 데이터도 지원합니다.

LM25066 구성 지점

구성설명

PMBus 코어클라이언트 드라이버로 연결

장치 생성자동 감지 없이 명시적 등록

션트 저항장치 트리 속성으로 설정

플랫폼 데이터표준 PMBus 형식 지원

전류·전력 환산을 좌우하는 입력과 관련 문서입니다.

전력 모니터 초기화

칩 유형과 I2C 주소 확인션트 저항값 확인장치 트리 또는 플랫폼 데이터 설정PMBus 클라이언트 생성환산된 전류·전력 검증

장치 설명과 션트 값을 확정한 뒤 PMBus에 연결합니다.

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

This driver supports hardware monitoring for National Semiconductor / TI LM25056,
LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
Control, and Protection ICs.

The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus.rst for details on PMBus client drivers.


Usage Notes
-----------

This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.

The shunt (sense) resistor value can be configured by a device tree property;
see Documentation/devicetree/bindings/hwmon/pmbus/ti,lm25066.yaml for details.

Platform data support
---------------------

The driver supports standard PMBus driver platform data.

입출력 전압·전류·전력·온도 속성

91-139

다음 속성 중 제한값은 읽기·쓰기가 가능하고 나머지는 읽기 전용입니다. `in1`은 `vin`으로 입력 전압의 현재값·평균·최소·최대와 저전압·고전압 경보를 제공합니다.

`in2`는 `vmon`으로 VAUX 핀 전압을 측정하며, 최소·최대 제한과 경보는 LM25056에서만 지원합니다. `in3`은 `vout1`으로 출력 전압의 현재값·평균·최소와 저전압 경보를 제공하지만 LM25056에서는 지원하지 않습니다.

`curr1`은 `iin` 입력 전류의 현재값·평균·최대 제한·고전류 경보를 제공합니다. `power1`은 `pin` 입력 전력의 현재값·평균·최대 제한·경보·과거 최고값을 제공하며, `power1_reset_history`에 아무 값이나 쓰면 최대 전력 이력을 초기화합니다.

온도 속성은 `temp1_input`, `temp1_max`, `temp1_crit`, `temp1_max_alarm`, `temp1_crit_alarm`입니다.

LM25066 sysfs 채널

채널측정특이 사항

in1 / vin입력 전압 현재·평균·최소·최대저·고전압 경보

in2 / vmonVAUX 전압제한·경보는 LM25056만

in3 / vout1출력 전압 현재·평균·최소LM25056 미지원

curr1 / iin입력 전류 현재·평균·최대고전류 경보

power1 / pin입력 전력·최고 이력쓰기 시 이력 초기화

temp1온도·최대·임계고온·임계 경보

측정 채널별 값과 모델별 예외를 정리합니다.

전력 이력 관리

입력 전압·전류·전력 읽기제한값과 경보 비교power1_input_highest 확인필요 시 power1_reset_history 기록새 이력 누적 확인

순간값과 이력 최고값을 함께 운용합니다.

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

The following attributes are supported. Limits are read-write; all other
attributes are read-only.

======================= =======================================================
in1_label                "vin"
in1_input                Measured input voltage.
in1_average                Average measured input voltage.
in1_min                        Minimum input voltage.
in1_max                        Maximum input voltage.
in1_min_alarm                Input voltage low alarm.
in1_max_alarm                Input voltage high alarm.

in2_label                "vmon"
in2_input                Measured voltage on VAUX pin
in2_min                        Minimum VAUX voltage (LM25056 only).
in2_max                        Maximum VAUX voltage (LM25056 only).
in2_min_alarm                VAUX voltage low alarm (LM25056 only).
in2_max_alarm                VAUX voltage high alarm (LM25056 only).

in3_label                "vout1"
                        Not supported on LM25056.
in3_input                Measured output voltage.
in3_average                Average measured output voltage.
in3_min                        Minimum output voltage.
in3_min_alarm                Output voltage low alarm.

curr1_label                "iin"
curr1_input                Measured input current.
curr1_average                Average measured input current.
curr1_max                Maximum input current.
curr1_max_alarm                Input current high alarm.

power1_label                "pin"
power1_input                Measured input power.
power1_average                Average measured input power.
power1_max                Maximum input power limit.
power1_alarm                Input power alarm
power1_input_highest        Historical maximum power.
power1_reset_history        Write any value to reset maximum power history.

temp1_input                Measured temperature.
temp1_max                Maximum temperature.
temp1_crit                Critical high temperature.
temp1_max_alarm                Chip temperature high alarm.
temp1_crit_alarm        Chip temperature critical high alarm.
======================= =======================================================