TI ADPLL clock | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

adpll.txt:1-39

두 ADPLL type의 parent 및 output 수 차이를 설명합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 Binding for Texas Instruments ADPLL clock.

3 This binding uses the common clock binding[1]. It assumes a

4 register-mapped ADPLL with two to three selectable input clocks

5 and three to four children.

7 [1] Documentation/devicetree/bindings/clock/clock-bindings.txt

9 Required properties:

10 - compatible : shall be one of "ti,dm814-adpll-s-clock" or

11 "ti,dm814-adpll-lj-clock" depending on the type of the ADPLL

12 - #clock-cells : from common clock binding; shall be set to 1.

13 - clocks : link phandles of parent clocks clkinp and clkinpulow, note

14 that the adpll-s-clock also has an optional clkinphif

15 - reg : address and length of the register set for controlling the ADPLL.

17 Examples:

18 adpll_mpu_ck: adpll@40 {

19 #clock-cells = <1>;

20 compatible = "ti,dm814-adpll-s-clock";

21 reg = <0x40 0x40>;

22 clocks = <&devosc_ck &devosc_ck &devosc_ck>;

23 clock-names = "clkinp", "clkinpulow", "clkinphif";

24 clock-output-names = "481c5040.adpll.dcoclkldo",

25 "481c5040.adpll.clkout",

26 "481c5040.adpll.clkoutx2",

27 "481c5040.adpll.clkouthif";

28 };

30 adpll_dsp_ck: adpll@80 {

31 #clock-cells = <1>;

32 compatible = "ti,dm814-adpll-lj-clock";

33 reg = <0x80 0x30>;

34 clocks = <&devosc_ck &devosc_ck>;

35 clock-names = "clkinp", "clkinpulow";

36 clock-output-names = "481c5080.adpll.dcoclkldo",

37 "481c5080.adpll.clkout",

38 "481c5080.adpll.clkoutldo";

39 };

3. 한국어 전문 번역

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

TI ADPLL 입력과 출력

1-16

Texas Instruments ADPLL clock 바인딩입니다. Register-mapped ADPLL이 두 개 또는 세 개의 선택 가능한 input clock과 세 개 또는 네 개의 child output을 가진다고 가정하며 공통 clock 바인딩을 사용합니다.

`compatible`은 ADPLL 종류에 따라 `ti,dm814-adpll-s-clock` 또는 `ti,dm814-adpll-lj-clock`입니다. 여러 child output을 index로 제공하므로 `#clock-cells`는 1이고, `reg`에는 ADPLL control register set의 address와 length를 넣습니다.

`clocks`에는 `clkinp`와 `clkinpulow` parent phandle을 연결합니다. `adpll-s-clock`은 선택적으로 `clkinphif` input도 가집니다.

DM814 ADPLL variants

compatibleInputsExample outputs

ti,dm814-adpll-s-clockclkinp, clkinpulow, optional clkinphif4

ti,dm814-adpll-lj-clockclkinp, clkinpulow3

두 ADPLL type의 input 및 output 수 차이를 정리합니다.

ADPLL-S와 ADPLL-LJ 예제

17-39

`adpll_mpu_ck` 예제는 세 input 이름과 `dcoclkldo`, `clkout`, `clkoutx2`, `clkouthif`의 네 output을 제공합니다. `adpll_dsp_ck` 예제는 두 input과 `dcoclkldo`, `clkout`, `clkoutldo`의 세 output을 제공합니다.

adpll_mpu_ck: adpll@40 {
        #clock-cells = <1>;
        compatible = "ti,dm814-adpll-s-clock";
        reg = <0x40 0x40>;
        clocks = <&devosc_ck &devosc_ck &devosc_ck>;
        clock-names = "clkinp", "clkinpulow", "clkinphif";
        clock-output-names = "481c5040.adpll.dcoclkldo",
                             "481c5040.adpll.clkout",
                             "481c5040.adpll.clkoutx2",
                             "481c5040.adpll.clkouthif";
};

adpll_dsp_ck: adpll@80 {
        #clock-cells = <1>;
        compatible = "ti,dm814-adpll-lj-clock";
        reg = <0x80 0x30>;
        clocks = <&devosc_ck &devosc_ck>;
        clock-names = "clkinp", "clkinpulow";
        clock-output-names = "481c5080.adpll.dcoclkldo",
                             "481c5080.adpll.clkout",
                             "481c5080.adpll.clkoutldo";
};