mirror of
https://github.com/torvalds/linux.git
synced 2026-04-25 18:12:26 -04: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
189 lines
4.4 KiB
YAML
189 lines
4.4 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: "http://devicetree.org/schemas/usb/nvidia,tegra-xudc.yaml#"
|
|
$schema: "http://devicetree.org/meta-schemas/core.yaml#"
|
|
|
|
title: Device tree binding for NVIDIA Tegra XUSB device mode controller (XUDC)
|
|
|
|
description:
|
|
The Tegra XUDC controller supports both USB 2.0 HighSpeed/FullSpeed and
|
|
USB 3.0 SuperSpeed protocols.
|
|
|
|
maintainers:
|
|
- Nagarjuna Kristam <nkristam@nvidia.com>
|
|
- JC Kuo <jckuo@nvidia.com>
|
|
- Thierry Reding <treding@nvidia.com>
|
|
|
|
properties:
|
|
compatible:
|
|
items:
|
|
- enum:
|
|
- nvidia,tegra210-xudc # For Tegra210
|
|
- nvidia,tegra186-xudc # For Tegra186
|
|
- nvidia,tegra194-xudc # For Tegra194
|
|
|
|
reg:
|
|
minItems: 2
|
|
items:
|
|
- description: XUSB device controller registers
|
|
- description: XUSB device PCI Config registers
|
|
- description: XUSB device registers.
|
|
|
|
reg-names:
|
|
minItems: 2
|
|
items:
|
|
- const: base
|
|
- const: fpci
|
|
- const: ipfs
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
description: Must contain the XUSB device interrupt.
|
|
|
|
clocks:
|
|
minItems: 4
|
|
items:
|
|
- description: Clock to enable core XUSB dev clock.
|
|
- description: Clock to enable XUSB super speed clock.
|
|
- description: Clock to enable XUSB super speed dev clock.
|
|
- description: Clock to enable XUSB high speed dev clock.
|
|
- description: Clock to enable XUSB full speed dev clock.
|
|
|
|
clock-names:
|
|
minItems: 4
|
|
items:
|
|
- const: dev
|
|
- const: ss
|
|
- const: ss_src
|
|
- const: fs_src
|
|
- const: hs_src
|
|
|
|
power-domains:
|
|
items:
|
|
- description: XUSBB(device) power-domain
|
|
- description: XUSBA(superspeed) power-domain
|
|
|
|
power-domain-names:
|
|
items:
|
|
- const: dev
|
|
- const: ss
|
|
|
|
nvidia,xusb-padctl:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description:
|
|
phandle to the XUSB pad controller that is used to configure the USB pads
|
|
used by the XUDC controller.
|
|
|
|
phys:
|
|
minItems: 1
|
|
description:
|
|
Must contain an entry for each entry in phy-names.
|
|
See ../phy/phy-bindings.txt for details.
|
|
|
|
phy-names:
|
|
minItems: 1
|
|
items:
|
|
- const: usb2-0
|
|
- const: usb2-1
|
|
- const: usb2-2
|
|
- const: usb2-3
|
|
- const: usb3-0
|
|
- const: usb3-1
|
|
- const: usb3-2
|
|
- const: usb3-3
|
|
|
|
avddio-usb-supply:
|
|
description: PCIe/USB3 analog logic power supply. Must supply 1.05 V.
|
|
|
|
hvdd-usb-supply:
|
|
description: USB controller power supply. Must supply 3.3 V.
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- reg-names
|
|
- interrupts
|
|
- clocks
|
|
- clock-names
|
|
- power-domains
|
|
- power-domain-names
|
|
- nvidia,xusb-padctl
|
|
- phys
|
|
- phy-names
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- nvidia,tegra210-xudc
|
|
then:
|
|
properties:
|
|
reg:
|
|
minItems: 3
|
|
reg-names:
|
|
minItems: 3
|
|
clocks:
|
|
minItems: 5
|
|
clock-names:
|
|
minItems: 5
|
|
required:
|
|
- avddio-usb-supply
|
|
- hvdd-usb-supply
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- nvidia,tegra186-xudc
|
|
- nvidia,tegra194-xudc
|
|
then:
|
|
properties:
|
|
reg:
|
|
maxItems: 2
|
|
reg-names:
|
|
maxItems: 2
|
|
clocks:
|
|
maxItems: 4
|
|
clock-names:
|
|
maxItems: 4
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/tegra210-car.h>
|
|
#include <dt-bindings/gpio/tegra-gpio.h>
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
|
|
usb@700d0000 {
|
|
compatible = "nvidia,tegra210-xudc";
|
|
reg = <0x700d0000 0x8000>,
|
|
<0x700d8000 0x1000>,
|
|
<0x700d9000 0x1000>;
|
|
reg-names = "base", "fpci", "ipfs";
|
|
|
|
interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>;
|
|
|
|
clocks = <&tegra_car TEGRA210_CLK_XUSB_DEV>,
|
|
<&tegra_car TEGRA210_CLK_XUSB_SS>,
|
|
<&tegra_car TEGRA210_CLK_XUSB_SSP_SRC>,
|
|
<&tegra_car TEGRA210_CLK_XUSB_FS_SRC>,
|
|
<&tegra_car TEGRA210_CLK_XUSB_HS_SRC>;
|
|
clock-names = "dev", "ss", "ss_src", "fs_src", "hs_src";
|
|
|
|
power-domains = <&pd_xusbdev>, <&pd_xusbss>;
|
|
power-domain-names = "dev", "ss";
|
|
|
|
nvidia,xusb-padctl = <&padctl>;
|
|
|
|
phys = <µ_b>;
|
|
phy-names = "usb2-0";
|
|
|
|
avddio-usb-supply = <&vdd_pex_1v05>;
|
|
hvdd-usb-supply = <&vdd_3v3_sys>;
|
|
};
|