요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Binding for the HSDK Generic PLL clock
3
This binding uses the common clock binding[1].
5
[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
7
Required properties:
8
- compatible: should be "snps,hsdk-<name>-pll-clock"
9
"snps,hsdk-core-pll-clock"
10
"snps,hsdk-gp-pll-clock"
11
"snps,hsdk-hdmi-pll-clock"
12
- reg : should contain base register location and length.
13
- clocks: shall be the input parent clock phandle for the PLL.
14
- #clock-cells: from common clock binding; Should always be set to 0.
16
Example:
17
input_clk: input-clk {
18
clock-frequency = <33333333>;
19
compatible = "fixed-clock";
20
#clock-cells = <0>;
21
};
23
cpu_clk: cpu-clk@0 {
24
compatible = "snps,hsdk-core-pll-clock";
25
reg = <0x00 0x10>;
26
#clock-cells = <0>;
27
clocks = <&input_clk>;
28
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
HSDK Generic PLL 속성
1-15HSDK Generic PLL clock 바인딩
이 바인딩은 공통 clock 바인딩 `Documentation/devicetree/bindings/clock/clock-bindings.txt`를 사용합니다.
필수 `compatible` 형식은 `snps,hsdk-<name>-pll-clock`이며 정의된 값은 `snps,hsdk-core-pll-clock`, `snps,hsdk-gp-pll-clock`, `snps,hsdk-hdmi-pll-clock`입니다.
`reg`에는 base register 위치와 길이, `clocks`에는 PLL input parent clock phandle을 지정합니다. `#clock-cells`는 항상 0입니다.
Fixed input→33.333333 MHz
PLL register→Core/GP/HDMI PLL
0-cell provider→단일 PLL output
Clock consumer→PLL output 참조
Fixed input clock이 선택한 HSDK PLL output을 만드는 흐름입니다.
HSDK core PLL 예
16-28예제는 33.333333 MHz fixed input을 0x00의 core PLL에 연결합니다.
input_clk: input-clk {
clock-frequency = <33333333>;
compatible = "fixed-clock";
#clock-cells = <0>;
};
cpu_clk: cpu-clk@0 {
compatible = "snps,hsdk-core-pll-clock";
reg = <0x00 0x10>;
#clock-cells = <0>;
clocks = <&input_clk>;
};
요약과 해설
snps,hsdk-pll-clock.txt:1-28Fixed input과 단일 PLL register 영역의 연결을 설명합니다.