← Documents Documentation/devicetree/bindings/usb/generic-xhci.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Generic USB xHCI Controller

generic·Marvell·Broadcom xHCI compatible, clock·coherency와 BCM2711 power-domain 조건을 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/generic-xhci.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

generic-xhci.yaml:1-86

generic·Marvell·Broadcom xHCI compatible, clock·coherency와 BCM2711 power-domain 조건을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, PHY, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/usb/generic-xhci.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: USB xHCI Controller
8
9 maintainers:
10 - Mathias Nyman <mathias.nyman@intel.com>
11
12 properties:
13 compatible:
14 oneOf:
15 - description: Generic xHCI device
16 const: generic-xhci
17 - description: Armada 37xx/375/38x/8k SoCs
18 items:
19 - enum:
20 - marvell,armada3700-xhci
21 - marvell,armada-375-xhci
22 - marvell,armada-380-xhci
23 - marvell,armada-8k-xhci
24 - const: generic-xhci
25 - description: Broadcom SoCs with power domains
26 items:
27 - enum:
28 - brcm,bcm2711-xhci
29 - const: brcm,xhci-brcm-v2
30 - description: Broadcom STB SoCs with xHCI
31 enum:
32 - brcm,xhci-brcm-v2
33 - brcm,bcm7445-xhci
34 - description: Generic xHCI device
35 const: xhci-platform
36 deprecated: true
37
38 reg:
39 maxItems: 1
40
41 interrupts:
42 maxItems: 1
43
44 clocks:
45 minItems: 1
46 maxItems: 2
47
48 clock-names:
49 minItems: 1
50 items:
51 - const: core
52 - const: reg
53
54 dma-coherent: true
55
56 power-domains:
57 maxItems: 1
58
59 unevaluatedProperties: false
60
61 required:
62 - compatible
63 - reg
64 - interrupts
65
66 allOf:
67 - $ref: usb-xhci.yaml#
68 - if:
69 properties:
70 compatible:
71 contains:
72 const: brcm,bcm2711-xhci
73 then:
74 required:
75 - power-domains
76 else:
77 properties:
78 power-domains: false
79
80 examples:
81 - |
82 usb@f0931000 {
83 compatible = "generic-xhci";
84 reg = <0xf0931000 0x8c8>;
85 interrupts = <0x0 0x4e 0x0>;
86 };
87

3. 한국어 전문 번역

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

USB xHCI controller

1-11

GPL-2.0으로 배포되는 이 schema는 USB xHCI controller를 정의합니다. 관리자는 Mathias Nyman입니다.

Generic, Marvell과 Broadcom compatible

12-37

generic device는 `generic-xhci`를 사용합니다. Marvell Armada 3700·375·380·8k는 각 SoC compatible 뒤에 `generic-xhci` fallback을 둡니다.

power domain을 사용하는 Broadcom BCM2711은 `brcm,bcm2711-xhci`, `brcm,xhci-brcm-v2` 순서입니다. Broadcom STB는 `brcm,xhci-brcm-v2` 또는 `brcm,bcm7445-xhci`를 사용합니다.

`xhci-platform`은 폐기된 generic compatible입니다.

properties:
  compatible:
    oneOf:
      - description: Generic xHCI device
        const: generic-xhci
      - description: Armada 37xx/375/38x/8k SoCs
        items:
          - enum:
              - marvell,armada3700-xhci
              - marvell,armada-375-xhci
              - marvell,armada-380-xhci
              - marvell,armada-8k-xhci
          - const: generic-xhci
      - description: Broadcom SoCs with power domains
        items:
          - enum:
              - brcm,bcm2711-xhci
          - const: brcm,xhci-brcm-v2
      - description: Broadcom STB SoCs with xHCI
        enum:
          - brcm,xhci-brcm-v2
          - brcm,bcm7445-xhci
      - description: Generic xHCI device
        const: xhci-platform
        deprecated: true

Register, interrupt, clock과 coherency

38-59

register 영역과 interrupt는 각각 최대 하나입니다. clock은 1~2개이고 이름은 순서대로 `core`, `reg`입니다.

`dma-coherent`를 허용하며 power domain은 최대 하나입니다. 평가되지 않은 추가 속성은 허용하지 않습니다.

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    minItems: 1
    maxItems: 2

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

  dma-coherent: true

  power-domains:
    maxItems: 1

unevaluatedProperties: false

필수 속성과 BCM2711 power domain

60-79

필수 속성은 `compatible`, `reg`, `interrupts`이며 공통 `usb-xhci.yaml`을 상속합니다.

`compatible`에 `brcm,bcm2711-xhci`가 포함되면 `power-domains`가 필수입니다. 다른 compatible에서는 `power-domains`를 허용하지 않습니다.


required:
  - compatible
  - reg
  - interrupts

allOf:
  - $ref: usb-xhci.yaml#
  - if:
      properties:
        compatible:
          contains:
            const: brcm,bcm2711-xhci
    then:
      required:
        - power-domains
    else:
      properties:
        power-domains: false

Generic xHCI 예제

80-86

예제 `usb@f0931000`은 `generic-xhci`, 0x8c8-byte register 영역과 interrupt specifier `<0x0 0x4e 0x0>`를 사용합니다.

examples:
  - |
    usb@f0931000 {
      compatible = "generic-xhci";
      reg = <0xf0931000 0x8c8>;
      interrupts = <0x0 0x4e 0x0>;
    };