← Documents Documentation/devicetree/bindings/usb/pxa-usb.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

PXA USB Controllers

PXA OHCI power mode와 PXA270 UDC의 clock·D+ pull-up 연결을 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/pxa-usb.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

pxa-usb.txt:1-53

PXA OHCI power mode와 PXA270 UDC의 clock·D+ pull-up 연결을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, GPIO, regulator, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 PXA USB controllers
2
3 OHCI
4
5 Required properties:
6 - compatible: Should be "marvell,pxa-ohci" for USB controllers
7 used in host mode.
8
9 Optional properties:
10 - "marvell,enable-port1", "marvell,enable-port2", "marvell,enable-port3"
11 If present, enables the appropriate USB port of the controller.
12 - "marvell,port-mode" selects the mode of the ports:
13 1 = PMM_NPS_MODE
14 2 = PMM_GLOBAL_MODE
15 3 = PMM_PERPORT_MODE
16 - "marvell,power-sense-low" - power sense pin is low-active.
17 - "marvell,power-control-low" - power control pin is low-active.
18 - "marvell,no-oc-protection" - disable over-current protection.
19 - "marvell,oc-mode-perport" - enable per-port over-current protection.
20 - "marvell,power_on_delay" Power On to Power Good time - in ms.
21
22 Example:
23
24 usb0: ohci@4c000000 {
25 compatible = "marvell,pxa-ohci";
26 reg = <0x4c000000 0x100000>;
27 interrupts = <18>;
28 marvell,enable-port1;
29 marvell,port-mode = <2>; /* PMM_GLOBAL_MODE */
30 };
31
32 UDC
33
34 Required properties:
35 - compatible: Should be "marvell,pxa270-udc" for USB controllers
36 used in device mode.
37 - reg: usb device MMIO address space
38 - interrupts: single interrupt generated by the UDC IP
39 - clocks: input clock of the UDC IP (see clock-bindings.txt)
40
41 Optional properties:
42 - gpios:
43 - gpio activated to control the USB D+ pullup (see gpio.txt)
44
45 Example:
46
47 pxa27x_udc: udc@40600000 {
48 compatible = "marvell,pxa270-udc";
49 reg = <0x40600000 0x10000>;
50 interrupts = <11>;
51 clocks = <&pxa2xx_clks 11>;
52 gpios = <&gpio 22 GPIO_ACTIVE_LOW>;
53 };
54

3. 한국어 전문 번역

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

PXA USB controller

1-4

이 문서는 PXA SoC의 host-mode OHCI controller와 device-mode UDC binding을 설명합니다.

PXA OHCI port와 power control

5-21

host mode USB controller의 필수 `compatible`은 `marvell,pxa-ohci`입니다. 선택 `marvell,enable-port1`, `marvell,enable-port2`, `marvell,enable-port3`은 해당 port를 활성화합니다.

`marvell,port-mode` 1은 `PMM_NPS_MODE`, 2는 `PMM_GLOBAL_MODE`, 3은 `PMM_PERPORT_MODE`입니다. `marvell,power-sense-low`와 `marvell,power-control-low`는 각 pin이 active-low임을 나타냅니다.

`marvell,no-oc-protection`은 over-current 보호를 끄고 `marvell,oc-mode-perport`는 port별 보호를 켭니다. `marvell,power_on_delay`는 Power On에서 Power Good까지의 시간을 millisecond로 지정합니다.

Required properties:
 - compatible: Should be "marvell,pxa-ohci" for USB controllers
   used in host mode.

Optional properties:
 - "marvell,enable-port1", "marvell,enable-port2", "marvell,enable-port3"
   If present, enables the appropriate USB port of the controller.
 - "marvell,port-mode" selects the mode of the ports:
        1 = PMM_NPS_MODE
        2 = PMM_GLOBAL_MODE
        3 = PMM_PERPORT_MODE
 - "marvell,power-sense-low" - power sense pin is low-active.
 - "marvell,power-control-low" - power control pin is low-active.
 - "marvell,no-oc-protection" - disable over-current protection.
 - "marvell,oc-mode-perport" - enable per-port over-current protection.
 - "marvell,power_on_delay" Power On to Power Good time - in ms.

PXA OHCI global power 예제

22-31

예제 `ohci@4c000000`은 0x100000-byte 영역, interrupt 18, port 1 활성화와 `PMM_GLOBAL_MODE` 값 2를 사용합니다.

Example:

        usb0: ohci@4c000000 {
                compatible = "marvell,pxa-ohci";
                reg = <0x4c000000 0x100000>;
                interrupts = <18>;
                marvell,enable-port1;
                marvell,port-mode = <2>; /* PMM_GLOBAL_MODE */
        };

PXA270 device controller

32-44

device mode controller의 필수 `compatible`은 `marvell,pxa270-udc`입니다. `reg`는 USB device MMIO address space, `interrupts`는 UDC IP가 생성하는 interrupt 하나, `clocks`는 UDC input clock입니다.

선택 `gpios`는 USB D+ pull-up을 제어하기 위해 활성화되는 GPIO입니다.

UDC

Required properties:
 - compatible: Should be "marvell,pxa270-udc" for USB controllers
   used in device mode.
 - reg: usb device MMIO address space
 - interrupts: single interrupt generated by the UDC IP
 - clocks: input clock of the UDC IP (see clock-bindings.txt)

Optional properties:
 - gpios:
   - gpio activated to control the USB D+ pullup (see gpio.txt)

PXA27x UDC 예제

45-53

예제 `udc@40600000`은 0x10000-byte register 영역, interrupt 11, PXA2xx clock index 11과 GPIO 22 active-low D+ pull-up을 사용합니다.

Example:

                pxa27x_udc: udc@40600000 {
                        compatible = "marvell,pxa270-udc";
                        reg = <0x40600000 0x10000>;
                        interrupts = <11>;
                        clocks = <&pxa2xx_clks 11>;
                        gpios = <&gpio 22 GPIO_ACTIVE_LOW>;
                };