요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
Generic AC97 Device Properties
3
This documents describes the devicetree bindings for an ac97 controller child
4
node describing ac97 codecs.
6
Required properties:
7
-compatible : Must be "ac97,vendor_id1,vendor_id2
8
The ids shall be the 4 characters hexadecimal encoding, such as
9
given by "%04x" formatting of printf
10
-reg : Must be the ac97 codec number, between 0 and 3
12
Example:
13
ac97: sound@40500000 {
14
compatible = "marvell,pxa270-ac97";
15
reg = < 0x40500000 0x1000 >;
16
interrupts = <14>;
17
reset-gpios = <&gpio 95 GPIO_ACTIVE_HIGH>;
18
#sound-dai-cells = <1>;
19
pinctrl-names = "default";
20
pinctrl-0 = < &pinctrl_ac97_default >;
21
clocks = <&clks CLK_AC97>, <&clks CLK_AC97CONF>;
22
clock-names = "AC97CLK", "AC97CONFCLK";
24
#address-cells = <1>;
25
#size-cells = <0>;
26
audio-codec@0 {
27
reg = <0>;
28
compatible = "ac97,574d,4c13";
29
clocks = <&fixed_wm9713_clock>;
30
clock-names = "ac97_clk";
31
}
32
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Generic AC97 codec 자식 노드
1-5이 binding은 AC97 controller 아래에서 AC97 codec을 설명하는 device tree 자식 노드를 정의합니다.
필수 속성
6-11`compatible`은 `ac97,vendor_id1,vendor_id2` 형식입니다. 각 ID는 `printf`의 `%04x` 형식처럼 4문자 hexadecimal encoding이어야 합니다.
`reg`는 0~3 범위의 AC97 codec 번호여야 합니다.
PXA270 AC97 예제
12-32예제는 PXA270 AC97 controller 아래 codec 0을 두고 vendor ID `574d,4c13`, fixed WM9713 clock과 `ac97_clk` 이름을 지정합니다.
ac97: sound@40500000 {
compatible = "marvell,pxa270-ac97";
reg = < 0x40500000 0x1000 >;
interrupts = <14>;
reset-gpios = <&gpio 95 GPIO_ACTIVE_HIGH>;
#sound-dai-cells = <1>;
pinctrl-names = "default";
pinctrl-0 = < &pinctrl_ac97_default >;
clocks = <&clks CLK_AC97>, <&clks CLK_AC97CONF>;
clock-names = "AC97CLK", "AC97CONFCLK";
#address-cells = <1>;
#size-cells = <0>;
audio-codec@0 {
reg = <0>;
compatible = "ac97,574d,4c13";
clocks = <&fixed_wm9713_clock>;
clock-names = "ac97_clk";
}
};
요약과 해설
ac97-bus.txt:1-32Audio controller와 codec의 clock, DMA, GPIO, supply 연결 규칙을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.