TI DaVinci EVM audio | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

davinci-evm-audio.txt:1-49

DAI stream과 TI McASP의 schema 구조, clock·DMA·routing 조건을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 * Texas Instruments SoC audio setups with TLV320AIC3X Codec

3 Required properties:

4 - compatible : "ti,da830-evm-audio" : forDM365/DA8xx/OMAPL1x/AM33xx

5 - ti,model : The user-visible name of this sound complex.

6 - ti,audio-codec : The phandle of the TLV320AIC3x audio codec

7 - ti,mcasp-controller : The phandle of the McASP controller

8 - ti,audio-routing : A list of the connections between audio components.

9 Each entry is a pair of strings, the first being the connection's sink,

10 the second being the connection's source. Valid names for sources and

11 sinks are the codec's pins, and the jacks on the board:

13 Optional properties:

14 - ti,codec-clock-rate : The Codec Clock rate (in Hz) applied to the Codec.

15 - clocks : Reference to the master clock

16 - clock-names : The clock should be named "mclk"

17 - Either codec-clock-rate or the codec-clock reference has to be defined. If

18 the both are defined the driver attempts to set referenced clock to the

19 defined rate and takes the rate from the clock reference.

21 Board connectors:

23 * Headphone Jack

24 * Line Out

25 * Mic Jack

26 * Line In

29 Example:

31 sound {

32 compatible = "ti,da830-evm-audio";

33 ti,model = "DA830 EVM";

34 ti,audio-codec = <&tlv320aic3x>;

35 ti,mcasp-controller = <&mcasp1>;

36 ti,codec-clock-rate = <12000000>;

37 ti,audio-routing =

38 "Headphone Jack", "HPLOUT",

39 "Headphone Jack", "HPROUT",

40 "Line Out", "LLOUT",

41 "Line Out", "RLOUT",

42 "MIC3L", "Mic Bias 2V",

43 "MIC3R", "Mic Bias 2V",

44 "Mic Bias 2V", "Mic Jack",

45 "LINE1L", "Line In",

46 "LINE2L", "Line In",

47 "LINE1R", "Line In",

48 "LINE2R", "Line In";

49 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

TI SoC와 TLV320AIC3X 필수 속성

1-12

이 binding은 TLV320AIC3X codec을 사용하는 Texas Instruments SoC audio setup을 설명합니다. `compatible`은 `ti,da830-evm-audio`이고 원문은 DM365/DA8xx/OMAPL1x/AM33xx용이라고 적습니다.

`ti,model`은 사용자에게 보이는 sound complex 이름, `ti,audio-codec`은 TLV320AIC3x codec phandle, `ti,mcasp-controller`는 McASP controller phandle입니다.

`ti,audio-routing`은 audio component 연결 목록입니다. 각 항목은 sink와 source 문자열 쌍이며 codec pin과 board jack 이름을 사용할 수 있습니다.

Codec master clock

13-20

`ti,codec-clock-rate`는 codec에 인가하는 clock rate를 Hz 단위로 지정합니다. `clocks`는 master clock reference이고 `clock-names`는 `mclk`여야 합니다.

`codec-clock-rate` 또는 codec clock reference 중 하나는 반드시 있어야 합니다. 둘 다 있으면 driver가 referenced clock을 지정 rate로 설정하려 한 뒤 clock reference에서 실제 rate를 가져옵니다.

Board connector 이름

21-28

Board connector로 `Headphone Jack`, `Line Out`, `Mic Jack`, `Line In`을 사용할 수 있습니다. 이 이름들이 `ti,audio-routing`의 source 또는 sink로 codec pin과 짝을 이룹니다.

DA830 EVM routing 예제

29-49

예제는 DA830 EVM model, TLV320AIC3x codec과 McASP1, 12MHz codec clock을 연결합니다. Headphone·line output, MIC3L/R와 2V mic bias, four line input pin의 routing pair를 지정합니다.

sound {
        compatible = "ti,da830-evm-audio";
        ti,model = "DA830 EVM";
        ti,audio-codec = <&tlv320aic3x>;
        ti,mcasp-controller = <&mcasp1>;
        ti,codec-clock-rate = <12000000>;
        ti,audio-routing =
                "Headphone Jack",       "HPLOUT",
                "Headphone Jack",       "HPROUT",
                "Line Out",             "LLOUT",
                "Line Out",             "RLOUT",
                "MIC3L",                "Mic Bias 2V",
                "MIC3R",                "Mic Bias 2V",
                "Mic Bias 2V",          "Mic Jack",
                "LINE1L",               "Line In",
                "LINE2L",               "Line In",
                "LINE1R",               "Line In",
                "LINE2R",               "Line In";
};