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

Linux 6.18.37 · Devicetree Bindings / Sound

IMG parallel output controller

Parallel audio output의 TX DMA, clock, reset과 interrupt를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

img,parallel-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 Parallel Output Controller
2
3 Required Properties:
4
5 - compatible : Compatible list, must contain "img,parallel-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 parallel 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 parallel_out: parallel-out@18100c00 {
33 compatible = "img,parallel-out";
34 reg = <0x18100C00 0x100>;
35 interrupts = <GIC_SHARED 19 IRQ_TYPE_LEVEL_HIGH>;
36 dmas = <&mdc 16 0xffffffff 0>;
37 dma-names = "tx";
38 clocks = <&cr_periph SYS_CLK_PAUD_OUT>,
39 <&clk_core CLK_AUDIO_DAC>;
40 clock-names = "sys", "ref";
41 resets = <&pistachio_reset PISTACHIO_RESET_PRL_OUT>;
42 reset-names = "rst";
43 #sound-dai-cells = <0>;
44 };
45

3. 한국어 전문 번역

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

IMG parallel output 필수 속성

1-25

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

선택적 interrupt

26-29

`interrupts`는 parallel output interrupt가 있을 때 지정하는 선택 속성입니다.

Pistachio parallel audio 예제

30-44

예제는 address `0x18100C00`, GIC shared interrupt 19, MDC TX DMA 16, PAUD system clock, audio DAC reference clock과 parallel output reset을 설정합니다.

parallel_out: parallel-out@18100c00 {
        compatible = "img,parallel-out";
        reg = <0x18100C00 0x100>;
        interrupts = <GIC_SHARED 19 IRQ_TYPE_LEVEL_HIGH>;
        dmas = <&mdc 16 0xffffffff 0>;
        dma-names = "tx";
        clocks = <&cr_periph SYS_CLK_PAUD_OUT>,
                 <&clk_core CLK_AUDIO_DAC>;
        clock-names = "sys", "ref";
        resets = <&pistachio_reset PISTACHIO_RESET_PRL_OUT>;
        reset-names = "rst";
        #sound-dai-cells = <0>;
};