Renesas RZ/G3E USB 3.2 Gen2 Host

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

1. 요약·해설

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

요약과 해설

renesas,rzg3e-xhci.yaml:1-87

RZ/G3E xHCI의 다섯 interrupt, clock·reset·PHY 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.

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/usb/renesas,rzg3e-xhci.yaml#

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

7 title: Renesas RZ/G3E USB 3.2 Gen2 Host controller

9 maintainers:

10 - Biju Das <biju.das.jz@bp.renesas.com>

12 properties:

13 compatible:

14 const: renesas,r9a09g047-xhci

16 reg:

17 maxItems: 1

19 interrupts:

20 items:

21 - description: Logical OR of all interrupt signals.

22 - description: System management interrupt

23 - description: Host system error interrupt

24 - description: Power management event interrupt

25 - description: xHC interrupt

27 interrupt-names:

28 items:

29 - const: all

30 - const: smi

31 - const: hse

32 - const: pme

33 - const: xhc

35 clocks:

36 maxItems: 1

38 phys:

39 maxItems: 2

41 phy-names:

42 items:

43 - const: usb2-phy

44 - const: usb3-phy

46 power-domains:

47 maxItems: 1

49 resets:

50 maxItems: 1

52 required:

53 - compatible

54 - reg

55 - interrupts

56 - interrupt-names

57 - clocks

58 - power-domains

59 - resets

60 - phys

61 - phy-names

63 allOf:

64 - $ref: usb-xhci.yaml

66 additionalProperties: false

68 examples:

69 - |

70 #include <dt-bindings/clock/renesas,r9a09g047-cpg.h>

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

73 usb@15850000 {

74 compatible = "renesas,r9a09g047-xhci";

75 reg = <0x15850000 0x10000>;

76 interrupts = <GIC_SPI 759 IRQ_TYPE_LEVEL_HIGH>,

77 <GIC_SPI 758 IRQ_TYPE_LEVEL_HIGH>,

78 <GIC_SPI 757 IRQ_TYPE_LEVEL_HIGH>,

79 <GIC_SPI 756 IRQ_TYPE_LEVEL_HIGH>,

80 <GIC_SPI 755 IRQ_TYPE_LEVEL_HIGH>;

81 interrupt-names = "all", "smi", "hse", "pme", "xhc";

82 clocks = <&cpg CPG_MOD 0xaf>;

83 power-domains = <&cpg>;

84 resets = <&cpg 0xaa>;

85 phys = <&usb3_phy>, <&usb3_phy>;

86 phy-names = "usb2-phy", "usb3-phy";

87 };

3. 한국어 전문 번역

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

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Renesas RZ/G3E USB 3.2 Gen2 Host controller를 정의합니다. 관리자는 Biju Das입니다.

다섯 interrupt와 두 PHY

12-51

`compatible`은 `renesas,r9a09g047-xhci`이고 register와 clock은 각각 하나입니다.

interrupt 다섯 개는 모든 signal의 logical OR `all`, system management `smi`, host system error `hse`, power-management event `pme`, xHC `xhc` 순서입니다.

PHY는 최대 두 개이고 이름은 `usb2-phy`, `usb3-phy`입니다. power domain과 reset은 각각 하나입니다.

properties:
  compatible:
    const: renesas,r9a09g047-xhci

  reg:
    maxItems: 1

  interrupts:
    items:
      - description: Logical OR of all interrupt signals.
      - description: System management interrupt
      - description: Host system error interrupt
      - description: Power management event interrupt
      - description: xHC interrupt

  interrupt-names:
    items:
      - const: all
      - const: smi
      - const: hse
      - const: pme
      - const: xhc

  clocks:
    maxItems: 1

  phys:
    maxItems: 2

  phy-names:
    items:
      - const: usb2-phy
      - const: usb3-phy

  power-domains:
    maxItems: 1

  resets:
    maxItems: 1

아홉 필수 속성과 xHCI schema

52-67

필수 속성은 `compatible`, `reg`, `interrupts`, `interrupt-names`, `clocks`, `power-domains`, `resets`, `phys`, `phy-names`의 아홉 개입니다. 공통 `usb-xhci.yaml`을 상속하고 정의되지 않은 추가 속성을 허용하지 않습니다.

required:
  - compatible
  - reg
  - interrupts
  - interrupt-names
  - clocks
  - power-domains
  - resets
  - phys
  - phy-names

allOf:
  - $ref: usb-xhci.yaml

additionalProperties: false

R9A09G047 xHCI 예제

68-87

예제 `usb@15850000`은 0x10000-byte 영역과 level-high GIC SPI 759·758·757·756·755를 `all`, `smi`, `hse`, `pme`, `xhc` 순서로 사용합니다.

CPG module clock 0xaf, CPG power domain, reset 0xaa를 연결하고 source에 적힌 대로 두 PHY phandle 모두 `usb3_phy`를 사용하되 이름은 `usb2-phy`, `usb3-phy`입니다.

examples:
  - |
    #include <dt-bindings/clock/renesas,r9a09g047-cpg.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    usb@15850000 {
      compatible = "renesas,r9a09g047-xhci";
      reg = <0x15850000 0x10000>;
      interrupts = <GIC_SPI 759 IRQ_TYPE_LEVEL_HIGH>,
                   <GIC_SPI 758 IRQ_TYPE_LEVEL_HIGH>,
                   <GIC_SPI 757 IRQ_TYPE_LEVEL_HIGH>,
                   <GIC_SPI 756 IRQ_TYPE_LEVEL_HIGH>,
                   <GIC_SPI 755 IRQ_TYPE_LEVEL_HIGH>;
      interrupt-names = "all", "smi", "hse", "pme", "xhc";
      clocks = <&cpg CPG_MOD 0xaf>;
      power-domains = <&cpg>;
      resets = <&cpg 0xaa>;
      phys = <&usb3_phy>, <&usb3_phy>;
      phy-names = "usb2-phy", "usb3-phy";
    };