요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Kernel drivers ltc2947-i2c and ltc2947-spi
2
==========================================
4
Supported chips:
6
* Analog Devices LTC2947
8
Prefix: 'ltc2947'
10
Addresses scanned: -
12
Datasheet:
14
https://www.analog.com/media/en/technical-documentation/data-sheets/LTC2947.pdf
16
Author: Nuno Sá <nuno.sa@analog.com>
18
Description
19
___________
21
The LTC2947 is a high precision power and energy monitor that measures current,
22
voltage, power, temperature, charge and energy. The device supports both SPI
23
and I2C depending on the chip configuration.
24
The device also measures accumulated quantities as energy. It has two banks of
25
register's to read/set energy related values. These banks can be configured
26
independently to have setups like: energy1 accumulates always and enrgy2 only
27
accumulates if current is positive (to check battery charging efficiency for
28
example). The device also supports a GPIO pin that can be configured as output
29
to control a fan as a function of measured temperature. Then, the GPIO becomes
30
active as soon as a temperature reading is higher than a defined threshold. The
31
temp2 channel is used to control this thresholds and to read the respective
32
alarms.
34
Sysfs entries
35
_____________
37
The following attributes are supported. Limits are read-write, reset_history
38
is write-only and all the other attributes are read-only.
40
======================= ==========================================
41
in0_input VP-VM voltage (mV).
42
in0_min Undervoltage threshold
43
in0_max Overvoltage threshold
44
in0_lowest Lowest measured voltage
45
in0_highest Highest measured voltage
46
in0_reset_history Write 1 to reset in1 history
47
in0_min_alarm Undervoltage alarm
48
in0_max_alarm Overvoltage alarm
49
in0_label Channel label (VP-VM)
51
in1_input DVCC voltage (mV)
52
in1_min Undervoltage threshold
53
in1_max Overvoltage threshold
54
in1_lowest Lowest measured voltage
55
in1_highest Highest measured voltage
56
in1_reset_history Write 1 to reset in2 history
57
in1_min_alarm Undervoltage alarm
58
in1_max_alarm Overvoltage alarm
59
in1_label Channel label (DVCC)
61
curr1_input IP-IM Sense current (mA)
62
curr1_min Undercurrent threshold
63
curr1_max Overcurrent threshold
64
curr1_lowest Lowest measured current
65
curr1_highest Highest measured current
66
curr1_reset_history Write 1 to reset curr1 history
67
curr1_min_alarm Undercurrent alarm
68
curr1_max_alarm Overcurrent alarm
69
curr1_label Channel label (IP-IM)
71
power1_input Power (in uW)
72
power1_min Low power threshold
73
power1_max High power threshold
74
power1_input_lowest Historical minimum power use
75
power1_input_highest Historical maximum power use
76
power1_reset_history Write 1 to reset power1 history
77
power1_min_alarm Low power alarm
78
power1_max_alarm High power alarm
79
power1_label Channel label (Power)
81
temp1_input Chip Temperature (in milliC)
82
temp1_min Low temperature threshold
83
temp1_max High temperature threshold
84
temp1_input_lowest Historical minimum temperature use
85
temp1_input_highest Historical maximum temperature use
86
temp1_reset_history Write 1 to reset temp1 history
87
temp1_min_alarm Low temperature alarm
88
temp1_max_alarm High temperature alarm
89
temp1_label Channel label (Ambient)
91
temp2_min Low temperature threshold for fan control
92
temp2_max High temperature threshold for fan control
93
temp2_min_alarm Low temperature fan control alarm
94
temp2_max_alarm High temperature fan control alarm
95
temp2_label Channel label (TEMPFAN)
97
energy1_input Measured energy over time (in microJoule)
99
energy2_input Measured energy over time (in microJoule)
100
======================= ==========================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
LTC2947 I2C·SPI 전력·에너지 모니터
1-32`ltc2947-i2c`와 `ltc2947-spi` 드라이버는 Analog Devices LTC2947을 `ltc2947` 접두사로 지원합니다. 주소 자동 검색은 하지 않으며 작성자는 Nuno Sá입니다.
LTC2947은 전류·전압·전력·온도·전하·에너지를 측정하는 고정밀 모니터이며 칩 구성에 따라 SPI 또는 I2C를 사용합니다.
에너지 관련 값을 읽고 설정하는 레지스터 뱅크가 두 개이고 독립적으로 구성할 수 있습니다. 예를 들어 energy1은 항상 누적하고 energy2는 전류가 양수일 때만 누적해 배터리 충전 효율을 확인할 수 있습니다.
GPIO 핀을 출력으로 설정해 측정 온도에 따라 팬을 제어할 수 있습니다. 온도가 정의된 문턱보다 높으면 GPIO가 활성화되며 `temp2` 채널이 팬 제어 문턱 설정과 경보 읽기에 사용됩니다.
기능내용
인터페이스칩 구성에 따라 I2C 또는 SPI
측정전류·전압·전력·온도·전하·에너지
에너지 뱅크2개, 독립 조건 설정
팬 제어온도 문턱 기반 GPIO 출력
팬 속성temp2 제한과 경보
측정 물리량과 이중 에너지 누적·팬 GPIO입니다.
I2C 또는 SPI 연결→순간 전압·전류·전력 측정→energy1·energy2 조건별 누적→temp2 팬 문턱 비교→GPIO 팬 출력 활성·비활성
측정값을 두 누적 조건과 팬 GPIO에 연결합니다.
Kernel drivers ltc2947-i2c and ltc2947-spi
==========================================
Supported chips:
* Analog Devices LTC2947
Prefix: 'ltc2947'
Addresses scanned: -
Datasheet:
https://www.analog.com/media/en/technical-documentation/data-sheets/LTC2947.pdf
Author: Nuno Sá <nuno.sa@analog.com>
Description
___________
The LTC2947 is a high precision power and energy monitor that measures current,
voltage, power, temperature, charge and energy. The device supports both SPI
and I2C depending on the chip configuration.
The device also measures accumulated quantities as energy. It has two banks of
register's to read/set energy related values. These banks can be configured
independently to have setups like: energy1 accumulates always and enrgy2 only
accumulates if current is positive (to check battery charging efficiency for
example). The device also supports a GPIO pin that can be configured as output
to control a fan as a function of measured temperature. Then, the GPIO becomes
active as soon as a temperature reading is higher than a defined threshold. The
temp2 channel is used to control this thresholds and to read the respective
alarms.전압·전류·전력·온도·에너지 속성
33-100제한값은 읽기·쓰기, `reset_history`는 쓰기 전용, 나머지는 읽기 전용입니다. `in0`은 VP-VM, `in1`은 DVCC 전압으로 현재·최저·최고·상하 제한·경보·라벨을 제공합니다.
`curr1`은 IP-IM 감지 전류의 현재값·최저·최고·저전류·과전류 제한과 경보, 이력 초기화, 라벨을 제공합니다. `power1`은 uW 단위 전력의 현재값·과거 최소·최대·제한·경보·이력 초기화와 Power 라벨입니다.
`temp1`은 Ambient 칩 온도의 현재값·과거 최소·최대·상하 제한·경보·이력 초기화를 제공합니다. `temp2`는 TEMPFAN 채널로 팬 제어용 저온·고온 문턱과 경보를 제공하지만 현재 온도 입력 항목은 없습니다.
`energy1_input`과 `energy2_input`은 시간에 따라 누적된 에너지를 마이크로줄로 보고합니다.
채널라벨주요 속성
in0VP-VM전압·최저·최고·상하 경보
in1DVCC전압·최저·최고·상하 경보
curr1IP-IM전류·이력·상하 경보
power1PoweruW·과거 최소·최대·경보
temp1Ambient칩 온도·이력·경보
temp2TEMPFAN팬 제어 문턱·경보
energy1/2-마이크로줄 누적 에너지
순간값·이력·누적 에너지와 팬 제어 채널입니다.
전압·전류·전력·온도 순간값 읽기→채널별 제한과 경보 확인→최저·최고 이력 보존→필요 시 reset_history에 1 기록→두 에너지 뱅크 누적값 비교
순간 측정·과거 이력·누적 에너지를 구분합니다.
Sysfs entries
_____________
The following attributes are supported. Limits are read-write, reset_history
is write-only and all the other attributes are read-only.
======================= ==========================================
in0_input VP-VM voltage (mV).
in0_min Undervoltage threshold
in0_max Overvoltage threshold
in0_lowest Lowest measured voltage
in0_highest Highest measured voltage
in0_reset_history Write 1 to reset in1 history
in0_min_alarm Undervoltage alarm
in0_max_alarm Overvoltage alarm
in0_label Channel label (VP-VM)
in1_input DVCC voltage (mV)
in1_min Undervoltage threshold
in1_max Overvoltage threshold
in1_lowest Lowest measured voltage
in1_highest Highest measured voltage
in1_reset_history Write 1 to reset in2 history
in1_min_alarm Undervoltage alarm
in1_max_alarm Overvoltage alarm
in1_label Channel label (DVCC)
curr1_input IP-IM Sense current (mA)
curr1_min Undercurrent threshold
curr1_max Overcurrent threshold
curr1_lowest Lowest measured current
curr1_highest Highest measured current
curr1_reset_history Write 1 to reset curr1 history
curr1_min_alarm Undercurrent alarm
curr1_max_alarm Overcurrent alarm
curr1_label Channel label (IP-IM)
power1_input Power (in uW)
power1_min Low power threshold
power1_max High power threshold
power1_input_lowest Historical minimum power use
power1_input_highest Historical maximum power use
power1_reset_history Write 1 to reset power1 history
power1_min_alarm Low power alarm
power1_max_alarm High power alarm
power1_label Channel label (Power)
temp1_input Chip Temperature (in milliC)
temp1_min Low temperature threshold
temp1_max High temperature threshold
temp1_input_lowest Historical minimum temperature use
temp1_input_highest Historical maximum temperature use
temp1_reset_history Write 1 to reset temp1 history
temp1_min_alarm Low temperature alarm
temp1_max_alarm High temperature alarm
temp1_label Channel label (Ambient)
temp2_min Low temperature threshold for fan control
temp2_max High temperature threshold for fan control
temp2_min_alarm Low temperature fan control alarm
temp2_max_alarm High temperature fan control alarm
temp2_label Channel label (TEMPFAN)
energy1_input Measured energy over time (in microJoule)
energy2_input Measured energy over time (in microJoule)
======================= ==========================================
요약·해설
ltc2947.rst:1-100전압·전류·전력·온도·전하·에너지를 측정하고 독립 에너지 뱅크 두 개와 온도 문턱 기반 팬 GPIO를 운용합니다.
원문 분량과 핵심 인터페이스입니다.
장치 연결부터 측정·이력 사용까지의 핵심 순서입니다.