요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: GPL-2.0-only
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/google,cros-ec-codec.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Audio codec controlled by ChromeOS EC
maintainers:
- Cheng-Yi Chiang <cychiang@chromium.org>
- Tzung-Bi Shih <tzungbi@kernel.org>
description: |
Google's ChromeOS EC codec is a digital mic codec provided by the
Embedded Controller (EC) and is controlled via a host-command
interface. An EC codec node should only be found inside the "codecs"
subnode of a cros-ec node.
(see Documentation/devicetree/bindings/embedded-controller/google,cros-ec.yaml).
allOf:
- $ref: dai-common.yaml#
properties:
compatible:
const: google,cros-ec-codec
"#sound-dai-cells":
const: 1
reg:
items:
- description: |
Physical base address and length of shared memory region from EC.
It contains 3 unsigned 32-bit integer. The first 2 integers
combine to become an unsigned 64-bit physical address.
The last one integer is the length of the shared memory.
memory-region:
maxItems: 1
description: |
Shared memory region to EC. A "shared-dma-pool".
See ../reserved-memory/reserved-memory.txt for details.
required:
- compatible
- '#sound-dai-cells'
unevaluatedProperties: false
examples:
- |
reserved_mem: reserved-mem@52800000 {
compatible = "shared-dma-pool";
reg = <0x52800000 0x100000>;
no-map;
};
spi {
#address-cells = <1>;
#size-cells = <0>;
cros-ec@0 {
compatible = "google,cros-ec-spi";
reg = <0>;
interrupts = <93 0>;
codecs {
#address-cells = <2>;
#size-cells = <1>;
cros_ec_codec: ec-codec@10500000 {
compatible = "google,cros-ec-codec";
#sound-dai-cells = <1>;
reg = <0x0 0x10500000 0x80000>;
memory-region = <&reserved_mem>;
};
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ChromeOS EC digital microphone codec
1-22Google ChromeOS EC codec은 Embedded Controller(EC)가 제공하고 host-command interface로 제어하는 digital microphone codec입니다. EC codec node는 cros-ec node의 `codecs` subnode 안에만 있어야 합니다.
원문은 `Documentation/devicetree/bindings/embedded-controller/google,cros-ec.yaml`을 참조합니다. Binding은 `dai-common.yaml#`을 상속하며 maintainer는 Cheng-Yi Chiang과 Tzung-Bi Shih입니다.
DAI cell과 EC shared memory
23-43`compatible`은 `google,cros-ec-codec`, `#sound-dai-cells`는 1입니다.
`reg` 한 항목은 EC shared-memory region의 physical base와 length를 나타내는 unsigned 32-bit integer 3개입니다. 앞의 두 integer를 결합해 unsigned 64-bit physical address를 만들고 마지막 integer가 길이입니다.
`memory-region`은 EC와 공유하는 `shared-dma-pool` 하나를 가리키며 `../reserved-memory/reserved-memory.txt`를 참조합니다.
필수 속성과 확장 제한
44-49필수 속성은 `compatible`과 `#sound-dai-cells`입니다. 공통 DAI schema 평가 뒤 남는 추가 속성은 허용하지 않습니다.
Reserved DMA pool 예제
50-56예제 reserved memory는 address `0x52800000`, size `0x100000`의 `shared-dma-pool`이며 `no-map`으로 지정됩니다.
reserved_mem: reserved-mem@52800000 {
compatible = "shared-dma-pool";
reg = <0x52800000 0x100000>;
no-map;
};Cros-EC codecs subnode 예제
57-78SPI cros-ec의 `codecs` subnode는 2-cell address와 1-cell size를 사용합니다. EC codec은 64-bit address `0x0000000010500000`, length `0x80000`을 `reg`에 적고 앞서 정의한 `reserved_mem`을 `memory-region`으로 연결합니다.
spi {
#address-cells = <1>;
#size-cells = <0>;
cros-ec@0 {
compatible = "google,cros-ec-spi";
reg = <0>;
interrupts = <93 0>;
codecs {
#address-cells = <2>;
#size-cells = <1>;
cros_ec_codec: ec-codec@10500000 {
compatible = "google,cros-ec-codec";
#sound-dai-cells = <1>;
reg = <0x0 0x10500000 0x80000>;
memory-region = <&reserved_mem>;
};
};
};
};
요약과 해설
google,cros-ec-codec.yaml:1-78NXP XCVR와 Google Chameleon·ChromeOS EC·SC7180 audio 구성의 memory, interrupt, DAI graph를 먼저 해설하고, 접을 수 있는 영어 원문 전체와 source path·symbol·줄 좌표를 보존한 한국어 전문 번역을 제공합니다.