Documentation/devicetree/bindings/sound/sirf-audio.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

SiRF internal audio card

SiRF internal codec·platform과 amplifier·jack GPIO를 설명합니다.

Source pathDocumentation/devicetree/bindings/sound/sirf-audio.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

sirf-audio.txt:1-41

SiRF internal codec·platform과 amplifier·jack GPIO를 설명합니다. 영어 원문 전체와 줄 좌표를 보존하고 한국어 전문 번역에서는 property·pin·phandle·수치와 예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 * SiRF atlas6 and prima2 internal audio codec and port based audio setups
2
3 Required properties:
4 - compatible: "sirf,sirf-audio-card"
5 - sirf,audio-platform: phandle for the platform node
6 - sirf,audio-codec: phandle for the SiRF internal codec node
7
8 Optional properties:
9 - hp-pa-gpios: Need to be present if the board need control external
10 headphone amplifier.
11 - spk-pa-gpios: Need to be present if the board need control external
12 speaker amplifier.
13 - hp-switch-gpios: Need to be present if the board capable to detect jack
14 insertion, removal.
15
16 Available audio endpoints for the audio-routing table:
17
18 Board connectors:
19 * Headset Stereophone
20 * Ext Spk
21 * Line In
22 * Mic
23
24 SiRF internal audio codec pins:
25 * HPOUTL
26 * HPOUTR
27 * SPKOUT
28 * Ext Mic
29 * Mic Bias
30
31 Example:
32
33 sound {
34 compatible = "sirf,sirf-audio-card";
35 sirf,audio-codec = <&audiocodec>;
36 sirf,audio-platform = <&audioport>;
37 hp-pa-gpios = <&gpio 44 0>;
38 spk-pa-gpios = <&gpio 46 0>;
39 hp-switch-gpios = <&gpio 45 0>;
40 };
41
42

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

SiRF internal codec card 속성

1-15

Atlas6·Prima2 internal audio codec card의 `compatible`은 `sirf,sirf-audio-card`, `sirf,audio-platform`은 platform node phandle, `sirf,audio-codec`은 SiRF internal codec phandle입니다.

선택 `hp-pa-gpios`는 external headphone amplifier, `spk-pa-gpios`는 external speaker amplifier 제어 GPIO이며 `hp-switch-gpios`는 jack 삽입·제거 감지 GPIO입니다.

SiRF audio-routing endpoint

16-30

Board connector는 `Headset Stereophone`, `Ext Spk`, `Line In`, `Mic`입니다. Internal codec pin은 `HPOUTL`, `HPOUTR`, `SPKOUT`, `Ext Mic`, `Mic Bias`이며 audio-routing table에서 사용할 수 있습니다.

SiRF card 예제

31-41

예제는 internal codec과 audio port를 연결하고 GPIO 44·46으로 headphone·speaker amplifier를, GPIO 45로 jack switch를 제어합니다.

sound {
                compatible = "sirf,sirf-audio-card";
                sirf,audio-codec = <&audiocodec>;
                sirf,audio-platform = <&audioport>;
                hp-pa-gpios = <&gpio 44 0>;
                spk-pa-gpios = <&gpio 46 0>;
                hp-switch-gpios = <&gpio 45 0>;
};