Renesas USB xHCI Controllers

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

1. 요약·해설

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

요약과 해설

renesas,usb-xhci.yaml:1-119

R-Car·RZ 계열 xHCI의 compatible과 조건부 clock 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, 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,usb-xhci.yaml#

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

7 title: Renesas USB xHCI controllers

9 maintainers:

10 - Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

11 - Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>

13 properties:

14 compatible:

15 oneOf:

16 - items:

17 - enum:

18 - renesas,xhci-r8a7742 # RZ/G1H

19 - renesas,xhci-r8a7743 # RZ/G1M

20 - renesas,xhci-r8a7744 # RZ/G1N

21 - renesas,xhci-r8a7790 # R-Car H2

22 - renesas,xhci-r8a7791 # R-Car M2-W

23 - renesas,xhci-r8a7793 # R-Car M2-N

24 - const: renesas,rcar-gen2-xhci # R-Car Gen2 and RZ/G1

25 - items:

26 - enum:

27 - renesas,xhci-r8a774a1 # RZ/G2M

28 - renesas,xhci-r8a774b1 # RZ/G2N

29 - renesas,xhci-r8a774c0 # RZ/G2E

30 - renesas,xhci-r8a774e1 # RZ/G2H

31 - renesas,xhci-r8a7795 # R-Car H3

32 - renesas,xhci-r8a7796 # R-Car M3-W

33 - renesas,xhci-r8a77961 # R-Car M3-W+

34 - renesas,xhci-r8a77965 # R-Car M3-N

35 - renesas,xhci-r8a77990 # R-Car E3

36 - const: renesas,rcar-gen3-xhci # R-Car Gen3 and RZ/G2

37 - items:

38 - enum:

39 - renesas,r9a09g011-xhci # RZ/V2M

40 - renesas,r9a09g055-xhci # RZ/V2MA

41 - const: renesas,rzv2m-xhci # RZ/{V2M, V2MA}

43 reg:

44 maxItems: 1

46 interrupts:

47 maxItems: 1

49 clocks:

50 minItems: 1

51 items:

52 - description: Main clock for host

53 - description: Register access clock

55 clock-names:

56 minItems: 1

57 items:

58 - const: axi

59 - const: reg

61 phys:

62 maxItems: 1

64 phy-names:

65 items:

66 - const: usb

68 power-domains:

69 maxItems: 1

71 resets:

72 maxItems: 1

74 required:

75 - compatible

76 - reg

77 - interrupts

78 - clocks

79 - power-domains

80 - resets

82 allOf:

83 - $ref: usb-xhci.yaml

85 - if:

86 properties:

87 compatible:

88 contains:

89 enum:

90 - renesas,rzv2m-xhci

91 then:

92 properties:

93 clocks:

94 minItems: 2

95 clock-names:

96 minItems: 2

97 required:

98 - clock-names

99 else:

100 properties:

101 clocks:

102 maxItems: 1

103

104 unevaluatedProperties: false

105

106 examples:

107 - |

108 #include <dt-bindings/clock/r8a7795-cpg-mssr.h>

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

110 #include <dt-bindings/power/r8a7795-sysc.h>

111

112 xhci0: usb@ee000000 {

113 compatible = "renesas,xhci-r8a7795", "renesas,rcar-gen3-xhci";

114 reg = <0xee000000 0xc00>;

115 interrupts = <GIC_SPI 102 IRQ_TYPE_LEVEL_HIGH>;

116 clocks = <&cpg CPG_MOD 328>;

117 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;

118 resets = <&cpg 328>;

119 };

120

3. 한국어 전문 번역

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

1-12

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 Renesas USB xHCI controller 계열을 정의합니다. 관리자는 Lad Prabhakar와 Yoshihiro Shimoda입니다.

R-Car·RZ/G·RZ/V2M compatible 계열

13-41

첫 compatible 계열은 RZ/G1H·G1M·G1N과 R-Car H2·M2-W·M2-N을 `renesas,rcar-gen2-xhci`로 fallback합니다. 둘째 계열은 RZ/G2M·G2N·G2E·G2H와 R-Car H3·M3-W·M3-W+·M3-N·E3를 `renesas,rcar-gen3-xhci`로 fallback합니다.

