Kernel driver adp1050 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

adp1050.rst:1-123

Isolated power controller와 step-down μModule의 명시적 등록 및 전체 sysfs attribute를 설명합니다.

문서 개요

항목값

SourceDocumentation/hwmon/adp1050.rst

분량123 source lines

InterfacePMBus

ProductsADP105x, LTP8800

원문 분량과 핵심 지원 범위입니다.

핵심 흐름

모델과 주소 확인장치 명시적 등록전압·전류 읽기전력·온도 alarm 감시

장치를 구성하고 측정하는 기본 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 .. SPDX-License-Identifier: GPL-2.0

3 Kernel driver adp1050

4 =====================

6 Supported chips:

8 * Analog Devices ADP1050

10 Prefix: 'adp1050'

12 Addresses scanned: I2C 0x70 - 0x77

14 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1050.pdf

16 * Analog Devices ADP1051

18 Prefix: 'adp1051'

20 Addresses scanned: I2C 0x70 - 0x77

22 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1051.pdf

24 * Analog Devices ADP1055

26 Prefix: 'adp1055'

28 Addresses scanned: I2C 0x4B - 0x77

30 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1055.pdf

32 * Analog Devices LTP8800-1A/-2/-4A

34 Prefix: 'ltp8800'

36 Addresses scanned: -

38 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-1A.pdf

39 https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-2.pdf

40 https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-4A.pdf

42 Authors:

44 - Radu Sabau <[email protected]>

47 Description

48 -----------

50 This driver supports hardware monitoring for Analog Devices ADP1050, ADP1051,

51 and ADP1055 Digital Controller for Isolated Power Supply with PMBus interface,

52 and the LTP8800 step-down μModule regulators.

54 The ADP1050, ADP1051, and ADP1055 are advanced digital controllers with PMBus™

55 interface targeting high density, high efficiency dc-to-dc power

56 conversion used to monitor system temperatures, voltages and currents. The

57 LTP8800 is a family of step-down μModule regulators that provides microprocessor

58 core voltage from 54V power distribution architecture. Through the PMBus

59 interface, the device can monitor input/output voltages, input current and

60 temperature.

62 Usage Notes

63 -----------

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

66 the devices explicitly.

67 Please see Documentation/i2c/instantiating-devices.rst for details.

69 Platform data support

70 ---------------------

72 The driver supports standard PMBus driver platform data.

74 Sysfs Attributes

75 ----------------

77 ================= ========================================

78 in1_label "vin"

79 in1_input Measured input voltage

80 in1_alarm Input voltage alarm

81 in1_crit Critical maximum input voltage

82 in1_crit_alarm Input voltage high alarm

83 in1_lcrit Critical minimum input voltage

84 in1_lcrit_alarm Input voltage critical low alarm

85 in2_label "vout1"

86 in2_input Measured output voltage

87 in2_crit Critical maximum output voltage

88 in2_crit_alarm Output voltage high alarm

89 in2_lcrit Critical minimum output voltage

90 in2_lcrit_alarm Output voltage critical low alarm

91 in2_max Critical maximum output voltage

92 in2_max_alarm Output voltage critical max alarm

93 in2_min Critical minimum output voltage

94 in2_min_alarm Output voltage critical min alarm

95 curr1_label "iin"

96 curr1_input Measured input current.

97 curr1_alarm Input current alarm

98 curr1_crit Critical maximum input current

99 curr1_crit_alarm Input current high alarm

100 curr2_label "iout1"

101 curr2_input Measured output current

102 curr2_alarm Output current alarm

103 curr2_crit Critical maximum output current

104 curr2_crit_alarm Output current high alarm

105 curr2_lcrit Critical minimum output current

106 curr2_lcrit_alarm Output current critical low alarm

107 curr2_max Critical maximum output current

108 curr2_max_alarm Output current critical max alarm

109 power1_label "pout1"

110 power1_input Measured output power

111 power1_crit Critical maximum output power

112 power1_crit_alarm Output power high alarm

113 temp1_input Measured temperature

114 temp1_crit Critical high temperature

115 temp1_crit_alarm Chip temperature critical high alarm

116 temp1_max Critical maximum temperature

117 temp1_max_alarm Temperature critical max alarm

118 temp2_input Measured temperature

119 temp2_crit Critical high temperature

120 temp2_crit_alarm Chip temperature critical high alarm

121 temp2_max Critical maximum temperature

122 temp2_max_alarm Temperature critical max alarm

123 ================= ========================================

124

3. 한국어 전문 번역

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

ADP105x와 LTP8800 지원

1-46

이 GPL-2.0 문서는 Analog Devices `ADP1050`, `ADP1051`, `ADP1055`와 `LTP8800-1A/-2/-4A`를 지원하는 드라이버를 설명합니다.

