mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-02 08:32:55 +00:00
f189c972f8
The sound card design is based on reference PLL frequencies that are the root of all clock rates calculations. Today, those frequencies are currently specified in DT via assigned-clocks, because they correspond to the basic audio use-case. It makes no sense to setup clock rates for a sound card without referencing the clocks for the sound card, mainly because at some point more complex audio use cases will be supported and those root rates would need to change. To solve this situation, let's legitimize the presence of assigned-clocks in the sound card by documenting those clocks, as it describes a true dependency of the sound card and paths the way of more complex audio uses-cases involving those root frequencies. Signed-off-by: Neil Armstrong <neil.armstrong@linaro.org> Acked-by: Conor Dooley <conor.dooley@microchip.com> Link: https://patch.msgid.link/20240828-topic-amlogic-upstream-bindings-fixes-audio-snd-card-v2-2-58159abf0779@linaro.org Signed-off-by: Mark Brown <broonie@kernel.org>
114 lines
2.8 KiB
YAML
114 lines
2.8 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/sound/amlogic,gx-sound-card.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Amlogic GX sound card
|
|
|
|
maintainers:
|
|
- Jerome Brunet <jbrunet@baylibre.com>
|
|
|
|
allOf:
|
|
- $ref: sound-card-common.yaml#
|
|
|
|
properties:
|
|
compatible:
|
|
items:
|
|
- const: amlogic,gx-sound-card
|
|
|
|
audio-aux-devs:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description: list of auxiliary devices
|
|
|
|
audio-widgets:
|
|
$ref: /schemas/types.yaml#/definitions/non-unique-string-array
|
|
description: |-
|
|
A list off component DAPM widget. Each entry is a pair of strings,
|
|
the first being the widget type, the second being the widget name
|
|
|
|
clocks:
|
|
minItems: 1
|
|
maxItems: 3
|
|
description:
|
|
Base PLL clocks of audio susbsytem, used to configure base clock
|
|
frequencies for different audio use-cases.
|
|
|
|
patternProperties:
|
|
"^dai-link-[0-9]+$":
|
|
type: object
|
|
additionalProperties: false
|
|
description: |-
|
|
dai-link child nodes:
|
|
Container for dai-link level properties and the CODEC sub-nodes.
|
|
There should be at least one (and probably more) subnode of this type
|
|
|
|
properties:
|
|
dai-format:
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
enum: [ i2s, left-j, dsp_a ]
|
|
|
|
mclk-fs:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: |-
|
|
Multiplication factor between the frame rate and master clock
|
|
rate
|
|
|
|
sound-dai:
|
|
maxItems: 1
|
|
description: phandle of the CPU DAI
|
|
|
|
patternProperties:
|
|
"^codec(-[0-9]+)?$":
|
|
type: object
|
|
additionalProperties: false
|
|
description: |-
|
|
Codecs:
|
|
dai-link representing backend links should have at least one subnode.
|
|
One subnode for each codec of the dai-link. dai-link representing
|
|
frontend links have no codec, therefore have no subnodes
|
|
|
|
properties:
|
|
sound-dai:
|
|
maxItems: 1
|
|
description: phandle of the codec DAI
|
|
|
|
required:
|
|
- sound-dai
|
|
|
|
required:
|
|
- sound-dai
|
|
|
|
required:
|
|
- model
|
|
- dai-link-0
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
sound {
|
|
compatible = "amlogic,gx-sound-card";
|
|
model = "GXL-ACME-S905X-FOO";
|
|
audio-aux-devs = <&>;
|
|
audio-routing = "I2S ENCODER I2S IN", "I2S FIFO Playback";
|
|
|
|
dai-link-0 {
|
|
sound-dai = <&i2s_fifo>;
|
|
};
|
|
|
|
dai-link-1 {
|
|
sound-dai = <&i2s_encoder>;
|
|
dai-format = "i2s";
|
|
mclk-fs = <256>;
|
|
|
|
codec-0 {
|
|
sound-dai = <&codec0>;
|
|
};
|
|
|
|
codec-1 {
|
|
sound-dai = <&codec1>;
|
|
};
|
|
};
|
|
};
|