MVEBU audio controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

mvebu-audio.txt:1-46

Kirkwood·Dove·Armada audio controller의 register, interrupt, clock과 S/PDIF mode를 설명합니다. 아래의 접을 수 있는 영어 원문은 source path와 줄 배치를 그대로 보존하고, 한국어 전문 번역은 property·phandle·symbol과 예제 코드를 원형으로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * mvebu (Kirkwood, Dove, Armada 370) audio controller

3 Required properties:

5 - compatible:

6 "marvell,kirkwood-audio" for Kirkwood platforms

7 "marvell,dove-audio" for Dove platforms

8 "marvell,armada370-audio" for Armada 370 platforms

9 "marvell,armada-380-audio" for Armada 38x platforms

11 - reg: physical base address of the controller and length of memory mapped

12 region (named "i2s_regs").

13 With "marvell,armada-380-audio" two other regions are required:

14 first of those is dedicated for Audio PLL Configuration registers

15 (named "pll_regs") and the second one ("soc_ctrl") - for register

16 where one of exceptive I/O types (I2S or S/PDIF) is set.

18 - interrupts:

19 with "marvell,kirkwood-audio", the audio interrupt

20 with "marvell,dove-audio", a list of two interrupts, the first for

21 the data flow, and the second for errors.

23 - clocks: one or two phandles.

24 The first one is mandatory and defines the internal clock.

25 The second one is optional and defines an external clock.

27 - clock-names: names associated to the clocks:

28 "internal" for the internal clock

29 "extclk" for the external clock

31 Optional properties:

33 - spdif-mode:

34 Enable S/PDIF mode on Armada 38x SoC. Using this property

35 disables standard I2S I/O. Valid only with "marvell,armada-380-audio"

36 compatible string.

38 Example:

40 i2s1: audio-controller@b4000 {

41 compatible = "marvell,dove-audio";

42 reg = <0xb4000 0x2210>;

43 interrupts = <21>, <22>;

44 clocks = <&gate_clk 13>;

45 clock-names = "internal";

46 };

3. 한국어 전문 번역

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

MVEBU audio controller 필수 속성

1-30

MVEBU audio controller는 Kirkwood의 `marvell,kirkwood-audio`, Dove의 `marvell,dove-audio`, Armada 370의 `marvell,armada370-audio`, Armada 38x의 `marvell,armada-380-audio` compatible을 사용합니다.

`reg`의 기본 region `i2s_regs`는 controller physical base와 memory-mapped 길이입니다. Armada 38x에는 Audio PLL configuration용 `pll_regs`와 I2S 또는 S/PDIF I/O type 선택 register용 `soc_ctrl` region도 필요합니다.

Kirkwood는 audio interrupt 하나를, Dove는 data-flow interrupt와 error interrupt 두 개를 지정합니다. `clocks`의 첫 phandle은 필수 internal clock이고 둘째는 선택 external clock이며 `clock-names`는 각각 `internal`, `extclk`입니다.

Armada 38x S/PDIF mode

31-37

선택 `spdif-mode`는 Armada 38x SoC에서 S/PDIF mode를 활성화하고 표준 I2S I/O를 비활성화합니다. 이 속성은 `marvell,armada-380-audio` compatible에서만 유효합니다.

Dove audio controller 예제

38-46

예제는 `0xb4000`의 Dove controller에 data-flow·error interrupt 21·22와 internal gate clock 13을 연결합니다.

i2s1: audio-controller@b4000 {
        compatible = "marvell,dove-audio";
        reg = <0xb4000 0x2210>;
        interrupts = <21>, <22>;
        clocks = <&gate_clk 13>;
        clock-names = "internal";
};