요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/fsl,mxs-audio-sgtl5000.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Freescale MXS audio complex with SGTL5000 codec
maintainers:
- Frank Li <Frank.Li@nxp.com>
properties:
compatible:
items:
- enum:
- bluegiga,apx4devkit-sgtl5000
- denx,m28evk-sgtl5000
- fsl,imx28-evk-sgtl5000
- fsl,imx28-mbmx28lc-sgtl5000
- fsl,imx28-tx28-sgtl5000
- const: fsl,mxs-audio-sgtl5000
model:
$ref: /schemas/types.yaml#/definitions/string
description: The user-visible name of this sound complex
saif-controllers:
$ref: /schemas/types.yaml#/definitions/phandle-array
description: The phandle list of the MXS SAIF controller
audio-codec:
$ref: /schemas/types.yaml#/definitions/phandle
description: The phandle of the SGTL5000 audio codec
audio-routing:
$ref: /schemas/types.yaml#/definitions/non-unique-string-array
description: |
A list of the connections between audio components.
Each entry is a pair of strings, the first being the
connection's sink, the second being the connection's
source. Valid names could be power supplies, SGTL5000
pins, and the jacks on the board:
Power supplies:
* Mic Bias
SGTL5000 pins:
* MIC_IN
* LINE_IN
* HP_OUT
* LINE_OUT
Board connectors:
* Mic Jack
* Line In Jack
* Headphone Jack
* Line Out Jack
* Ext Spk
required:
- compatible
- saif-controllers
- audio-codec
allOf:
- $ref: dai-common.yaml#
unevaluatedProperties: false
examples:
- |
sound {
compatible = "fsl,imx28-evk-sgtl5000", "fsl,mxs-audio-sgtl5000";
model = "imx28-evk-sgtl5000";
saif-controllers = <&saif0 &saif1>;
audio-codec = <&sgtl5000>;
audio-routing =
"MIC_IN", "Mic Jack",
"Mic Jack", "Mic Bias",
"Headphone Jack", "HP_OUT";
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MXS와 SGTL5000 audio complex
1-11이 YAML binding은 SGTL5000 codec을 사용하는 Freescale MXS audio complex를 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/fsl,mxs-audio-sgtl5000.yaml#`이며 maintainer는 Frank Li입니다.
Board 호환성과 SAIF·codec phandle
12-34`compatible`은 `bluegiga,apx4devkit-sgtl5000`, `denx,m28evk-sgtl5000`, `fsl,imx28-evk-sgtl5000`, `fsl,imx28-mbmx28lc-sgtl5000`, `fsl,imx28-tx28-sgtl5000` 중 board 항목 하나 뒤에 fallback `fsl,mxs-audio-sgtl5000`을 둡니다.
`model`은 사용자에게 보이는 sound complex 이름입니다. `saif-controllers`는 MXS SAIF controller phandle 목록이고 `audio-codec`은 SGTL5000 codec의 phandle입니다.
SGTL5000 audio routing
35-59`audio-routing`은 component 사이 연결 목록이며 각 pair의 첫 문자열은 sink, 두 번째는 source입니다.
유효한 이름은 power supply `Mic Bias`, SGTL5000 pin `MIC_IN`, `LINE_IN`, `HP_OUT`, `LINE_OUT`, board connector `Mic Jack`, `Line In Jack`, `Headphone Jack`, `Line Out Jack`, `Ext Spk`입니다.
필수 속성과 DAI 공통 규칙
60-69필수 속성은 `compatible`, `saif-controllers`, `audio-codec`입니다. `dai-common.yaml#`을 상속하며 평가되지 않은 추가 속성은 허용하지 않습니다.
i.MX28 EVK routing 예제
70-81예제는 SAIF0과 SAIF1을 SGTL5000에 연결하고 `MIC_IN`을 `Mic Jack`에서, `Mic Jack` bias를 `Mic Bias`에서, `Headphone Jack`을 `HP_OUT`에서 공급받도록 route합니다.
sound {
compatible = "fsl,imx28-evk-sgtl5000", "fsl,mxs-audio-sgtl5000";
model = "imx28-evk-sgtl5000";
saif-controllers = <&saif0 &saif1>;
audio-codec = <&sgtl5000>;
audio-routing =
"MIC_IN", "Mic Jack",
"Mic Jack", "Mic Bias",
"Headphone Jack", "HP_OUT";
};
요약과 해설
fsl,mxs-audio-sgtl5000.yaml:1-81NXP/Freescale digital microphone, GPIO audio, SGTL5000 machine card와 QMC multichannel audio의 핵심 signal path와 조건부 속성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.