Documentation/devicetree/bindings/sound/img,spdif-out.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

IMG SPDIF output controller

SPDIF output의 TX DMA, system/reference clock, reset과 interrupt를 설명합니다.

Source pathDocumentation/devicetree/bindings/sound/img,spdif-out.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

img,spdif-out.txt:1-44

Google SC7280 LPASS card와 Hisilicon·Imagination audio controller의 DAI, DMA, clock, reset 계약을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 legacy TXT의 property·code·줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Imagination Technologies SPDIF Output Controller
2
3 Required Properties:
4
5 - compatible : Compatible list, must contain "img,spdif-out"
6
7 - #sound-dai-cells : Must be equal to 0
8
9 - reg : Offset and length of the register set for the device
10
11 - dmas: Contains an entry for each entry in dma-names.
12
13 - dma-names: Must include the following entry:
14 "tx"
15
16 - clocks : Contains an entry for each entry in clock-names.
17
18 - clock-names : Includes the following entries:
19 "sys" The system clock
20 "ref" The reference clock
21
22 - resets: Contains a phandle to the spdif out reset signal
23
24 - reset-names: Contains the reset signal name "rst"
25
26 Optional Properties:
27
28 - interrupts : Contains the parallel out interrupt, if present
29
30 Example:
31
32 spdif_out: spdif-out@18100d00 {
33 compatible = "img,spdif-out";
34 reg = <0x18100D00 0x100>;
35 interrupts = <GIC_SHARED 21 IRQ_TYPE_LEVEL_HIGH>;
36 dmas = <&mdc 14 0xffffffff 0>;
37 dma-names = "tx";
38 clocks = <&cr_periph SYS_CLK_SPDIF_OUT>,
39 <&clk_core CLK_SPDIF>;
40 clock-names = "sys", "ref";
41 resets = <&pistachio_reset PISTACHIO_RESET_SPDIF_OUT>;
42 reset-names = "rst";
43 #sound-dai-cells = <0>;
44 };
45

3. 한국어 전문 번역

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

IMG SPDIF output 필수 속성

1-25

`compatible`은 `img,spdif-out`, `#sound-dai-cells`는 0이고 `reg`는 register set입니다. `dma-names`는 TX `tx`, `clock-names`는 system `sys`와 reference `ref`입니다. `resets`와 `reset-names = "rst"`가 output reset을 지정합니다.

선택적 interrupt

26-29

`interrupts`는 원문 표현대로 parallel out interrupt가 있을 때 지정하는 선택 속성입니다.

Pistachio SPDIF output 예제

30-44

예제는 address `0x18100D00`, GIC shared interrupt 21, MDC TX DMA 14, SPDIF system/reference clock과 output reset을 설정합니다.

spdif_out: spdif-out@18100d00 {
        compatible = "img,spdif-out";
        reg = <0x18100D00 0x100>;
        interrupts = <GIC_SHARED 21 IRQ_TYPE_LEVEL_HIGH>;
        dmas = <&mdc 14 0xffffffff 0>;
        dma-names = "tx";
        clocks = <&cr_periph SYS_CLK_SPDIF_OUT>,
                 <&clk_core CLK_SPDIF>;
        clock-names = "sys", "ref";
        resets = <&pistachio_reset PISTACHIO_RESET_SPDIF_OUT>;
        reset-names = "rst";
        #sound-dai-cells = <0>;
};