ADP1050의 prefix는 `adp1050`, ADP1051은 `adp1051`이며 두 칩 모두 I2C `0x70`부터 `0x77`까지 검색합니다. ADP1055의 prefix는 `adp1055`이고 검색 범위는 I2C `0x4B`부터 `0x77`까지입니다.

LTP8800 계열의 prefix는 `ltp8800`이며 자동 검색 주소는 없습니다. LTP8800-1A, LTP8800-2, LTP8800-4A용 데이터시트 URL이 각각 제공됩니다. 저자는 Radu Sabau입니다.

지원 장치

장치Prefix검색 주소

ADP1050adp10500x70 ~ 0x77

ADP1051adp10510x70 ~ 0x77

ADP1055adp10550x4B ~ 0x77

LTP8800-1A/-2/-4Altp8800없음

모델별 prefix와 자동 검색 범위입니다.

장치 결합

ADP105x 또는 LTP8800 모델 확인지원되는 주소 범위 확인LTP8800은 platform에서 명시적 선언모델별 prefix로 driver 결합

주소 검색 또는 명시적 선언으로 PMBus client를 등록합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver adp1050
=====================

Supported chips:

  * Analog Devices ADP1050

    Prefix: 'adp1050'

    Addresses scanned: I2C 0x70 - 0x77

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1050.pdf

  * Analog Devices ADP1051

    Prefix: 'adp1051'

    Addresses scanned: I2C 0x70 - 0x77

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1051.pdf

  * Analog Devices ADP1055

    Prefix: 'adp1055'

    Addresses scanned: I2C 0x4B - 0x77

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1055.pdf

  * Analog Devices LTP8800-1A/-2/-4A

    Prefix: 'ltp8800'

    Addresses scanned: -

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-1A.pdf
         https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-2.pdf
         https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-4A.pdf

Authors:

  - Radu Sabau <[email protected]>

전력 변환 monitor와 등록 방식

47-73

드라이버는 PMBus interface를 갖춘 isolated power supply용 Digital Controller인 ADP1050, ADP1051, ADP1055와 LTP8800 step-down μModule regulator의 hardware monitoring을 지원합니다.

ADP1050, ADP1051, ADP1055는 고밀도·고효율 DC-to-DC power conversion을 대상으로 하는 advanced digital controller입니다. PMBus interface를 통해 system temperature, voltage, current를 감시합니다.

LTP8800은 54V power distribution architecture에서 microprocessor core voltage를 제공하는 step-down μModule regulator 계열입니다. PMBus를 통해 input/output voltage, input current와 temperature를 감시할 수 있습니다.

이 드라이버는 장치를 자동 검색하지 않습니다. 사용자가 명시적으로 instantiate해야 하며 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참조합니다. 표준 PMBus driver platform data도 지원합니다.

전력 장치 기능

제품군역할PMBus 감시

ADP1050/1051/1055Isolated supply digital controllerTemperature, voltage, current

LTP880054V architecture step-down μModuleInput/output voltage, input current, temperature

두 제품군의 역할과 감시 채널입니다.

명시적 등록

I2C bus와 model 확인장치를 명시적으로 instantiateStandard PMBus platform data 적용Hwmon attribute 등록전압·전류·전력·온도 감시

Autodetection 없이 platform 정보로 장치를 생성합니다.

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

This driver supports hardware monitoring for Analog Devices ADP1050, ADP1051,
and ADP1055 Digital Controller for Isolated Power Supply with PMBus interface,
and the LTP8800 step-down μModule regulators.

The ADP1050, ADP1051, and ADP1055 are advanced digital controllers with PMBus™
interface targeting high density, high efficiency dc-to-dc power
conversion used to monitor system temperatures, voltages and currents. The
LTP8800 is a family of step-down μModule regulators that provides microprocessor
core voltage from 54V power distribution architecture. Through the PMBus
interface, the device can monitor input/output voltages, input current and
temperature.

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.

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

The driver supports standard PMBus driver platform data.

Input voltage와 input current sysfs

74-99

Input voltage label `in1_label`은 `vin`입니다. `in1_input`은 측정 input voltage이고 `in1_alarm`은 input voltage alarm입니다. `in1_crit`과 `in1_lcrit`은 각각 critical maximum 및 minimum input voltage이며 `in1_crit_alarm`, `in1_lcrit_alarm`은 high 및 critical low alarm입니다.

Output voltage label `in2_label`은 `vout1`입니다. `in2_input`은 측정 output voltage입니다. `in2_crit`, `in2_lcrit`과 해당 alarm은 critical maximum 및 minimum을 나타냅니다. `in2_max`, `in2_min`도 critical maximum 및 minimum output voltage로 설명되며 `in2_max_alarm`, `in2_min_alarm`은 critical max/min alarm입니다.

