NXP Audio-to-HDMI controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

fsl,aud2htx.yaml:1-66

FourSemi amplifier와 Freescale/NXP audio card·controller의 compatible, clock, DMA, routing과 firmware 조건을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

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,aud2htx.yaml#

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

7 title: NXP Audio Subsystem to HDMI RTX Subsystem Controller

9 maintainers:

10 - Shengjiu Wang <[email protected]>

12 properties:

13 compatible:

14 const: fsl,imx8mp-aud2htx

16 reg:

17 maxItems: 1

19 interrupts:

20 maxItems: 1

22 clocks:

23 items:

24 - description: Peripheral clock

26 clock-names:

27 items:

28 - const: bus

30 dmas:

31 items:

32 - description: DMA controller phandle and request line for TX

34 dma-names:

35 items:

36 - const: tx

38 power-domains:

39 maxItems: 1

41 required:

42 - compatible

43 - reg

44 - interrupts

45 - clocks

46 - clock-names

47 - dmas

48 - dma-names

50 additionalProperties: false

52 examples:

53 - |

54 #include <dt-bindings/interrupt-controller/arm-gic.h>

55 #include <dt-bindings/clock/imx8mp-clock.h>

57 aud2htx: aud2htx@30cb0000 {

58 compatible = "fsl,imx8mp-aud2htx";

59 reg = <0x30cb0000 0x10000>;

60 interrupts = <GIC_SPI 130 IRQ_TYPE_LEVEL_HIGH>;

61 clocks = <&audiomix_clk IMX8MP_CLK_AUDIOMIX_AUD2HTX_IPG>;

62 clock-names = "bus";

63 dmas = <&sdma2 26 2 0>;

64 dma-names = "tx";

65 power-domains = <&audiomix_pd>;

66 };

3. 한국어 전문 번역

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

NXP AUD2HTX controller

1-11

이 YAML binding은 NXP audio subsystem에서 HDMI RTX subsystem으로 연결하는 AUD2HTX controller를 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/fsl,aud2htx.yaml#`이고 maintainer는 Shengjiu Wang입니다.

Register, IRQ, clock, DMA와 power

12-40

`compatible`은 `fsl,imx8mp-aud2htx`, `reg`와 `interrupts`는 각각 최대 한 항목입니다. `clocks`는 peripheral clock 한 항목이고 `clock-names`는 `bus`입니다.

`dmas`는 TX용 DMA controller phandle과 request line 한 항목이며 `dma-names`는 `tx`입니다. `power-domains`는 최대 한 항목입니다.

필수 속성과 추가 속성

41-51

필수 속성은 `compatible`, `reg`, `interrupts`, `clocks`, `clock-names`, `dmas`, `dma-names`입니다. `additionalProperties: false`이므로 정의되지 않은 속성은 허용하지 않습니다.

i.MX8MP AUD2HTX 예제

52-66

예제는 address `0x30cb0000`의 AUD2HTX에 GIC SPI 130, AudioMix AUD2HTX IPG bus clock, SDMA2 request 26과 AudioMix power domain을 연결합니다.

#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/clock/imx8mp-clock.h>

aud2htx: aud2htx@30cb0000 {
    compatible = "fsl,imx8mp-aud2htx";
    reg = <0x30cb0000 0x10000>;
    interrupts = <GIC_SPI 130 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&audiomix_clk IMX8MP_CLK_AUDIOMIX_AUD2HTX_IPG>;
    clock-names = "bus";
    dmas = <&sdma2 26 2 0>;
    dma-names = "tx";
    power-domains = <&audiomix_pd>;
};