← Documents Documentation/devicetree/bindings/usb/faraday,fotg210.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Faraday FOTG200 Series HS OTG USB 2.0 Controller

Faraday FOTG200·FOTG210의 compatible, PCLK·Gemini syscon·PHY와 host 예제를 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/faraday,fotg210.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

faraday,fotg210.yaml:1-78

Faraday FOTG200·FOTG210의 compatible, PCLK·Gemini syscon·PHY와 host 예제를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, PHY, connector, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright 2022 Linaro Ltd.
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/usb/faraday,fotg210.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: Faraday Technology FOTG200 series HS OTG USB 2.0 controller
9
10 maintainers:
11 - Linus Walleij <linus.walleij@linaro.org>
12
13 allOf:
14 - $ref: usb-drd.yaml#
15 - $ref: usb-hcd.yaml#
16
17 properties:
18 compatible:
19 oneOf:
20 - const: faraday,fotg200
21 - const: faraday,fotg210
22 - items:
23 - const: cortina,gemini-usb
24 - const: faraday,fotg200
25
26 reg:
27 maxItems: 1
28
29 interrupts:
30 maxItems: 1
31
32 clocks:
33 maxItems: 1
34
35 clock-names:
36 items:
37 - const: PCLK
38
39 resets:
40 maxItems: 1
41
42 syscon:
43 $ref: /schemas/types.yaml#/definitions/phandle
44 description: a phandle to the global Gemini system controller on
45 Gemini systems
46
47 dr_mode: true
48
49 phys:
50 maxItems: 1
51
52 phy-names:
53 const: usb2-phy
54
55 required:
56 - compatible
57 - reg
58 - interrupts
59 - clocks
60 - clock-names
61
62 additionalProperties: false
63
64 examples:
65 - |
66 #include <dt-bindings/interrupt-controller/irq.h>
67 #include <dt-bindings/clock/cortina,gemini-clock.h>
68 #include <dt-bindings/reset/cortina,gemini-reset.h>
69 usb0: usb@68000000 {
70 compatible = "cortina,gemini-usb", "faraday,fotg200";
71 reg = <0x68000000 0x1000>;
72 interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;
73 resets = <&syscon GEMINI_RESET_USB0>;
74 clocks = <&syscon GEMINI_CLK_GATE_USB0>;
75 clock-names = "PCLK";
76 syscon = <&syscon>;
77 dr_mode = "host";
78 };
79

3. 한국어 전문 번역

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

Faraday FOTG200 series HS OTG

1-16

GPL-2.0 또는 BSD-2-Clause로 배포되는 이 schema는 Faraday Technology FOTG200 series HS OTG USB 2.0 controller를 정의합니다. 저작권자는 Linaro Ltd., 관리자는 Linus Walleij입니다.

공통 dual-role USB와 host controller 제약을 `usb-drd.yaml`, `usb-hcd.yaml`에서 상속합니다.

Compatible, clock, syscon과 PHY

17-54

`compatible`은 `faraday,fotg200`, `faraday,fotg210` 또는 `cortina,gemini-usb`와 `faraday,fotg200`의 fallback 조합입니다. register, interrupt, clock, reset은 각각 최대 하나입니다.

clock 이름은 `PCLK`입니다. Gemini system에서는 `syscon`이 global Gemini system controller의 phandle입니다. `dr_mode`의 공통 정의를 허용합니다.

PHY는 최대 하나이고 이름은 `usb2-phy`입니다.

properties:
  compatible:
    oneOf:
      - const: faraday,fotg200
      - const: faraday,fotg210
      - items:
          - const: cortina,gemini-usb
          - const: faraday,fotg200

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: PCLK

  resets:
    maxItems: 1

  syscon:
    $ref: /schemas/types.yaml#/definitions/phandle
    description: a phandle to the global Gemini system controller on
      Gemini systems

  dr_mode: true

  phys:
    maxItems: 1

  phy-names:
    const: usb2-phy

필수 속성과 추가 속성 제한

55-63

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

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

additionalProperties: false

Cortina Gemini host 예제

64-78

예제 `usb@68000000`은 Gemini USB와 FOTG200 fallback, 0x1000-byte register 영역, level-high interrupt 10, Gemini USB0 reset·clock gate와 global syscon을 사용하며 `dr_mode`는 `host`입니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/clock/cortina,gemini-clock.h>
    #include <dt-bindings/reset/cortina,gemini-reset.h>
    usb0: usb@68000000 {
        compatible = "cortina,gemini-usb", "faraday,fotg200";
        reg = <0x68000000 0x1000>;
        interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;
        resets = <&syscon GEMINI_RESET_USB0>;
        clocks = <&syscon GEMINI_CLK_GATE_USB0>;
        clock-names = "PCLK";
        syscon = <&syscon>;
        dr_mode = "host";
    };