요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Binding for Texas Instruments clockdomain.
This binding uses the common clock binding[1] in consumer role.
Every clock on TI SoC belongs to one clockdomain, but software
only needs this information for specific clocks which require
their parent clockdomain to be controlled when the clock is
enabled/disabled. This binding doesn't define a new clock
binding type, it is used to group existing clock nodes under
hardware hierarchy.
[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
Required properties:
- compatible : shall be "ti,clockdomain"
- #clock-cells : from common clock binding; shall be set to 0.
- clocks : link phandles of clocks within this domain
Optional properties:
- clock-output-names : from common clock binding.
Examples:
dss_clkdm: dss_clkdm {
compatible = "ti,clockdomain";
clocks = <&dss1_alwon_fck_3430es2>, <&dss_ick_3430es2>;
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
TI clockdomain hierarchy
1-20Texas Instruments clockdomain 바인딩입니다. 공통 clock 바인딩을 consumer 역할로 사용합니다. TI SoC의 모든 clock은 하나의 clockdomain에 속하지만, software가 clock enable 또는 disable 시 parent clockdomain까지 제어해야 하는 특정 clock에만 이 정보가 필요합니다.
새로운 clock provider type을 정의하는 바인딩이 아니라 기존 clock node를 hardware hierarchy에 맞게 묶습니다. `compatible`은 `ti,clockdomain`, `#clock-cells`는 0이며 `clocks`에는 domain 내부 clock들의 phandle을 연결합니다. 선택적으로 `clock-output-names`를 사용할 수 있습니다.
기존 clock들을 domain 아래 묶어 enable/disable 시 parent hardware domain 제어를 연결합니다.
DSS clockdomain 예제
21-25예제 `dss_clkdm`은 `dss1_alwon_fck_3430es2`와 `dss_ick_3430es2` 두 clock을 하나의 display subsystem clockdomain에 묶습니다.
dss_clkdm: dss_clkdm {
compatible = "ti,clockdomain";
clocks = <&dss1_alwon_fck_3430es2>, <&dss_ick_3430es2>;
};
요약과 해설
clockdomain.txt:1-25Clock enable/disable 시 필요한 parent domain 제어 관계를 설명합니다.