요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver ads7828
=====================
Supported chips:
* Texas Instruments/Burr-Brown ADS7828
Prefix: 'ads7828'
Datasheet: Publicly available at the Texas Instruments website:
http://focus.ti.com/lit/ds/symlink/ads7828.pdf
* Texas Instruments ADS7830
Prefix: 'ads7830'
Datasheet: Publicly available at the Texas Instruments website:
http://focus.ti.com/lit/ds/symlink/ads7830.pdf
Authors:
- Steve Hardy <shardy@redhat.com>
- Vivien Didelot <vivien.didelot@savoirfairelinux.com>
- Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
Platform data
-------------
The ads7828 driver accepts an optional ads7828_platform_data structure (defined
in include/linux/platform_data/ads7828.h). The structure fields are:
* diff_input: (bool) Differential operation
set to true for differential mode, false for default single ended mode.
* ext_vref: (bool) External reference
set to true if it operates with an external reference, false for default
internal reference.
* vref_mv: (unsigned int) Voltage reference
if using an external reference, set this to the reference voltage in mV,
otherwise it will default to the internal value (2500mV). This value will be
bounded with limits accepted by the chip, described in the datasheet.
If no structure is provided, the configuration defaults to single ended
operation and internal voltage reference (2.5V).
Description
-----------
This driver implements support for the Texas Instruments ADS7828 and ADS7830.
The ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does
8-bit sampling.
It can operate in single ended mode (8 +ve inputs) or in differential mode,
where 4 differential pairs can be measured.
The chip also has the facility to use an external voltage reference. This
may be required if your hardware supplies the ADS7828 from a 5V supply, see
the datasheet for more details.
There is no reliable way to identify this chip, so the driver will not scan
some addresses to try to auto-detect it. That means that you will have to
statically declare the device in the platform support code.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ADS7828과 ADS7830 지원
1-26드라이버는 Texas Instruments/Burr-Brown `ADS7828` prefix `ads7828`과 Texas Instruments `ADS7830` prefix `ads7830`을 지원합니다. 두 데이터시트는 TI 웹사이트에 공개되어 있으며 원문에 각 URL이 기재되어 있습니다.
저자는 Steve Hardy, Vivien Didelot, Guillaume Roguez입니다.
두 ADC의 driver prefix입니다.
정적으로 선언한 장치 이름으로 해상도를 선택합니다.
Kernel driver ads7828
=====================
Supported chips:
* Texas Instruments/Burr-Brown ADS7828
Prefix: 'ads7828'
Datasheet: Publicly available at the Texas Instruments website:
http://focus.ti.com/lit/ds/symlink/ads7828.pdf
* Texas Instruments ADS7830
Prefix: 'ads7830'
Datasheet: Publicly available at the Texas Instruments website:
http://focus.ti.com/lit/ds/symlink/ads7830.pdf
Authors:
- Steve Hardy <shardy@redhat.com>
- Vivien Didelot <vivien.didelot@savoirfairelinux.com>
- Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
Platform data와 voltage reference
27-46`ads7828` 드라이버는 선택적인 `ads7828_platform_data` 구조체를 받습니다. 정의 위치는 `include/linux/platform_data/ads7828.h`입니다.
Boolean `diff_input`은 differential operation을 선택합니다. `true`이면 differential mode, `false`이면 기본 single-ended mode입니다. Boolean `ext_vref`는 external reference 사용 여부이며 `true`는 외부 reference, `false`는 기본 internal reference입니다.
Unsigned integer `vref_mv`는 reference voltage를 mV 단위로 지정합니다. External reference를 사용하면 실제 reference voltage를 기록하고, 그렇지 않으면 internal value인 2500mV가 기본값입니다. 이 값은 데이터시트가 설명하는 chip 허용 범위로 제한됩니다.
Platform data 구조체를 제공하지 않으면 single-ended operation과 internal 2.5V voltage reference를 기본으로 사용합니다.
선택 가능한 입력 방식과 reference 설정입니다.
Platform data 유무와 field 값으로 변환 기준을 정합니다.
Platform data
-------------
The ads7828 driver accepts an optional ads7828_platform_data structure (defined
in include/linux/platform_data/ads7828.h). The structure fields are:
* diff_input: (bool) Differential operation
set to true for differential mode, false for default single ended mode.
* ext_vref: (bool) External reference
set to true if it operates with an external reference, false for default
internal reference.
* vref_mv: (unsigned int) Voltage reference
if using an external reference, set this to the reference voltage in mV,
otherwise it will default to the internal value (2500mV). This value will be
bounded with limits accepted by the chip, described in the datasheet.
If no structure is provided, the configuration defaults to single ended
operation and internal voltage reference (2.5V).해상도, 입력 mode와 정적 선언
47-65이 드라이버는 Texas Instruments ADS7828과 ADS7830을 지원합니다. ADS7828은 12-bit 8-channel A/D converter이고 ADS7830은 8-bit sampling을 수행합니다.
Single-ended mode에서는 positive input 8개를 측정하고 differential mode에서는 differential pair 4개를 측정할 수 있습니다.
칩은 external voltage reference도 사용할 수 있습니다. Hardware가 ADS7828에 5V supply를 제공하는 경우 외부 reference가 필요할 수 있으므로 자세한 내용은 데이터시트를 확인해야 합니다.
이 칩을 신뢰성 있게 식별할 방법이 없어 드라이버는 일부 주소를 scan하여 자동 검색하지 않습니다. 따라서 platform support code에서 장치를 statically declare해야 합니다.
해상도와 입력 mode의 channel 수입니다.
신뢰할 identity가 없어 platform 선언을 요구합니다.
Description
-----------
This driver implements support for the Texas Instruments ADS7828 and ADS7830.
The ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does
8-bit sampling.
It can operate in single ended mode (8 +ve inputs) or in differential mode,
where 4 differential pairs can be measured.
The chip also has the facility to use an external voltage reference. This
may be required if your hardware supplies the ADS7828 from a 5V supply, see
the datasheet for more details.
There is no reliable way to identify this chip, so the driver will not scan
some addresses to try to auto-detect it. That means that you will have to
statically declare the device in the platform support code.
요약·해설
ads7828.rst:1-6512-bit 또는 8-bit ADC를 single-ended 8채널이나 differential 4쌍으로 구성하고 reference를 선택합니다.
원문 분량과 핵심 지원 범위입니다.
장치를 구성하고 측정하는 기본 순서입니다.