← Documents Documentation/devicetree/bindings/clock/armada3700-xtal-clock.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Armada 3700 xtal clock

GPIO latch register로 Armada 37xx crystal frequency를 결정하는 clock provider입니다.

Source pathDocumentation/devicetree/bindings/clock/armada3700-xtal-clock.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

armada3700-xtal-clock.txt:1-29

GPIO/syscon parent 아래 0-cell xtal clock을 배치하는 방법을 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 * Xtal Clock bindings for Marvell Armada 37xx SoCs
2
3 Marvell Armada 37xx SoCs allow to determine the xtal clock frequencies by
4 reading the gpio latch register.
5
6 This node must be a subnode of the node exposing the register address
7 of the GPIO block where the gpio latch is located.
8 See Documentation/devicetree/bindings/pinctrl/marvell,armada-37xx-pinctrl.txt
9
10 Required properties:
11 - compatible : shall be one of the following:
12 "marvell,armada-3700-xtal-clock"
13 - #clock-cells : from common clock binding; shall be set to 0
14
15 Optional properties:
16 - clock-output-names : from common clock binding; allows overwrite default clock
17 output names ("xtal")
18
19 Example:
20 pinctrl_nb: pinctrl-nb@13800 {
21 compatible = "armada3710-nb-pinctrl", "syscon", "simple-mfd";
22 reg = <0x13800 0x100>, <0x13C00 0x20>;
23
24 xtalclk: xtal-clk {
25 compatible = "marvell,armada-3700-xtal-clock";
26 clock-output-names = "xtal";
27 #clock-cells = <0>;
28 };
29 };
30

3. 한국어 전문 번역

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

Armada 37xx xtal clock 속성

1-18

Marvell Armada 37xx SoC용 Xtal Clock 바인딩

Marvell Armada 37xx SoC는 GPIO latch register를 읽어 xtal clock 주파수를 결정할 수 있습니다.

이 노드는 GPIO latch가 있는 GPIO block의 register 주소를 노출하는 노드의 subnode여야 합니다. 자세한 내용은 `Documentation/devicetree/bindings/pinctrl/marvell,armada-37xx-pinctrl.txt`를 참조합니다.

필수 `compatible`은 `marvell,armada-3700-xtal-clock`입니다. 공통 clock 바인딩의 `#clock-cells`는 0으로 설정해야 합니다.

선택적 `clock-output-names`는 공통 clock 바인딩을 따르며 기본 output 이름 `xtal`을 덮어쓸 수 있습니다.

Armada 37xx xtal 주파수 결정
GPIO/syscon parentLatch register 주소 노출
xtal-clk childLatch 값 판독
Frequency selectionArmada 37xx xtal 주파수 결정
Clock consumer0-cell clock provider 참조

GPIO latch register가 clock provider의 주파수를 결정하는 관계입니다.

North bridge pinctrl 아래 xtal clock 예

19-29

예제는 north bridge pinctrl/syscon 노드 아래 기본 output 이름 `xtal`을 제공하는 0-cell clock 노드를 배치합니다.

pinctrl_nb: pinctrl-nb@13800 {
        compatible = "armada3710-nb-pinctrl", "syscon", "simple-mfd";
        reg = <0x13800 0x100>, <0x13C00 0x20>;

        xtalclk: xtal-clk {
                compatible = "marvell,armada-3700-xtal-clock";
                clock-output-names = "xtal";
                #clock-cells = <0>;
        };
};