요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver adc128d818
========================
Supported chips:
* Texas Instruments ADC818D818
Prefix: 'adc818d818'
Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
Datasheet: Publicly available at the TI website https://www.ti.com/
Author: Guenter Roeck
Description
-----------
This driver implements support for the Texas Instruments ADC128D818.
It is described as 'ADC System Monitor with Temperature Sensor'.
The ADC128D818 implements one temperature sensor and seven voltage sensors.
Temperatures are measured in degrees Celsius. There is one set of limits.
When the HOT Temperature Limit is crossed, this will cause an alarm that will
be reasserted until the temperature drops below the HOT Hysteresis.
Measurements are guaranteed between -55 and +125 degrees. The temperature
measurement has a resolution of 0.5 degrees; the limits have a resolution
of 1 degree.
Voltage sensors (also known as IN sensors) report their values in volts.
An alarm is triggered if the voltage has crossed a programmable minimum
or maximum limit. Note that minimum in this case always means 'closest to
zero'; this is important for negative voltage measurements. All voltage
inputs can measure voltages between 0 and 2.55 volts, with a resolution
of 0.625 mV.
If an alarm triggers, it will remain triggered until the hardware register
is read at least once. This means that the cause for the alarm may
already have disappeared by the time the alarm is read. The driver
caches the alarm status for each sensor until it is at least reported
once, to ensure that alarms are reported to user space.
The ADC128D818 only updates its values approximately once per second;
reading it more often will do no harm, but will return 'old' values.
In addition to the scanned address list, the chip can also be configured for
addresses 0x35 to 0x37. Those addresses are not scanned. You have to instantiate
the driver explicitly if the chip is configured for any of those addresses in
your system.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 장치와 I2C 주소
1-17이 문서는 Texas Instruments ADC128D818용 커널 드라이버를 설명합니다. 지원 칩 목록의 표기는 `ADC818D818`, prefix는 `adc818d818`이며, 자동 검색하는 I2C 주소는 `0x1d`, `0x1e`, `0x1f`, `0x2d`, `0x2e`, `0x2f`입니다.
데이터시트는 TI 웹사이트 `https://www.ti.com/`에서 공개되어 있으며 저자는 Guenter Roeck입니다.
드라이버가 자동으로 찾는 주소와 기본 식별자입니다.
스캔 주소에 있는 장치를 hwmon으로 등록하는 순서입니다.
Kernel driver adc128d818
========================
Supported chips:
* Texas Instruments ADC818D818
Prefix: 'adc818d818'
Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
Datasheet: Publicly available at the TI website https://www.ti.com/
Author: Guenter Roeck
Description
-----------온도와 전압 측정
18-36이 드라이버는 '온도 센서가 있는 ADC 시스템 모니터'로 설명되는 Texas Instruments ADC128D818을 지원합니다. 칩에는 온도 센서 1개와 전압 센서 7개가 있습니다.
온도는 섭씨로 측정하며 한 세트의 한계값을 갖습니다. `HOT Temperature Limit`를 넘으면 경보가 발생하고, 온도가 `HOT Hysteresis` 아래로 내려갈 때까지 경보가 다시 설정됩니다. 보장 측정 범위는 -55도에서 +125도이고 측정 해상도는 0.5도, 한계값 해상도는 1도입니다.
전압 센서, 즉 IN 센서는 값을 volt로 보고합니다. 프로그래밍한 최소 또는 최대 한계값을 넘으면 경보가 발생합니다. 여기서 최소값은 항상 0에 가장 가까운 값이라는 뜻이므로 음전압을 측정할 때 특히 주의해야 합니다. 모든 전압 입력의 범위는 0V에서 2.55V이고 해상도는 0.625mV입니다.
채널별 범위와 한계값의 의미를 정리합니다.
측정값과 프로그램된 한계값을 비교합니다.
This driver implements support for the Texas Instruments ADC128D818.
It is described as 'ADC System Monitor with Temperature Sensor'.
The ADC128D818 implements one temperature sensor and seven voltage sensors.
Temperatures are measured in degrees Celsius. There is one set of limits.
When the HOT Temperature Limit is crossed, this will cause an alarm that will
be reasserted until the temperature drops below the HOT Hysteresis.
Measurements are guaranteed between -55 and +125 degrees. The temperature
measurement has a resolution of 0.5 degrees; the limits have a resolution
of 1 degree.
Voltage sensors (also known as IN sensors) report their values in volts.
An alarm is triggered if the voltage has crossed a programmable minimum
or maximum limit. Note that minimum in this case always means 'closest to
zero'; this is important for negative voltage measurements. All voltage
inputs can measure voltages between 0 and 2.55 volts, with a resolution
of 0.625 mV.경보 래치와 갱신 주기
37-50경보가 발생하면 하드웨어 register를 적어도 한 번 읽을 때까지 발생 상태가 유지됩니다. 따라서 경보를 읽는 시점에는 원인이 이미 사라졌을 수 있습니다. 드라이버는 경보가 사용자 공간에 최소 한 번 보고될 때까지 센서별 경보 상태를 cache하여 짧은 경보가 누락되지 않게 합니다.
ADC128D818은 값을 약 1초에 한 번만 갱신합니다. 더 자주 읽어도 장치에 해가 되지는 않지만 이전 값을 반환합니다.
기본 검색 목록 외에 칩을 `0x35`부터 `0x37` 주소로 설정할 수도 있습니다. 이 주소들은 자동 검색하지 않으므로 시스템에서 해당 주소를 사용한다면 드라이버 장치를 명시적으로 instantiate해야 합니다.
경보 보존, 값 갱신, 비검색 주소의 처리입니다.
짧게 발생한 하드웨어 경보를 사용자 공간까지 보존합니다.
If an alarm triggers, it will remain triggered until the hardware register
is read at least once. This means that the cause for the alarm may
already have disappeared by the time the alarm is read. The driver
caches the alarm status for each sensor until it is at least reported
once, to ensure that alarms are reported to user space.
The ADC128D818 only updates its values approximately once per second;
reading it more often will do no harm, but will return 'old' values.
In addition to the scanned address list, the chip can also be configured for
addresses 0x35 to 0x37. Those addresses are not scanned. You have to instantiate
the driver explicitly if the chip is configured for any of those addresses in
your system.
요약·해설
adc128d818.rst:1-50ADC128D818의 측정 범위, 경보 cache, 1초 갱신 주기와 명시적 장치 생성 조건을 함께 다룹니다.
원문과 핵심 지원 범위를 요약합니다.
드라이버를 이해할 때의 주요 순서입니다.