셋째 계열은 RZ/V2M의 `renesas,r9a09g011-xhci`와 RZ/V2MA의 `renesas,r9a09g055-xhci`를 공통 `renesas,rzv2m-xhci`로 fallback합니다.

properties:
  compatible:
    oneOf:
      - items:
          - enum:
              - renesas,xhci-r8a7742 # RZ/G1H
              - renesas,xhci-r8a7743 # RZ/G1M
              - renesas,xhci-r8a7744 # RZ/G1N
              - renesas,xhci-r8a7790 # R-Car H2
              - renesas,xhci-r8a7791 # R-Car M2-W
              - renesas,xhci-r8a7793 # R-Car M2-N
          - const: renesas,rcar-gen2-xhci # R-Car Gen2 and RZ/G1
      - items:
          - enum:
              - renesas,xhci-r8a774a1 # RZ/G2M
              - renesas,xhci-r8a774b1 # RZ/G2N
              - renesas,xhci-r8a774c0 # RZ/G2E
              - renesas,xhci-r8a774e1 # RZ/G2H
              - renesas,xhci-r8a7795  # R-Car H3
              - renesas,xhci-r8a7796  # R-Car M3-W
              - renesas,xhci-r8a77961 # R-Car M3-W+
              - renesas,xhci-r8a77965 # R-Car M3-N
              - renesas,xhci-r8a77990 # R-Car E3
          - const: renesas,rcar-gen3-xhci # R-Car Gen3 and RZ/G2
      - items:
          - enum:
              - renesas,r9a09g011-xhci # RZ/V2M
              - renesas,r9a09g055-xhci # RZ/V2MA
          - const: renesas,rzv2m-xhci  # RZ/{V2M, V2MA}

register, clock, PHY와 필수 resource

42-81

register와 interrupt는 각각 하나입니다. clock은 host main clock과 register access clock 순서이며 최소 하나를 사용합니다. 이름은 `axi`, `reg` 순서입니다. 선택 가능한 PHY는 하나이고 이름은 `usb`입니다. power domain과 reset도 각각 하나입니다.

필수 속성은 `compatible`, `reg`, `interrupts`, `clocks`, `power-domains`, `resets`입니다.


  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    minItems: 1
    items:
      - description: Main clock for host
      - description: Register access clock

  clock-names:
    minItems: 1
    items:
      - const: axi
      - const: reg

  phys:
    maxItems: 1

  phy-names:
    items:
      - const: usb

  power-domains:
    maxItems: 1

  resets:
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - power-domains
  - resets

공통 xHCI schema와 RZ/V2M clock 조건

82-105

공통 `usb-xhci.yaml`을 상속합니다. `renesas,rzv2m-xhci`가 포함되면 clock 두 개와 clock 이름 두 개가 필요하며 `clock-names`도 필수입니다. 그 밖의 compatible은 clock을 최대 하나만 사용합니다. 평가되지 않은 추가 속성은 허용하지 않습니다.

allOf:
  - $ref: usb-xhci.yaml

  - if:
      properties:
        compatible:
          contains:
            enum:
              - renesas,rzv2m-xhci
    then:
      properties:
        clocks:
          minItems: 2
        clock-names:
          minItems: 2
      required:
        - clock-names
    else:
      properties:
        clocks:
          maxItems: 1

unevaluatedProperties: false

R-Car H3 xHCI 예제

106-119

예제 `xhci0: usb@ee000000`은 R-Car H3 compatible과 Gen3 fallback, 0xc00-byte register 영역, level-high GIC SPI 102, CPG module clock 328, always-on power domain, reset 328을 사용합니다.

examples:
  - |
    #include <dt-bindings/clock/r8a7795-cpg-mssr.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/power/r8a7795-sysc.h>

    xhci0: usb@ee000000 {
        compatible = "renesas,xhci-r8a7795", "renesas,rcar-gen3-xhci";
        reg = <0xee000000 0xc00>;
        interrupts = <GIC_SPI 102 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&cpg CPG_MOD 328>;
        power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;
        resets = <&cpg 328>;
    };