This doesn't yet do anything in the tools, but make it explicit so we can check either 'unevaluatedProperties' or 'additionalProperties' is present in schemas. 'unevaluatedProperties' is appropriate when including another schema (via '$ref') and all possible properties and/or child nodes are not explicitly listed in the schema with the '$ref'. This is in preparation to add a meta-schema to check for missing 'unevaluatedProperties' or 'additionalProperties'. This has been a constant source of review issues. Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Wolfram Sang <wsa@kernel.org> Acked-by: Krzysztof Kozlowski <krzk@kernel.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Geert Uytterhoeven <geert+renesas@glider.be> Acked-by: Ulf Hansson <ulf.hansson@linaro.org> Acked-by: Guenter Roeck <linux@roeck-us.net> Acked-by: Mathieu Poirier <mathieu.poirier@linaro.org> Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> Link: https://lore.kernel.org/r/20201005183830.486085-2-robh@kernel.org Signed-off-by: Rob Herring <robh@kernel.org>
135 lines
3.7 KiB
YAML
135 lines
3.7 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/mmc/cdns,sdhci.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Cadence SD/SDIO/eMMC Host Controller (SD4HC)
|
|
|
|
maintainers:
|
|
- Masahiro Yamada <yamada.masahiro@socionext.com>
|
|
- Piotr Sroka <piotrs@cadence.com>
|
|
|
|
allOf:
|
|
- $ref: mmc-controller.yaml
|
|
|
|
properties:
|
|
compatible:
|
|
items:
|
|
- enum:
|
|
- socionext,uniphier-sd4hc
|
|
- const: cdns,sd4hc
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
# PHY DLL input delays:
|
|
# They are used to delay the data valid window, and align the window to
|
|
# sampling clock. The delay starts from 5ns (for delay parameter equal to 0)
|
|
# and it is increased by 2.5ns in each step.
|
|
|
|
cdns,phy-input-delay-sd-highspeed:
|
|
description: Value of the delay in the input path for SD high-speed timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-legacy:
|
|
description: Value of the delay in the input path for legacy timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-sd-uhs-sdr12:
|
|
description: Value of the delay in the input path for SD UHS SDR12 timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-sd-uhs-sdr25:
|
|
description: Value of the delay in the input path for SD UHS SDR25 timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-sd-uhs-sdr50:
|
|
description: Value of the delay in the input path for SD UHS SDR50 timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-sd-uhs-ddr50:
|
|
description: Value of the delay in the input path for SD UHS DDR50 timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-mmc-highspeed:
|
|
description: Value of the delay in the input path for MMC high-speed timing
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-input-delay-mmc-ddr:
|
|
description: Value of the delay in the input path for eMMC high-speed DDR timing
|
|
|
|
# PHY DLL clock delays:
|
|
# Each delay property represents the fraction of the clock period.
|
|
# The approximate delay value will be
|
|
# (<delay property value>/128)*sdmclk_clock_period.
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x1f
|
|
|
|
cdns,phy-dll-delay-sdclk:
|
|
description: |
|
|
Value of the delay introduced on the sdclk output for all modes except
|
|
HS200, HS400 and HS400_ES.
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x7f
|
|
|
|
cdns,phy-dll-delay-sdclk-hsmmc:
|
|
description: |
|
|
Value of the delay introduced on the sdclk output for HS200, HS400 and
|
|
HS400_ES speed modes.
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x7f
|
|
|
|
cdns,phy-dll-delay-strobe:
|
|
description: |
|
|
Value of the delay introduced on the dat_strobe input used in
|
|
HS400 / HS400_ES speed modes.
|
|
$ref: "/schemas/types.yaml#/definitions/uint32"
|
|
minimum: 0
|
|
maximum: 0x7f
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
- clocks
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
emmc: mmc@5a000000 {
|
|
compatible = "socionext,uniphier-sd4hc", "cdns,sd4hc";
|
|
reg = <0x5a000000 0x400>;
|
|
interrupts = <0 78 4>;
|
|
clocks = <&clk 4>;
|
|
bus-width = <8>;
|
|
mmc-ddr-1_8v;
|
|
mmc-hs200-1_8v;
|
|
mmc-hs400-1_8v;
|
|
cdns,phy-dll-delay-sdclk = <0>;
|
|
};
|