요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Binding for the AXS10X Generic PLL clock
This binding uses the common clock binding[1].
[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
Required properties:
- compatible: should be "snps,axs10x-<name>-pll-clock"
"snps,axs10x-arc-pll-clock"
"snps,axs10x-pgu-pll-clock"
- reg: should always contain 2 pairs address - length: first for PLL config
registers and second for corresponding LOCK CGU register.
- clocks: shall be the input parent clock phandle for the PLL.
- #clock-cells: from common clock binding; Should always be set to 0.
Example:
input-clk: input-clk {
clock-frequency = <33333333>;
compatible = "fixed-clock";
#clock-cells = <0>;
};
core-clk: core-clk@80 {
compatible = "snps,axs10x-arc-pll-clock";
reg = <0x80 0x10>, <0x100 0x10>;
#clock-cells = <0>;
clocks = <&input-clk>;
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
AXS10X Generic PLL 속성
1-15AXS10X Generic PLL clock 바인딩
이 바인딩은 공통 clock 바인딩 `Documentation/devicetree/bindings/clock/clock-bindings.txt`를 사용합니다.
필수 `compatible` 형식은 `snps,axs10x-<name>-pll-clock`이며 정의된 값은 `snps,axs10x-arc-pll-clock`, `snps,axs10x-pgu-pll-clock`입니다.
`reg`에는 항상 address-length pair 두 개가 있어야 합니다. 첫 번째는 PLL configuration register, 두 번째는 해당 LOCK CGU register입니다.
`clocks`에는 PLL input parent clock phandle을 지정하고 `#clock-cells`는 항상 0입니다.
두 register 영역과 fixed input clock으로 PLL output을 만듭니다.
AXS10X ARC PLL 예
16-28예제는 33.333333 MHz input과 0x80 PLL configuration, 0x100 LOCK CGU register를 사용하는 ARC PLL을 기술합니다.
input-clk: input-clk {
clock-frequency = <33333333>;
compatible = "fixed-clock";
#clock-cells = <0>;
};
core-clk: core-clk@80 {
compatible = "snps,axs10x-arc-pll-clock";
reg = <0x80 0x10>, <0x100 0x10>;
#clock-cells = <0>;
clocks = <&input-clk>;
};
요약과 해설
snps,pll-clock.txt:1-28두 register pair와 fixed input을 사용하는 0-cell PLL provider를 설명합니다.