요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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/google,sc7180-trogdor.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Google SC7180-Trogdor ASoC sound card driver
maintainers:
- Rohit kumar <[email protected]>
- Cheng-Yi Chiang <[email protected]>
description:
This binding describes the SC7180 sound card which uses LPASS for audio.
allOf:
- $ref: sound-card-common.yaml#
properties:
compatible:
enum:
- google,sc7180-trogdor
- google,sc7180-coachz
"#address-cells":
const: 1
"#size-cells":
const: 0
dmic-gpios:
maxItems: 1
description: GPIO for switching between DMICs
patternProperties:
"^dai-link(@[0-9])?$":
description:
Each subnode represents a dai link. Subnodes of each dai links would be
cpu/codec dais.
type: object
properties:
link-name:
description: Indicates dai-link name and PCM stream name.
$ref: /schemas/types.yaml#/definitions/string
maxItems: 1
reg:
maxItems: 1
description: dai link address.
cpu:
description: Holds subnode which indicates cpu dai.
type: object
additionalProperties: false
properties:
sound-dai:
maxItems: 1
codec:
description: Holds subnode which indicates codec dai.
type: object
additionalProperties: false
properties:
sound-dai:
minItems: 1
maxItems: 4
required:
- link-name
- cpu
- codec
additionalProperties: false
required:
- compatible
- "#address-cells"
- "#size-cells"
unevaluatedProperties: false
examples:
- |
sound {
compatible = "google,sc7180-trogdor";
model = "sc7180-rt5682-max98357a-2mic";
audio-routing =
"Headphone Jack", "HPOL",
"Headphone Jack", "HPOR";
#address-cells = <1>;
#size-cells = <0>;
dmic-gpios = <&tlmm 86 0>;
dai-link@0 {
link-name = "MultiMedia0";
reg = <0>;
cpu {
sound-dai = <&lpass_cpu 0>;
};
codec {
sound-dai = <&alc5682 0>;
};
};
dai-link@1 {
link-name = "MultiMedia1";
reg = <1>;
cpu {
sound-dai = <&lpass_cpu 1>;
};
codec {
sound-dai = <&max98357a>;
};
};
dai-link@2 {
link-name = "MultiMedia2";
reg = <2>;
cpu {
sound-dai = <&lpass_hdmi 0>;
};
codec {
sound-dai = <&msm_dp>;
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
SC7180 Trogdor ASoC card
1-18이 binding은 audio에 LPASS를 사용하는 Google SC7180 sound card를 설명합니다. `sound-card-common.yaml#`을 상속하며 schema ID는 `http://devicetree.org/schemas/sound/google,sc7180-trogdor.yaml#`입니다.
Board compatible과 DMIC switch
19-34`compatible`은 `google,sc7180-trogdor` 또는 `google,sc7180-coachz`입니다. `#address-cells`는 1, `#size-cells`는 0입니다. `dmic-gpios`는 DMIC 사이를 전환하는 GPIO 한 항목입니다.
DAI link와 CPU DAI
35-61각 `^dai-link(@[0-9])?$` subnode는 하나의 DAI link를 나타내고 그 아래 CPU/codec DAI를 둡니다. `link-name`은 DAI-link 이름과 PCM stream 이름이며 최대 한 문자열이고, `reg`는 link address 한 항목입니다.
`cpu` subnode는 CPU DAI를 나타내며 추가 속성을 허용하지 않고 `sound-dai`를 최대 한 항목 가집니다.
Codec DAI와 link 필수 속성
62-78`codec` subnode는 codec DAI를 나타내며 추가 속성을 허용하지 않습니다. `sound-dai`는 1~4개입니다. 각 DAI link에는 `link-name`, `cpu`, `codec`이 필수이고 link node에도 정의되지 않은 속성을 허용하지 않습니다.
Card 필수 속성과 확장 제한
79-85Card의 필수 속성은 `compatible`, `#address-cells`, `#size-cells`입니다. 공통 sound card schema 평가 뒤 남는 속성은 허용하지 않습니다.
Trogdor 세 DAI link 예제
86-137예제 `sc7180-rt5682-max98357a-2mic` card는 GPIO 86으로 DMIC을 전환합니다. `MultiMedia0`은 LPASS CPU 0과 ALC5682, `MultiMedia1`은 LPASS CPU 1과 MAX98357A, `MultiMedia2`는 LPASS HDMI 0과 DisplayPort codec `msm_dp`를 연결합니다.
- |
sound {
compatible = "google,sc7180-trogdor";
model = "sc7180-rt5682-max98357a-2mic";
audio-routing =
"Headphone Jack", "HPOL",
"Headphone Jack", "HPOR";
#address-cells = <1>;
#size-cells = <0>;
dmic-gpios = <&tlmm 86 0>;
dai-link@0 {
link-name = "MultiMedia0";
reg = <0>;
cpu {
sound-dai = <&lpass_cpu 0>;
};
codec {
sound-dai = <&alc5682 0>;
};
};
dai-link@1 {
link-name = "MultiMedia1";
reg = <1>;
cpu {
sound-dai = <&lpass_cpu 1>;
};
codec {
sound-dai = <&max98357a>;
};
};
dai-link@2 {
link-name = "MultiMedia2";
reg = <2>;
cpu {
sound-dai = <&lpass_hdmi 0>;
};
codec {
sound-dai = <&msm_dp>;
};
};
};
요약과 해설
google,sc7180-trogdor.yaml:1-137NXP XCVR와 Google Chameleon·ChromeOS EC·SC7180 audio 구성의 memory, interrupt, DAI graph를 먼저 해설하고, 접을 수 있는 영어 원문 전체와 source path·symbol·줄 좌표를 보존한 한국어 전문 번역을 제공합니다.