TI TUSB73x0 PCIe xHCI Host Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

ti,tusb73x0-pci.yaml:1-55

TUSB7320·TUSB7340의 PCI 식별자, port 수와 PWRON 극성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, PHY, firmware, graph endpoint, 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/ti,tusb73x0-pci.yaml#

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

7 title: TUSB73x0 USB 3.0 xHCI Host Controller (PCIe)

9 maintainers:

10 - Francesco Dolcini <[email protected]>

12 description:

13 TUSB73x0 USB 3.0 xHCI Host Controller via PCIe x1 Gen2 interface.

14 The TUSB7320 supports up to two downstream ports, the TUSB7340 supports up

15 to four downstream ports, both variants share the same PCI device ID.

17 properties:

18 compatible:

19 const: pci104c,8241

21 reg:

22 maxItems: 1

24 ti,pwron-active-high:

25 $ref: /schemas/types.yaml#/definitions/flag

26 description:

27 Configure the polarity of the PWRONx# signals. When this is present, the

28 PWRONx# pins are active high and their internal pull-down resistors are

29 disabled. When this is absent, the PWRONx# pins are active low (default)

30 and their internal pull-down resistors are enabled.

32 required:

33 - compatible

34 - reg

36 allOf:

37 - $ref: usb-xhci.yaml

39 additionalProperties: false

41 examples:

42 - |

43 pcie@0 {

44 reg = <0x0 0x1000>;

45 ranges = <0x02000000 0x0 0x100000 0x10000000 0x0 0x0>;

46 #address-cells = <3>;

47 #size-cells = <2>;

48 device_type = "pci";

50 usb@0 {

51 compatible = "pci104c,8241";

52 reg = <0x0 0x0 0x0 0x0 0x0>;

53 ti,pwron-active-high;

54 };

55 };

3. 한국어 전문 번역

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

TUSB73x0 PCIe xHCI host controller

1-16

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 PCIe x1 Gen2 interface를 사용하는 TUSB73x0 USB 3.0 xHCI host controller를 정의합니다. 관리자는 Francesco Dolcini입니다.

TUSB7320은 downstream port를 최대 두 개, TUSB7340은 최대 네 개 지원하며 두 변형은 같은 PCI device ID를 공유합니다.

PCI ID와 PWRON 극성

17-31

compatible은 TI vendor와 device ID를 나타내는 `pci104c,8241`이고 register는 하나입니다.

`ti,pwron-active-high`가 있으면 PWRONx# pin은 active high가 되고 internal pull-down resistor는 비활성화됩니다. 속성이 없으면 기본값은 active low이며 internal pull-down resistor가 활성화됩니다.

properties:
  compatible:
    const: pci104c,8241

  reg:
    maxItems: 1

  ti,pwron-active-high:
    $ref: /schemas/types.yaml#/definitions/flag
    description:
      Configure the polarity of the PWRONx# signals. When this is present, the
      PWRONx# pins are active high and their internal pull-down resistors are
      disabled. When this is absent, the PWRONx# pins are active low (default)
      and their internal pull-down resistors are enabled.

xHCI schema와 확장 제한

32-40

compatible과 register가 필수이고 `usb-xhci.yaml`을 상속합니다. 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - reg

allOf:
  - $ref: usb-xhci.yaml

additionalProperties: false

PCIe child controller 예제

41-55

예제 PCIe bus는 세 개의 address cell과 두 개의 size cell을 사용합니다. 내부 `usb@0`은 `pci104c,8241` device이며 `ti,pwron-active-high`를 지정해 PWRONx# 신호를 active high로 구성합니다.

examples:
  - |
    pcie@0 {
        reg = <0x0 0x1000>;
        ranges = <0x02000000 0x0 0x100000 0x10000000 0x0 0x0>;
        #address-cells = <3>;
        #size-cells = <2>;
        device_type = "pci";

        usb@0 {
            compatible = "pci104c,8241";
            reg = <0x0 0x0 0x0 0x0 0x0>;
            ti,pwron-active-high;
        };
    };