요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
*Imagination Technologies PWM DAC driver
3
Required properties:
4
- compatible: Should be "img,pistachio-pwm"
5
- reg: Should contain physical base address and length of pwm registers.
6
- clocks: Must contain an entry for each entry in clock-names.
7
See ../clock/clock-bindings.txt for details.
8
- clock-names: Must include the following entries.
9
- pwm: PWM operating clock.
10
- sys: PWM system interface clock.
11
- #pwm-cells: Should be 2. See pwm.yaml in this directory for the
12
description of the cells format.
13
- img,cr-periph: Must contain a phandle to the peripheral control
14
syscon node which contains PWM control registers.
16
Example:
17
pwm: pwm@18101300 {
18
compatible = "img,pistachio-pwm";
19
reg = <0x18101300 0x100>;
20
clocks = <&pwm_clk>, <&system_clk>;
21
clock-names = "pwm", "sys";
22
#pwm-cells = <2>;
23
img,cr-periph = <&cr_periph>;
24
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
필수·선택 property
1-15Imagination Technologies PWM DAC의 필수 `compatible`은 `img,pistachio-pwm`입니다. `reg`는 PWM register 범위입니다. `clocks`는 `clock-names` 각 항목과 대응하며 이름 `pwm`은 operating clock, `sys`는 system-interface clock입니다. `#pwm-cells`는 2이고 `img,cr-periph`는 PWM control register를 포함한 peripheral-control syscon phandle입니다. Clock 형식은 `../clock/clock-bindings.txt`, PWM cell 형식은 `pwm.yaml`을 따릅니다.
Device-tree 예제
16-24Pistachio 예제는 PWM·system clock과 peripheral syscon을 controller에 연결합니다.
pwm: pwm@18101300 {
compatible = "img,pistachio-pwm";
reg = <0x18101300 0x100>;
clocks = <&pwm_clk>, <&system_clk>;
clock-names = "pwm", "sys";
#pwm-cells = <2>;
img,cr-periph = <&cr_periph>;
};
요약과 해설
img-pwm.txt:1-24Controller별 필수 property와 실제 device-tree 예제를 함께 설명합니다.