Freescale MXS Serial Audio Interface | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

fsl,saif.yaml:1-83

NXP/Freescale RPMSG virtual audio와 SAI/SAIF serial interface의 clock, DMA, signal direction과 graph 연결을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/sound/fsl,saif.yaml#

5 $schema: http://devicetree.org/meta-schemas/core.yaml#

7 title: Freescale MXS Serial Audio Interface (SAIF)

9 maintainers:

10 - Lukasz Majewski <lukma@denx.de>

12 allOf:

13 - $ref: dai-common.yaml#

15 description:

16 The SAIF is based on I2S module that is used to communicate with audio codecs,

17 but only with half-duplex manner (i.e. it can either transmit or receive PCM

18 audio).

20 properties:

21 compatible:

22 const: fsl,imx28-saif

24 reg:

25 maxItems: 1

27 "#sound-dai-cells":

28 const: 0

30 interrupts:

31 maxItems: 1

33 dmas:

34 maxItems: 1

36 dma-names:

37 const: rx-tx

39 "#clock-cells":

40 description: Configure the I2S device as MCLK clock provider.

41 const: 0

43 clocks:

44 maxItems: 1

46 fsl,saif-master:

47 description: Indicate that saif is a slave and its phandle points to master

48 $ref: /schemas/types.yaml#/definitions/phandle

50 required:

51 - compatible

52 - reg

53 - "#sound-dai-cells"

54 - interrupts

55 - dmas

56 - dma-names

57 - clocks

59 unevaluatedProperties: false

61 examples:

62 - |

63 saif0: saif@80042000 {

64 compatible = "fsl,imx28-saif";

65 reg = <0x80042000 2000>;

66 #sound-dai-cells = <0>;

67 interrupts = <59>;

68 dmas = <&dma_apbx 4>;

69 dma-names = "rx-tx";

70 #clock-cells = <0>;

71 clocks = <&clks 53>;

72 };

73 - |

74 saif1: saif@80046000 {

75 compatible = "fsl,imx28-saif";

76 reg = <0x80046000 2000>;

77 #sound-dai-cells = <0>;

78 interrupts = <58>;

79 dmas = <&dma_apbx 5>;

80 dma-names = "rx-tx";

81 clocks = <&clks 53>;

82 fsl,saif-master = <&saif0>;

83 };

3. 한국어 전문 번역

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

Freescale MXS SAIF

1-19

SAIF는 audio codec 통신에 사용하는 I2S module 기반 interface지만 half-duplex 방식이어서 PCM audio를 송신하거나 수신하는 한 방향만 동시에 수행할 수 있습니다. Binding은 `dai-common.yaml#`을 상속하며 schema ID는 `http://devicetree.org/schemas/sound/fsl,saif.yaml#`, maintainer는 Lukasz Majewski입니다.

DAI, DMA와 MCLK provider

20-49

`compatible`은 `fsl,imx28-saif`, `reg`와 `interrupts`는 각각 최대 한 항목이며 `#sound-dai-cells`는 0입니다.

`dmas`는 최대 한 항목이고 `dma-names`는 송수신 공용 `rx-tx`입니다. `#clock-cells`가 0이면 I2S device를 MCLK provider로 구성하며 입력 `clocks`는 최대 한 항목입니다.

`fsl,saif-master`는 이 SAIF가 slave임을 표시하고 master SAIF를 가리키는 phandle입니다.

필수 속성과 확장 제한

50-60

필수 속성은 `compatible`, `reg`, `#sound-dai-cells`, `interrupts`, `dmas`, `dma-names`, `clocks`입니다. 공통 DAI schema 평가 뒤 정의되지 않은 추가 속성은 허용하지 않습니다.

SAIF0 master와 MCLK provider

61-72

첫 예제 SAIF0은 address `0x80042000`, interrupt 59, APBX DMA channel 4를 사용하며 `#clock-cells = <0>`으로 MCLK provider가 됩니다.

saif0: saif@80042000 {
    compatible = "fsl,imx28-saif";
    reg = <0x80042000 2000>;
    #sound-dai-cells = <0>;
    interrupts = <59>;
    dmas = <&dma_apbx 4>;
    dma-names = "rx-tx";
    #clock-cells = <0>;
    clocks = <&clks 53>;
};

SAIF1 slave 예제

73-83

두 번째 예제 SAIF1은 address `0x80046000`, interrupt 58, APBX DMA channel 5를 사용하며 `fsl,saif-master = <&saif0>`으로 SAIF0의 slave가 됩니다.

saif1: saif@80046000 {
    compatible = "fsl,imx28-saif";
    reg = <0x80046000 2000>;
    #sound-dai-cells = <0>;
    interrupts = <58>;
    dmas = <&dma_apbx 5>;
    dma-names = "rx-tx";
    clocks = <&clks 53>;
    fsl,saif-master = <&saif0>;
};