USB Switch Ports Graph Properties | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

usb-switch-ports.yaml:1-68

USB mode·orientation switch의 단일·복수 port graph와 data lane 조건을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, property, enum, phandle, graph endpoint, example, 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/usb-switch-ports.yaml#

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

7 title: USB Orientation and Mode Switches Ports Graph Properties

9 maintainers:

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

12 description:

13 Ports Graph properties for devices handling USB mode and orientation switching.

15 properties:

16 port:

17 $ref: /schemas/graph.yaml#/$defs/port-base

18 description:

19 A port node to link the device to a TypeC controller for the purpose of

20 handling altmode muxing and orientation switching.

22 properties:

23 endpoint:

24 $ref: /schemas/graph.yaml#/$defs/endpoint-base

25 unevaluatedProperties: false

26 properties:

27 data-lanes:

28 $ref: /schemas/types.yaml#/definitions/uint32-array

29 minItems: 1

30 maxItems: 8

31 uniqueItems: true

32 items:

33 maximum: 8

35 ports:

36 $ref: /schemas/graph.yaml#/properties/ports

37 properties:

38 port@0:

39 $ref: /schemas/graph.yaml#/properties/port

40 description:

41 Super Speed (SS) Output endpoint to the Type-C connector

43 port@1:

44 $ref: /schemas/graph.yaml#/$defs/port-base

45 description:

46 Super Speed (SS) Input endpoint from the Super-Speed PHY

47 unevaluatedProperties: false

49 properties:

50 endpoint:

51 $ref: /schemas/graph.yaml#/$defs/endpoint-base

52 unevaluatedProperties: false

53 properties:

54 data-lanes:

55 $ref: /schemas/types.yaml#/definitions/uint32-array

56 minItems: 1

57 maxItems: 8

58 uniqueItems: true

59 items:

60 maximum: 8

62 oneOf:

63 - required:

64 - port

65 - required:

66 - ports

68 additionalProperties: true

3. 한국어 전문 번역

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

USB switch graph properties

1-14

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 USB mode 및 orientation switching을 처리하는 장치의 port graph 속성을 정의합니다. 관리자는 Greg Kroah-Hartman입니다.

단일 Type-C controller port

15-34

단일 `port` 형식은 altmode muxing과 orientation switching을 위해 switch 장치를 Type-C controller에 연결합니다.

endpoint의 `data-lanes`는 1~8개의 고유한 32-bit 값으로 구성되며 각 값은 최대 8입니다. endpoint에는 schema가 평가하지 않은 추가 속성을 허용하지 않습니다.

properties:
  port:
    $ref: /schemas/graph.yaml#/$defs/port-base
    description:
      A port node to link the device to a TypeC controller for the purpose of
      handling altmode muxing and orientation switching.

    properties:
      endpoint:
        $ref: /schemas/graph.yaml#/$defs/endpoint-base
        unevaluatedProperties: false
        properties:
          data-lanes:
            $ref: /schemas/types.yaml#/definitions/uint32-array
            minItems: 1
            maxItems: 8
            uniqueItems: true
            items:
              maximum: 8

SuperSpeed input·output ports

35-61

복수 `ports` 형식에서 `port@0`은 Type-C connector로 향하는 SuperSpeed output endpoint이고 `port@1`은 SuperSpeed PHY에서 들어오는 input endpoint입니다.

`port@1` endpoint의 `data-lanes`도 1~8개의 고유 값, 각 값 최대 8이라는 동일한 제한을 따릅니다.

ports:
  $ref: /schemas/graph.yaml#/properties/ports
  properties:
    port@0:
      $ref: /schemas/graph.yaml#/properties/port
      description:
        Super Speed (SS) Output endpoint to the Type-C connector

    port@1:
      $ref: /schemas/graph.yaml#/$defs/port-base
      description:
        Super Speed (SS) Input endpoint from the Super-Speed PHY
      unevaluatedProperties: false

      properties:
        endpoint:
          $ref: /schemas/graph.yaml#/$defs/endpoint-base
          unevaluatedProperties: false
          properties:
            data-lanes:
              $ref: /schemas/types.yaml#/definitions/uint32-array
              minItems: 1
              maxItems: 8
              uniqueItems: true
              items:
                maximum: 8

port 표현 선택

62-68

단일 `port` 또는 복수 `ports` 가운데 정확히 한 형식을 필수로 사용합니다. 장치별 추가 속성은 허용합니다.

oneOf:
  - required:
      - port
  - required:
      - ports

additionalProperties: true