← Documents Documentation/devicetree/bindings/usb/samsung,exynos-usb2.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Samsung Exynos USB 2.0 EHCI/OHCI Controller

Exynos EHCI/OHCI의 clock, PHY, VBUS GPIO와 USB child 예제를 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/samsung,exynos-usb2.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

samsung,exynos-usb2.yaml:1-107

Exynos EHCI/OHCI의 clock, PHY, VBUS GPIO와 USB child 예제를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, GPIO, clock, PHY, hub mode, 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/samsung,exynos-usb2.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Samsung Exynos SoC USB 2.0 EHCI/OHCI Controller
8
9 maintainers:
10 - Krzysztof Kozlowski <krzk@kernel.org>
11
12 properties:
13 compatible:
14 enum:
15 - samsung,exynos4210-ehci
16 - samsung,exynos4210-ohci
17
18 clocks:
19 maxItems: 1
20
21 clock-names:
22 items:
23 - const: usbhost
24
25 interrupts:
26 maxItems: 1
27
28 phys:
29 minItems: 1
30 maxItems: 3
31
32 phy-names:
33 items:
34 enum: [host, hsic0, hsic1]
35 minItems: 1
36 maxItems: 3
37
38 reg:
39 maxItems: 1
40
41 samsung,vbus-gpio:
42 description:
43 Only for controller in EHCI mode, if present, specifies the GPIO that
44 needs to be pulled up for the bus to be powered.
45
46 required:
47 - compatible
48 - clocks
49 - clock-names
50 - interrupts
51 - phys
52 - phy-names
53 - reg
54
55 allOf:
56 - $ref: usb-hcd.yaml#
57 - if:
58 properties:
59 compatible:
60 contains:
61 const: samsung,exynos4210-ohci
62 then:
63 properties:
64 samsung,vbus-gpio: false
65
66 unevaluatedProperties: false
67
68 examples:
69 - |
70 #include <dt-bindings/clock/exynos5420.h>
71 #include <dt-bindings/interrupt-controller/arm-gic.h>
72
73 usb@12110000 {
74 compatible = "samsung,exynos4210-ehci";
75 reg = <0x12110000 0x100>;
76 interrupts = <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>;
77 clocks = <&clock CLK_USBH20>;
78 clock-names = "usbhost";
79 phys = <&usb2_phy 0>;
80 phy-names = "host";
81
82 #address-cells = <1>;
83 #size-cells = <0>;
84
85 hub@1 {
86 compatible = "usb0424,9514";
87 reg = <1>;
88 #address-cells = <1>;
89 #size-cells = <0>;
90
91 usbether@1 {
92 compatible = "usb0424,ec00";
93 reg = <1>;
94 local-mac-address = [00 00 00 00 00 00];
95 };
96 };
97 };
98
99 usb@12120000 {
100 compatible = "samsung,exynos4210-ohci";
101 reg = <0x12120000 0x100>;
102 interrupts = <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>;
103 clocks = <&clock CLK_USBH20>;
104 clock-names = "usbhost";
105 phys = <&usb2_phy 0>;
106 phy-names = "host";
107 };
108

3. 한국어 전문 번역

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

Exynos USB 2.0 EHCI/OHCI

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 Samsung Exynos SoC USB 2.0 EHCI/OHCI controller를 정의합니다. 관리자는 Krzysztof Kozlowski입니다.

clock, PHY와 EHCI VBUS GPIO

12-45

compatible은 `samsung,exynos4210-ehci` 또는 `samsung,exynos4210-ohci`입니다. controller clock은 하나이고 이름은 `usbhost`, interrupt와 register 영역도 각각 하나입니다.

PHY는 1~3개이며 이름은 `host`, `hsic0`, `hsic1` 가운데 순서대로 지정합니다. `samsung,vbus-gpio`는 EHCI mode에서만 사용할 수 있고, bus에 전원을 공급하기 위해 pull-up해야 하는 GPIO를 나타냅니다.

properties:
  compatible:
    enum:
      - samsung,exynos4210-ehci
      - samsung,exynos4210-ohci

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: usbhost

  interrupts:
    maxItems: 1

  phys:
    minItems: 1
    maxItems: 3

  phy-names:
    items:
      enum: [host, hsic0, hsic1]
    minItems: 1
    maxItems: 3

  reg:
    maxItems: 1

  samsung,vbus-gpio:
    description:
      Only for controller in EHCI mode, if present, specifies the GPIO that
      needs to be pulled up for the bus to be powered.

필수 속성과 OHCI 제한

46-67

필수 속성은 `compatible`, `clocks`, `clock-names`, `interrupts`, `phys`, `phy-names`, `reg`입니다. 공통 `usb-hcd.yaml`을 상속하며 OHCI compatible에서는 `samsung,vbus-gpio`를 허용하지 않습니다. 평가되지 않은 추가 속성도 허용하지 않습니다.

required:
  - compatible
  - clocks
  - clock-names
  - interrupts
  - phys
  - phy-names
  - reg

allOf:
  - $ref: usb-hcd.yaml#
  - if:
      properties:
        compatible:
          contains:
            const: samsung,exynos4210-ohci
    then:
      properties:
        samsung,vbus-gpio: false

unevaluatedProperties: false

EHCI hub·Ethernet과 OHCI 예제

68-107

EHCI 예제 `usb@12110000`은 0x100-byte 영역, level-high GIC SPI 71, `CLK_USBH20`, host PHY를 사용합니다. child `hub@1`은 USB0424:9514 hub이고 그 아래 `usbether@1`은 USB0424:EC00 Ethernet device이며 빈 local MAC address를 둡니다.

OHCI 예제 `usb@12120000`도 같은 interrupt, clock, host PHY 구성을 사용하지만 EHCI 전용 VBUS GPIO는 없습니다.

examples:
  - |
    #include <dt-bindings/clock/exynos5420.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    usb@12110000 {
        compatible = "samsung,exynos4210-ehci";
        reg = <0x12110000 0x100>;
        interrupts = <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&clock CLK_USBH20>;
        clock-names = "usbhost";
        phys = <&usb2_phy 0>;
        phy-names = "host";

        #address-cells = <1>;
        #size-cells = <0>;

        hub@1 {
            compatible = "usb0424,9514";
            reg = <1>;
            #address-cells = <1>;
            #size-cells = <0>;

            usbether@1 {
                compatible = "usb0424,ec00";
                reg = <1>;
                local-mac-address = [00 00 00 00 00 00];
            };
        };
    };

    usb@12120000 {
        compatible = "samsung,exynos4210-ohci";
        reg = <0x12120000 0x100>;
        interrupts = <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&clock CLK_USBH20>;
        clock-names = "usbhost";
        phys = <&usb2_phy 0>;
        phy-names = "host";
    };