ST USB EHCI Controller

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

1. 요약·해설

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

요약과 해설

ehci-st.txt:1-38

ST EHCI controller의 register·interrupt·clock·PHY·reset 요구 사항과 STiH416 예제를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, PHY, connector, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ST USB EHCI controller

3 Required properties:

4 - compatible : must be "st,st-ehci-300x"

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

6 region

7 - interrupts : one EHCI interrupt should be described here

8 - pinctrl-names : a pinctrl state named "default" must be defined

9 - pinctrl-0 : phandle referencing pin configuration of the USB controller

10 See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

11 - clocks : phandle list of usb clocks

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

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

15 - phys : phandle for the PHY device

16 - phy-names : should be "usb"

17 - resets : phandle + reset specifier pairs to the powerdown and softreset lines

18 of the USB IP

19 - reset-names : should be "power" and "softreset"

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

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

23 Example:

25 ehci1: usb@fe203e00 {

26 compatible = "st,st-ehci-300x";

27 reg = <0xfe203e00 0x100>;

28 interrupts = <GIC_SPI 148 IRQ_TYPE_NONE>;

29 pinctrl-names = "default";

30 pinctrl-0 = <&pinctrl_usb1>;

31 clocks = <&clk_s_a1_ls 0>;

32 phys = <&usb2_phy>;

33 phy-names = "usb";

35 resets = <&powerdown STIH416_USB1_POWERDOWN>,

36 <&softreset STIH416_USB1_SOFTRESET>;

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

38 };

3. 한국어 전문 번역

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

1-2

이 binding은 ST USB EHCI controller를 설명합니다.

필수 register, clock, PHY와 reset

3-22

`compatible`은 `st,st-ehci-300x`이어야 합니다. `reg`에는 controller의 physical base address와 memory-mapped 영역 길이를 넣고, `interrupts`에는 EHCI interrupt 하나를 기술합니다.

`pinctrl-names`에는 `default` state가 필요하고 `pinctrl-0`은 USB controller pin configuration을 참조하는 phandle입니다. 자세한 정의는 `Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt`를 따릅니다.

`clocks`는 USB clock phandle 목록이며 이름은 interconnect clock용 `ic`와 `clk48`입니다. clock binding은 `Documentation/devicetree/bindings/clock/clock-bindings.txt`를 참조합니다.

`phys`는 PHY device phandle이고 이름은 `usb`입니다. `resets`에는 USB IP의 powerdown·softreset line을 가리키는 phandle와 reset specifier 쌍을 넣고 이름은 `power`, `softreset`입니다. 관련 reset binding 두 경로도 원문 그대로 보존합니다.

Required properties:
 - compatible                : must be "st,st-ehci-300x"
 - reg                        : physical base addresses of the controller and length of memory mapped
                          region
 - interrupts                : one EHCI interrupt should be described here
 - pinctrl-names        : a pinctrl state named "default" must be defined
 - pinctrl-0                : phandle referencing pin configuration of the USB controller
See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt
 - 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 + reset specifier pairs to the powerdown and softreset lines
                          of 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 EHCI 예제

23-38

예제 `usb@fe203e00`은 0x100-byte register 영역, GIC SPI 148, default USB1 pinctrl, `clk_s_a1_ls`, USB2 PHY를 사용합니다. powerdown과 softreset은 각각 `STIH416_USB1_POWERDOWN`, `STIH416_USB1_SOFTRESET` specifier로 지정합니다.

Example:

        ehci1: usb@fe203e00 {
                compatible = "st,st-ehci-300x";
                reg = <0xfe203e00 0x100>;
                interrupts = <GIC_SPI 148 IRQ_TYPE_NONE>;
                pinctrl-names = "default";
                pinctrl-0 = <&pinctrl_usb1>;
                clocks = <&clk_s_a1_ls 0>;
                phys = <&usb2_phy>;
                phy-names = "usb";

                resets = <&powerdown STIH416_USB1_POWERDOWN>,
                         <&softreset STIH416_USB1_SOFTRESET>;
                reset-names = "power", "softreset";
        };