Documentation/devicetree/bindings/sound/fsl,imx95-cm7-sof.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

NXP i.MX95 CM7 SOF core

Audio 처리용 i.MX95 CM7의 SRAM, DMA memory, mailbox와 SAI3 graph 연결을 설명합니다.

Source pathDocumentation/devicetree/bindings/sound/fsl,imx95-cm7-sof.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

fsl,imx95-cm7-sof.yaml:1-64

Freescale/NXP audio sample-rate conversion, board-level codec routing과 CM7 SOF 처리 경로의 핵심 속성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/sound/fsl,imx95-cm7-sof.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: NXP imx95 CM7 core
8
9 maintainers:
10 - Daniel Baluta <[email protected]>
11
12 description: NXP imx95 CM7 core used for audio processing
13
14 properties:
15 compatible:
16 const: fsl,imx95-cm7-sof
17
18 reg:
19 maxItems: 1
20
21 reg-names:
22 const: sram
23
24 memory-region:
25 maxItems: 1
26
27 memory-region-names:
28 const: dma
29
30 port:
31 description: SAI3 port
32 $ref: audio-graph-port.yaml#
33 unevaluatedProperties: false
34
35 required:
36 - compatible
37 - reg
38 - reg-names
39 - memory-region
40 - memory-region-names
41 - port
42
43 allOf:
44 - $ref: fsl,sof-cpu.yaml#
45
46 unevaluatedProperties: false
47
48 examples:
49 - |
50 cm7-cpu@80000000 {
51 compatible = "fsl,imx95-cm7-sof";
52 reg = <0x80000000 0x6100000>;
53 reg-names = "sram";
54 mboxes = <&mu7 2 0>, <&mu7 2 1>, <&mu7 3 0>, <&mu7 3 1>;
55 mbox-names = "txdb0", "txdb1", "rxdb0", "rxdb1";
56 memory-region = <&adma_res>;
57 memory-region-names = "dma";
58 port {
59 /* SAI3-WM8962 link */
60 endpoint {
61 remote-endpoint = <&wm8962_ep>;
62 };
63 };
64 };
65

3. 한국어 전문 번역

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

Audio 처리용 i.MX95 CM7 core

1-13

이 YAML binding은 audio processing에 사용하는 NXP i.MX95 CM7 core를 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/fsl,imx95-cm7-sof.yaml#`이며 maintainer는 Daniel Baluta입니다.

SRAM과 DMA memory region

14-29

`compatible`은 `fsl,imx95-cm7-sof`로 고정됩니다. `reg`는 최대 한 항목이고 `reg-names`는 `sram`이어야 합니다.

`memory-region`도 최대 한 항목이며 `memory-region-names`는 `dma`로 고정되어 CM7 audio firmware가 사용할 DMA reserved memory를 식별합니다.

SAI3 audio graph port

30-34

`port`는 SAI3 port를 나타내며 `audio-graph-port.yaml#`을 참조합니다. 평가되지 않은 추가 속성은 허용하지 않습니다.

필수 속성과 SOF CPU 공통 schema

35-47

필수 속성은 `compatible`, `reg`, `reg-names`, `memory-region`, `memory-region-names`, `port`입니다. `fsl,sof-cpu.yaml#`을 상속하여 mailbox 같은 SOF CPU 공통 속성을 함께 검증하며, 그 밖의 평가되지 않은 속성은 금지합니다.

CM7 SRAM, mailbox와 WM8962 link

48-64

예제는 `0x80000000`에서 시작하는 SRAM, MU7의 `txdb0`, `txdb1`, `rxdb0`, `rxdb1` mailbox, `adma_res` DMA memory를 설정합니다. SAI3-WM8962 link의 endpoint는 `wm8962_ep`를 가리킵니다.

cm7-cpu@80000000 {
    compatible = "fsl,imx95-cm7-sof";
    reg = <0x80000000 0x6100000>;
    reg-names = "sram";
    mboxes = <&mu7 2 0>, <&mu7 2 1>, <&mu7 3 0>, <&mu7 3 1>;
    mbox-names = "txdb0", "txdb1", "rxdb0", "rxdb1";
    memory-region = <&adma_res>;
    memory-region-names = "dma";
    port {
        /* SAI3-WM8962 link */
        endpoint {
            remote-endpoint = <&wm8962_ep>;
        };
    };
};