요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Hisilicon PWM controller
3
Required properties:
4
-compatible: should contain one SoC specific compatible string
5
The SoC specific strings supported including:
6
"hisilicon,hi3516cv300-pwm"
7
"hisilicon,hi3519v100-pwm"
8
"hisilicon,hi3559v100-shub-pwm"
9
"hisilicon,hi3559v100-pwm
10
- reg: physical base address and length of the controller's registers.
11
- clocks: phandle and clock specifier of the PWM reference clock.
12
- resets: phandle and reset specifier for the PWM controller reset.
13
- #pwm-cells: Should be 3. See pwm.yaml in this directory for a description of
14
the cells format.
16
Example:
17
pwm: pwm@12130000 {
18
compatible = "hisilicon,hi3516cv300-pwm";
19
reg = <0x12130000 0x10000>;
20
clocks = <&crg_ctrl HI3516CV300_PWM_CLK>;
21
resets = <&crg_ctrl 0x38 0>;
22
#pwm-cells = <3>;
23
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
필수·선택 property
1-15Hisilicon PWM controller는 `hisilicon,hi3516cv300-pwm`, `hisilicon,hi3519v100-pwm`, `hisilicon,hi3559v100-shub-pwm`, `hisilicon,hi3559v100-pwm` 중 SoC별 compatible 하나를 사용합니다. `reg`, reference `clocks`, controller `resets`가 필수이며 `#pwm-cells`는 3입니다.
원문 9행의 `hisilicon,hi3559v100-pwm` string에는 닫는 따옴표가 없습니다. 번역 설명에서는 식별자를 명확히 표기하되 접힌 원문은 그대로 보존합니다.
Device-tree 예제
16-23HI3516CV300 예제는 0x12130000 register, PWM clock과 reset specifier를 연결합니다.
pwm: pwm@12130000 {
compatible = "hisilicon,hi3516cv300-pwm";
reg = <0x12130000 0x10000>;
clocks = <&crg_ctrl HI3516CV300_PWM_CLK>;
resets = <&crg_ctrl 0x38 0>;
#pwm-cells = <3>;
};
요약과 해설
pwm-hibvt.txt:1-23Controller별 필수 property와 실제 device-tree 예제를 함께 설명합니다.