mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-09-18 22:14:16 +00:00
972d6a7dce
If a property has an 'items' list, then a 'minItems' or 'maxItems' with the same size as the list is redundant and can be dropped. Note that is DT schema specific behavior and not standard json-schema behavior. The tooling will fixup the final schema adding any unspecified minItems/maxItems. This condition is partially checked with the meta-schema already, but only if both 'minItems' and 'maxItems' are equal to the 'items' length. An improved meta-schema is pending. Cc: Jens Axboe <axboe@kernel.dk> Cc: Stephen Boyd <sboyd@kernel.org> Cc: Herbert Xu <herbert@gondor.apana.org.au> Cc: "David S. Miller" <davem@davemloft.net> Cc: David Airlie <airlied@linux.ie> Cc: Daniel Vetter <daniel@ffwll.ch> Cc: Bartosz Golaszewski <bgolaszewski@baylibre.com> Cc: Kamal Dasu <kdasu.kdev@gmail.com> Cc: Lars-Peter Clausen <lars@metafoo.de> Cc: Thomas Gleixner <tglx@linutronix.de> Cc: Marc Zyngier <maz@kernel.org> Cc: Joerg Roedel <joro@8bytes.org> Cc: Mauro Carvalho Chehab <mchehab@kernel.org> Cc: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> Cc: Jakub Kicinski <kuba@kernel.org> Cc: Wolfgang Grandegger <wg@grandegger.com> Cc: Andrew Lunn <andrew@lunn.ch> Cc: Vivien Didelot <vivien.didelot@gmail.com> Cc: Vladimir Oltean <olteanv@gmail.com> Cc: Bjorn Helgaas <bhelgaas@google.com> Cc: Kishon Vijay Abraham I <kishon@ti.com> Cc: Linus Walleij <linus.walleij@linaro.org> Cc: "Uwe Kleine-König" <u.kleine-koenig@pengutronix.de> Cc: Lee Jones <lee.jones@linaro.org> Cc: Ohad Ben-Cohen <ohad@wizery.com> Cc: Mathieu Poirier <mathieu.poirier@linaro.org> Cc: Paul Walmsley <paul.walmsley@sifive.com> Cc: Palmer Dabbelt <palmer@dabbelt.com> Cc: Albert Ou <aou@eecs.berkeley.edu> Cc: Alessandro Zummo <a.zummo@towertech.it> Cc: Alexandre Belloni <alexandre.belloni@bootlin.com> Cc: Zhang Rui <rui.zhang@intel.com> Cc: Daniel Lezcano <daniel.lezcano@linaro.org> Cc: Wim Van Sebroeck <wim@linux-watchdog.org> Cc: Guenter Roeck <linux@roeck-us.net> Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Marc Kleine-Budde <mkl@pengutronix.de> Acked-by: Ulf Hansson <ulf.hansson@linaro.org> # for MMC Acked-by: Jassi Brar <jassisinghbrar@gmail.com> Acked-By: Vinod Koul <vkoul@kernel.org> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Arnaud Pouliquen <arnaud.pouliquen@st.com> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Philipp Zabel <p.zabel@pengutronix.de> Acked-by: Wolfram Sang <wsa@kernel.org> # for I2C Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Link: https://lore.kernel.org/r/20210615191543.1043414-1-robh@kernel.org
117 lines
3.1 KiB
YAML
117 lines
3.1 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/sound/nvidia,tegra210-i2s.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Tegra210 I2S Controller Device Tree Bindings
|
|
|
|
description: |
|
|
The Inter-IC Sound (I2S) controller implements full-duplex,
|
|
bi-directional and single direction point-to-point serial
|
|
interfaces. It can interface with I2S compatible devices.
|
|
I2S controller can operate both in master and slave mode.
|
|
|
|
maintainers:
|
|
- Jon Hunter <jonathanh@nvidia.com>
|
|
- Sameer Pujar <spujar@nvidia.com>
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: "^i2s@[0-9a-f]*$"
|
|
|
|
compatible:
|
|
oneOf:
|
|
- const: nvidia,tegra210-i2s
|
|
- items:
|
|
- enum:
|
|
- nvidia,tegra194-i2s
|
|
- nvidia,tegra186-i2s
|
|
- const: nvidia,tegra210-i2s
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
minItems: 1
|
|
items:
|
|
- description: I2S bit clock
|
|
- description:
|
|
Sync input clock, which can act as clock source to other I/O
|
|
modules in AHUB. The Tegra I2S driver sets this clock rate as
|
|
per bit clock rate. I/O module which wants to use this clock
|
|
as source, can mention this clock as parent in the DT bindings.
|
|
This is an optional clock entry, since it is only required when
|
|
some other I/O wants to reference from a particular I2Sx
|
|
instance.
|
|
|
|
clock-names:
|
|
minItems: 1
|
|
items:
|
|
- const: i2s
|
|
- const: sync_input
|
|
|
|
assigned-clocks:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
assigned-clock-parents:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
assigned-clock-rates:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
sound-name-prefix:
|
|
pattern: "^I2S[1-9]$"
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
description:
|
|
Used as prefix for sink/source names of the component. Must be a
|
|
unique string among multiple instances of the same component.
|
|
The name can be "I2S1" or "I2S2" ... "I2Sx", where x depends
|
|
on the maximum available instances on a Tegra SoC.
|
|
|
|
ports:
|
|
$ref: /schemas/graph.yaml#/properties/ports
|
|
properties:
|
|
port@0:
|
|
$ref: audio-graph-port.yaml#
|
|
unevaluatedProperties: false
|
|
description: |
|
|
I2S ACIF (Audio Client Interface) port connected to the
|
|
corresponding AHUB (Audio Hub) ACIF port.
|
|
|
|
port@1:
|
|
$ref: audio-graph-port.yaml#
|
|
unevaluatedProperties: false
|
|
description: |
|
|
I2S DAP (Digital Audio Port) interface which can be connected
|
|
to external audio codec for playback or capture.
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- clocks
|
|
- clock-names
|
|
- assigned-clocks
|
|
- assigned-clock-parents
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include<dt-bindings/clock/tegra210-car.h>
|
|
|
|
i2s@702d1000 {
|
|
compatible = "nvidia,tegra210-i2s";
|
|
reg = <0x702d1000 0x100>;
|
|
clocks = <&tegra_car TEGRA210_CLK_I2S0>;
|
|
clock-names = "i2s";
|
|
assigned-clocks = <&tegra_car TEGRA210_CLK_I2S0>;
|
|
assigned-clock-parents = <&tegra_car TEGRA210_CLK_PLL_A_OUT0>;
|
|
assigned-clock-rates = <1536000>;
|
|
sound-name-prefix = "I2S1";
|
|
};
|
|
|
|
...
|