TI TWL4030 USB PHY and Comparator | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

ti,twl4030-usb.yaml:1-74

TWL4030 USB PHY의 interrupt, 세 regulator와 ULPI·CEA2011 mode를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, regulator, USB ID, graph 구조, 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,twl4030-usb.yaml#

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

7 title: Texas Instruments TWL4030 USB PHY and Comparator

9 maintainers:

10 - Peter Ujfalusi <[email protected]>

12 description:

13 Bindings for the USB PHY and comparator module found within the

14 TWL4030 family of companion chips. If a sibling node is compatible with

15 "ti,twl4030-bci", the driver for that node will query this device for

16 USB power status.

18 properties:

19 compatible:

20 const: ti,twl4030-usb

22 interrupts:

23 minItems: 1

24 items:

25 - description: OTG interrupt number for ID events.

26 - description: USB interrupt number for VBUS events.

28 usb1v5-supply:

29 description: Phandle to the vusb1v5 regulator.

31 usb1v8-supply:

32 description: Phandle to the vusb1v8 regulator.

34 usb3v1-supply:

35 description: Phandle to the vusb3v1 regulator.

37 usb_mode:

38 description: |

39 The mode used by the PHY to connect to the controller:

40 1: ULPI mode

41 2: CEA2011_3PIN mode

42 $ref: /schemas/types.yaml#/definitions/uint32

43 enum: [1, 2]

45 '#phy-cells':

46 const: 0

48 required:

49 - compatible

50 - interrupts

51 - usb1v5-supply

52 - usb1v8-supply

53 - usb3v1-supply

54 - usb_mode

56 additionalProperties: false

58 examples:

59 - |

60 #include <dt-bindings/interrupt-controller/irq.h>

62 usb-phy {

63 compatible = "ti,twl4030-usb";

65 interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;

66 interrupt-parent = <&gic>;

68 usb1v5-supply = <&reg_vusb1v5>;

69 usb1v8-supply = <&reg_vusb1v8>;

70 usb3v1-supply = <&reg_vusb3v1>;

71 usb_mode = <1>;

73 #phy-cells = <0>;

74 };

3. 한국어 전문 번역

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

TWL4030 USB PHY와 comparator

1-17

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 TWL4030 companion chip 계열에 들어 있는 USB PHY와 comparator module을 정의합니다. 관리자는 Peter Ujfalusi입니다.

sibling node가 `ti,twl4030-bci`와 호환되면 그 node의 driver는 이 장치에 USB power status를 질의합니다.

interrupt, regulator와 PHY mode

18-46

compatible은 `ti,twl4030-usb`입니다. interrupt는 최소 하나이며 첫 항목은 ID event용 OTG interrupt, 둘째 항목은 VBUS event용 USB interrupt입니다.

`usb1v5-supply`, `usb1v8-supply`, `usb3v1-supply`는 각각 vusb1v5·vusb1v8·vusb3v1 regulator phandle입니다. `usb_mode` 값 1은 ULPI mode, 2는 CEA2011_3PIN mode이며 `#phy-cells`는 0입니다.

properties:
  compatible:
    const: ti,twl4030-usb

  interrupts:
    minItems: 1
    items:
      - description: OTG interrupt number for ID events.
      - description: USB interrupt number for VBUS events.

  usb1v5-supply:
    description: Phandle to the vusb1v5 regulator.

  usb1v8-supply:
    description: Phandle to the vusb1v8 regulator.

  usb3v1-supply:
    description: Phandle to the vusb3v1 regulator.

  usb_mode:
    description: |
      The mode used by the PHY to connect to the controller:
        1: ULPI mode
        2: CEA2011_3PIN mode
    $ref: /schemas/types.yaml#/definitions/uint32
    enum: [1, 2]

  '#phy-cells':
    const: 0

필수 속성과 확장 제한

47-57

compatible, interrupts, 세 regulator supply와 `usb_mode`가 모두 필수이며 추가 속성은 허용하지 않습니다.


required:
  - compatible
  - interrupts
  - usb1v5-supply
  - usb1v8-supply
  - usb3v1-supply
  - usb_mode

additionalProperties: false

TWL4030 ULPI PHY 예제

58-74

예제 `usb-phy`는 high-level interrupt 10, GIC interrupt parent, 1.5V·1.8V·3.1V regulator를 연결합니다. `usb_mode = <1>`로 ULPI mode를 선택하고 PHY 인수 cell은 없습니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>

    usb-phy {
        compatible = "ti,twl4030-usb";

        interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-parent = <&gic>;

        usb1v5-supply = <&reg_vusb1v5>;
        usb1v8-supply = <&reg_vusb1v8>;
        usb3v1-supply  = <&reg_vusb3v1>;
        usb_mode = <1>;

        #phy-cells = <0>;
    };