ADI AXI-I2S controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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";
};