ST USB OHCI Controller

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

1. 요약·해설

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

요약과 해설

ohci-st.txt:1-36

ST OHCI의 interconnect·48 MHz clock, PHY와 두 reset을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, power, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ST USB OHCI controller

3 Required properties:

5 - compatible : must be "st,st-ohci-300x"

6 - reg : physical base addresses of the controller and length of memory mapped

7 region

8 - interrupts : one OHCI controller interrupt should be described here

9 - clocks : phandle list of usb clocks

10 - clock-names : should be "ic" for interconnect clock and "clk48"

11 See: Documentation/devicetree/bindings/clock/clock-bindings.txt

13 - phys : phandle for the PHY device

14 - phy-names : should be "usb"

16 - resets : phandle to the powerdown and reset controller for the USB IP

17 - reset-names : should be "power" and "softreset".

18 See: Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml

19 See: Documentation/devicetree/bindings/reset/reset.txt

21 Example:

23 ohci0: usb@fe1ffc00 {

24 compatible = "st,st-ohci-300x";

25 reg = <0xfe1ffc00 0x100>;

26 interrupts = <GIC_SPI 149 IRQ_TYPE_NONE>;

27 clocks = <&clk_s_a1_ls 0>,

28 <&clockgen_b0 0>;

29 clock-names = "ic", "clk48";

30 phys = <&usb2_phy>;

31 phy-names = "usb";

33 resets = <&powerdown STIH416_USB0_POWERDOWN>,

34 <&softreset STIH416_USB0_SOFTRESET>;

35 reset-names = "power", "softreset";

36 };

3. 한국어 전문 번역

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

1-2

이 문서는 STMicroelectronics USB OHCI controller의 clock, PHY, powerdown 및 reset 연결을 정의합니다.

Clock, PHY와 두 reset

3-20

필수 `compatible`은 `st,st-ohci-300x`입니다. `reg`는 controller physical base와 memory-mapped region 길이, `interrupts`는 OHCI controller interrupt 하나입니다.

`clocks`는 USB clock phandle 목록이며 `clock-names`는 interconnect용 `ic`와 48 MHz용 `clk48`입니다. `phys`는 PHY phandle이고 `phy-names`는 `usb`입니다.

`resets`는 USB IP의 powerdown·reset controller phandle이고 `reset-names`는 `power`, `softreset`입니다. 관련 clock 및 reset binding source path도 원문대로 보존합니다.

Required properties:

 - compatible                : must be "st,st-ohci-300x"
 - reg                        : physical base addresses of the controller and length of memory mapped
                          region
 - interrupts                : one OHCI controller interrupt should be described here
 - clocks                : phandle list of usb clocks
 - clock-names                : should be "ic" for interconnect clock and "clk48"
See: Documentation/devicetree/bindings/clock/clock-bindings.txt

 - phys                        : phandle for the PHY device
 - phy-names                : should be "usb"

 - resets                : phandle to the powerdown and reset controller for the USB IP
 - reset-names                : should be "power" and "softreset".
See: Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml
See: Documentation/devicetree/bindings/reset/reset.txt

STiH416 OHCI 예제

21-36

예제 `usb@fe1ffc00`은 0x100-byte register 영역, GIC SPI 149, `clk_s_a1_ls`와 `clockgen_b0` clock, USB2 PHY를 사용합니다. reset은 USB0 powerdown과 softreset 순서입니다.

Example:

        ohci0: usb@fe1ffc00 {
                compatible = "st,st-ohci-300x";
                reg = <0xfe1ffc00 0x100>;
                interrupts = <GIC_SPI 149 IRQ_TYPE_NONE>;
                clocks = <&clk_s_a1_ls 0>,
                         <&clockgen_b0 0>;
                clock-names = "ic", "clk48";
                phys = <&usb2_phy>;
                phy-names = "usb";

                resets = <&powerdown STIH416_USB0_POWERDOWN>,
                         <&softreset STIH416_USB0_SOFTRESET>;
                reset-names = "power", "softreset";
        };