← Documents Documentation/iio/ep93xx_adc.rst GitHub 원문 ↗

Linux 6.18.37 · IIO

Cirrus Logic EP93xx ADC driver

EP93xx ADC 장치군과 8개 IIO 전압 채널의 번호 및 하드웨어 핀 대응을 설명합니다.

Source pathDocumentation/iio/ep93xx_adc.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

ep93xx_adc.rst:1-40

EP93xx ADC 드라이버는 5채널 저사양 모델과 touchscreen/ADC 고사양 모델을 지원합니다. 공통 채널 0..4는 데이터시트 번호를 따르고 추가 채널 5..7은 드라이버가 정한 번호로 XP·XM·YP에 대응합니다.

문서 개요
항목내용
SourceDocumentation/iio/ep93xx_adc.rst
분량40 source lines
저사양EP9301, EP9302
고사양EP9307, EP9312, EP9315

원문 분량과 핵심 대상을 요약합니다.

핵심 흐름
SoC 모델 확인IIO device0 등록채널 번호와 핀 대응 확인`in_voltageN_raw`에서 ADC 값 읽기

설정과 데이터 접근 순서를 압축합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 ==============================
2 Cirrus Logic EP93xx ADC driver
3 ==============================
4
5 1. Overview
6 ===========
7
8 The driver is intended to work on both low-end (EP9301, EP9302) devices with
9 5-channel ADC and high-end (EP9307, EP9312, EP9315) devices with 10-channel
10 touchscreen/ADC module.
11
12 2. Channel numbering
13 ====================
14
15 Numbering scheme for channels 0..4 is defined in EP9301 and EP9302 datasheets.
16 EP9307, EP9312 and EP9315 have 3 channels more (total 8), but the numbering is
17 not defined. So the last three are numbered randomly, let's say.
18
19 Assuming ep93xx_adc is IIO device0, you'd find the following entries under
20 /sys/bus/iio/devices/iio:device0/:
21
22 +-----------------+---------------+
23 | sysfs entry | ball/pin name |
24 +=================+===============+
25 | in_voltage0_raw | YM |
26 +-----------------+---------------+
27 | in_voltage1_raw | SXP |
28 +-----------------+---------------+
29 | in_voltage2_raw | SXM |
30 +-----------------+---------------+
31 | in_voltage3_raw | SYP |
32 +-----------------+---------------+
33 | in_voltage4_raw | SYM |
34 +-----------------+---------------+
35 | in_voltage5_raw | XP |
36 +-----------------+---------------+
37 | in_voltage6_raw | XM |
38 +-----------------+---------------+
39 | in_voltage7_raw | YP |
40 +-----------------+---------------+
41

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

EP93xx ADC 지원 장치

1-11

Cirrus Logic EP93xx ADC 드라이버는 저사양 장치와 고사양 장치 모두에서 동작하도록 설계되었습니다.

EP93xx ADC 지원 장치군
장치군모델ADC 구성
저사양EP9301, EP93025채널 ADC
고사양EP9307, EP9312, EP931510채널 touchscreen/ADC module

원문이 구분하는 저사양·고사양 모델과 ADC 구성을 정리했습니다.

EP93xx 장치 선택
EP93xx SoC 모델 확인EP9301·EP9302면 5채널 구성EP9307·EP9312·EP9315면 touchscreen/ADC 구성IIO 장치와 voltage 채널 등록

SoC 모델에 따라 ADC 기능을 구성하는 흐름입니다.

==============================
Cirrus Logic EP93xx ADC driver
==============================

1. Overview
===========

The driver is intended to work on both low-end (EP9301, EP9302) devices with
5-channel ADC and high-end (EP9307, EP9312, EP9315) devices with 10-channel
touchscreen/ADC module.

ADC 채널 번호 체계

12-20

채널 0부터 4까지의 번호 체계는 EP9301과 EP9302 데이터시트에 정의되어 있습니다.

EP9307, EP9312, EP9315에는 채널이 3개 더 있어 총 8개이지만, 추가 채널의 번호 체계는 정의되어 있지 않습니다. 따라서 원문 표현대로 마지막 세 채널은 임의로 번호를 붙였습니다.

`ep93xx_adc`가 IIO `device0`이라고 가정하면 `/sys/bus/iio/devices/iio:device0/` 아래에서 이어지는 항목을 찾을 수 있습니다.

EP93xx 채널 번호 출처
채널모델번호 근거
0..4EP9301, EP9302 및 공통Datasheet 정의
5..7EP9307, EP9312, EP9315 추가 채널정의 없음, driver가 임의 배정

데이터시트 정의 여부와 드라이버의 처리 방식을 구분합니다.

2. Channel numbering
====================

Numbering scheme for channels 0..4 is defined in EP9301 and EP9302 datasheets.
EP9307, EP9312 and EP9315 have 3 channels more (total 8), but the numbering is
not defined. So the last three are numbered randomly, let's say.

Assuming ep93xx_adc is IIO device0, you'd find the following entries under
/sys/bus/iio/devices/iio:device0/:

sysfs 전압 채널과 ball/pin 대응

21-40
EP93xx ADC sysfs 채널 대응표
sysfs entryball/pin name
`in_voltage0_raw`YM
`in_voltage1_raw`SXP
`in_voltage2_raw`SXM
`in_voltage3_raw`SYP
`in_voltage4_raw`SYM
`in_voltage5_raw`XP
`in_voltage6_raw`XM
`in_voltage7_raw`YP

`iio:device0` 아래의 전압 원시 값 속성과 하드웨어 ball/pin 이름을 원문과 동일하게 대응시켰습니다.

ADC 원시 값 접근
`/sys/bus/iio/devices/iio:device0/` 열기필요한 ball/pin 이름 확인대응하는 `in_voltageN_raw` 선택원시 ADC 값 읽기

하드웨어 핀을 대응하는 IIO sysfs 값으로 읽는 순서입니다.


  +-----------------+---------------+
  | sysfs entry     | ball/pin name |
  +=================+===============+
  | in_voltage0_raw | YM            |
  +-----------------+---------------+
  | in_voltage1_raw | SXP           |
  +-----------------+---------------+
  | in_voltage2_raw | SXM           |
  +-----------------+---------------+
  | in_voltage3_raw | SYP           |
  +-----------------+---------------+
  | in_voltage4_raw | SYM           |
  +-----------------+---------------+
  | in_voltage5_raw | XP            |
  +-----------------+---------------+
  | in_voltage6_raw | XM            |
  +-----------------+---------------+
  | in_voltage7_raw | YP            |
  +-----------------+---------------+