요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Kernel driver ltc4245
2
=====================
4
Supported chips:
6
* Linear Technology LTC4245
8
Prefix: 'ltc4245'
10
Addresses scanned: 0x20-0x3f
12
Datasheet:
14
http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
16
Author: Ira W. Snyder <[email protected]>
19
Description
20
-----------
22
The LTC4245 controller allows a board to be safely inserted and removed
23
from a live backplane in multiple supply systems such as CompactPCI and
24
PCI Express.
27
Usage Notes
28
-----------
30
This driver does not probe for LTC4245 devices, due to the fact that some
31
of the possible addresses are unfriendly to probing. You will have to
32
instantiate the devices explicitly.
34
Example: the following will load the driver for an LTC4245 at address 0x23
35
on I2C bus #1::
37
$ modprobe ltc4245
38
$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
41
Sysfs entries
42
-------------
44
The LTC4245 has built-in limits for over and under current warnings. This
45
makes it very likely that the reference circuit will be used.
47
This driver uses the values in the datasheet to change the register values
48
into the values specified in the sysfs-interface document. The current readings
49
rely on the sense resistors listed in Table 2: "Sense Resistor Values".
51
======================= =======================================================
52
in1_input 12v input voltage (mV)
53
in2_input 5v input voltage (mV)
54
in3_input 3v input voltage (mV)
55
in4_input Vee (-12v) input voltage (mV)
57
in1_min_alarm 12v input undervoltage alarm
58
in2_min_alarm 5v input undervoltage alarm
59
in3_min_alarm 3v input undervoltage alarm
60
in4_min_alarm Vee (-12v) input undervoltage alarm
62
curr1_input 12v current (mA)
63
curr2_input 5v current (mA)
64
curr3_input 3v current (mA)
65
curr4_input Vee (-12v) current (mA)
67
curr1_max_alarm 12v overcurrent alarm
68
curr2_max_alarm 5v overcurrent alarm
69
curr3_max_alarm 3v overcurrent alarm
70
curr4_max_alarm Vee (-12v) overcurrent alarm
72
in5_input 12v output voltage (mV)
73
in6_input 5v output voltage (mV)
74
in7_input 3v output voltage (mV)
75
in8_input Vee (-12v) output voltage (mV)
77
in5_min_alarm 12v output undervoltage alarm
78
in6_min_alarm 5v output undervoltage alarm
79
in7_min_alarm 3v output undervoltage alarm
80
in8_min_alarm Vee (-12v) output undervoltage alarm
82
in9_input GPIO voltage data (see note 1)
83
in10_input GPIO voltage data (see note 1)
84
in11_input GPIO voltage data (see note 1)
86
power1_input 12v power usage (mW)
87
power2_input 5v power usage (mW)
88
power3_input 3v power usage (mW)
89
power4_input Vee (-12v) power usage (mW)
90
======================= =======================================================
93
Note 1
94
------
96
If you have NOT configured the driver to sample all GPIO pins as analog
97
voltages, then the in10_input and in11_input sysfs attributes will not be
98
created. The driver will sample the GPIO pin that is currently connected to the
99
ADC as an analog voltage, and report the value in in9_input.
101
If you have configured the driver to sample all GPIO pins as analog voltages,
102
then they will be sampled in round-robin fashion. If userspace reads too
103
slowly, -EAGAIN will be returned when you read the sysfs attribute containing
104
the sensor reading.
106
The LTC4245 chip can be configured to sample all GPIO pins with two methods:
108
1) platform data -- see include/linux/platform_data/ltc4245.h
109
2) OF device tree -- add the "ltc4245,use-extra-gpios" property to each chip
111
The default mode of operation is to sample a single GPIO pin.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
다중 전원 시스템용 LTC4245 핫스왑
1-54LTC4245는 `ltc4245` 접두사를 사용하는 핫스왑 컨트롤러로 CompactPCI와 PCI Express 같은 다중 전원 시스템에서 보드를 활선 백플레인에 안전하게 삽입·제거하게 합니다. 저자는 Ira W. Snyder이며 주소 범위는 `0x20-0x3f`입니다.
일부 주소가 탐색에 안전하지 않으므로 자동 탐색하지 않습니다. I2C 버스 1의 주소 `0x23` 예시는 모듈을 적재한 뒤 `/sys/bus/i2c/devices/i2c-1/new_device`에 `ltc4245 0x23`을 써서 생성합니다.
칩에는 과전류와 부족 전류 경고 한계가 내장되어 있어 기준 회로 사용이 예상됩니다. 드라이버는 데이터시트 값을 sysfs 인터페이스 단위로 변환하며 전류값은 Table 2의 `Sense Resistor Values`에 의존합니다.
레일전압전류전력
12 Vin1 / in5curr1power1
5 Vin2 / in6curr2power2
3 Vin3 / in7curr3power3
Vee (-12 V)in4 / in8curr4power4
네 레일의 입력·출력·전류·전력을 함께 감시합니다.
I2C 주소 0x20-0x3f에서 실제 주소 확인→ltc4245 장치 명시적 생성→Table 2 감지 저항값 적용→전압·전류·전력과 경보 감시
주소와 감지 저항 표를 기준으로 네 레일을 구성합니다.
Kernel driver ltc4245
=====================
Supported chips:
* Linear Technology LTC4245
Prefix: 'ltc4245'
Addresses scanned: 0x20-0x3f
Datasheet:
http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
Author: Ira W. Snyder <[email protected]>
Description
-----------
The LTC4245 controller allows a board to be safely inserted and removed
from a live backplane in multiple supply systems such as CompactPCI and
PCI Express.
Usage Notes
-----------
This driver does not probe for LTC4245 devices, due to the fact that some
of the possible addresses are unfriendly to probing. You will have to
instantiate the devices explicitly.
Example: the following will load the driver for an LTC4245 at address 0x23
on I2C bus #1::
$ modprobe ltc4245
$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
Sysfs entries
-------------
The LTC4245 has built-in limits for over and under current warnings. This
makes it very likely that the reference circuit will be used.
This driver uses the values in the datasheet to change the register values
into the values specified in the sysfs-interface document. The current readings
rely on the sense resistors listed in Table 2: "Sense Resistor Values".
======================= =======================================================
in1_input 12v input voltage (mV)
in2_input 5v input voltage (mV)
in3_input 3v input voltage (mV)4개 레일과 GPIO 아날로그 샘플링
55-111`in1-4_input`은 12 V, 5 V, 3 V, Vee(-12 V) 입력 전압을 mV로 보고하고 `in1-4_min_alarm`은 각 입력 저전압 알람입니다. `curr1-4_input`은 네 레일 전류를 mA로, `curr1-4_max_alarm`은 각 과전류 알람을 보고합니다.
`in5-8_input`은 같은 네 레일의 출력 전압이며 `in5-8_min_alarm`은 출력 저전압 알람입니다. `power1-4_input`은 12 V, 5 V, 3 V, Vee 레일의 소비 전력을 mW로 보고합니다.
`in9_input`, `in10_input`, `in11_input`은 GPIO 전압 데이터입니다. 모든 GPIO를 아날로그 전압으로 샘플하도록 구성하지 않으면 `in10_input`과 `in11_input`은 생성되지 않고, 현재 ADC에 연결된 GPIO만 `in9_input`으로 보고됩니다.
모든 GPIO 아날로그 샘플링을 사용하면 라운드 로빈으로 측정합니다. 사용자 공간이 너무 느리게 읽으면 센서 속성을 읽을 때 `-EAGAIN`이 반환될 수 있습니다. 설정 방법은 플랫폼 데이터 `include/linux/platform_data/ltc4245.h` 또는 OF 장치 트리의 `ltc4245,use-extra-gpios` 속성입니다. 기본 모드는 GPIO 하나만 샘플합니다.
속성군내용단위
in1-4 / in5-8레일별 입력 / 출력 전압mV
curr1-4레일별 전류와 과전류 알람mA
power1-4레일별 소비 전력mW
in9현재 ADC GPIO전압
in10-11추가 GPIO, 전체 샘플링 시에만전압
네 전원 레일과 선택 가능한 GPIO 아날로그 채널입니다.
기본값은 현재 ADC GPIO 하나만 샘플→플랫폼 데이터 또는 장치 트리로 extra GPIO 활성화→세 GPIO를 라운드 로빈으로 측정→느린 읽기에서 -EAGAIN 처리
단일 GPIO와 전체 GPIO 라운드 로빈 모드를 구분합니다.
in4_input Vee (-12v) input voltage (mV)
in1_min_alarm 12v input undervoltage alarm
in2_min_alarm 5v input undervoltage alarm
in3_min_alarm 3v input undervoltage alarm
in4_min_alarm Vee (-12v) input undervoltage alarm
curr1_input 12v current (mA)
curr2_input 5v current (mA)
curr3_input 3v current (mA)
curr4_input Vee (-12v) current (mA)
curr1_max_alarm 12v overcurrent alarm
curr2_max_alarm 5v overcurrent alarm
curr3_max_alarm 3v overcurrent alarm
curr4_max_alarm Vee (-12v) overcurrent alarm
in5_input 12v output voltage (mV)
in6_input 5v output voltage (mV)
in7_input 3v output voltage (mV)
in8_input Vee (-12v) output voltage (mV)
in5_min_alarm 12v output undervoltage alarm
in6_min_alarm 5v output undervoltage alarm
in7_min_alarm 3v output undervoltage alarm
in8_min_alarm Vee (-12v) output undervoltage alarm
in9_input GPIO voltage data (see note 1)
in10_input GPIO voltage data (see note 1)
in11_input GPIO voltage data (see note 1)
power1_input 12v power usage (mW)
power2_input 5v power usage (mW)
power3_input 3v power usage (mW)
power4_input Vee (-12v) power usage (mW)
======================= =======================================================
Note 1
------
If you have NOT configured the driver to sample all GPIO pins as analog
voltages, then the in10_input and in11_input sysfs attributes will not be
created. The driver will sample the GPIO pin that is currently connected to the
ADC as an analog voltage, and report the value in in9_input.
If you have configured the driver to sample all GPIO pins as analog voltages,
then they will be sampled in round-robin fashion. If userspace reads too
slowly, -EAGAIN will be returned when you read the sysfs attribute containing
the sensor reading.
The LTC4245 chip can be configured to sample all GPIO pins with two methods:
1) platform data -- see include/linux/platform_data/ltc4245.h
2) OF device tree -- add the "ltc4245,use-extra-gpios" property to each chip
The default mode of operation is to sample a single GPIO pin.
요약·해설
ltc4245.rst:1-111네 전원 레일의 입력·출력 전압, 전류, 전력과 알람을 감시하고 선택적으로 세 GPIO를 라운드 로빈 아날로그 입력으로 읽습니다.
원문 분량과 핵심 장치 특성입니다.
등록부터 측정·경보 처리까지의 핵심 순서입니다.