← Documents Documentation/devicetree/bindings/clock/keystone-gate.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Keystone PSC gate clock

PSC control/domain register와 domain ID를 사용하는 gate clock 바인딩입니다.

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

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

1. 요약·해설

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

요약과 해설

keystone-gate.txt:1-27

Parent clock과 PSC transition state로 USB gate output을 제어하는 예를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Binding for Keystone gate control driver which uses PSC controller IP.
2
3 This binding uses the common clock binding[1].
4
5 [1] Documentation/devicetree/bindings/clock/clock-bindings.txt
6
7 Required properties:
8 - compatible : shall be "ti,keystone,psc-clock".
9 - #clock-cells : from common clock binding; shall be set to 0.
10 - clocks : parent clock phandle
11 - reg : psc control and domain address address space
12 - reg-names : psc control and domain registers
13 - domain-id : psc domain id needed to check the transition state register
14
15 Optional properties:
16 - clock-output-names : From common clock binding to override the
17 default output clock name
18 Example:
19 clkusb: clkusb {
20 #clock-cells = <0>;
21 compatible = "ti,keystone,psc-clock";
22 clocks = <&chipclk16>;
23 clock-output-names = "usb";
24 reg = <0x02350008 0xb00>, <0x02350000 0x400>;
25 reg-names = "control", "domain";
26 domain-id = <0>;
27 };
28

3. 한국어 전문 번역

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

Keystone PSC gate clock 속성

1-17

PSC controller IP를 사용하는 Keystone gate control driver 바인딩

이 바인딩은 공통 clock 바인딩 `Documentation/devicetree/bindings/clock/clock-bindings.txt`를 사용합니다.

필수 `compatible`은 `ti,keystone,psc-clock`, `#clock-cells`는 0입니다. `clocks`에는 parent clock phandle을 지정합니다.

`reg`에는 PSC control 및 domain 주소 공간을 지정하고 `reg-names`는 해당 영역을 `control`, `domain` register로 식별합니다. `domain-id`는 transition state register를 확인할 때 필요한 PSC domain ID입니다.

선택적 `clock-output-names`는 공통 clock 바인딩을 따라 기본 output clock 이름을 덮어씁니다.

Keystone PSC gate clock
Parent clockclocks phandle
PSC control registersGate control
PSC domain registersTransition state 확인
domain-id대상 domain 선택
0-cell output이름이 지정된 gate clock

Parent clock과 PSC domain 상태를 사용해 gate output을 제공하는 흐름입니다.

USB PSC gate clock 예

18-27

예제는 `chipclk16`을 parent로 사용하고 PSC control/domain register와 domain 0을 통해 `usb` output clock을 제공합니다.

clkusb: clkusb {
        #clock-cells = <0>;
        compatible = "ti,keystone,psc-clock";
        clocks = <&chipclk16>;
        clock-output-names = "usb";
        reg = <0x02350008 0xb00>, <0x02350000 0x400>;
        reg-names = "control", "domain";
        domain-id = <0>;
};