요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
Kernel driver tmp513
4
====================
6
Supported chips:
8
* Texas Instruments TMP512
10
Prefix: 'tmp512'
12
Datasheet: https://www.ti.com/lit/ds/symlink/tmp512.pdf
14
* Texas Instruments TMP513
16
Prefix: 'tmp513'
18
Datasheet: https://www.ti.com/lit/ds/symlink/tmp513.pdf
20
Authors:
22
Eric Tremblay <[email protected]>
24
Description
25
-----------
27
This driver implements support for Texas Instruments TMP512, and TMP513.
28
The TMP512 (dual-channel) and TMP513 (triple-channel) are system monitors
29
that include remote sensors, a local temperature sensor, and a high-side current
30
shunt monitor. These system monitors have the capability of measuring remote
31
temperatures, on-chip temperatures, and system voltage/power/current
32
consumption.
34
The temperatures are measured in degrees Celsius with a range of
35
-40 to + 125 degrees with a resolution of 0.0625 degree C.
37
For hysteresis value, only the first channel is writable. Writing to it
38
will affect all other values since each channels are sharing the same
39
hysteresis value. The hysteresis is in degrees Celsius with a range of
40
0 to 127.5 degrees with a resolution of 0.5 degree.
42
The driver exports the temperature values via the following sysfs files:
44
**temp[1-4]_input**
46
**temp[1-4]_crit**
48
**temp[1-4]_crit_alarm**
50
**temp[1-4]_crit_hyst**
52
The driver read the shunt voltage from the chip and convert it to current.
53
The readable range depends on the "ti,pga-gain" property (default to 8) and the
54
shunt resistor value. The value resolution will be equal to 10uV/Rshunt.
56
The driver exports the shunt currents values via the following sysFs files:
58
**curr1_input**
60
**curr1_lcrit**
62
**curr1_lcrit_alarm**
64
**curr1_crit**
66
**curr1_crit_alarm**
68
The bus voltage range is read from the chip with a resolution of 4mV. The chip
69
can be configurable in two different range (32V or 16V) using the
70
ti,bus-range-microvolt property in the devicetree.
72
The driver exports the bus voltage values via the following sysFs files:
74
**in0_input**
76
**in0_lcrit**
78
**in0_lcrit_alarm**
80
**in0_crit**
82
**in0_crit_alarm**
84
The bus power and bus currents range and resolution depends on the calibration
85
register value. Those values are calculate by the hardware using those
86
formulas:
88
Current = (ShuntVoltage * CalibrationRegister) / 4096
89
Power = (Current * BusVoltage) / 5000
91
The driver exports the bus current and bus power values via the following
92
sysFs files:
94
**curr2_input**
96
**power1_input**
98
**power1_crit**
100
**power1_crit_alarm**
102
The calibration process follow the procedure of the datasheet (without overflow)
103
and depend on the shunt resistor value and the pga_gain value.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 칩과 작성자
1-23이 문서는 GPL-2.0 SPDX 식별자를 사용합니다. `tmp513` 드라이버는 Texas Instruments TMP512와 TMP513을 지원하며 접두사는 각각 `tmp512`, `tmp513`입니다.
작성자는 Eric Tremblay입니다.
칩접두사원격 채널
TMP512tmp5122채널
TMP513tmp5133채널
두 시스템 모니터의 접두사와 채널 구성을 비교합니다.
TMP512 또는 TMP513 식별→로컬 온도 센서 초기화→원격 온도 채널 수 결정→고측 션트 모니터 보정→hwmon 속성 등록
칩 변형에 따라 온도 채널과 전력 모니터를 구성합니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver tmp513
====================
Supported chips:
* Texas Instruments TMP512
Prefix: 'tmp512'
Datasheet: https://www.ti.com/lit/ds/symlink/tmp512.pdf
* Texas Instruments TMP513
Prefix: 'tmp513'
Datasheet: https://www.ti.com/lit/ds/symlink/tmp513.pdf
Authors:
Eric Tremblay <[email protected]>
온도와 공유 히스테리시스
24-51드라이버는 TMP512와 TMP513을 지원합니다. TMP512는 2채널, TMP513은 3채널 시스템 모니터로 원격 센서, 로컬 온도 센서, 고측 전류 션트 모니터를 포함합니다. 원격·온칩 온도와 시스템 전압·전력·전류 소비를 측정할 수 있습니다.
온도 측정 범위는 -40~+125°C이고 해상도는 0.0625°C입니다.
히스테리시스 값은 첫 번째 채널만 쓸 수 있습니다. 모든 채널이 같은 히스테리시스 값을 공유하므로 첫 번째 채널에 쓰면 다른 값에도 영향을 줍니다. 범위는 0~127.5°C, 해상도는 0.5°C입니다.
드라이버는 `temp[1-4]_input`, `temp[1-4]_crit`, `temp[1-4]_crit_alarm`, `temp[1-4]_crit_hyst`로 온도값·임계 한계·경보·히스테리시스를 제공합니다.
속성의미범위·제약
`temp[1-4]_input`온도 입력-40~+125°C, 0.0625°C
`temp[1-4]_crit`임계 온도채널별
`temp[1-4]_crit_alarm`임계 경보채널별
`temp[1-4]_crit_hyst`임계 히스테리시스0~127.5°C, 0.5°C
히스테리시스 쓰기첫 번째 채널만 쓰기 가능모든 채널에 공유
채널 범위와 공유 설정을 구조화했습니다.
첫 번째 `crit_hyst`에 값 쓰기→0~127.5°C 범위 확인→0.5°C 해상도로 변환→공유 히스테리시스 레지스터 갱신→모든 채널 읽기에 같은 값 반영
하나의 하드웨어 값을 여러 채널 속성에 반영합니다.
Description
-----------
This driver implements support for Texas Instruments TMP512, and TMP513.
The TMP512 (dual-channel) and TMP513 (triple-channel) are system monitors
that include remote sensors, a local temperature sensor, and a high-side current
shunt monitor. These system monitors have the capability of measuring remote
temperatures, on-chip temperatures, and system voltage/power/current
consumption.
The temperatures are measured in degrees Celsius with a range of
-40 to + 125 degrees with a resolution of 0.0625 degree C.
For hysteresis value, only the first channel is writable. Writing to it
will affect all other values since each channels are sharing the same
hysteresis value. The hysteresis is in degrees Celsius with a range of
0 to 127.5 degrees with a resolution of 0.5 degree.
The driver exports the temperature values via the following sysfs files:
**temp[1-4]_input**
**temp[1-4]_crit**
**temp[1-4]_crit_alarm**
**temp[1-4]_crit_hyst**
션트 전류와 버스 전압
52-83드라이버는 칩에서 션트 전압을 읽어 전류로 변환합니다. 읽을 수 있는 범위는 기본값 8인 `ti,pga-gain` 속성과 션트 저항값에 따라 달라집니다. 값의 해상도는 `10uV/Rshunt`입니다.
션트 전류는 `curr1_input`, `curr1_lcrit`, `curr1_lcrit_alarm`, `curr1_crit`, `curr1_crit_alarm`으로 내보냅니다.
버스 전압 범위는 칩에서 읽으며 해상도는 4 mV입니다. Devicetree의 `ti,bus-range-microvolt` 속성으로 32 V 또는 16 V 범위를 선택할 수 있습니다.
버스 전압은 `in0_input`, `in0_lcrit`, `in0_lcrit_alarm`, `in0_crit`, `in0_crit_alarm`으로 내보냅니다.
경로속성해상도·설정
션트 전류`curr1_input``10uV/Rshunt`
션트 저한계`curr1_lcrit`, `_lcrit_alarm`한계·경보
션트 고한계`curr1_crit`, `_crit_alarm`임계·경보
버스 전압`in0_input`4 mV
버스 저한계`in0_lcrit`, `_lcrit_alarm`한계·경보
버스 고한계`in0_crit`, `_crit_alarm`임계·경보
버스 범위`ti,bus-range-microvolt`32 V 또는 16 V
전류와 전압 경로의 설정·해상도·sysfs 파일입니다.
션트 전압 읽기→`ti,pga-gain` 적용→션트 저항값 확인→`10uV/Rshunt` 해상도로 변환→`curr1_*` 속성 제공
전압 측정값과 보드 저항값을 전류로 바꾸는 경로입니다.
The driver read the shunt voltage from the chip and convert it to current.
The readable range depends on the "ti,pga-gain" property (default to 8) and the
shunt resistor value. The value resolution will be equal to 10uV/Rshunt.
The driver exports the shunt currents values via the following sysFs files:
**curr1_input**
**curr1_lcrit**
**curr1_lcrit_alarm**
**curr1_crit**
**curr1_crit_alarm**
The bus voltage range is read from the chip with a resolution of 4mV. The chip
can be configurable in two different range (32V or 16V) using the
ti,bus-range-microvolt property in the devicetree.
The driver exports the bus voltage values via the following sysFs files:
**in0_input**
**in0_lcrit**
**in0_lcrit_alarm**
**in0_crit**
**in0_crit_alarm**
버스 전류·전력 계산과 보정
84-103버스 전력과 버스 전류의 범위·해상도는 보정 레지스터 값에 따라 달라집니다. 하드웨어는 다음 식으로 값을 계산합니다.
Current = (ShuntVoltage * CalibrationRegister) / 4096
Power = (Current * BusVoltage) / 5000드라이버는 버스 전류를 `curr2_input`, 버스 전력을 `power1_input`, `power1_crit`, `power1_crit_alarm`으로 내보냅니다.
보정 과정은 오버플로 없이 데이터시트 절차를 따르며 션트 저항값과 `pga_gain` 값에 의존합니다.
계산입력출력 속성
버스 전류ShuntVoltage, CalibrationRegister`curr2_input`
버스 전력Current, BusVoltage`power1_input`
전력 임계보정된 전력`power1_crit`, `_crit_alarm`
보정Rshunt, pga_gain오버플로 없는 데이터시트 절차
보정 레지스터를 사용하는 하드웨어 계산과 출력 속성입니다.
Rshunt·pga_gain으로 보정값 계산→션트 전압과 보정값으로 전류 계산→전류와 버스 전압으로 전력 계산→curr2·power1 입력값 제공→전력 임계 경보 평가
보정부터 전력 경보까지의 계산 순서입니다.
The bus power and bus currents range and resolution depends on the calibration
register value. Those values are calculate by the hardware using those
formulas:
Current = (ShuntVoltage * CalibrationRegister) / 4096
Power = (Current * BusVoltage) / 5000
The driver exports the bus current and bus power values via the following
sysFs files:
**curr2_input**
**power1_input**
**power1_crit**
**power1_crit_alarm**
The calibration process follow the procedure of the datasheet (without overflow)
and depend on the shunt resistor value and the pga_gain value.
요약·해설
tmp513.rst:1-103TMP513 계열은 온도 최대 4채널과 고측 션트 모니터를 결합해 전압·전류·전력을 하드웨어 보정식으로 계산합니다.
원문 분량과 핵심 기능을 요약합니다.
장치 초기화부터 측정·보호 상태 제공까지의 순서입니다.