Documentation/devicetree/bindings/ufs/qcom,ufs-common.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / UFS

Qualcomm UFS Controller Common Properties

Qualcomm UFS controller가 공유하는 clock, interconnect, PHY, power 및 reset 속성을 설명합니다.

Source pathDocumentation/devicetree/bindings/ufs/qcom,ufs-common.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

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#
6
7 title: Qualcomm Universal Flash Storage (UFS) Controller Common Properties
8
9 maintainers:
10 - Bjorn Andersson <[email protected]>
11
12 properties:
13 clocks:
14 minItems: 7
15 maxItems: 9
16
17 clock-names:
18 minItems: 7
19 maxItems: 9
20
21 dma-coherent: true
22
23 interconnects:
24 minItems: 2
25 maxItems: 2
26
27 interconnect-names:
28 items:
29 - const: ufs-ddr
30 - const: cpu-ufs
31
32 iommus:
33 minItems: 1
34 maxItems: 2
35
36 phys:
37 maxItems: 1
38
39 phy-names:
40 items:
41 - const: ufsphy
42
43 power-domains:
44 maxItems: 1
45
46 required-opps:
47 maxItems: 1
48
49 resets:
50 maxItems: 1
51
52 '#reset-cells':
53 const: 1
54
55 reset-names:
56 items:
57 - const: rst
58
59 reset-gpios:
60 maxItems: 1
61 description:
62 GPIO connected to the RESET pin of the UFS memory device.
63
64 allOf:
65 - $ref: ufs-common.yaml
66
67 additionalProperties: true
68

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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