Documentation/devicetree/bindings/usb/nxp,isp1760.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

NXP ISP1760 Family Controller

ISP1760 계열의 host·peripheral interrupt, bus width와 DRD mode를 설명합니다.

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

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

nxp,isp1760.yaml:1-67

ISP1760 계열의 host·peripheral interrupt, bus width와 DRD mode를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, power, 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/nxp,isp1760.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: NXP ISP1760 family controller
8
9 maintainers:
10 - Sebastian Siewior <[email protected]>
11 - Laurent Pinchart <[email protected]>
12
13 description: |
14 NXP ISP1760 family, which includes ISP1760/1761/1763 devicetree controller
15 bindings
16
17 properties:
18 compatible:
19 enum:
20 - nxp,usb-isp1760
21 - nxp,usb-isp1761
22 - nxp,usb-isp1763
23 reg:
24 maxItems: 1
25
26 interrupts:
27 minItems: 1
28 items:
29 - description: Host controller interrupt
30 - description: Device controller interrupt in isp1761
31
32 interrupt-names:
33 minItems: 1
34 items:
35 - const: host
36 - const: peripheral
37
38 bus-width:
39 description:
40 Number of data lines.
41 enum: [8, 16, 32]
42 default: 32
43
44 dr_mode:
45 enum:
46 - host
47 - peripheral
48
49 required:
50 - compatible
51 - reg
52 - interrupts
53
54 additionalProperties: false
55
56 examples:
57 - |
58 #include <dt-bindings/interrupt-controller/arm-gic.h>
59 usb@40200000 {
60 compatible = "nxp,usb-isp1763";
61 reg = <0x40200000 0x100000>;
62 interrupts = <GIC_SPI 114 IRQ_TYPE_LEVEL_HIGH>;
63 bus-width = <16>;
64 dr_mode = "host";
65 };
66
67 ...
68

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

NXP ISP1760 controller family

1-16

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 NXP ISP1760, ISP1761, ISP1763 controller 계열을 정의합니다. 관리자는 Sebastian Siewior와 Laurent Pinchart입니다.

Interrupt, bus width와 DRD mode

17-48

허용 compatible은 `nxp,usb-isp1760`, `nxp,usb-isp1761`, `nxp,usb-isp1763`이고 register는 하나입니다.

host controller interrupt가 필수이며 ISP1761에서는 device controller interrupt를 둘째로 둘 수 있습니다. 이름은 `host`, `peripheral` 순서입니다.

data bus width는 8, 16, 32 bit 중 하나이고 기본값은 32 bit입니다. `dr_mode`는 `host` 또는 `peripheral`입니다.

properties:
  compatible:
    enum:
      - nxp,usb-isp1760
      - nxp,usb-isp1761
      - nxp,usb-isp1763
  reg:
    maxItems: 1

  interrupts:
    minItems: 1
    items:
      - description: Host controller interrupt
      - description: Device controller interrupt in isp1761

  interrupt-names:
    minItems: 1
    items:
      - const: host
      - const: peripheral

  bus-width:
    description:
      Number of data lines.
    enum: [8, 16, 32]
    default: 32

  dr_mode:
    enum:
      - host
      - peripheral

필수 속성

49-55

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

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

ISP1763 16-bit host 예제

56-67

예제 `usb@40200000`은 ISP1763, 0x100000-byte register 영역, level-high GIC SPI 114, 16-bit bus와 host mode를 사용합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    usb@40200000 {
        compatible = "nxp,usb-isp1763";
        reg = <0x40200000 0x100000>;
        interrupts = <GIC_SPI 114 IRQ_TYPE_LEVEL_HIGH>;
        bus-width = <16>;
        dr_mode = "host";
    };

...