요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Kernel driver ltc2945
2
=====================
4
Supported chips:
6
* Linear Technology LTC2945
8
Prefix: 'ltc2945'
10
Addresses scanned: -
12
Datasheet:
14
https://www.analog.com/media/en/technical-documentation/data-sheets/2945fb.pdf
16
Author: Guenter Roeck <linux@roeck-us.net>
19
Description
20
-----------
22
The LTC2945 is a rail-to-rail system monitor that measures current, voltage,
23
and power consumption.
26
Usage Notes
27
-----------
29
This driver does not probe for LTC2945 devices, since there is no register
30
which can be safely used to identify the chip. You will have to instantiate
31
the devices explicitly.
33
Example: the following will load the driver for an LTC2945 at address 0x10
34
on I2C bus #1::
36
$ modprobe ltc2945
37
$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
40
Sysfs entries
41
-------------
43
Voltage readings provided by this driver are reported as obtained from the ADC
44
registers. If a set of voltage divider resistors is installed, calculate the
45
real voltage by multiplying the reported value with (R1+R2)/R2, where R1 is the
46
value of the divider resistor against the measured voltage and R2 is the value
47
of the divider resistor against Ground.
49
Current reading provided by this driver is reported as obtained from the ADC
50
Current Sense register. The reported value assumes that a 1 mOhm sense resistor
51
is installed. If a different sense resistor is installed, calculate the real
52
current by dividing the reported value by the sense resistor value in mOhm.
54
======================= ========================================================
55
in1_input VIN voltage (mV). Voltage is measured either at
56
SENSE+ or VDD pin depending on chip configuration.
57
in1_min Undervoltage threshold
58
in1_max Overvoltage threshold
59
in1_lowest Lowest measured voltage
60
in1_highest Highest measured voltage
61
in1_reset_history Write 1 to reset in1 history
62
in1_min_alarm Undervoltage alarm
63
in1_max_alarm Overvoltage alarm
65
in2_input ADIN voltage (mV)
66
in2_min Undervoltage threshold
67
in2_max Overvoltage threshold
68
in2_lowest Lowest measured voltage
69
in2_highest Highest measured voltage
70
in2_reset_history Write 1 to reset in2 history
71
in2_min_alarm Undervoltage alarm
72
in2_max_alarm Overvoltage alarm
74
curr1_input SENSE current (mA)
75
curr1_min Undercurrent threshold
76
curr1_max Overcurrent threshold
77
curr1_lowest Lowest measured current
78
curr1_highest Highest measured current
79
curr1_reset_history Write 1 to reset curr1 history
80
curr1_min_alarm Undercurrent alarm
81
curr1_max_alarm Overcurrent alarm
83
power1_input Power (in uW). Power is calculated based on SENSE+/VDD
84
voltage or ADIN voltage depending on chip configuration.
85
power1_min Low lower threshold
86
power1_max High power threshold
87
power1_input_lowest Historical minimum power use
88
power1_input_highest Historical maximum power use
89
power1_reset_history Write 1 to reset power1 history
90
power1_min_alarm Low power alarm
91
power1_max_alarm High power alarm
92
======================= ========================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
LTC2945 레일투레일 전력 모니터 등록
1-40Linear Technology LTC2945는 `ltc2945` 접두사를 사용하는 레일투레일 시스템 모니터로 전류·전압·소비 전력을 측정합니다. 작성자는 Guenter Roeck입니다.
칩을 안전하게 식별할 수 있는 레지스터가 없어 드라이버가 탐색하지 않습니다. I2C 버스 1의 주소 `0x10`에 등록하는 예시는 `modprobe ltc2945` 뒤 `echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device`입니다.
항목내용
측정전류·전압·전력
입력 구조레일투레일
자동 탐색안전한 ID 레지스터가 없어 미지원
등록 예I2C bus 1, address 0x10
측정 기능과 명시적 등록 이유입니다.
회로도에서 주소 확인→ltc2945 모듈 적재→new_device로 명시적 등록→전압 분압·감지 저항 확인→환산된 측정값 사용
주소를 직접 지정한 뒤 ADC 환산을 적용합니다.
Kernel driver ltc2945
=====================
Supported chips:
* Linear Technology LTC2945
Prefix: 'ltc2945'
Addresses scanned: -
Datasheet:
https://www.analog.com/media/en/technical-documentation/data-sheets/2945fb.pdf
Author: Guenter Roeck <linux@roeck-us.net>
Description
-----------
The LTC2945 is a rail-to-rail system monitor that measures current, voltage,
and power consumption.
Usage Notes
-----------
This driver does not probe for LTC2945 devices, since there is no register
which can be safely used to identify the chip. You will have to instantiate
the devices explicitly.
Example: the following will load the driver for an LTC2945 at address 0x10
on I2C bus #1::
$ modprobe ltc2945
$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
Sysfs entries분압·감지 저항 환산과 측정 이력
41-92전압 값은 ADC 레지스터에서 얻은 그대로 보고됩니다. 분압 저항을 사용하면 실제 전압은 보고값에 `(R1+R2)/R2`를 곱합니다. R1은 측정 전압 쪽 저항, R2는 접지 쪽 저항입니다.
전류는 ADC Current Sense 레지스터 값이며 1 mOhm 감지 저항을 가정합니다. 다른 저항이면 보고값을 감지 저항의 mOhm 값으로 나눠 실제 전류를 구합니다.
`in1`은 구성에 따라 SENSE+ 또는 VDD에서 측정한 VIN 전압이고 `in2`는 ADIN 전압입니다. 두 채널 모두 현재·최저·최고·저전압·과전압 제한과 경보, 이력 초기화를 제공합니다.
`curr1`은 SENSE 전류의 현재·최저·최고·저전류·과전류 제한과 경보, 이력 초기화를 제공합니다. `power1`은 구성에 따라 SENSE+/VDD 또는 ADIN 전압을 기준으로 계산한 uW 전력이며 현재값·과거 최소·최대·제한·경보·이력 초기화를 제공합니다.
채널측정·이력환산
in1VIN, 최저·최고·상하 경보분압 시 ×(R1+R2)/R2
in2ADIN, 최저·최고·상하 경보분압 시 동일
curr1SENSE 전류·이력·경보보고값 ÷ Rsense(mOhm)
power1uW, 과거 최소·최대·경보구성 선택 전압 기반
채널과 외부 부품 환산 규칙입니다.
ADC 전압·전류 보고값 읽기→분압비로 실제 전압 계산→감지 저항으로 실제 전류 계산→전력·제한·경보 비교→필요 시 채널별 history에 1 기록
외부 저항값을 반영해 물리량과 이력을 해석합니다.
-------------
Voltage readings provided by this driver are reported as obtained from the ADC
registers. If a set of voltage divider resistors is installed, calculate the
real voltage by multiplying the reported value with (R1+R2)/R2, where R1 is the
value of the divider resistor against the measured voltage and R2 is the value
of the divider resistor against Ground.
Current reading provided by this driver is reported as obtained from the ADC
Current Sense register. The reported value assumes that a 1 mOhm sense resistor
is installed. If a different sense resistor is installed, calculate the real
current by dividing the reported value by the sense resistor value in mOhm.
======================= ========================================================
in1_input VIN voltage (mV). Voltage is measured either at
SENSE+ or VDD pin depending on chip configuration.
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 in1 history
in1_min_alarm Undervoltage alarm
in1_max_alarm Overvoltage alarm
in2_input ADIN voltage (mV)
in2_min Undervoltage threshold
in2_max Overvoltage threshold
in2_lowest Lowest measured voltage
in2_highest Highest measured voltage
in2_reset_history Write 1 to reset in2 history
in2_min_alarm Undervoltage alarm
in2_max_alarm Overvoltage alarm
curr1_input 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
power1_input Power (in uW). Power is calculated based on SENSE+/VDD
voltage or ADIN voltage depending on chip configuration.
power1_min Low lower 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
======================= ========================================================
요약·해설
ltc2945.rst:1-92ADC 보고값에 분압비와 감지 저항을 적용해 실제 전압·전류를 계산하고 전력·최저·최고·경보 이력을 제공합니다.
원문 분량과 핵심 인터페이스입니다.
장치 연결부터 측정·이력 사용까지의 핵심 순서입니다.