← Documents Documentation/devicetree/bindings/usb/intel,keembay-dwc3.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Intel Keem Bay DWC3 USB Controller

Keem Bay DWC3 wrapper의 네 clock, address 범위와 peripheral-mode DWC3 child를 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/intel,keembay-dwc3.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

intel,keembay-dwc3.yaml:1-77

Keem Bay DWC3 wrapper의 네 clock, address 범위와 peripheral-mode DWC3 child를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, PHY, connector, 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/intel,keembay-dwc3.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Intel Keem Bay DWC3 USB controller
8
9 maintainers:
10 - Wan Ahmad Zainie <[email protected]>
11
12 properties:
13 compatible:
14 const: intel,keembay-dwc3
15
16 reg:
17 maxItems: 1
18
19 clocks:
20 maxItems: 4
21
22 clock-names:
23 items:
24 - const: async_master
25 - const: ref
26 - const: alt_ref
27 - const: suspend
28
29 ranges: true
30
31 '#address-cells':
32 enum: [ 1, 2 ]
33
34 '#size-cells':
35 enum: [ 1, 2 ]
36
37 # Required child node:
38
39 patternProperties:
40 "^usb@[0-9a-f]+$":
41 $ref: snps,dwc3.yaml#
42
43 required:
44 - compatible
45 - clocks
46 - clock-names
47 - ranges
48
49 additionalProperties: false
50
51 examples:
52 - |
53 #include <dt-bindings/interrupt-controller/arm-gic.h>
54 #include <dt-bindings/interrupt-controller/irq.h>
55 #define KEEM_BAY_A53_AUX_USB
56 #define KEEM_BAY_A53_AUX_USB_REF
57 #define KEEM_BAY_A53_AUX_USB_ALT_REF
58 #define KEEM_BAY_A53_AUX_USB_SUSPEND
59
60 usb {
61 compatible = "intel,keembay-dwc3";
62 clocks = <&scmi_clk KEEM_BAY_A53_AUX_USB>,
63 <&scmi_clk KEEM_BAY_A53_AUX_USB_REF>,
64 <&scmi_clk KEEM_BAY_A53_AUX_USB_ALT_REF>,
65 <&scmi_clk KEEM_BAY_A53_AUX_USB_SUSPEND>;
66 clock-names = "async_master", "ref", "alt_ref", "suspend";
67 ranges;
68 #address-cells = <1>;
69 #size-cells = <1>;
70
71 usb@34000000 {
72 compatible = "snps,dwc3";
73 reg = <0x34000000 0x10000>;
74 interrupts = <GIC_SPI 91 IRQ_TYPE_LEVEL_HIGH>;
75 dr_mode = "peripheral";
76 };
77 };
78

3. 한국어 전문 번역

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

Intel Keem Bay DWC3 controller

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Intel Keem Bay DWC3 USB controller wrapper를 정의합니다. 관리자는 Wan Ahmad Zainie입니다.

네 clock, address 범위와 DWC3 child

12-42

`compatible`은 `intel,keembay-dwc3`이고 register 영역은 최대 하나입니다. clock은 최대 네 개이며 이름과 순서는 `async_master`, `ref`, `alt_ref`, `suspend`입니다.

wrapper는 `ranges`를 사용하고 address cell 및 size cell 수는 각각 1 또는 2입니다. `usb@` 뒤에 16진 주소가 오는 필수 child node는 `snps,dwc3.yaml`을 따라야 합니다.

properties:
  compatible:
    const: intel,keembay-dwc3

  reg:
    maxItems: 1

  clocks:
    maxItems: 4

  clock-names:
    items:
      - const: async_master
      - const: ref
      - const: alt_ref
      - const: suspend

  ranges: true

  '#address-cells':
    enum: [ 1, 2 ]

  '#size-cells':
    enum: [ 1, 2 ]

# Required child node:

patternProperties:
  "^usb@[0-9a-f]+$":
    $ref: snps,dwc3.yaml#

필수 wrapper 속성

43-50

필수 속성은 `compatible`, `clocks`, `clock-names`, `ranges`입니다. 정의되지 않은 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - clocks
  - clock-names
  - ranges

additionalProperties: false

Keem Bay peripheral-mode DWC3

51-77

예제 wrapper는 SCMI에서 auxiliary, reference, alternate reference, suspend clock 네 개를 받아 해당 이름으로 연결하고 address cell과 size cell을 1로 설정합니다.

child `usb@34000000`은 `snps,dwc3`, 0x10000-byte register 영역, level-high GIC SPI 91을 사용하며 `dr_mode`를 `peripheral`로 설정합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/interrupt-controller/irq.h>
    #define KEEM_BAY_A53_AUX_USB
    #define KEEM_BAY_A53_AUX_USB_REF
    #define KEEM_BAY_A53_AUX_USB_ALT_REF
    #define KEEM_BAY_A53_AUX_USB_SUSPEND

    usb {
        compatible = "intel,keembay-dwc3";
        clocks = <&scmi_clk KEEM_BAY_A53_AUX_USB>,
                 <&scmi_clk KEEM_BAY_A53_AUX_USB_REF>,
                 <&scmi_clk KEEM_BAY_A53_AUX_USB_ALT_REF>,
                 <&scmi_clk KEEM_BAY_A53_AUX_USB_SUSPEND>;
        clock-names = "async_master", "ref", "alt_ref", "suspend";
        ranges;
        #address-cells = <1>;
        #size-cells = <1>;

        usb@34000000 {
            compatible = "snps,dwc3";
            reg = <0x34000000 0x10000>;
            interrupts = <GIC_SPI 91 IRQ_TYPE_LEVEL_HIGH>;
            dr_mode = "peripheral";
        };
    };