Generic USB Host Controller

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

1. 요약·해설

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

요약과 해설

usb-hcd.yaml:1-52

USB host controller의 companion, Targeted Peripheral List와 hard-wired child를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, property, enum, phandle, graph endpoint, example, 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/usb-hcd.yaml#

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

7 title: Generic USB Host Controller

9 maintainers:

10 - Greg Kroah-Hartman <gregkh@linuxfoundation.org>

12 allOf:

13 - $ref: usb.yaml#

15 properties:

16 companion:

17 description: Phandle of a companion device

18 $ref: /schemas/types.yaml#/definitions/phandle

20 tpl-support:

21 description:

22 Indicates if the Targeted Peripheral List is supported for given

23 targeted hosts (non-PC hosts).

24 type: boolean

26 "#address-cells":

27 const: 1

29 "#size-cells":

30 const: 0

32 patternProperties:

33 "^.*@[0-9a-f]{1,2}$":

34 description: The hard wired USB devices

35 type: object

36 $ref: /schemas/usb/usb-device.yaml

38 additionalProperties: true

40 examples:

41 - |

42 usb {

43 phys = <&usb2_phy1>, <&usb3_phy1>;

44 phy-names = "usb2", "usb3";

45 #address-cells = <1>;

46 #size-cells = <0>;

48 hub@1 {

49 compatible = "usb5e3,610";

50 reg = <1>;

51 };

52 };

3. 한국어 전문 번역

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

1-11

GPL-2.0으로 배포되는 이 스키마는 일반 USB host controller의 공통 속성을 정의합니다. 관리자는 Greg Kroah-Hartman입니다.

companion, TPL과 hard-wired device

12-38

공통 `usb.yaml`을 상속합니다. `companion`은 companion device의 phandle입니다. `tpl-support`는 targeted host, 즉 non-PC host에서 Targeted Peripheral List를 지원함을 나타냅니다.

address cell 수는 1, size cell 수는 0입니다. 1~2자리 소문자 16진수 port unit address를 가진 child는 hard-wired USB device이며 `usb-device.yaml`을 따릅니다. controller별 추가 속성은 허용합니다.

allOf:
  - $ref: usb.yaml#

properties:
  companion:
    description: Phandle of a companion device
    $ref: /schemas/types.yaml#/definitions/phandle

  tpl-support:
    description:
      Indicates if the Targeted Peripheral List is supported for given
      targeted hosts (non-PC hosts).
    type: boolean

  "#address-cells":
    const: 1

  "#size-cells":
    const: 0

patternProperties:
  "^.*@[0-9a-f]{1,2}$":
    description: The hard wired USB devices
    type: object
    $ref: /schemas/usb/usb-device.yaml

additionalProperties: true

고정 연결 hub 예제

39-52

예제 host controller는 USB2·USB3 PHY와 이름을 지정하고 port address용 한 개의 cell을 사용합니다. port 1에 고정 연결된 hub의 compatible은 `usb5e3,610`입니다.


examples:
  - |
    usb {
        phys = <&usb2_phy1>, <&usb3_phy1>;
        phy-names = "usb2", "usb3";
        #address-cells = <1>;
        #size-cells = <0>;

        hub@1 {
            compatible = "usb5e3,610";
            reg = <1>;
        };
    };