요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver ltc4261
=====================
Supported chips:
* Linear Technology LTC4261
Prefix: 'ltc4261'
Addresses scanned: -
Datasheet:
http://cds.linear.com/docs/Datasheet/42612fb.pdf
Author: Guenter Roeck <linux@roeck-us.net>
Description
-----------
The LTC4261/LTC4261-2 negative voltage Hot Swap controllers allow a board
to be safely inserted and removed from a live backplane.
Usage Notes
-----------
This driver does not probe for LTC4261 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 LTC4261 at address 0x10
on I2C bus #1::
$ modprobe ltc4261
$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
Sysfs entries
-------------
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.
The chip has two voltage sensors, but only one set of voltage alarm status bits.
In many many designs, those alarms are associated with the ADIN2 sensor, due to
the proximity of the ADIN2 pin to the OV pin. ADIN2 is, however, not available
on all chip variants. To ensure that the alarm condition is reported to the user,
report it with both voltage sensors.
======================= =============================
in1_input ADIN2 voltage (mV)
in1_min_alarm ADIN/ADIN2 Undervoltage alarm
in1_max_alarm ADIN/ADIN2 Overvoltage alarm
in2_input ADIN voltage (mV)
in2_min_alarm ADIN/ADIN2 Undervoltage alarm
in2_max_alarm ADIN/ADIN2 Overvoltage alarm
curr1_input SENSE current (mA)
curr1_alarm SENSE overcurrent alarm
======================= =============================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
LTC4261 음전압 핫스왑 컨트롤러
1-38LTC4261과 LTC4261-2는 음전압 Hot Swap 컨트롤러로 활선 백플레인에 보드를 안전하게 삽입·제거하게 합니다. 드라이버 접두사는 `ltc4261`, 저자는 Guenter Roeck이며 주소 자동 탐색은 없습니다.
안전한 칩 식별 레지스터가 없으므로 명시적으로 생성해야 합니다. 문서 예시는 I2C 버스 1 주소 `0x10`에 `ltc4261`을 등록합니다.
음전압 핫스왑 장치와 등록 조건입니다.
음전압 회로의 실제 변형과 주소를 기준으로 생성합니다.
Kernel driver ltc4261
=====================
Supported chips:
* Linear Technology LTC4261
Prefix: 'ltc4261'
Addresses scanned: -
Datasheet:
http://cds.linear.com/docs/Datasheet/42612fb.pdf
Author: Guenter Roeck <linux@roeck-us.net>
Description
-----------
The LTC4261/LTC4261-2 negative voltage Hot Swap controllers allow a board
to be safely inserted and removed from a live backplane.
Usage Notes
-----------
This driver does not probe for LTC4261 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 LTC4261 at address 0x10
on I2C bus #1::
$ modprobe ltc4261
$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
공유 전압 알람과 전류 환산
39-71전압 분압이 있으면 LTC4260과 동일하게 보고값에 `(R1+R2)/R2`를 곱합니다. 전류는 1 mOhm 감지 저항을 가정하므로 실제 저항이 다르면 보고값을 그 mOhm 값으로 나눕니다.
칩에는 전압 센서가 두 개지만 전압 알람 상태 비트는 한 세트뿐입니다. 많은 설계에서 OV 핀과 가까운 ADIN2에 알람이 연결되지만 ADIN2가 없는 변형도 있으므로 드라이버는 같은 알람 상태를 두 전압 센서 모두에 보고합니다.
`in1_input`은 ADIN2, `in2_input`은 ADIN 전압입니다. 두 그룹 모두 `min_alarm`과 `max_alarm`으로 ADIN/ADIN2 저전압·과전압 알람을 표시합니다. `curr1_input`은 SENSE 전류이고 `curr1_alarm`은 SENSE 과전류 알람입니다.
두 전압 센서가 한 알람 비트 세트를 공유합니다.
ADIN2 유무와 관계없이 두 채널에서 같은 상태를 확인합니다.
Sysfs entries
-------------
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.
The chip has two voltage sensors, but only one set of voltage alarm status bits.
In many many designs, those alarms are associated with the ADIN2 sensor, due to
the proximity of the ADIN2 pin to the OV pin. ADIN2 is, however, not available
on all chip variants. To ensure that the alarm condition is reported to the user,
report it with both voltage sensors.
======================= =============================
in1_input ADIN2 voltage (mV)
in1_min_alarm ADIN/ADIN2 Undervoltage alarm
in1_max_alarm ADIN/ADIN2 Overvoltage alarm
in2_input ADIN voltage (mV)
in2_min_alarm ADIN/ADIN2 Undervoltage alarm
in2_max_alarm ADIN/ADIN2 Overvoltage alarm
curr1_input SENSE current (mA)
curr1_alarm SENSE overcurrent alarm
======================= =============================
요약·해설
ltc4261.rst:1-71두 전압 센서가 알람 비트 한 세트를 공유하므로 ADIN2가 없는 변형까지 고려해 같은 저·과전압 상태를 양쪽에 보고합니다.
원문 분량과 핵심 인터페이스입니다.
장치 연결부터 측정·경보 처리까지의 순서입니다.