요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/spmi/mtk,spmi-mtk-pmif.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Mediatek SPMI Controller
maintainers:
- Hsin-Hsiung Wang <hsin-hsiung.wang@mediatek.com>
description: |+
On MediaTek SoCs the PMIC is connected via SPMI and the controller allows
for multiple SoCs to control a single SPMI master.
allOf:
- $ref: spmi.yaml
properties:
compatible:
oneOf:
- enum:
- mediatek,mt6873-spmi
- mediatek,mt8195-spmi
- items:
- enum:
- mediatek,mt8186-spmi
- mediatek,mt8188-spmi
- const: mediatek,mt8195-spmi
reg:
maxItems: 2
reg-names:
items:
- const: pmif
- const: spmimst
clocks:
minItems: 3
maxItems: 3
clock-names:
items:
- const: pmif_sys_ck
- const: pmif_tmr_ck
- const: spmimst_clk_mux
assigned-clocks:
maxItems: 1
assigned-clock-parents:
maxItems: 1
required:
- compatible
- reg
- reg-names
- clocks
- clock-names
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/clock/mt8192-clk.h>
spmi: spmi@10027000 {
compatible = "mediatek,mt6873-spmi";
reg = <0x10027000 0xe00>,
<0x10029000 0x100>;
reg-names = "pmif", "spmimst";
clocks = <&infracfg CLK_INFRA_PMIC_AP>,
<&infracfg CLK_INFRA_PMIC_TMR>,
<&topckgen CLK_TOP_SPMI_MST_SEL>;
clock-names = "pmif_sys_ck",
"pmif_tmr_ck",
"spmimst_clk_mux";
assigned-clocks = <&topckgen CLK_TOP_PWRAP_ULPOSC_SEL>;
assigned-clock-parents = <&topckgen CLK_TOP_OSC_D10>;
};
...
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MediaTek SPMI PMIF controller
1-18이 GPL-2.0 또는 BSD-2-Clause YAML schema는 MediaTek SPMI controller를 정의합니다. MediaTek SoC에서 PMIC는 SPMI로 연결되고 controller는 여러 SoC가 단일 SPMI master를 제어할 수 있게 합니다. Maintainer는 Hsin-Hsiung Wang이며 공통 `spmi.yaml`을 상속합니다.
MT6873·MT8195와 fallback
19-30독립 compatible은 `mediatek,mt6873-spmi`, `mediatek,mt8195-spmi`입니다. `mediatek,mt8186-spmi`와 `mediatek,mt8188-spmi`는 각각 첫 compatible로 사용하고 `mediatek,mt8195-spmi`를 fallback으로 함께 지정합니다.
PMIF와 SPMI master register
31-38`reg`는 최대 두 항목이며 `reg-names`는 PMIC interface용 `pmif`, SPMI master용 `spmimst` 순서입니다.
세 clock과 assigned parent
39-54`clocks`는 정확히 세 항목이고 `clock-names`는 PMIF system clock `pmif_sys_ck`, PMIF timer clock `pmif_tmr_ck`, SPMI master clock mux `spmimst_clk_mux` 순서입니다.
`assigned-clocks`와 `assigned-clock-parents`는 각각 최대 한 항목입니다.
필수 속성과 추가 속성 제한
55-63필수 속성은 `compatible`, `reg`, `reg-names`, `clocks`, `clock-names`입니다. `unevaluatedProperties: false`로 평가되지 않은 추가 속성을 금지합니다.
MT6873 PMIF·SPMI master 예제
64-82예제의 `spmi@10027000`은 `mediatek,mt6873-spmi`, PMIF 영역 0x10027000과 SPMI master 영역 0x10029000을 사용합니다. 세 infrastructure·top clock을 연결하고 `CLK_TOP_PWRAP_ULPOSC_SEL`의 parent를 `CLK_TOP_OSC_D10`으로 지정합니다.
#include <dt-bindings/clock/mt8192-clk.h>
spmi: spmi@10027000 {
compatible = "mediatek,mt6873-spmi";
reg = <0x10027000 0xe00>,
<0x10029000 0x100>;
reg-names = "pmif", "spmimst";
clocks = <&infracfg CLK_INFRA_PMIC_AP>,
<&infracfg CLK_INFRA_PMIC_TMR>,
<&topckgen CLK_TOP_SPMI_MST_SEL>;
clock-names = "pmif_sys_ck",
"pmif_tmr_ck",
"spmimst_clk_mux";
assigned-clocks = <&topckgen CLK_TOP_PWRAP_ULPOSC_SEL>;
assigned-clock-parents = <&topckgen CLK_TOP_OSC_D10>;
};
...
요약과 해설
mtk,spmi-mtk-pmif.yaml:1-82MediaTek PMIF·SPMI master register와 세 clock 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·수치·예제 코드를 원형대로 유지합니다.