Freescale i.MX USBMISC Wrapper | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

fsl,usbmisc.yaml:1-92

i.MX ChipIdea USB2 wrapper의 SoC별 fallback, register 구성과 i.MX95 조건을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, 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/fsl,usbmisc.yaml#

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

7 title: Freescale i.MX wrapper module for Chipidea USB2 controller

9 maintainers:

10 - Xu Yang <xu.yang_2@nxp.com>

11 - Peng Fan <peng.fan@nxp.com>

13 properties:

14 compatible:

15 oneOf:

16 - enum:

17 - fsl,imx25-usbmisc

18 - fsl,imx27-usbmisc

19 - fsl,imx35-usbmisc

20 - fsl,imx51-usbmisc

21 - fsl,imx53-usbmisc

22 - fsl,imx6q-usbmisc

23 - fsl,vf610-usbmisc

24 - nxp,s32g2-usbmisc

25 - nxp,s32g3-usbmisc

26 - items:

27 - enum:

28 - fsl,imx6ul-usbmisc

29 - fsl,imx6sl-usbmisc

30 - fsl,imx6sx-usbmisc

31 - fsl,imx7d-usbmisc

32 - const: fsl,imx6q-usbmisc

33 - items:

34 - enum:

35 - fsl,imx7ulp-usbmisc

36 - fsl,imx8mm-usbmisc

37 - fsl,imx8mn-usbmisc

38 - fsl,imx8ulp-usbmisc

39 - fsl,imx95-usbmisc

40 - const: fsl,imx7d-usbmisc

41 - const: fsl,imx6q-usbmisc

42 - items:

43 - const: fsl,imx6sll-usbmisc

44 - const: fsl,imx6ul-usbmisc

45 - const: fsl,imx6q-usbmisc

47 clocks:

48 maxItems: 1

50 reg:

51 minItems: 1

52 items:

53 - description: Base and length of the Wrapper module register

54 - description: Base and length of the HSIO Block Control register

56 '#index-cells':

57 const: 1

58 description: Cells used to describe usb controller index.

59 deprecated: true

61 required:

62 - compatible

63 - reg

65 allOf:

66 # imx95 soc needs use HSIO Block Control

67 - if:

68 properties:

69 compatible:

70 contains:

71 enum:

72 - fsl,imx95-usbmisc

73 then:

74 properties:

75 reg:

76 minItems: 2

77 else:

78 properties:

79 reg:

80 maxItems: 1

82 additionalProperties: false

84 examples:

85 - |

86 usbmisc@2184800 {

87 compatible = "fsl,imx6q-usbmisc";

88 reg = <0x02184800 0x200>;

89 #index-cells = <1>;

90 };

92 ...

3. 한국어 전문 번역

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

i.MX ChipIdea USB2 wrapper

1-12

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 ChipIdea USB2 controller용 Freescale i.MX wrapper module을 정의합니다. 관리자는 Xu Yang과 Peng Fan입니다.

SoC별 compatible과 fallback

13-46

단독 compatible에는 i.MX25·27·35·51·53·6Q, VF610, NXP S32G2·S32G3 USBMISC가 포함됩니다.

i.MX6UL·6SL·6SX·7D는 `fsl,imx6q-usbmisc` fallback을 사용합니다. i.MX7ULP·8MM·8MN·8ULP·95는 `fsl,imx7d-usbmisc`, `fsl,imx6q-usbmisc` 순서의 두 단계 fallback을 사용합니다.

i.MX6SLL은 `fsl,imx6ul-usbmisc`, `fsl,imx6q-usbmisc` 순서의 fallback을 사용합니다.

properties:
  compatible:
    oneOf:
      - enum:
          - fsl,imx25-usbmisc
          - fsl,imx27-usbmisc
          - fsl,imx35-usbmisc
          - fsl,imx51-usbmisc
          - fsl,imx53-usbmisc
          - fsl,imx6q-usbmisc
          - fsl,vf610-usbmisc
          - nxp,s32g2-usbmisc
          - nxp,s32g3-usbmisc
      - items:
          - enum:
              - fsl,imx6ul-usbmisc
              - fsl,imx6sl-usbmisc
              - fsl,imx6sx-usbmisc
              - fsl,imx7d-usbmisc
          - const: fsl,imx6q-usbmisc
      - items:
          - enum:
              - fsl,imx7ulp-usbmisc
              - fsl,imx8mm-usbmisc
              - fsl,imx8mn-usbmisc
              - fsl,imx8ulp-usbmisc
              - fsl,imx95-usbmisc
          - const: fsl,imx7d-usbmisc
          - const: fsl,imx6q-usbmisc
      - items:
          - const: fsl,imx6sll-usbmisc
          - const: fsl,imx6ul-usbmisc
          - const: fsl,imx6q-usbmisc

Clock, register와 폐기된 index cell

47-60

clock은 최대 하나입니다. 첫 `reg` 항목은 wrapper module register의 base와 length이고, 둘째 항목은 HSIO Block Control register의 base와 length입니다.

USB controller index를 기술하던 `#index-cells`는 값 1이지만 현재는 deprecated입니다.

clocks:
  maxItems: 1

reg:
  minItems: 1
  items:
    - description: Base and length of the Wrapper module register
    - description: Base and length of the HSIO Block Control register

'#index-cells':
  const: 1
  description: Cells used to describe usb controller index.
  deprecated: true

필수 속성과 i.MX95 register 조건

61-83

필수 속성은 `compatible`과 `reg`입니다. i.MX95 SoC는 HSIO Block Control을 사용하므로 `fsl,imx95-usbmisc` compatible이면 register 영역이 최소 두 개여야 합니다. 그 밖의 SoC는 register 영역을 최대 하나만 허용합니다.

정의되지 않은 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - reg

allOf:
  # imx95 soc needs use HSIO Block Control
  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,imx95-usbmisc
    then:
      properties:
        reg:
          minItems: 2
    else:
      properties:
        reg:
          maxItems: 1

additionalProperties: false

i.MX6Q USBMISC 예제

84-92

예제 `usbmisc@2184800`은 `fsl,imx6q-usbmisc`, 0x200-byte register 영역과 deprecated `#index-cells = 1`을 사용합니다.

examples:
  - |
    usbmisc@2184800 {
        compatible = "fsl,imx6q-usbmisc";
        reg = <0x02184800 0x200>;
        #index-cells = <1>;
    };

...