ADI AXI-I2S controller | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

adi,axi-i2s.txt:1-34

Audio controller와 codec의 clock, DMA, GPIO, supply 연결 규칙을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 ADI AXI-I2S controller

3 The core can be generated with transmit (playback), only receive

4 (capture) or both directions enabled.

6 Required properties:

7 - compatible : Must be "adi,axi-i2s-1.00.a"

8 - reg : Must contain I2S core's registers location and length

9 - clocks : Pairs of phandle and specifier referencing the controller's clocks.

10 The controller expects two clocks, the clock used for the AXI interface and

11 the clock used as the sampling rate reference clock sample.

12 - clock-names : "axi" for the clock to the AXI interface, "ref" for the sample

13 rate reference clock.

14 - dmas: Pairs of phandle and specifier for the DMA channels that are used by

15 the core. The core expects two dma channels if both transmit and receive are

16 enabled, one channel otherwise.

17 - dma-names : "tx" for the transmit channel, "rx" for the receive channel.

19 For more details on the 'dma', 'dma-names', 'clock' and 'clock-names' properties

20 please check:

21 * resource-names.txt

22 * clock/clock-bindings.txt

23 * dma/dma.txt

25 Example:

27 i2s: i2s@77600000 {

28 compatible = "adi,axi-i2s-1.00.a";

29 reg = <0x77600000 0x1000>;

30 clocks = <&clk 15>, <&audio_clock>;

31 clock-names = "axi", "ref";

32 dmas = <&ps7_dma 0>, <&ps7_dma 1>;

33 dma-names = "tx", "rx";

34 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

AXI-I2S 방향 구성

1-5

ADI AXI-I2S core는 transmit(playback) 전용, receive(capture) 전용 또는 양방향이 활성화된 형태로 생성할 수 있습니다.

Clock과 DMA 필수 속성

6-18

`compatible`은 `adi,axi-i2s-1.00.a`, `reg`는 I2S core register의 위치와 길이입니다.

`clocks`는 controller clock의 phandle·specifier 쌍이며 AXI interface clock과 sample rate reference clock 두 개가 필요합니다. `clock-names`는 각각 `axi`, `ref`입니다.

`dmas`는 core가 사용하는 DMA channel의 phandle·specifier 쌍입니다. transmit과 receive가 모두 활성화되면 두 channel, 한 방향만 활성화되면 하나가 필요합니다. `dma-names`는 송신 `tx`, 수신 `rx`입니다.

공통 resource binding 참조

19-24

`dma`, `dma-names`, `clock`, `clock-names`의 자세한 정의는 `resource-names.txt`, `clock/clock-bindings.txt`, `dma/dma.txt`를 참조합니다.

양방향 AXI-I2S 예제

25-34

예제는 AXI·audio reference clock과 송수신 DMA channel 두 개를 연결합니다.

i2s: i2s@77600000 {
        compatible = "adi,axi-i2s-1.00.a";
        reg = <0x77600000 0x1000>;
        clocks = <&clk 15>, <&audio_clock>;
        clock-names = "axi", "ref";
        dmas = <&ps7_dma 0>, <&ps7_dma 1>;
        dma-names = "tx", "rx";
};