요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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/dai-params.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Digital Audio Interface (DAI) Stream Parameters
maintainers:
- Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
select: false
properties:
convert-channels:
description: Number of audio channels used by DAI
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 1
maximum: 32
convert-sample-format:
description: Audio sample format used by DAI
$ref: /schemas/types.yaml#/definitions/string
enum:
- s8
- s16_le
- s24_le
- s24_3le
- s32_le
convert-rate:
description: Audio sample rate used by DAI
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 8000
maximum: 192000
additionalProperties: true
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
DAI stream parameter schema
1-13이 YAML schema는 DAI stream conversion parameter를 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/dai-params.yaml#`이고 maintainer는 Kuninori Morimoto입니다.
`select: false`이므로 compatible을 기준으로 독립 선택되는 binding이 아니라 다른 audio schema에서 참조하는 공통 parameter schema입니다.
Channel 수 변환
14-20`convert-channels`는 DAI가 사용할 audio channel 수를 나타내는 `uint32`입니다. 허용 범위는 1~32 channel입니다.
Sample format 변환
21-30`convert-sample-format`은 DAI가 사용할 audio sample format 문자열입니다. 허용값은 `s8`, `s16_le`, `s24_le`, `s24_3le`, `s32_le`입니다.
Sample rate 변환
31-37`convert-rate`는 DAI가 사용할 audio sample rate를 나타내는 `uint32`이며 8000Hz부터 192000Hz까지 허용합니다. `additionalProperties: true`이므로 참조하는 schema가 다른 속성을 함께 둘 수 있습니다.
요약과 해설
dai-params.yaml:1-37DAI stream과 TI McASP의 schema 구조, clock·DMA·routing 조건을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.