Input current label `curr1_label`은 `iin`입니다. `curr1_input`은 측정 input current, `curr1_alarm`은 input current alarm, `curr1_crit`은 critical maximum input current이며 `curr1_crit_alarm`은 input current high alarm입니다.

입력과 전압 attribute

GroupAttribute의미

Input voltagein1_input/alarmvin 측정값과 일반 alarm

Input voltage limitin1_crit/lcritCritical max/min 및 alarm

Output voltagein2_inputvout1 측정값

Output voltage limitin2_crit/lcrit/max/minCritical max/min 및 각 alarm

Input currentcurr1_input/alarm/critiin 측정값, alarm, critical max

원문의 sysfs 표를 전압 및 input current group으로 정리합니다.

Voltage·current 경보

vin 또는 vout1 측정Critical min/max 값 읽기범위를 벗어나면 대응 alarm 설정iin 측정과 critical max 비교Sysfs alarm을 사용자 공간에 보고

측정값을 각 critical limit와 비교합니다.

Sysfs Attributes
----------------

================= ========================================
in1_label         "vin"
in1_input         Measured input voltage
in1_alarm          Input voltage alarm
in1_crit          Critical maximum input voltage
in1_crit_alarm    Input voltage high alarm
in1_lcrit         Critical minimum input voltage
in1_lcrit_alarm   Input voltage critical low alarm
in2_label          "vout1"
in2_input          Measured output voltage
in2_crit          Critical maximum output voltage
in2_crit_alarm    Output voltage high alarm
in2_lcrit          Critical minimum output voltage
in2_lcrit_alarm          Output voltage critical low alarm
in2_max           Critical maximum output voltage
in2_max_alarm     Output voltage critical max alarm
in2_min           Critical minimum output voltage
in2_min_alarm     Output voltage critical min alarm
curr1_label          "iin"
curr1_input          Measured input current.
curr1_alarm          Input current alarm
curr1_crit        Critical maximum input current
curr1_crit_alarm  Input current high alarm

Output current·power·temperature sysfs

100-123

Output current label `curr2_label`은 `iout1`입니다. `curr2_input`은 측정 output current, `curr2_alarm`은 일반 alarm입니다. `curr2_crit`과 `curr2_lcrit`은 critical maximum 및 minimum output current이고 대응하는 `curr2_crit_alarm`, `curr2_lcrit_alarm`은 high 및 critical low alarm입니다. `curr2_max`와 `curr2_max_alarm`은 critical maximum 및 critical max alarm입니다.

Power label `power1_label`은 `pout1`입니다. `power1_input`은 측정 output power, `power1_crit`은 critical maximum output power, `power1_crit_alarm`은 output power high alarm입니다.

`temp1_input`과 `temp2_input`은 두 temperature 측정값입니다. 각 channel의 `temp#_crit`, `temp#_crit_alarm`은 critical high temperature와 chip temperature critical high alarm을 나타내고, `temp#_max`, `temp#_max_alarm`은 critical maximum temperature와 critical max alarm입니다.

출력과 온도 attribute

Group측정Limit과 alarm

Output currentcurr2_inputalarm, crit/lcrit/max 및 대응 alarm

Output powerpower1_inputpower1_crit, power1_crit_alarm

Temperature 1temp1_inputcrit/max 및 대응 alarm

Temperature 2temp2_inputcrit/max 및 대응 alarm

Output current, power와 두 온도 channel입니다.

출력 상태 감시

Output current 읽기Output power 읽기Temperature 1·2 읽기각 critical limit와 비교High 또는 low alarm 보고

iout1, pout1과 두 온도 channel을 함께 평가합니다.

curr2_label       "iout1"
curr2_input       Measured output current
curr2_alarm          Output current alarm
curr2_crit        Critical maximum output current
curr2_crit_alarm  Output current high alarm
curr2_lcrit       Critical minimum output current
curr2_lcrit_alarm Output current critical low alarm
curr2_max         Critical maximum output current
curr2_max_alarm   Output current critical max alarm
power1_label      "pout1"
power1_input      Measured output power
power1_crit       Critical maximum output power
power1_crit_alarm Output power high alarm
temp1_input       Measured temperature
temp1_crit          Critical high temperature
temp1_crit_alarm  Chip temperature critical high alarm
temp1_max         Critical maximum temperature
temp1_max_alarm   Temperature critical max alarm
temp2_input       Measured temperature
temp2_crit        Critical high temperature
temp2_crit_alarm  Chip temperature critical high alarm
temp2_max         Critical maximum temperature
temp2_max_alarm   Temperature critical max alarm
================= ========================================