Qualcomm UFS Controller Common Properties | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

qcom,ufs-common.yaml:1-67

Qualcomm UFS controller가 공유하는 clock, interconnect, PHY, power 및 reset 속성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 compatible, clock name, register, phandle, OPP, interrupt, 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/ufs/qcom,ufs-common.yaml#

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

7 title: Qualcomm Universal Flash Storage (UFS) Controller Common Properties

9 maintainers:

10 - Bjorn Andersson <[email protected]>

12 properties:

13 clocks:

14 minItems: 7

15 maxItems: 9

17 clock-names:

18 minItems: 7

19 maxItems: 9

21 dma-coherent: true

23 interconnects:

24 minItems: 2

25 maxItems: 2

27 interconnect-names:

28 items:

29 - const: ufs-ddr

30 - const: cpu-ufs

32 iommus:

33 minItems: 1

34 maxItems: 2

36 phys:

37 maxItems: 1

39 phy-names:

40 items:

41 - const: ufsphy

43 power-domains:

44 maxItems: 1

46 required-opps:

47 maxItems: 1

49 resets:

50 maxItems: 1

52 '#reset-cells':

53 const: 1

55 reset-names:

56 items:

57 - const: rst

59 reset-gpios:

60 maxItems: 1

61 description:

62 GPIO connected to the RESET pin of the UFS memory device.

64 allOf:

65 - $ref: ufs-common.yaml

67 additionalProperties: true

3. 한국어 전문 번역

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

Qualcomm UFS 공통 속성

1-11

GPL-2.0-only 또는 BSD-2-Clause 이중 라이선스의 이 스키마는 Qualcomm UFS controller가 공유하는 속성을 정의합니다. 관리자는 Bjorn Andersson입니다.

Clock, interconnect 및 IOMMU

12-35

`clocks`와 `clock-names`는 각각 7~9개입니다. `dma-coherent`를 사용할 수 있습니다. `interconnects`는 정확히 2개이고 이름은 `ufs-ddr`, `cpu-ufs` 순서입니다. `iommus`는 1~2개입니다.

properties:
  clocks:
    minItems: 7
    maxItems: 9

  clock-names:
    minItems: 7
    maxItems: 9

  dma-coherent: true

  interconnects:
    minItems: 2
    maxItems: 2

  interconnect-names:
    items:
      - const: ufs-ddr
      - const: cpu-ufs

  iommus:
    minItems: 1
    maxItems: 2

PHY, power domain, OPP 및 reset

36-63

`phys`는 최대 한 항목이고 `phy-names`는 `ufsphy`입니다. `power-domains`와 `required-opps`도 각각 최대 한 항목입니다. `resets`는 최대 한 항목이며 `#reset-cells`는 1, `reset-names`는 `rst`입니다. `reset-gpios`는 UFS memory device의 RESET pin에 연결된 GPIO로 최대 한 항목입니다.

phys:
  maxItems: 1

phy-names:
  items:
    - const: ufsphy

power-domains:
  maxItems: 1

required-opps:
  maxItems: 1

resets:
  maxItems: 1

'#reset-cells':
  const: 1

reset-names:
  items:
    - const: rst

reset-gpios:
  maxItems: 1
  description:
    GPIO connected to the RESET pin of the UFS memory device.

JEDEC 공통 속성 상속

64-67

기본 UFS 속성은 `ufs-common.yaml`에서 상속합니다. SoC별 Qualcomm 스키마가 추가 제약을 덧붙일 수 있도록 이 공통 스키마 자체는 추가 속성을 허용합니다.

allOf:
  - $ref: ufs-common.yaml

additionalProperties: true